Commit graph

41 commits

Author SHA1 Message Date
Simon L. B. Nielsen
541f5ec33d o Split the FreeBSD Developers Handbook into two books:
- FreeBSD Architecture Handbook, which is a book about the FreeBSD
    architecture.  The SMP article have also been moved into the new
    arch handbook as a separate chapter.

  - FreeBSD Developers Handbook, which is a book about developing on
    FreeBSD; basically what was left when the architecture parts was
    moved away.

o Hook up the new FreeBSD Architecture Handbook to the build.

o Remove the SMP article since it is now part of the FreeBSD
  Architecture Handbook.

The relevant files from the FreeBSD Developers Handbook have been
repository copied to the new FreeBSD Architecture Handbook.

This is just step one in the split, both books need some work to be
real seperate books.  E.g. the FreeBSD Architecture Handbook still
needs an introduction.

Repository copy by:	joe
Requested by:		rwatson
Approved by:		murray, ceri (mentor)
2003-08-06 23:48:04 +00:00
Murray Stokely
8e984d0048 Include Trademark Legend in the preamble. 2003-06-17 20:16:35 +00:00
Marc Fonvieille
34d7a51850 Add 2003 for the copyright. 2003-02-09 11:28:09 +00:00
Alfred Perlstein
7e4ba0309d Add a chapter to describe newbus.
Submitted by: Hiten Pandya <hiten@angelica.unixdaemons.com>
PR: docs/42557
2002-09-08 21:25:24 +00:00
Chris Costello
1c8ff53e4f Introduce support for Mandatory Access Control and extensible
kernel access control.

Document the kernel side of the MAC policy architecture.  This
is a little out of date at the moment.  Some parts to be filled
in as things are developed, and much is subject to change.  It
will, however, give developers a good idea of how things work.

Obtained from:	TrustedBSD Project
Sponsored by:	DARPA, NAI Labs
2002-08-19 04:38:25 +00:00
Murray Stokely
2c4941f92c Remove the "History of the Unix Kernel" place-holder chapter. That
material does not belong here.  Replace it with the new "Booting and
Kernel Initialization" chapter.
2002-07-29 06:19:30 +00:00
Giorgos Keramidas
4d513c74f1 Various utypo fixes.
PR:		docs/34912
Submitted by:	Ceri <setantae@submonkey.net>
2002-02-13 23:49:11 +00:00
Murray Stokely
6f26cb1384 Update copyright years. 2002-01-01 09:43:38 +00:00
Murray Stokely
c730fc3dfc Add a chapter about the internals of the Jail subsystem.
PR:		docs/32910
Submitted by:	Evan Sarmiento <evms@cs.bu.edu>
2002-01-01 09:33:44 +00:00
Murray Stokely
7fe9c7b818 Add a chapter about writing device drivers for the sound subsystem.
Submitted by:	Jean-Francois Dockes <jean-francois.dockes@wanadoo.fr>
Reviewed by:	cg
2001-11-23 19:01:25 +00:00
Murray Stokely
cbaac8819e Catch up with the changes made to the Handbook makefile. Make the
index a parameter entity that is only included if -i chap.index is
added to the command line (handled automatically in the GEN_INDEX=true
case).
2001-11-19 06:23:41 +00:00
Murray Stokely
bc83273cff * Correct some links
* Use ftp.hostname.com/directory rather than
  ftp.hostname.com:directory.
* s/freebsd.org/FreeBSD.org/
* Use relative links for FreeBSD.org documents

PR:		31447
Submitted by:	Cyrille Lefevre
Found by:	linbot
2001-10-23 21:54:19 +00:00
Murray Stokely
aea326884e Add the "Source Tree Guidelines and Policies" chapter by phk, obrien,
and others.  This was repo-copied from the Handbook.
2001-10-17 08:53:34 +00:00
Chern Lee
ca986fc704 Add references to new chapter, l10n/Localization, to appropriate files.
Suggsted by: murray and nik
2001-09-13 00:15:54 +00:00
Murray Stokely
f1979ede58 Add a small chapter on the sysinit framework, linker sets, etc..
PR:		docs/30265
Submitted by:	Jason Smethers <jason@smethers.net>
2001-09-02 21:19:03 +00:00
Murray Stokely
32c554e9bb Add a chapter on Kernel Objects. The content is rather limited right
now but there are several other texts that can be integrated into this
chapter.

PR:		27678
Submitted by:	Jason Smethers <jason@smethers.net>
2001-09-02 03:11:09 +00:00
Dima Dorfman
c2eac56e0a Reference %authors by its PUBLIC rather than SYSTEM identifier. This
fixes the cases where the Developer's Handbook is separated from the
Handbook (i.e., different parent directories), and where authors.ent
is somewhere other than "../handbook".
2001-08-16 03:34:59 +00:00
Jeroen Ruigrok van der Werven
905b48ecf8 Put the information about the versions and availability in their own
paragraph.
2001-07-22 14:00:50 +00:00
Murray Stokely
d78ef2bfe3 Reorganize the Developer's Handbook.
* Add chapter on kernel debugging (repo-copied from the Handbook)
  * Change "Introduction" part with 4 empty chapters to a
    "Introduction" chapter with 4 mostly empty <sect1>s.
  * Combine many of the different <part>s that contain only one empty
    <chapter> into larger <part>s.
  * Add * in front of unfinished chapter names so its very clear what
    needs to be worked on.
  * Added some <filename> tags where appropriate.
