From owner-freebsd-doc  Tue Mar 12  8:51: 9 2002
Delivered-To: freebsd-doc@freebsd.org
Received: from freefall.freebsd.org (freefall.FreeBSD.org [216.136.204.21])
	by hub.freebsd.org (Postfix) with ESMTP id 74EE337B6E1
	for <freebsd-doc@freebsd.org>; Tue, 12 Mar 2002 08:50:02 -0800 (PST)
Received: (from gnats@localhost)
	by freefall.freebsd.org (8.11.6/8.11.6) id g2CGo2f97905;
	Tue, 12 Mar 2002 08:50:02 -0800 (PST)
	(envelope-from gnats)
Received: from hpdi.ath.cx (pc2-nthf5-0-cust237.not.cable.ntl.com [80.4.35.237])
	by hub.freebsd.org (Postfix) with ESMTP id 7636C37C179
	for <FreeBSD-gnats-submit@freebsd.org>; Tue, 12 Mar 2002 08:45:19 -0800 (PST)
Received: (from hitenp@hpdi.ath.cx)
	by hpdi.ath.cx (8.11.6/8.11.6) id g2CGgGL00829;
	Tue, 12 Mar 2002 16:42:16 GMT
	(envelope-from hitenp@hpdi.ath.cx)
Message-Id: <200203121642.g2CGgGL00829@hpdi.ath.cx>
Date: Tue, 12 Mar 2002 16:42:16 GMT
From: Hiten Pandya <hiten@uk.FreeBSD.org>
Reply-To: Hiten Pandya <hiten@uk.FreeBSD.org>
To: FreeBSD-gnats-submit@freebsd.org
X-Send-Pr-Version: 3.113
Subject: docs/35823: [PATCH] Little Restructuring of the Developers Handbook
Sender: owner-freebsd-doc@FreeBSD.ORG
Precedence: bulk
List-ID: <freebsd-doc.FreeBSD.ORG>
List-Archive: <http://docs.freebsd.org/mail/> (Web Archive)
List-Help: <mailto:majordomo@FreeBSD.ORG?subject=help> (List Instructions)
List-Subscribe: <mailto:majordomo@FreeBSD.ORG?subject=subscribe%20freebsd-doc>
List-Unsubscribe: <mailto:majordomo@FreeBSD.ORG?subject=unsubscribe%20freebsd-doc>
X-Loop: FreeBSD.org


>Number:         35823
>Category:       docs
>Synopsis:       [PATCH] Little Restructuring of the Developers Handbook
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          update
>Submitter-Id:   current-users
>Arrival-Date:   Tue Mar 12 08:50:01 PST 2002
>Closed-Date:
>Last-Modified:
>Originator:     Hiten Pandya
>Release:        FreeBSD 5.0-CURRENT i386
>Organization:
>Environment:
System: FreeBSD hpdi.ath.cx 5.0-CURRENT FreeBSD 5.0-CURRENT #1: Tue Mar 12 14:30:20 GMT 2002 hitenp@hpdi.ath.cx:/c1/obj/data/dev/src/sys/CURRENT5 i386

>Description:

	Currently, the Dev. Handbook is using the UFS chapter for having
	all the non-UFS things, and it also looks a bit un-organised.

	The patch I am submitting will resolve that issue by re-organising
	the UFS chapter, into a <part> called "Filesystem & I/O Services".

	This part will contain the following chapters:

		- Overview of the I/O System (namei, disklabels...)
		- The Virtual Filesystem Interface (vnodes, vnops...)
		- Local Filesystems (FFS, UFS, MFS, Ext2FS...)
		- Network Filesystems (AFS, NFS, SANs...)
		- Special Filesystems (PortalFS, UnionFS, ProcFS...)
		- Journaled (Log-based) Filesystems (JFS, LFS...)
	
	As of now, none of the above have been written up, but this
	patch is the first in the series, as it will help me to correctly
	place the content I will write up for the individual chapters
	named above.

	If you need more information, regarding this PR and the patch
	supplied, please do not hesitate to contact me.

	Thanks,
	Regards,

	  -- Hiten Pandya
	  -- <hiten@uk.FreeBSD.org>
	  
>How-To-Repeat:

	Visit the Dev. Handbook, and look at the currently messed
	structure of the Filesystems and stuff. (no offense) :)
	
>Fix:

	Please apply this patch (or comment) to:
		doc/en_US.ISO8859-1/books/developers-handbook/book.sgml
	
--- book.sgml	2002/03/12 16:13:16	1.1
+++ book.sgml	2002/03/12 16:20:42
@@ -97,7 +97,11 @@
     &chap.vm;
     &chap.dma;
     &chap.kerneldebug;
+  </part>
 
+  <part id="fsio">
+    <title>Filesystems & I/O Services</title>
+    
     <chapter id="ufs">
       <title>* UFS</title>
 
@@ -113,6 +117,7 @@
       <para>AFS, NFS, SANs, etc.</para>
 
     </chapter>
+  </part>
 
     <chapter id="syscons">
       <title>* Syscons</title>
>Release-Note:
>Audit-Trail:
>Unformatted:

To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message