Subject: Organizational changes for htdocs/Documentation/index.xml
To: None <netbsd-docs@NetBSD.org, hubertf@NetBSD.org>
From: David Holland <dholland@eecs.harvard.edu>
List: netbsd-docs
Date: 04/07/2007 19:05:12
Organizational adjustments for Documentation/index.xml:
* Move the cvsweb link up with the internals.
* The "other systems" links set is now its own top-level section.
* "general bsd information" -> "historic bsd information"
* Separate the links to external resources from miscellaneous NetBSD docs.
Index: index.xml
===================================================================
RCS file: /cvsroot/htdocs/Documentation/index.xml,v
retrieving revision 1.32
diff -u -r1.32 index.xml
--- index.xml 7 Apr 2007 18:28:29 -0000 1.32
+++ index.xml 7 Apr 2007 23:01:01 -0000
@@ -45,8 +45,16 @@
Pages</ulink>
</listitem>
<listitem>
- <ulink url="#documentation-other-information">Other
- Information</ulink>
+ <ulink url="#documentation-other-information">Miscellaneous
+ Documentation</ulink>
+ </listitem>
+ <listitem>
+ <ulink url="#documentation-external-resources">External
+ Resources</ulink>
+ </listitem>
+ <listitem>
+ <ulink url="#documentation-other-systems">Online
+ Documentation for Other Unix Systems</ulink>
</listitem>
</itemizedlist>
</para>
@@ -267,6 +275,12 @@
</td>
</tr>
</table>
+ <itemizedlist>
+ <listitem>
+ Browse the NetBSD codebase with
+ <ulink url="http://cvsweb.NetBSD.org">cvsweb</ulink>
+ </listitem>
+ </itemizedlist>
</sect1>
<sect1 id="documentation-howtos">
@@ -504,33 +518,22 @@
to NetBSD Manual Pages.</para>
</sect1>
<sect1 id="documentation-other-information">
- <title>Other Information</title>
+ <title>Miscellaneous Documentation</title>
<itemizedlist>
<listitem>
<ulink url="Hardware/">Hardware Documentation
Library</ulink>
</listitem>
<listitem>
- <ulink url="http://cvsweb.NetBSD.org">cvsweb</ulink>
- , a useful tool for examining changes to NetBSD's
- codebase</listitem>
- <listitem>
<ulink url="books.html">Recommended reading</ulink>
(Published books you may find informative)</listitem>
<listitem>
- <ulink url="http://www.gw.com/UNIXhelp/">UNIXhelp</ulink>
- (Helpful information for UNIX users)</listitem>
- <listitem>
<ulink url="research/">Research and Demonstrations</ulink>
</listitem>
<listitem>
- <ulink url="bsd/">General BSD Information</ulink>
+ <ulink url="bsd/">Historic BSD Information</ulink>
</listitem>
<listitem>
- <ulink url="http://www.bsdforums.org/">BSD Forums</ulink>
- - a discussion forum site dedicated to BSD and other open
- source software</listitem>
- <listitem>
<ulink url="mailto:jlemon@FreeBSD.org">Jonathan Lemon</ulink>
: ``Kqueue: A generic and scalable event notification
facility'' -
@@ -542,68 +545,81 @@
url="http://people.freebsd.org/~jlemon/papers/kqueue.ps">
PostScript</ulink>
version</listitem>
+ </itemizedlist>
+ </sect1>
+ <sect1 id="documentation-external-resources">
+ <title>External Resources</title>
+ <itemizedlist>
+ <listitem>
+ <ulink url="http://wiki.netbsd.se/">NetBSD Community Wiki</ulink>.
+ An unofficial NetBSD wiki maintained by the Swedish NetBSD User
+ Group.
+ </listitem>
+ <listitem>
+ <ulink url="http://www.gw.com/UNIXhelp/">UNIXhelp</ulink>
+ (Helpful information for UNIX users)</listitem>
+ <listitem>
+ <ulink url="http://www.bsdforums.org/">BSD Forums</ulink>
+ - a discussion forum site dedicated to BSD and other open
+ source software</listitem>
<listitem>
<ulink url="http://www.informit.com/articles/article.asp?p=363731">
Information on using systrace</ulink>.
References OpenBSD but much of the information applies to NetBSD.
</listitem>
+ </itemizedlist>
+ </sect1>
+ <sect1 id="documentation-other-systems">
+ <title>Online Documentation for other Unix Systems</title>
+ <itemizedlist>
<listitem>
- <ulink url="http://wiki.netbsd.se/">NetBSD Community Wiki</ulink>.
- An unofficial NetBSD wiki maintained by the Swedish NetBSD User
- Group.
+ <ulink url="http://www.unix-systems.org/online.html">
+ Single UNIX Specification</ulink>
</listitem>
- <listitem>Online Documentation for other UNIX systems
- <itemizedlist>
- <listitem>
- <ulink url="http://www.unix-systems.org/online.html">
- Single UNIX Specification</ulink>
- </listitem>
- <listitem>
- <ulink url="http://www.freebsd.org/docs.html">
- FreeBSD</ulink>
- </listitem>
- <listitem>
- <ulink url="http://docs.hp.com/hpux/os/man_pages.html">
- HP-UX Manual Pages</ulink>
- </listitem>
- <listitem>
- <ulink url="http://techpubs.sgi.com/">IRIX, UNICOS, and
- some NT/Linux</ulink>
- </listitem>
- <listitem>
- <ulink url="http://docs.sun.com/">Solaris</ulink>
- </listitem>
- <listitem>SCO
+ <listitem>
+ <ulink url="http://www.freebsd.org/docs.html">
+ FreeBSD</ulink>
+ </listitem>
+ <listitem>
+ <ulink url="http://docs.hp.com/hpux/os/man_pages.html">
+ HP-UX Manual Pages</ulink>
+ </listitem>
+ <listitem>
+ <ulink url="http://techpubs.sgi.com/">IRIX, UNICOS, and
+ some NT/Linux</ulink>
+ </listitem>
+ <listitem>
+ <ulink url="http://docs.sun.com/">Solaris</ulink>
+ </listitem>
+ <listitem>SCO
+ <ulink
+ url="http://www.caldera.com/support/docs/openserver/">
+ Openserver 5</ulink>
+ and
+ <ulink url="http://www.caldera.com/support/docs/unixware/">
+ UnixWare 7</ulink>
+ documentation</listitem>
+ <listitem>
+ <ulink
+ url="http://www.tru64unix.compaq.com/docs/pub_page/doc_list.html">
+ Tru64 Unix</ulink>
+ (Used to be Digital Unix)</listitem>
+ <listitem>
+ <ulink url="http://lxr.linux.no/source/">Linux Source
+ Tree</ulink>
+ (cross-referenced)</listitem>
+ <listitem>
+ <ulink url="http://fxr.watson.org/">FreeBSD/NetBSD/OpenBSD
+ (and Linux) Source Tree</ulink>
+ (cross-referenced)</listitem>
+ <listitem>
<ulink
- url="http://www.caldera.com/support/docs/openserver/">
- Openserver 5</ulink>
- and
- <ulink url="http://www.caldera.com/support/docs/unixware/">
- UnixWare 7</ulink>
- documentation</listitem>
- <listitem>
+ url="http://publib.boulder.ibm.com/infocenter/pseries/index.jsp?topic=/com.ibm.aix.doc/infocenter/base/aix53.htm">
+ AIX</ulink>
+ </listitem>
+ <listitem>
<ulink
- url="http://www.tru64unix.compaq.com/docs/pub_page/doc_list.html">
- Tru64 Unix</ulink>
- (Used to be Digital Unix)</listitem>
- <listitem>
- <ulink url="http://lxr.linux.no/source/">Linux Source
- Tree</ulink>
- (cross-referenced)</listitem>
- <listitem>
- <ulink url="http://fxr.watson.org/">FreeBSD/NetBSD/OpenBSD
- (and Linux) Source Tree</ulink>
- (cross-referenced)</listitem>
- <listitem>
- <ulink
- url="http://publib.boulder.ibm.com/infocenter/pseries/index.jsp?topic=/com.ibm.aix.doc/infocenter/base/aix53.htm">
- AIX</ulink>
- </listitem>
- <listitem>
- <ulink
- url="http://www.gnu.org/manual/manual.html">GNU</ulink>
- </listitem>
- </itemizedlist>
+ url="http://www.gnu.org/manual/manual.html">GNU</ulink>
</listitem>
</itemizedlist>
</sect1>