Skip Menu |

Preferred bug tracker

Please visit the preferred bug tracker to report your issue.

This queue is for tickets about the Pod-ProjectDocs CPAN distribution.

Report information
The Basics
Id: 15052
Status: resolved
Priority: 0/
Queue: Pod-ProjectDocs

People
Owner: Nobody in particular
Requestors: smueller [...] cpan.org
Cc:
AdminCc:

Bug Information
Severity: Important
Broken in: 0.18
Fixed in: (no value)



Subject: Verbatim block formatting
This was found with Pod-ProjectDocs-0.18. This bug report is about how verbatim blocks are formatted. I hope I'm actually reporting this in the correct place. It might be a bug in an underlying module for all I know. Inline verbatim blocks such as the following this paragraph are formatted as a HTML 'pre' section. That's correct. There are, however, two problems I found. a) The block includes a trailing empty line increasing its size. (This can be pretty distracting for short blocks.) b) If the block has "empty" lines which contain as much whitespace at the start of the line as the first line of the block, these lines should not be understood as paragraph separators. I.e. the result should only be a single 'pre' environment. Example block which should be rendered as a single 'pre'. Note the two spaces at the start of the previous line! The line above this line does not contain spaces. Thus, it marks the end of the verbatim block. I hope I could make myself sufficiently clear. I'd like to take the opportunity to thank you for this really useful tool. Please continue the great work you have done so far. Details on my Perl: This is perl, v5.8.7 built for MSWin32-x86-multi-thread (with 7 registered patches, see perl -V for more detail) Copyright 1987-2005, Larry Wall Binary build 813 [148120] provided by ActiveState http://www.ActiveState.com ActiveState is a division of Sophos. Built Jun 6 2005 13:36:37 Perl may be copied only under the terms of either the Artistic License or the GNU General Public License, which may be found in the Perl 5 source kit. Complete documentation for Perl, including FAQ lists, should be found on this system using `man perl' or `perldoc perl'. If you have access to the Internet, point your browser at http://www.perl.org/, the Perl Home Page.
Trailing newline fixed in https://github.com/mgruner/p5-pod-projectdocs/commit/5bfdbc49d5dedceddfa6a633187480c656d0c608, will be in 0.42. The other issue has been fixed in the meantime, AFAICT. Am Fr 14. Okt 2005, 04:30:17, guest schrieb: Show quoted text
> This was found with Pod-ProjectDocs-0.18. > > This bug report is about how verbatim blocks are formatted. I hope I'm > actually reporting this in the correct place. It might be a bug in an > underlying module for all I know. > > Inline verbatim blocks such as the following this paragraph are > formatted as a HTML 'pre' section. That's correct. There are, however, > two problems I found. a) The block includes a trailing empty line > increasing its size. (This can be pretty distracting for short > blocks.) b) If the block has "empty" lines which contain as much > whitespace at the start of the line as the first line of the block, > these lines should not be understood as paragraph separators. I.e. the > result should only be a single 'pre' environment. > > Example block which should be rendered as a single 'pre'. > > Note the two spaces at the start of the previous line! > > The line above this line does not contain spaces. Thus, it marks the > end of the verbatim block. I hope I could make myself sufficiently > clear. > > I'd like to take the opportunity to thank you for this really useful > tool. Please continue the great work you have done so far. > > Details on my Perl: > > This is perl, v5.8.7 built for MSWin32-x86-multi-thread > (with 7 registered patches, see perl -V for more detail) > > Copyright 1987-2005, Larry Wall > > Binary build 813 [148120] provided by ActiveState > http://www.ActiveState.com > ActiveState is a division of Sophos. > Built Jun 6 2005 13:36:37 > > Perl may be copied only under the terms of either the Artistic License > or the > GNU General Public License, which may be found in the Perl 5 source > kit. > > Complete documentation for Perl, including FAQ lists, should be found > on > this system using `man perl' or `perldoc perl'. If you have access to > the > Internet, point your browser at http://www.perl.org/, the Perl Home > Page.