Re: Strange perldoc perldoc

Shawn H Corey <[email protected]> writes:
> On 12-04-30 11:19 AM, Russ Allbery wrote:

>> 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.

> Well, POD is suppose to be simple. If Mr. Wall wanted the full power of
> groff/nroff/troff, he would have written his documentation in them. The
> idea is to fit the documentation to the format, not the other way around.

> Yeah, it can be annoying but the most important thing about the
> documentation is its content, not its appearance. So don't plan to get to
> fancy with formatting.

Right, I generally agree.  I've just seen other people do this before, so
I can make a good guess at the thought process that was behind it.

-- 
Russ Allbery ([email protected])             <http://www.eyrie.org/~eagle/>