On Thu, 4 Jun 2009 10:23:34 +0100, Chris Rees <utis...@googlemail.com> wrote: > The FreeBSD project still uses man pages as the principle form of > documentation.
Sorry I brought up this topic... I don't think manpages are bad, I cosider them THE BEST SOLUTION for local documentation, so I don't think your use of the word "still" is well placed here. It should be "The FreeBSD project uses man pages [...]" - not "still", which reads like "The FreeBSD project still uses those old fashioned man pages, but will abandon them soon in favour of a GUI-driven help system that is used via Internet." :-) As a programmer, FreeBSD's documentation - beginning with the manpages, furthermore including the FAQ and the handbook, and finally the source code as well - is the most excellent kind of documentation I've seen so far. Returning to the manpages, they cover everything: Binaries, file formats, maintenance procedures, kernel interfaces, library calls... nothing important is missing. If you have a problem with "foo", you simply enter "man foo" to get more info about it. This is a situation you won't find in modern Linusi, and sadly, as well in modern applications on FreeBSD, mostly those that are GUI driven. Try to find manpages for some program from the KDE project. In opposite, try "man mplayer" or "man xmms", and, there's even "man opera", but no "man firefox". In those cases where there's no manpage, users are usually redirected to some web forum, Wiki, or encouraged to write the documentation on their own. :-) I think Wojciech just had the same observation. -- Polytropon >From Magdeburg, Germany Happy FreeBSD user since 4.0 Andra moi ennepe, Mousa, ... _______________________________________________ firstname.lastname@example.org mailing list http://lists.freebsd.org/mailman/listinfo/freebsd-questions To unsubscribe, send any mail to "freebsd-questions-unsubscr...@freebsd.org"