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.