Date: Wed, 23 Jun 1999 15:47:45 +0930 From: Greg Lehey <grog@lemis.com> To: Taavi Talvik <taavi@uninet.ee> Cc: Jeroen Ruigrok/Asmodai <asmodai@wxs.nl>, Mike Smith <mike@smith.net.au>, hm@hcs.de, dfr@nlsystems.com, peter@FreeBSD.ORG, FreeBSD Hackers <hackers@FreeBSD.ORG> Subject: Re: All this and documentation too? (was: cvs commit: src/sys/isa sio.c) Message-ID: <19990623154745.D581@freebie.lemis.com> In-Reply-To: <Pine.BSF.3.95.990623090548.13324B-100000@ns.uninet.ee>; from Taavi Talvik on Wed, Jun 23, 1999 at 09:12:12AM %2B0300 References: <19990622214019.B15249@daemon.ninth-circle.org> <Pine.BSF.3.95.990623090548.13324B-100000@ns.uninet.ee>
next in thread | previous in thread | raw e-mail | index | archive | help
On Wednesday, 23 June 1999 at 9:12:12 +0300, Taavi Talvik wrote: > On Tue, 22 Jun 1999, Jeroen Ruigrok/Asmodai wrote: > >> I am not fingerpointing here, not am I willing to. I just want to ask all >> developers to try and document at least the basic ideas somewhere in a >> manpage in order to make it easier for others (like me) who want to get >> the documentation on the road. > > If you write man pages first time, it is quite close to clack magic. > It would be really nice if someone comfortant with troff/nroff etc. > would make Handbook page describing how to get started with it. > Maybe even templates or script generating page sceletion and pointers to > them under some handbook entry > > http://www.ee.freebsd.org/docproj/doc-set.html says, > > The [Documentation]Project does not really concern itself with these, > since they are a part of the base system. There's a man page for it :-) mdoc.samples(7). Now tell me that that's not intuitive. Greg -- See complete headers for address, home page and phone numbers finger grog@lemis.com for PGP public key To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-hackers" in the body of the message
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?19990623154745.D581>