Subject: misc/29875: NetBSD Guide chap-net-{practice,misc} patch commit request
To: None <misc-bug-people@netbsd.org, gnats-admin@netbsd.org,>
From: None <lavalamp@spiritual-machines.org>
List: netbsd-bugs
Date: 04/04/2005 01:10:00
>Number:         29875
>Category:       misc
>Synopsis:       NetBSD Guide chap-net-{practice,misc} patch commit request
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    misc-bug-people
>State:          open
>Class:          doc-bug
>Submitter-Id:   net
>Arrival-Date:   Mon Apr 04 01:10:00 +0000 2005
>Originator:     Brian A. Seklecki
>Release:        NetBSD deadset 2.99.9 NetBSD 2.99.9 (DEADSET) #4: Sun Nov  7 21:21:25 EST 2004
>Organization:
Spiritual Machines
>Environment:
NetBSD deadset 2.99.9 NetBSD 2.99.9 (DEADSET) #4: Sun Nov  7 21:21:25 EST 2004
>Description:
http://mail-index.netbsd.org/netbsd-docs/2005/03/26/0001.html

---------
Included is a massive set of patches to guide/en/chap-
net-{practice,misc}.xml;

This is a very large patch that due to many circumstances.  Firstly,
this patch was based on diff's to chap-net.xml rev 1.13 from work I
started in October `04.  There have been many revisions since then,
including the very large patch between r1.18 and r1.19; -- not to
mention, the breaking and reorganization of chap-net-*. 

Because my original changes to chap-net.xml were so radical, combined
with the branching, I was forced to manually merge my original changes
and "catch up", resulting in a less-than-optimal set of patches below.

It was very difficult to track NON-FORMATING changes between
chap-net.xml's final revision and the first revisions of
chap-net-misc.xml and chap-net-practice.xml, but I believe I got the
formatting and section names right.

However visually poor the patches may appear, I believe that I have made
a great number improvements worth reviewing.

I was originally planning to allocate time to write a great deal more
content; however I other priorities occupy my time, so I'm submitting
the work I have, now, before someone else commits an radical change >:}

Patch to chap-net-practice.xml:
http://digitalfreaks.org/~lavalamp/nbsd/chap-net-practicee.xml.patch.gz

Patch to chap-net-misc.xml:
http://digitalfreaks.org/~lavalamp/nbsd/chap-net-misc.xml.patch.gz

Full versions:
http://digitalfreaks.org/~lavalamp/nbsd/chap-net-practice.xml.gz
http://digitalfreaks.org/~lavalamp/nbsd/chap-net-misc.xml.gz

Viewable versions (w/ my NetBSD.css of course) at:
http://digitalfreaks.org/~lavalamp/htdocs/guide/en/chap-net-practice.html
http://digitalfreaks.org/~lavalamp/htdocs/guide/en/chap-net-misc.html

I will post URLs to original graphics/images soon, but in the mean time:
http://digitalfreaks.org/~lavalamp/htdocs/guide/images/chap-net-misc_hub.png
http://digitalfreaks.org/~lavalamp/htdocs/guide/images/chap-net-misc_bridge.png
http://digitalfreaks.org/~lavalamp/htdocs/guide/images/chap-net-misc_VLAN.png

---

Hopefully this document will marginalize the need for
htdocs/Documentation/network/index.html, also hopefully encourage other
parts of htdocs/Documentation/network/* to be migrated, and maybe
motiviate more users to contribute to sections that I've outlined, but
not been able to complete.

Before commiting, general many incomplete <sect1>'s will need to be
commented out, and any contributors to either
chap-net-{practice,misc}.xml since Oct 2004 will want to verify
everything was merged in properly.

My hope is that some day NetBSD will feature the most comprehensive set
of Network-related documentation (FAQ/Tutorial/Howto/References/etc.)

~BAS
>How-To-Repeat:
Determine that you're running "Net"BSD, realized how little documentation on Networking services exists outside of the man pages and source code.
>Fix:
See patch at URL.