From mark@remotelab.org Fri Oct 3 07:48:41 2003 Return-Path: Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 21E0F16A4C0 for ; Fri, 3 Oct 2003 07:48:28 -0700 (PDT) Received: from 194-185-53-242.f5.ngi.it (194-185-53-242.f5.ngi.it [194.185.53.242]) by mx1.FreeBSD.org (Postfix) with ESMTP id 9ED1343FDD for ; Fri, 3 Oct 2003 07:48:23 -0700 (PDT) (envelope-from mark@remotelab.org) Received: from einstein.lab (einstein.lab [192.168.168.2]) by 194-185-53-242.f5.ngi.it (8.12.9p2/8.12.9) with ESMTP id h93EmMUX017828 for ; Fri, 3 Oct 2003 16:48:22 +0200 (CEST) (envelope-from mark@remotelab.org) Received: from einstein.lab (localhost [127.0.0.1]) by einstein.lab (8.12.9p2/8.12.9) with ESMTP id h93Em57Y000369 for ; Fri, 3 Oct 2003 16:48:05 +0200 (CEST) (envelope-from mark@einstein.lab) Received: (from mark@localhost) by einstein.lab (8.12.9p2/8.12.9/Submit) id h93Em4ms000368; Fri, 3 Oct 2003 16:48:04 +0200 (CEST) (envelope-from mark) Message-Id: <200310031448.h93Em4ms000368@einstein.lab> Date: Fri, 3 Oct 2003 16:48:04 +0200 (CEST) From: mark@remotelab.org Reply-To: mark@remotelab.org To: FreeBSD-gnats-submit@freebsd.org Cc: Subject: Some suggestions for the Basics chapter of the Handbook X-Send-Pr-Version: 3.113 X-GNATS-Notify: >Number: 57541 >Category: docs >Synopsis: Some suggestions for the Basics chapter of the Handbook >Confidential: no >Severity: non-critical >Priority: low >Responsible: trhodes >State: closed >Quarter: >Keywords: >Date-Required: >Class: change-request >Submitter-Id: current-users >Arrival-Date: Fri Oct 03 07:50:17 PDT 2003 >Closed-Date: Sat Dec 24 03:35:32 GMT 2005 >Last-Modified: Sat Dec 24 03:35:32 GMT 2005 >Originator: Marco T. >Release: FreeBSD 4.9-PRERELEASE i386 >Organization: >Environment: System: FreeBSD einstein.lab 4.9-PRERELEASE FreeBSD 4.9-PRERELEASE #0: Sun Sep 28 19:14:04 CEST 2003 root@einstein.lab:/usr/obj/usr/src/sys/EINSTEIN i386 >Description: -add new item in Synopsis; -correct one command prompt; -tags,images and links adjustment (install --> basics); -adapt two sentence into new context of basics chapter; Some files in the handbook/install directory should be removed: disk-layout.kil example-dir1.dot example-dir2.dot example-dir3.dot example-dir4.dot example-dir5.dot and some files in the doc/share/images/books/handbook/install directory should be moved in a new doc/share/images/books/handbook/basics directory: disk-layout.eps example-dir1.eps example-dir2.eps example-dir3.eps example-dir4.eps example-dir5.eps >How-To-Repeat: >Fix: --- all.diff begins here --- --- chapter.sgml.old Fri Oct 3 16:34:35 2003 +++ chapter.sgml Fri Oct 3 16:34:15 2003 @@ -44,6 +44,9 @@ The default &os; file system layout. + The &os; disk organization. + + How to mount and unmount file systems. @@ -176,7 +179,7 @@ You should see the MOTD or message of the day followed by a command prompt (a #, - $, or $ character). This + $, or % character). This indicates you have successfully logged into FreeBSD. @@ -894,7 +897,7 @@ - + @@ -914,7 +917,7 @@ - + @@ -942,7 +945,7 @@ - + @@ -968,7 +971,7 @@ - + @@ -994,7 +997,7 @@ - + @@ -1079,8 +1082,8 @@ Filesystems are contained in partitions. This does not have the - same meaning as the earlier usage of the term partition in this - chapter, because of FreeBSD's &unix; heritage. Each partition is + same meaning as the common usage of the term partition (for example, DOS + partition), because of FreeBSD's &unix; heritage. Each partition is identified by a letter from a through to h. Each partition can contain only one filesystem, which means that filesystems are often described by either their @@ -1150,7 +1153,7 @@ Each partition-that-contains-a-filesystem is stored in what FreeBSD calls a slice. Slice is FreeBSD's term - for what were earlier called partitions, and again, this is because of + for what common call partitions, and again, this is because of FreeBSD's &unix; background. Slices are numbered, starting at 1, through to 4. @@ -1183,16 +1186,16 @@ starts with a code that indicates the type of disk, and then a number, indicating which disk it is. Unlike slices, disk numbering starts at 0. Common codes that you will see are listed in - . + . When referring to a partition FreeBSD requires that you also name the slice and disk that contains the partition, and when referring to a slice you should also refer to the disk name. Do this by listing the disk name, s, the slice number, and then the partition letter. Examples are shown in - . + . - shows a conceptual + shows a conceptual model of the disk layout that should help make things clearer. In order to install FreeBSD you must first configure the disk @@ -1200,7 +1203,7 @@ FreeBSD, and then create a filesystem (or swap space) in each partition, and decide where that filesystem will be mounted. - +
Disk Device Codes @@ -1249,7 +1252,7 @@
- + Sample Disk, Slice, and Partition Names @@ -1286,7 +1289,7 @@ - + Conceptual Model of a Disk This diagram shows FreeBSD's view of the first IDE disk attached @@ -1304,7 +1307,7 @@ - + --- Makefile.old Fri Oct 3 16:34:58 2003 +++ Makefile Fri Oct 3 16:34:42 2003 @@ -39,6 +39,12 @@ IMAGES_EN = advanced-networking/isdn-bus.eps IMAGES_EN+= advanced-networking/isdn-twisted-pair.eps IMAGES_EN+= advanced-networking/natd.eps +IMAGES_EN+= basics/disk-layout.eps +IMAGES_EN+= basics/example-dir1.eps +IMAGES_EN+= basics/example-dir2.eps +IMAGES_EN+= basics/example-dir3.eps +IMAGES_EN+= basics/example-dir4.eps +IMAGES_EN+= basics/example-dir5.eps IMAGES_EN+= install/userconfig.scr IMAGES_EN+= install/userconfig2.scr IMAGES_EN+= install/hdwrconf.scr @@ -96,14 +102,7 @@ IMAGES_EN+= install/adduser2.scr IMAGES_EN+= install/adduser3.scr IMAGES_EN+= install/mainexit.scr -IMAGES_EN+= install/disk-layout.eps IMAGES_EN+= install/edit-inetd-conf.scr - -IMAGES_EN+= install/example-dir1.eps -IMAGES_EN+= install/example-dir2.eps -IMAGES_EN+= install/example-dir3.eps -IMAGES_EN+= install/example-dir4.eps -IMAGES_EN+= install/example-dir5.eps IMAGES_EN+= security/ipsec-network.pic IMAGES_EN+= security/ipsec-crypt-pkt.pic IMAGES_EN+= security/ipsec-encap-pkt.pic --- all.diff ends here --- >Release-Note: >Audit-Trail: Responsible-Changed-From-To: freebsd-doc->trhodes Responsible-Changed-By: trhodes Responsible-Changed-When: Fri Oct 3 10:02:24 PDT 2003 Responsible-Changed-Why: This conflicts with a WIP of mine, take it as to avoid patch application difficulties. http://www.freebsd.org/cgi/query-pr.cgi?pr=57541 State-Changed-From-To: open->patched State-Changed-By: trhodes State-Changed-When: Sat Dec 27 08:40:35 PST 2003 State-Changed-Why: Much of these changes have been applied. The Makefile and image changes are forthcoming until I figure out exactly what I want to do with them. They should be repocopied during a weekday when I can make an instant commit to them. http://www.freebsd.org/cgi/query-pr.cgi?pr=57541 State-Changed-From-To: patched->closed State-Changed-By: linimon State-Changed-When: Sat Dec 24 03:34:38 UTC 2005 State-Changed-Why: Most of the original text was already committed, and other text has probably been changed since then. http://www.freebsd.org/cgi/query-pr.cgi?pr=57541 >Unformatted: