Re: Strange perldoc perldoc

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.


-- 
Just my 0.00000002 million dollars worth,
   Shawn

Programming is as much about organization and communication
as it is about coding.

[updated for today's programmers]
"Show me your code and conceal your interfaces, and I shall continue
to be mystified. Show me your interfaces, and I won't usually need
your code; it'll be obvious."
	-- Fred Brooks

Don't be clever; being great is good enough.