>-----Original Message-----
>From: Julian Elischer [mailto:[EMAIL PROTECTED]]
>Sent: Friday, November 30, 2001 1:01 AM
>To: Ted Mittelstaedt
>Cc: [EMAIL PROTECTED]; [EMAIL PROTECTED]; [EMAIL PROTECTED]
>Subject: RE: Netgraph
>
>
>
>
>On Fri, 30 Nov 2001, Ted Mittelstaedt wrote:
>
>> >-----Original Message-----
>>
>> If there is anything wrong with netgraph is that there's a lack of
>examples of
>> setting up common configurations in the handbook, man pages, and other
>> documents.
>
>/usr/share/examples/netgraph gives examples of some common
>configurations.
>

Oh dang, I should have checked there.  But really, this info needs to be
in the ngctl man page.

>> Also, speaking as a writer, section 4 of the manual page on netgraph is
>> extremely
>> hard to digest, within the first paragraph alone they redefine the
>meaning of
>> the words "graph", "node", "hook", and "edge"  I understand it's because of
>> the modularness of the software but this is a man page that needs
>to be a lot
>> less
>> abbreviated.
>
>Suggestions welcome.. :-)
>

The biggest problem with those man pages is that they tell you exactly
what the stuff does but not exactly why you would want to do it.

I actually sent in a proposal to BSDcon to give a presentation on building
network routers with FreeBSD, with a big D&P show of different systems
tied together.  Discussion of Netgraph would have been part of this
of course and while I was writing that part I could have modified
the man pages.  But it wasn't picked up and I set it aside.  Maybe sometime
in the future I'll pick it up again.


Ted Mittelstaedt                                       [EMAIL PROTECTED]
Author of:                           The FreeBSD Corporate Networker's Guide
Book website:                          http://www.freebsd-corp-net-guide.com



To Unsubscribe: send mail to [EMAIL PROTECTED]
with "unsubscribe freebsd-hackers" in the body of the message

Reply via email to