| Re: [AD] Docs and set_gfx_mode |
[ Thread Index |
Date Index
| More lists.liballeg.org/allegro-developers Archives
]
Grzegorz Adam Hankiewicz wrote:
And there's the problem with the Allegro
manual being both a read-from-top-to-bottom document as in .txt,
rtf, pdf format or jump-to-reference like info. In the former you
are reading everything in a row, so it makes sense to put those
"see below for more information". In info like format, you see the
single function you are reading, and there's no below, up or down
in a practical sense.
Actually, there is. When you get to the end of a page, press space :-)
But, yeah, "see below for more information" should probably be avoided.
It is even more drastic in unix manpages,
which are physically cut off from other bits.
Man pages are only for looking up details like function arguments,
return types, error codes, etc. You have to know what you're doing first.
Peter