Skip site navigation (1)Skip section navigation (2)
Date:      Tue, 12 Mar 2002 16:42:16 GMT
From:      Hiten Pandya <hiten@uk.FreeBSD.org>
To:        FreeBSD-gnats-submit@freebsd.org
Subject:   docs/35823: [PATCH] Little Restructuring of the Developers Handbook
Message-ID:  <200203121642.g2CGgGL00829@hpdi.ath.cx>

next in thread | raw e-mail | index | archive | help

>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




Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?200203121642.g2CGgGL00829>