diff --git a/en_US.ISO8859-1/books/arch-handbook/book.sgml b/en_US.ISO8859-1/books/arch-handbook/book.sgml
index 3275a733c4..1f96922552 100644
--- a/en_US.ISO8859-1/books/arch-handbook/book.sgml
+++ b/en_US.ISO8859-1/books/arch-handbook/book.sgml
@@ -1,232 +1,363 @@
%bookinfo;
]>
FreeBSD Developers' Handbook
The FreeBSD Documentation Project
doc@FreeBSD.org
August 2000
2000
The FreeBSD Documentation Project
&bookinfo.legalnotice;
Welcome to the Developers' Handbook.
Introduction
Developing on FreeBSD
This will need to discuss FreeBSD as a development
platform, the vision of BSD, architectural overview, layout of
/usr/src, history, etc.
Thank you for considering FreeBSD as your development
platform! We hope it will not let you down.
The BSD Vision
Architectural Overview
The Layout of /usr/src
-
+ The complete source code to FreeBSD is available from our
+ public CVS repository. The source code is normally installed in
+ /usr/src which contains the
+ following subdirectories.
+
+
+
+
+
+
+ Directory
+ Description
+
+
+
+
+
+ bin/
+ Source for files in
+ /bin
+
+
+
+ contrib/
+ Source for files from contribued software.
+
+
+
+ crypto/
+ DES source
+
+
+
+ etc/
+ Source for files in /etc
+
+
+
+ games/
+ Source for files in /usr/games
+
+
+
+ gnu/
+ Utilities covered by the GNU Public License
+
+
+
+ include/
+ Source for files in /usr/include
+
+
+
+ kerberosIV/
+ Source for Kerbereros version IV
+
+
+
+ kerberosV/
+ Source for Kerbereros version V
+
+
+
+ lib/
+ Source for files in /usr/lib
+
+
+
+ libexec/
+ Source for files in /usr/libexec
+
+
+
+ release/
+ Files required to produce a FreeBSD release
+
+
+
+ sbin/
+ Source for files in /sbin
+
+
+
+ secure/
+ FreeSec sources
+
+
+
+ share/
+ Source for files in /sbin
+
+
+
+ sys/
+ Kernel source files
+
+
+
+ tools/
+ Tools used for maintenance and testing of
+ FreeBSD
+
+
+
+ usr.bin/
+ Source for files in /usr/bin
+
+
+
+ usr.sbin/
+ Source for files in /usr/sbin
+
+
+
+
+
+
+
Basics
Compilation
This will include things like: compilation, makefiles, .mk
files, basic debugging, linking, secure programming
guidelines, style(9), CVS, diff, patch, etc.
Kernel
History of the Unix Kernel
Some history of the Unix/BSD kernel, system calls, how do
processes work, blocking, scheduling, threads (kernel),
context switching, signals, interrupts, modules, etc.
Memory and Virtual Memory
Virtual Memory
VM, paging, swapping, allocating memory, testing for
memory leaks, mmap, vnodes, etc.
I/O System
UFS
UFS, FFS, Ext2FS, JFS, inodes, buffer cache, labeling,
locking, metadata, soft-updates, LFS, portalfs, procfs,
vnodes, memory sharing, memory objects, TLBs, caching
Interprocess Communication
Signals
Signals, pipes, semaphores, message queues, shared memory,
ports, sockets, doors
Networking
Sockets
Sockets, bpf, IP, TCP, UDP, ICMP, OSI, bridging,
firewalling, NAT, switching, etc
Network Filesystems
AFS
AFS, NFS, SANs etc]
Terminal Handling
Syscons
Syscons, tty, PCVT, serial console, screen savers,
etc
Sound
OSS
OSS, waveforms, etc
Device Drivers
4.4BSD Driver Writing
old ways, newbus, character/block devices, etc
Architectures
IA-32
Detail the (major) differences between IA-32, IA-64, PPC,
ARM, Sparc, Alpha, etc
Debugging
Truss
various descriptions on how to debug certain aspects of
the system using truss, ktrace, gdb, kgdb, etc
Compatibility Layers
Linux
Linux, SVR4, etc
diff --git a/en_US.ISO8859-1/books/developers-handbook/book.sgml b/en_US.ISO8859-1/books/developers-handbook/book.sgml
index 3275a733c4..1f96922552 100644
--- a/en_US.ISO8859-1/books/developers-handbook/book.sgml
+++ b/en_US.ISO8859-1/books/developers-handbook/book.sgml
@@ -1,232 +1,363 @@
%bookinfo;
]>
FreeBSD Developers' Handbook
The FreeBSD Documentation Project
doc@FreeBSD.org
August 2000
2000
The FreeBSD Documentation Project
&bookinfo.legalnotice;
Welcome to the Developers' Handbook.
Introduction
Developing on FreeBSD
This will need to discuss FreeBSD as a development
platform, the vision of BSD, architectural overview, layout of
/usr/src, history, etc.
Thank you for considering FreeBSD as your development
platform! We hope it will not let you down.
The BSD Vision
Architectural Overview
The Layout of /usr/src
-
+ The complete source code to FreeBSD is available from our
+ public CVS repository. The source code is normally installed in
+ /usr/src which contains the
+ following subdirectories.
+
+
+
+
+
+
+ Directory
+ Description
+
+
+
+
+
+ bin/
+ Source for files in
+ /bin
+
+
+
+ contrib/
+ Source for files from contribued software.
+
+
+
+ crypto/
+ DES source
+
+
+
+ etc/
+ Source for files in /etc
+
+
+
+ games/
+ Source for files in /usr/games
+
+
+
+ gnu/
+ Utilities covered by the GNU Public License
+
+
+
+ include/
+ Source for files in /usr/include
+
+
+
+ kerberosIV/
+ Source for Kerbereros version IV
+
+
+
+ kerberosV/
+ Source for Kerbereros version V
+
+
+
+ lib/
+ Source for files in /usr/lib
+
+
+
+ libexec/
+ Source for files in /usr/libexec
+
+
+
+ release/
+ Files required to produce a FreeBSD release
+
+
+
+ sbin/
+ Source for files in /sbin
+
+
+
+ secure/
+ FreeSec sources
+
+
+
+ share/
+ Source for files in /sbin
+
+
+
+ sys/
+ Kernel source files
+
+
+
+ tools/
+ Tools used for maintenance and testing of
+ FreeBSD
+
+
+
+ usr.bin/
+ Source for files in /usr/bin
+
+
+
+ usr.sbin/
+ Source for files in /usr/sbin
+
+
+
+
+
+
+
Basics
Compilation
This will include things like: compilation, makefiles, .mk
files, basic debugging, linking, secure programming
guidelines, style(9), CVS, diff, patch, etc.
Kernel
History of the Unix Kernel
Some history of the Unix/BSD kernel, system calls, how do
processes work, blocking, scheduling, threads (kernel),
context switching, signals, interrupts, modules, etc.
Memory and Virtual Memory
Virtual Memory
VM, paging, swapping, allocating memory, testing for
memory leaks, mmap, vnodes, etc.
I/O System
UFS
UFS, FFS, Ext2FS, JFS, inodes, buffer cache, labeling,
locking, metadata, soft-updates, LFS, portalfs, procfs,
vnodes, memory sharing, memory objects, TLBs, caching
Interprocess Communication
Signals
Signals, pipes, semaphores, message queues, shared memory,
ports, sockets, doors
Networking
Sockets
Sockets, bpf, IP, TCP, UDP, ICMP, OSI, bridging,
firewalling, NAT, switching, etc
Network Filesystems
AFS
AFS, NFS, SANs etc]
Terminal Handling
Syscons
Syscons, tty, PCVT, serial console, screen savers,
etc
Sound
OSS
OSS, waveforms, etc
Device Drivers
4.4BSD Driver Writing
old ways, newbus, character/block devices, etc
Architectures
IA-32
Detail the (major) differences between IA-32, IA-64, PPC,
ARM, Sparc, Alpha, etc
Debugging
Truss
various descriptions on how to debug certain aspects of
the system using truss, ktrace, gdb, kgdb, etc
Compatibility Layers
Linux
Linux, SVR4, etc
diff --git a/en_US.ISO_8859-1/books/developers-handbook/book.sgml b/en_US.ISO_8859-1/books/developers-handbook/book.sgml
index 3275a733c4..1f96922552 100644
--- a/en_US.ISO_8859-1/books/developers-handbook/book.sgml
+++ b/en_US.ISO_8859-1/books/developers-handbook/book.sgml
@@ -1,232 +1,363 @@
%bookinfo;
]>
FreeBSD Developers' Handbook
The FreeBSD Documentation Project
doc@FreeBSD.org
August 2000
2000
The FreeBSD Documentation Project
&bookinfo.legalnotice;
Welcome to the Developers' Handbook.
Introduction
Developing on FreeBSD
This will need to discuss FreeBSD as a development
platform, the vision of BSD, architectural overview, layout of
/usr/src, history, etc.
Thank you for considering FreeBSD as your development
platform! We hope it will not let you down.
The BSD Vision
Architectural Overview
The Layout of /usr/src
-
+ The complete source code to FreeBSD is available from our
+ public CVS repository. The source code is normally installed in
+ /usr/src which contains the
+ following subdirectories.
+
+
+
+
+
+
+ Directory
+ Description
+
+
+
+
+
+ bin/
+ Source for files in
+ /bin
+
+
+
+ contrib/
+ Source for files from contribued software.
+
+
+
+ crypto/
+ DES source
+
+
+
+ etc/
+ Source for files in /etc
+
+
+
+ games/
+ Source for files in /usr/games
+
+
+
+ gnu/
+ Utilities covered by the GNU Public License
+
+
+
+ include/
+ Source for files in /usr/include
+
+
+
+ kerberosIV/
+ Source for Kerbereros version IV
+
+
+
+ kerberosV/
+ Source for Kerbereros version V
+
+
+
+ lib/
+ Source for files in /usr/lib
+
+
+
+ libexec/
+ Source for files in /usr/libexec
+
+
+
+ release/
+ Files required to produce a FreeBSD release
+
+
+
+ sbin/
+ Source for files in /sbin
+
+
+
+ secure/
+ FreeSec sources
+
+
+
+ share/
+ Source for files in /sbin
+
+
+
+ sys/
+ Kernel source files
+
+
+
+ tools/
+ Tools used for maintenance and testing of
+ FreeBSD
+
+
+
+ usr.bin/
+ Source for files in /usr/bin
+
+
+
+ usr.sbin/
+ Source for files in /usr/sbin
+
+
+
+
+
+
+
Basics
Compilation
This will include things like: compilation, makefiles, .mk
files, basic debugging, linking, secure programming
guidelines, style(9), CVS, diff, patch, etc.
Kernel
History of the Unix Kernel
Some history of the Unix/BSD kernel, system calls, how do
processes work, blocking, scheduling, threads (kernel),
context switching, signals, interrupts, modules, etc.
Memory and Virtual Memory
Virtual Memory
VM, paging, swapping, allocating memory, testing for
memory leaks, mmap, vnodes, etc.
I/O System
UFS
UFS, FFS, Ext2FS, JFS, inodes, buffer cache, labeling,
locking, metadata, soft-updates, LFS, portalfs, procfs,
vnodes, memory sharing, memory objects, TLBs, caching
Interprocess Communication
Signals
Signals, pipes, semaphores, message queues, shared memory,
ports, sockets, doors
Networking
Sockets
Sockets, bpf, IP, TCP, UDP, ICMP, OSI, bridging,
firewalling, NAT, switching, etc
Network Filesystems
AFS
AFS, NFS, SANs etc]
Terminal Handling
Syscons
Syscons, tty, PCVT, serial console, screen savers,
etc
Sound
OSS
OSS, waveforms, etc
Device Drivers
4.4BSD Driver Writing
old ways, newbus, character/block devices, etc
Architectures
IA-32
Detail the (major) differences between IA-32, IA-64, PPC,
ARM, Sparc, Alpha, etc
Debugging
Truss
various descriptions on how to debug certain aspects of
the system using truss, ktrace, gdb, kgdb, etc
Compatibility Layers
Linux
Linux, SVR4, etc