[MEncoder-users] Re: Re: Tutorial?

[Ilya Zakharevich]

[A complimentary Cc of this posting was NOT [per weedlist] sent to
Jeff Clagg 
<mencoder-users at mplayerhq.hu>], who wrote in article <20061006191523.GA5606 at ikaruga.co.uk>:
> >   0) It is unreadable; but this is not easy to fix, so let's delay this ;-)

> What exactly is unreadable about it? That it's so long?

Too long is not NECESSARILY bad; what is important that it is
organized to simplify job for the writer, not for the reader.

In short term, such an organization in an open source project may even
help; however, in long term all the (enormous!) effort which went into
manpage becomes kinda useless, since the reader can't find what she
needs.

One should break readers into several "categories" according to what
they want to find the docs, and organize things so that all these
categories can get at least 2 pennies worth from an act of reading the
docs.  Currently, only one category is addressed: people who knew all
the docs by heart already, but just can't recollect one particular
line.  ;-)

Thanks again to everybody how made this program possible to use,
Ilya