My CPAN application SudokuTrainer has POD sections in files
sudokutrainer.pl and enter_presets.pl. In addition there are 3 POD files
in dir Games/Sudoku/Trainer/pod/. My module files reside in dir
Games/Sudoku/Trainer/. I also copied (by commands in Build.PL) the POD
sections of *.pl to separate files sudokutrainer.pod and
enter_presets.pod, which also reside in dir Games/Sudoku/Trainer/pod/,
hoping that this might ease the usage of the docu.
I am able to create links from a POD file to a target in the same file,
and also to a module in CPAN. But I cannot create a link from a POD file
to a different one. When clicking on such a link at
"http://search.cpan.org/search?query=sudokutrainer&mode=all"; I always
get the CPAN window saying "not found". Here are some variants that I
tried in enter_presets.pl:
L<SudokuTrainer|Games::Sudoku::Trainer::pod::sudokutrainer.pod> (link
looks good)
L<Games::Sudoku::Trainer::pod::sudokutrainer.pod> (link looks good)
L<Games::Sudoku::Trainer::pod/sudokutrainer.pod> (link looks good)
L<Games/Sudoku/Trainer/pod/sudokutrainer.pod> (apparently wrong)
L<sudokutrainer.pl>
L<sudokutrainer>
All generated HTML-links are clickable.
Is it possible that all of this fails simply because I didn't yet upload
a "stable" version of SudokuTrainer, and thus there are no POD files in
my namespace?
And before you ask: Yes, I really did try to find the correct syntax for
the links in various sources, among others perldoc pod, the camel book
(German edition), PerlMonks Tutorial "POD in 5 minutes"
(http://www.perlmonks.org/?node_id=252477).
