Re: Strange perldoc perldoc

[email protected] (Russ Allbery)
Newsgroups perl.pod-people
Organization The Eyrie
Message-ID <[email protected]>
Shawn H Corey <[email protected]> writes:
> On 12-04-30 10:52 AM, Smylers wrote:

>> It didn't used to be verbatim, when the bold formatting was originally
>> added. That Pod got indented in this Dev release a few months ago:
>> https://metacpan.org/diff/file/?target=BDFOY/Pod-Perldoc-3.15_10/lib/perldoc.pod&source=BDFOY/Pod-Perldoc-3.15_09/lib/perldoc.pod

> Well, if they wanted it indented, they should have used
> =over/=back. That's what it was invented for. ;)

I suspect indentation wasn't the goal, but rather preserving formatting.
There currently isn't any way in POD to preserve line breaks and allow
inline formatting, which gets a little annoying when writing man pages.

(There's an undocumented hack in pod2man that actually preserves
formatting in this particular situation even without indentation due to an
accidental interaction with *roff, but it's not really something to rely
upon.)

-- 
Russ Allbery ([email protected])             <http://www.eyrie.org/~eagle/>
lmpx.com only provides a reader for public news (NNTP) servers. It is not affiliated with the servers or forums shown here and is not responsible for the content of articles, which is written by their respective authors.