more organized handbook
authorxor <xor@web>
Wed, 18 Feb 2009 03:18:07 +0000 (19:18 -0800)
committerCharlie <root@leaf.dragonflybsd.org>
Wed, 18 Feb 2009 03:18:07 +0000 (19:18 -0800)
docs/handbook/index.mdwn

index 461c56a..c566620 100644 (file)
@@ -6,21 +6,27 @@ Welcome to DragonFly! This handbook covers the installation and day to day use o
 
 Portions of this document originally documented use of the [FreeBSD](http://www.freebsd.org/) operating system. While many functions should be similar on DragonFly, some differences should be expected. If you find instructions here that no longer apply to DragonFly, please contact the documentation mailing list at [DragonFly Documentation project mailing list](http://leaf.dragonflybsd.org/mailarchive/).
 
-1. 1. [[Preface|handbook-book-preface]]
-   1. [[Getting Started|handbook-getting-started]]
+###Preface 
 
-2. 1. [[Introduction|handbook-introduction]]
-   1. [[Synopsis|handbook-introduction#INTRODUCTION-SYNOPSIS]]
+   1. [[Preface|handbook-book-preface]]
+   1. [[Getting Started|handbook-getting-started]]   
+
+###Chapter 1 Introduction
+
+   1. [[Synopsis|handbook-introduction]]
    1. [[Welcome to DragonFly!|handbook-nutshell]]
-   1. [[About the DragonFly Project|handbook-history]]
+   1. [[About the DragonFly Project|handbook-history]]  
 
-3. 1. [[Installation from CD|handbook-InstallDragonFlyFromCD]]
+###Chapter 2 Installation
+   1. [[Installation from CD|handbook-InstallDragonFlyFromCD]]
    1. [[First steps|handbook-InstallFirstSteps]]
    1. [[Disk setup|handbook-InstallDiskSetup]]
    1. [[Installing to Disk from CD|handbook-InstallToDisk]]
-   1. [[New system setup|handbook-InstallationSystemSetup]]
+   1. [[New system setup|handbook-InstallationSystemSetup]]  
+
+###Chapter 3 UNIX Basics 
 
-1. 1. [[UNIX Basics|handbook-basics]]
    1. [[Synopsis|handbook-basics]]
    1. [[Virtual Consoles and Terminals|handbook-consoles]]
    1. [[Permissions|handbook-permissions]]
@@ -33,18 +39,20 @@ Portions of this document originally documented use of the [FreeBSD](http://www.
    1. [[Text Editors|handbook-editors]]
    1. [[Devices and Device Nodes|handbook-basics-devices]]
    1. [[Binary Formats|handbook-binary-formats]]
-   1. [[For More Information|handbook-basics-more-information]]
+   1. [[For More Information|handbook-basics-more-information]]  
+
+###Chapter 4 Installing Applications
 
-1. 1. [[Installing Applications using NetBSD's pkgsrc framework|handbook-pkgsrc]]
    1. [[Synopsis|handbook-pkgsrc]]
    1. [[Overview of Software Installation|handbook-pkgsrc-overview]]
    1. [[Finding Your Application|handbook-pkgsrc-finding-applications]]
    1. [[Using the Binary Packages System|handbook-pkgsrc-using]]
    1. [[Using the pkgsrc Source Tree|handbook-pkgsrc-sourcetree-using]]
    1. [[Post-installation Activities|handbook-pkgsrc-nextsteps]]
-   1. [[Dealing with Broken Packages|handbook-pkgsrc-broken]]
+   1. [[Dealing with Broken Packages|handbook-pkgsrc-broken]]  
+
+###Chapter 5 The X Window System
 
-1. 1. [[The X Window System|handbook-x11]]
    1. [[Synopsis|handbook-x11]]
    1. [[Understanding X|handbook-x-understanding]]
    1. [[Installing X11|handbook-x-install]]
@@ -52,9 +60,10 @@ Portions of this document originally documented use of the [FreeBSD](http://www.
    1. [[Using Fonts in X11|handbook-x-fonts]]
    1. [[The X Display Manager|handbook-x-xdm]]
    1. [[Desktop Environments|handbook-x11-wm]]
-   1. [[System Administration|handbook-system-administration]]
+   1. [[System Administration|handbook-system-administration]]  
+
+###Chapter 6 UNIX Configuring and Tuning
 
-1. 1. [[Configuration and Tuning|handbook-config-tuning]]
    1. [[Synopsis|handbook-config-tuning]]
    1. [[Initial Configuration|handbook-configtuning-initial]]
    1. [[Core Configuration|handbook-configtuning-core-configuration]]
@@ -70,22 +79,26 @@ Portions of this document originally documented use of the [FreeBSD](http://www.
    1. [[Tuning Kernel Limits|handbook-configtuning-kernel-limits]]
    1. [[Adding Swap Space|handbook-adding-swap-space]]
    1. [[Power and Resource Management|handbook-acpi-overview]]
-   1. [[Using and Debugging DragonFly ACPI|handbook-acpi-debug]]
+   1. [[Using and Debugging DragonFly ACPI|handbook-acpi-debug]]  
 
-1. 1. [[The DragonFly virtual kernel|docs/user/list/VKernelOverview]]
+###Chapter 7 The DragonFly virtual kernel
+   
+   1. [[The DragonFly virtual kernel|docs/user/list/VKernelOverview]]
    1. [[Setup a virtual kernel environment|docs/user/list/VKernelSetup]]
    1. [[Setup networking|docs/user/list/VKernelNetwork]]
-   1. [[Run a virtual kernel|docs/user/list/VKernelRun]]
+   1. [[Run a virtual kernel|docs/user/list/VKernelRun]]  
+
+###Chapter 8 The DragonFly Booting Process
 
-1. 1. [[The DragonFly Booting Process|handbook-boot]]
    1. [[Synopsis|handbook-boot]]
    1. [[The Booting Problem|handbook-boot-introduction]]
    1. [[The Boot Manager and Boot Stages|handbook-boot-blocks]]
    1. [[Kernel Interaction During Boot|handbook-boot-kernel]]
    1. [[Init: Process Control Initialization|handbook-boot-init]]
-   1. [[Shutdown Sequence|handbook-boot-shutdown]]
+   1. [[Shutdown Sequence|handbook-boot-shutdown]]  
+
+###Chapter 9 Users and Basic Account Management
 
-1. 1. [[Users and Basic Account Management|handbook-users]]
    1. [[Synopsis|handbook-users]]
    1. [[Introduction|handbook-users-introduction]]
    1. [[The Superuser Account|handbook-users-superuser]]
@@ -94,17 +107,20 @@ Portions of this document originally documented use of the [FreeBSD](http://www.
    1. [[Modifying Accounts|handbook-users-modifying]]
    1. [[Limiting Users|handbook-users-limiting]]
    1. [[Personalizing Users|handbook-users-personalizing]]
-   1. [[Groups|handbook-users-groups]]
+   1. [[Groups|handbook-users-groups]]  
+
+###Chapter 10 Configuring the DragonFly Kernel
 
-1. 1. [[Configuring the DragonFly Kernel|handbook-kernelconfig]]
    1. [[Synopsis|handbook-kernelconfig]]
    1. [[Why Build a Custom Kernel?|handbook-kernelconfig-custom-kernel]]
    1. [[Building and Installing a Custom Kernel|handbook-kernelconfig-building]]
    1. [[The Configuration File|handbook-kernelconfig-config]]
    1. [[Making Device Nodes|handbook-kernelconfig-nodes]]
-   1. [[If Something Goes Wrong|handbook-kernelconfig-trouble]]
+   1. [[If Something Goes Wrong|handbook-kernelconfig-trouble]]  
 
-1. 1. [[Security|handbook-security]]
+###Chapter 11 Security
+
+   1. [[Synopsis|handbook-security]]
    1. [[Introduction|handbook-security-intro]]
    1. [[Securing DragonFly|handbook-securing-freebsd]]
    1. [[DES, MD5, and Crypt|handbook-crypt]]
@@ -113,25 +129,28 @@ Portions of this document originally documented use of the [FreeBSD](http://www.
    1. [[Firewalls|handbook-firewalls]]
    1. [[OpenSSL|handbook-openssl]]
    1. [[VPN over IPsec|handbook-ipsec]]
-   1. [[OpenSSH|handbook-openssh]]
+   1. [[OpenSSH|handbook-openssh]]  
 
-1. 1. [[Jails|handbook-jails]]
-   1. [[Synopsis|handbook-jails#JAILS-SYNOPSIS]]
+###Chapter 12 Jails
+  
+   1. [[Synopsis|handbook-jails]]
    1. [[Terms Related to Jails|handbook-jails-terms]]
    1. [[Introduction|handbook-jails-intro]]
    1. [[Creating and Controlling Jails|handbook-jails-build]]
-   1. [[Fine Tuning and Administration|handbook-jails-tuning]]
+   1. [[Fine Tuning and Administration|handbook-jails-tuning]]  
+
+###Chapter 13 Printing
 
-1. 1. [[Printing|handbook-printing]]
    1. [[Synopsis|handbook-printing]]
    1. [[Introduction|handbook-printing-intro-spooler]]
    1. [[Basic Setup|handbook-printing-intro-setup]]
    1. [[Advanced Printer Setup|handbook-printing-advanced]]
    1. [[Using Printers|handbook-printing-using]]
    1. [[Alternatives to the Standard Spooler|handbook-printing-lpd-alternatives]]
-   1. [[Troubleshooting|handbook-printing-troubleshooting]]
+   1. [[Troubleshooting|handbook-printing-troubleshooting]]  
+
+###Chapter 14 Storage
 
-1. 1. [[Storage|handbook-disks]]
    1. [[Synopsis|handbook-disks]]
    1. [[Device Names|handbook-disks-naming]]
    1. [[Adding Disks|handbook-disks-adding]]
@@ -143,9 +162,10 @@ Portions of this document originally documented use of the [FreeBSD](http://www.
    1. [[Backups to Floppies|handbook-backups-floppybackups]]
    1. [[Backup Basics|handbook-backup-basics]]
    1. [[Network, Memory, and File-Backed File Systems|handbook-disks-virtual]]
-   1. [[File System Quotas|handbook-quotas]]
+   1. [[File System Quotas|handbook-quotas]]  
+
+###Chapter 15 The Vinum Volume Manager
 
-1. 1. [[The Vinum Volume Manager|handbook-vinum-vinum]]
    1. [[Synopsis|handbook-vinum-vinum]]
    1. [[Disks Are Too Small|handbook-vinum-intro]]
    1. [[Access Bottlenecks|handbook-vinum-access-bottlenecks]]
@@ -154,47 +174,53 @@ Portions of this document originally documented use of the [FreeBSD](http://www.
    1. [[Some Examples|handbook-vinum-examples]]
    1. [[Object Naming|handbook-vinum-object-naming]]
    1. [[Configuring Vinum|handbook-vinum-config]]
-   1. [[Using Vinum for the Root Filesystem|handbook-vinum-root]]
+   1. [[Using Vinum for the Root Filesystem|handbook-vinum-root]]  
+
+###Chapter 16 Localization - I18N/L10N Usage and Setup
 
-1. 1. [[Localization - I18N/L10N Usage and Setup|handbook-l10n]]
    1. [[Synopsis|handbook-l10n]]
    1. [[The Basics|handbook-l10n-basics]]
    1. [[Using Localization|handbook-using-localization]]
    1. [[Compiling I18N Programs|handbook-l10n-compiling]]
-   1. [[Localizing DragonFly to Specific Languages|handbook-lang-setup]]
+   1. [[Localizing DragonFly to Specific Languages|handbook-lang-setup]]  
+
+###Chapter 17 Desktop Applications
 
-1. 1. [[Desktop Applications|handbook-desktop]]
    1. [[Synopsis|handbook-desktop]]
    1. [[Browsers|handbook-desktop-browsers]]
    1. [[Productivity|handbook-desktop-productivity]]
    1. [[Document Viewers|handbook-desktop-viewers]]
    1. [[Finance|handbook-desktop-finance]]
-   1. [[Summary|handbook-desktop-summary]]
+   1. [[Summary|handbook-desktop-summary]]  
+
+###Chapter 18 Multimedia
 
-1. 1. [[Multimedia|handbook-multimedia]]
    1. [[Synopsis|handbook-multimedia]]
    1. [[Setting Up the Sound Card|handbook-sound-setup]]
    1. [[MP3 Audio|handbook-sound-mp3]]
    1. [[Video Playback|handbook-video-playback]]
-   1. [[Setting Up TV Cards|handbook-tvcard]]
+   1. [[Setting Up TV Cards|handbook-tvcard]]  
+
+###Chapter 19 Serial Communications
 
-1. 1. [[Serial Communications|handbook-serialcomms]]
    1. [[Synopsis|handbook-serialcomms]]
    1. [[Introduction|handbook-serial]]
    1. [[Terminals|handbook-term]]
    1. [[Dial-in Service|handbook-dialup]]
    1. [[Dial-out Service|handbook-dialout]]
-   1. [[Setting Up the Serial Console|handbook-serialconsole-setup]]
+   1. [[Setting Up the Serial Console|handbook-serialconsole-setup]]  
+
+### Chapter 20 PPP and SLIP
 
-1. 1. [[PPP and SLIP|handbook-ppp-and-slip]]
    1. [[Synopsis|handbook-ppp-and-slip]]
    1. [[Using User PPP|handbook-userppp]]
    1. [[Using Kernel PPP|handbook-ppp]]
    1. [[Troubleshooting PPP Connections|handbook-ppp-troubleshoot]]
    1. [[Using PPP over Ethernet (PPPoE)|handbook-pppoe]]
-   1. [[Using SLIP|handbook-slip]]
+   1. [[Using SLIP|handbook-slip]]  
+
+### Chapter 21 Advanced Networking
 
-1. 1. [[Advanced Networking|handbook-advanced-networking]]
    1. [[Synopsis|handbook-advanced-networking]]
    1. [[Gateways and Routes|handbook-network-routing]]
    1. [[Wireless Networking|handbook-network-wireless]]
@@ -210,9 +236,10 @@ Portions of this document originally documented use of the [FreeBSD](http://www.
    1. [[Network Address Translation|handbook-network-natd]]
    1. [[The '''inetd ''' **Super-Server**|handbook-network-inetd]]
    1. [[Parallel Line IP (PLIP)|handbook-network-plip]]
-   1. [[IPv6|handbook-network-ipv6]]
+   1. [[IPv6|handbook-network-ipv6]]  
+
+###Chapter 22 Electronic Mail
 
-1. 1. [[Electronic Mail|handbook-mail]]
    1. [[Synopsis|handbook-mail]]
    1. [[Using Electronic Mail|handbook-mail-using]]
    1. [['''sendmail ''' Configuration|handbook-sendmail]]
@@ -225,20 +252,24 @@ Portions of this document originally documented use of the [FreeBSD](http://www.
    1. [[SMTP Authentication|handbook-smtp-auth]]
    1. [[Mail User Agents|handbook-mail-agents]]
    1. [[Using fetchmail|handbook-mail-fetchmail]]
-   1. [[Using procmail|handbook-mail-procmail]]
+   1. [[Using procmail|handbook-mail-procmail]]  
+
+###Chapter 23 Updating DragonFly
 
-1. 1. [[Updating DragonFly|handbook-updating]]
    1. [[Initial Setup|handbook-updating]]
    1. [[Configuration|handbook-updating-using]]
    1. [[Preparing to Update|handbook-updating-before-building]]
-   1. [[Updating the System|handbook-updating-makeworld]]
+   1. [[Updating the System|handbook-updating-makeworld]]  
 
-1. 1. [[ Debug the DragonFly kernel|docs/user/list/DebugKernelCrashDumps]]
+###Chapter 24 Debug the DragonFly kernel
+
+   1. [[Debug the DragonFly kernel|docs/user/list/DebugKernelCrashDumps]]
    1. [[Configure your system|docs/user/list/DebugKernelCrashDumps#head-c7f19c562c575c26006f6b7cce69df26e2873bc9]]
    1. [[Debug the crash dump|docs/user/list/DebugKernelCrashDumps#head-f2abcea0beb4c42a93034c32e6209064484c2900]]
-   1. [[Further information|docs/user/list/DebugKernelCrashDumps#head-e306fd7a51d5b330b0e770f96a6796e28c5ce0df]]
+   1. [[Further information|docs/user/list/DebugKernelCrashDumps#head-e306fd7a51d5b330b0e770f96a6796e28c5ce0df]]  
+
+###Chapter 25 Linux Binary Compatibility
 
-1. 1. [[Linux Binary Compatibility|handbook-linuxemu]]
    1. [[Synopsis|handbook-linuxemu]]
    1. [[Installation|handbook-linuxemu-lbc-install]]
    1. [[Installing Mathematica &reg;|handbook-linuxemu-mathematica]]
@@ -246,9 +277,11 @@ Portions of this document originally documented use of the [FreeBSD](http://www.
    1. [[Installing MATLAB $reg;|handbook-linuxemu-matlab]]
    1. [[Installing Oracle $reg;|handbook-linuxemu-oracle]]
    1. [[Installing SAP &reg;  R/3 &reg;|handbook-sapr3]]
-   1. [[Advanced Topics|handbook-linuxemu-advanced]]
+   1. [[Advanced Topics|handbook-linuxemu-advanced]]  
+
+###Appendices
 
-1. 1. [[Appendices|handbook-appendices]]
+   1. [[Appendices|handbook-appendices]]
    1. [[Obtaining DragonFly|handbook-mirrors]]
    1. [[CDROM and DVD Publishers|handbook-mirrors]]
    1. [[FTP Sites|handbook-mirrors-ftp]]
@@ -267,4 +300,4 @@ Portions of this document originally documented use of the [FreeBSD](http://www.
    1. [[Resources on the Internet|handbook-eresources]]
    1. [[Mailing Lists|handbook-eresources]]
    1. [[Usenet Newsgroups|handbook-eresources-news]]
-   1. [[World Wide Web Servers|handbook-eresources-web]]
+   1. [[World Wide Web Servers|handbook-eresources-web]]