2001-07-19 22:06:06 +00:00
Murray Stokely
2cf4943a03 Turn on our nascent index by default 2001-06-23 04:57:32 +00:00
Murray Stokely
33c100c32d Add a chapter on sockets programming.
Submitted by:	G. Adam Stanislav
2001-06-22 08:49:14 +00:00
Chris Costello
d7cec802c5 Move mailing-lists.ent out of the Handbook and into the language-specific
share/sgml directories, create a public identifier for it and replace all
SYSTEM references to the file with PUBLIC references.

There was no repo-copy made of these files as there is no important
history to preserve.
2001-06-21 03:38:34 +00:00
Murray Stokely
90b1aec3d1 Add chapters on DMA Basics, IPv6 Implementation, and the VM systems.
Suggested by: 	nik
Obtained from:	The Handbook
2001-05-14 02:52:44 +00:00
Murray Stokely
d771da3e3e Add a more useful abstract, stolen from the Handbook. 2001-05-14 01:36:20 +00:00
Murray Stokely
48e08f6677 Import Adam Stanislav's Assembly Language Tutorial as a chapter of the DH.
SGML Markup by: Wylie Stillwell <wylie@osd.bsdi.com> and
	        Valentino Vaschetto <logo@osd.bsdi.com>
Approved by:	Adam Stanislav
2001-05-11 10:20:34 +00:00
Murray Stokely
0fb2e7255d Add Sergey Babkin's ISA device driver tutorial as a chapter to the
Developer's Handbook.

SGMLified by:	emacs, Wylie Stilwell, Valentino Vaschetto, and I
Approved by:	Sergey Babkin
Obtained from:	Daemonnews
2001-05-02 01:53:14 +00:00
Nik Clayton
35f6b4ed80 Use <corpauthor> properly. My fault for providing flawed examples for
people to copy from.
2001-04-18 08:57:47 +00:00
Murray Stokely
3f8dcd2eb1 Add beginnings of a chapter on our USB Device Driver framework. More
diagrams and content to come.

Obtained from:	Nick Himba's various presentations
2001-04-13 09:05:13 +00:00
Nik Clayton
2d71ef8cb4 Typo: contribued -> contributed 2001-04-09 09:35:48 +00:00
Murray Stokely
73daea17a1 o Add a chapter on writing a CAM SCSI host bus adapter driver by
Sergey Babkin (first published in Daemonnews).
o Update copyrights for 2001.
o Include the authors.ent file from the FreeBSD Handbook

Approved by:	babkin
2001-03-29 06:14:42 +00:00
John Baldwin
9b75bcbfaa Add a new chapter to the kernel section that will eventually document all
of the locks used to make the kernel MP safe.
2000-11-29 04:15:17 +00:00
Jeroen Ruigrok van der Werven
e1fe303667 Split off PCI chapter.
Submitted by:	murray
2000-11-28 19:07:46 +00:00
Jeroen Ruigrok van der Werven
fc669e67ec Split off the driversbasic chapter and put it in its own file.
Submitted by:	murray
2000-11-28 19:04:09 +00:00
Jeroen Ruigrok van der Werven
1ac9fc70ea Split the secure programming section off into it's own file.
Submitted by:	murray
2000-11-28 18:31:39 +00:00
Jeroen Ruigrok van der Werven
57f0c002c6 Split off the tools section into its own directory.
Asked for by:	murray
2000-11-28 18:21:36 +00:00
Murray Stokely
eeb803f1dc Integrate James Raynard's programming tutorial into the Developer's Hanbook.
I was unable to contact James to ask for his permission.

Discussed on: -doc
2000-11-16 19:02:53 +00:00
Murray Stokely
a86ed65644 Added chapter on secure programming in basics section and added a
bibliography.
2000-11-06 13:52:26 +00:00
Murray Stokely
87fddebcea First significant batch of content for the Developer's Handbook.
* Added introductory content for device driver chapter.
   * Included some example pseudo device drivers with (not-enough) commentary.
   * Added new chapters to the framework
   * Included pointers to more information in some of the unwritten chapters.
2000-11-06 10:22:11 +00:00
Alexey Zelkin
d727224850 Fix kerberos release number: s/V/5 2000-10-06 15:36:45 +00:00
Murray Stokely
376c5138c6 Following asmodai's nice skeleton of the developers' handbook, this
change adds a section to Chapter 4 on the layout of /usr/src.
2000-10-03 07:34:34 +00:00
Jeroen Ruigrok van der Werven
e39773fe6a Add the initial skeleton of the Developers' Handbook. 2000-07-30 18:20:23 +00:00