Bug #85780 for Pod-Perldoc: Pod::Perldoc breaks paragraph lines incorrectly after the switch to ToTerm

Fri May 31 20:31:47 2013 DOHERTY [...] cpan.org - Ticket created

Subject:

Pod::Perldoc breaks paragraph lines incorrectly after the switch to ToTerm

This is probably related to the switch from ToMan to ToTerm. I noticed in 5.18.0 that perldelta paragraphs had line breaks at every line break in the source. That is: Here begins a paragraph and it continues here. would be rendered as two lines, with the line break in the output where it appears in the input. Previously, this was rendered as a single paragraph, which was wrapped according to the size of the terminal it was output to. The -MPod::Perldoc::ToMan switch to perldoc restores the previous correct behaviour.

Fri May 31 20:37:26 2013 DOHERTY [...] cpan.org - Correspondence added

In fact, ansi and term have the same error.

Fri May 31 20:39:03 2013 DOHERTY [...] cpan.org - Correspondence added

On Fri May 31 20:37:26 2013, DOHERTY wrote: Show quoted text

> In fact, ansi and term have the same error.

So, the workaround is to use a formatter that does the right thing. You can set the environment variable PERLDOC="-MPod::Perldoc::Man" to restore the old behaviour.

Tue Jun 04 10:10:21 2013 mrallen1 [...] yahoo.com - Correspondence added

On Fri May 31 20:31:47 2013, DOHERTY wrote: Show quoted text

> This is probably related to the switch from ToMan to ToTerm. > > I noticed in 5.18.0 that perldelta paragraphs had line breaks at every > line break in the source. That is: > > Here begins a paragraph > and it continues here. > > would be rendered as two lines, with the line break in the output > where it appears in the input. Previously, this was rendered as a > single paragraph, which was wrapped according to the size of the > terminal it was output to. > > The -MPod::Perldoc::ToMan switch to perldoc restores the previous > correct behaviour.

Yes, the ToTerm and Pod::Text::Term formatters need as much love as ToMan has gotten over the last 10 years. Thanks for the report. I will work with the podulators on a fix.

Tue Jun 04 10:10:21 2013 The RT System itself - Status changed from 'new' to 'open'

Wed Feb 05 00:07:22 2014 mrallen1 [...] yahoo.com - Correspondence added

On Tue Jun 04 10:10:21 2013, mallen wrote: Show quoted text

> On Fri May 31 20:31:47 2013, DOHERTY wrote:

> > This is probably related to the switch from ToMan to ToTerm. > > > > I noticed in 5.18.0 that perldelta paragraphs had line breaks at > > every > > line break in the source. That is: > > > > Here begins a paragraph > > and it continues here. > > > > would be rendered as two lines, with the line break in the output > > where it appears in the input. Previously, this was rendered as a > > single paragraph, which was wrapped according to the size of the > > terminal it was output to. > > > > The -MPod::Perldoc::ToMan switch to perldoc restores the previous > > correct behaviour.

> > Yes, the ToTerm and Pod::Text::Term formatters need as much love as > ToMan has gotten over the > last 10 years. > > Thanks for the report. I will work with the podulators on a fix.

In September 2013, the podulators team committed some fixes to the way that Pod::Text::Termcap wraps lines including paragraph breaks. Using that + the pager of /usr/bin/less -R and the Pod::Perldoc test release I haven't been able to replicate this issue. Would you please test on your system(s) and report back? It would be especially helpful if you could set PERLDOCDEBUG=4 before you run perldoc and attach the output from perldoc. Thanks.