man (and its lesser known
cousin apropos)
are invaluable resources for using the command-line on Linux. While the
information is useful, sometimes they can also be entertaining, particularly
in the BUGS sections. Some due to being overly honest like
nethack's which merely states
Probably infinite.
or bash's which admits
It's too big and too slow.
My personal favorite is the passage in the BUGS section for
xargs, which,
after a two paragraph long discussion on the interaction between the
-i, -I, and -s flags finally concludes
Instead, the
-ioption should not impose a line length limit, which is why this discussion appears in the BUGS section.
Some have comments that are merely strange, like the BUGS section for
screen,
which, among many other comments, includes the bug
A weird imagination is most useful to gain full advantage of all the features.
which is where this blog gets it name.