"James E Keenan via RT" <perl...@perl.org> writes:
> On Thu Aug 14 16:19:56 2014, jkeenan wrote:>> >> The only problem is that while removing the line numbers will make "A>> Complete Example" look better on perldoc.perl.org, it removes semantic>> information when that example is viewed through *other* POD>> formatters.>> >> For example, when I apply that patch to a branch based on blead, and>> then say:>> >> #####>> perldoc pod/perlthrtut.pod>> #####>> >> ... the line numbers are removed -- but then the text in subsequent>> paragraphs becomes hard to follow:>> >> #####>> The bulk of the work is done by the "check_num()" subroutine, which>> takes>> a reference to its input queue and a prime number that it's>> responsible>> for. After pulling in the input queue and the prime that the>> subroutine is>> checking (line 11), we create a new queue (line 13) and reserve a>> scalar>> for the thread that we're likely to create later (line 12).>> #####>> >> There are a total of 5 paragraphs that make reference to the line>> numbering in the example. If we remove the line number from the text>> of pod/perlthrtut.pod, we improve the situation for perldoc.perl.org,>> but make the situation worse (IMHO) for other POD formatters.>> >> I think this is mainly a question for those who maintain>> perldoc.perl.org to resolve (should they choose to do so; that site is>> not maintained by Perl 5 Porters).>> >> Rolando, since there has been no further discussion in this ticket,> I'm going to close it without applying your patch. I urge you to take> your concerns up with the maintainers of perldoc.perl.org.>> Thank you very much.> Jim Keenan
Hello Jim,
I had assumed that this mailing list was the correct place to discuss
the "perldoc.perl.org" page since that page is under the "perl.org"
domain.
Feel free to close the ticket.
Best Regards,
Rolando Pereira