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.
