Date: Sat, 4 Jan 2003 10:04:28 +0200 From: Giorgos Keramidas <keramida@freebsd.org> To: Nick Rogness <nick@rogness.net> Cc: Lucky Green <shamrock@cypherpunks.to>, l.rizzo@iet.unipi.it, doc@freebsd.org Subject: Re: IPFW: suicidal defaults Message-ID: <20030104080428.GA5322@gothmog.gr> In-Reply-To: <20030103195642.G6257-100000@skywalker.rogness.net> References: <20030103212617.GC2505@gothmog.gr> <20030103195642.G6257-100000@skywalker.rogness.net>
next in thread | previous in thread | raw e-mail | index | archive | help
On 2003-01-03 20:01, Nick Rogness <nick@rogness.net> wrote:
> On Fri, 3 Jan 2003, Giorgos Keramidas wrote:
> > > Agreed. There should be a mention. However, someone has to write
> > > it. Instead of bitchin about it, go ahead and submit a change
> > > (bug report).
> >
> > Oh but it is documented. The sample configuration that one can find
> > at /usr/src/sys/i386/conf/LINT includes a comment:
> > [...]
> > Ignoring this is not a fault of the documentation :(
>
> You are right. The documentation is there. However, finding this
> is not easy for a beginner. It wouldn't hurt to mention it
> ipfw(8) and the handbook.
>
> But that takes work and is redundant :-)
Actually, no work is redundant. All the help you can give in
improving our documentation is welcome, and much appreciated.
In this particular case, all the references I could find to LINT in
the kernelconfig/chapter.sgml chapter of the handbook were:
[ Quoting doc/en_US.ISO8859-1/books/handbook/kernelconfig/chapter.sgml ]
%%
411 id="kernelconfig-options"> An exhaustive list of options and more
412 detailed explanations of the device lines is present in the
413 <filename>LINT</filename> configuration file, located in the same
414 directory as <filename>GENERIC</filename>. If you are in doubt as
415 to the purpose or necessity of a line, check first in
416 <filename>LINT</filename>.</para>
%%
441 closely. For details of all the possible kernel options, see
442 <filename>/usr/src/sys/i386/conf/LINT</filename>.</para>
...
The first paragraph looks like it needs a bit of toning up, in order
to be more obvious and stand out. But some doumentation *is* there.
If you think that it can be improved, then please, by all means, help
us improve it. Post your changes to the freebsd-doc list or file a
problem report under the ``docs'' category.
- Giorgos
To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20030104080428.GA5322>