Commit graph

194 commits

Author SHA1 Message Date
Pav Lucistnik
f15ce0d3a0 - WITHOUT_MODULES example does not work as advertised, modify to a version that
will work

PR:		docs/140649
Reported by:	Ben Kelly <ben@wanderview.com>
2009-12-14 14:23:24 +00:00
Benedict Reuschling
2cf902adb0 Remove the old SCHED_4BSD system scheduler in favor of SCHED_ULE.
Approved by:    jkois (mentor)
2009-09-25 14:20:40 +00:00
Robert Watson
f33d7f0e8d Add some text describing the "include" kernel configuration directive,
and give an example.  In practice, including GENERIC and then simply
providing a few additional options or devices is the preferred way to
configure kernels now, rather than writing them from scratch (except
in embedded environments).  This text could probably use some
refinement.

Suggested by:	Richard Clayton <richard.clayton at cl.cam.ac.uk>
2009-05-15 13:31:51 +00:00
Robert Watson
cf1dd0e5d7 Recompiling a kernel is no longer a rite of passed for nearly all BSD
users; only advanced users now compile kernels.  Expand rationale for
building a custom kernel: unused features still take up memory that
could be used by applications.
2009-05-15 12:22:44 +00:00
Tom Rhodes
71682c57b3 Merge the Updating chapter into the Cutting Edge chapter, and rename the
new chapter "Updating and Upgrading FreeBSD."

Update other chapters to reference the new chapter name.

While here, add Audit chapter to the preface section.

Reviewed by:    murray, manolis, remko, pgj, -doc
2008-12-23 18:48:22 +00:00
Tom Rhodes
a731c2e31e Revert back to using "cutting-edge" instead of "updating-upgrading" which
is a future change being discussed on -doc and waiting for a repo-copy.

Noticed by:	pgj
2008-12-23 01:34:17 +00:00
Tom Rhodes
6f0b6c5eef KLDs that "work" with PAE work fine as modules.
PR:	120628
2008-12-22 22:02:40 +00:00
Gabor Pali
83842964cb Fix a small indentation problem 2008-11-29 14:05:12 +00:00
Gabor Pali
edafad6a69 Eliminate erroneous role="directory" attributes from <filename> elements
and replace them with class="directory" [1][2]

[1] http://docbook.org/tdg/en/html/filename.html
[2] http://www.freebsd.org/doc/en/books/fdp-primer/sgml-markup-docbook.html#AEN1799
    (4.2.5.5)

Approved by:	trhodes, gabor (mentor)
2008-08-06 22:03:50 +00:00
Tom Rhodes
12df008bb1 Add a section about using modules.
PR:		87445
Reviewed by:	brueffer, remko
2008-08-03 14:39:40 +00:00
Remko Lodder
52425992c2 Borrow Poul-Henning's Axe and chop out old information for 4.x, 5.x
and unsupported 6.x releases. Tom started this process a while ago
and I'll follow up on that for the latest EoL round.

The old versions can still be found in the doc archives:
http://docs.freebsd.org/doc/
2008-06-01 09:42:12 +00:00
Gabor Kovesdan
e5b607947c - Cut some long lines. Translators can ignore this change. 2008-05-05 14:14:39 +00:00
Gabor Kovesdan
6b6ea32dbb - Add some replaceable elements to granularize the markup
PR:		docs/123143
Submitted by:	pgj
2008-05-05 14:06:18 +00:00
Christian Brueffer
9fe3615245 Only four trouble categories are mentioned, not five.
PR:		122635
Submitted by:	pgj
2008-04-12 21:44:53 +00:00
Chin-San Huang
9073a61f4b - Fix the tail tag.
- On occasion, the data from dmesg will only show system messages instead
  of the boot probe output. In these situations, the output may be obtained
  by viewing the /var/run/dmesg.boot instead of
  /var/log/dmesg.{today,yesterday} in case it was not today or yesterday.
2008-01-27 04:23:28 +00:00
Giorgos Keramidas
1918b8d117 Note that on 8.0-CURRENT the ADAPTIVE_GIANT is gone. 2008-01-26 12:00:57 +00:00
Tom Rhodes
5a2e4b1fe4 Add a bit more information about KBD_INSTALL_CDEV.
PR:		112683
2008-01-26 08:22:28 +00:00
Tom Rhodes
cf40f34793 Add a section on finding the hardware and matching them to device drivers.
PR:		112684
Reviewed by:	brueffer
2008-01-24 09:50:06 +00:00
Marc Fonvieille
1cc1a507d9 Add forgotten Ethernet device in GENERIC configuration file.
Pointy Hat:	blackend
2007-09-07 05:11:24 +00:00
Gabor Kovesdan
e553de0f49 - Document the WITHOUT_MODULES macro
PR:		docs/115255
Submitted by:	David Yeske <dyeske@gmail.com>
2007-09-04 14:50:23 +00:00
Marc Fonvieille
b3d13652a2 Update the configuration file section to match RELENG_6 2007-07-19 12:05:16 +00:00
Marc Fonvieille
7e090658b8 Note: the apic device exists only on i386
Found by:	Ernst de Haan <ernst@ernstdehaan.com>
2007-07-18 18:38:41 +00:00
Marc Fonvieille
ec5b91a182 Remove a remaining reference to the "traditional way for building a
kernel" which has been removed for the Handbook.
2007-07-18 17:26:22 +00:00
Marc Fonvieille
3e0b56c38f One also needs to install top-level Makefiles to build a kernel.
Found by: Paco Cubi <francisco.cubi@gmail.com>
2007-03-16 19:24:21 +00:00
Marc Fonvieille
8474e8d299 Remove remains of previous 2 ways used to build a custom kernel (since
only 1 way is now documented in this book).

Found by:	Paco Cubi <francisco.cubi@gmail.com>
2007-03-11 10:58:21 +00:00
Daniel Gerzo
e9dd92b996 - whitespace cleanup of previous commit 2006-10-16 19:18:09 +00:00
Daniel Gerzo
b5a92a5409 - remove "traditional" way of building kernel and add it to the
developers' handbook instead

Approved by: keramida (mentor), trhodes (mentor)
2006-10-16 19:15:36 +00:00
Joel Dahl
dbaaec99cb Update the kernel configuration section to cover 6.1:
- Update the lists of device drivers and tweak a few comments.
- Add a couple of missing options, like PREEMPTION and kbdmux.
- Remove some SCHED_ULE information.  It's not stable and we
  shouldn't encourage users to make the switch, at least not
  right now.
- Remove some 386-specific info.  We can't keep old stuff like
  this around forever, so let's nuke it.

This is not perfect yet though.  There are still some
differences between GENERIC in 6.1 and this document.

Reviewed by:	simon
2006-06-28 17:34:00 +00:00
Dmitry Morozovsky
8ed100d44a Chase after trhodes@ in cleaning up 4.X era statements. 2006-06-20 15:04:58 +00:00
Tom Rhodes
f571554b8b In kernelconfig/chapter.sgml:
Remove a synopsis item discussing /dev entries.

In cutting-edge/chapter.sgml:
  Add some section IDs and make use of one (previous commit did not);
  Remove some info about -j being experimental;
  Use an estimated time period instead of discussing specific system configs;
  Do a quick s/take/make in a few places it otherwise seemed awkward.

PR:	92518 (based on part of this patch).
2006-06-07 09:59:56 +00:00
Tom Rhodes
3f0d1b56f0 Do what I swore would be done:
o Remove 4.X information, this includes notes and sections.

o Update documentation to reflect 5.X and 6.X.

o In some areas, try to make the new content version agnostic.

o Skip areas stating "5.[0-5] and later" as it's relevant - we
need a better way to handle these.

For several items, I checked the NOTES files, manual pages,
CVS history, etc.

Discussed on:		-doc
A few ideas from:	remko
2006-05-30 23:08:25 +00:00
Jesus R. Camou
eac01c0bd1 s/rebuilded/rebuilt/
PR:		docs/92670
Submitted by:	Daniel Gerzo <danger@rulez.sk>
Noticed by:	Daniel Summer <dvdan23@hotmail.com>
Approved by:	trhodes (mentor)
2006-02-02 14:17:52 +00:00
Xin LI
e140896ec8 Escape <, >, &'s, plus some cleanups against the SGML. There should not
be any content changes involved in this commit, however, localization
teams are encouraged to catch up with this change.

Requested by:	intron at intron ac
Reviewed by:	Niclas Zeising <lothrandil at n00b apagnu se>
Glanced by:	simon
2006-01-05 20:03:39 +00:00
Simon L. B. Nielsen
98ee4faecb Remove note specific to using buildkernel on FreeBSD 4.2 and older.
FreeBSD 4.2 was released over 4 years ago and people should not be
running that.

PR:		docs/91241
Submitted by:	Siebrand Mazeland <s.mazeland@xs4all.nl>
2006-01-02 23:11:26 +00:00
Vitaly Bogdanov
ee722e2721 Add tip which describes the way of building only custom modules.
Reviewed by: blackend
2005-12-22 17:17:12 +00:00
Joel Dahl
1f5b165da0 Move npx and loop, fix wording, and delete the big comment found
in GENERIC.

Approved by:	brueffer (mentor)
2005-08-30 07:12:45 +00:00
Joel Dahl
0fe6859cda Move "maxusers n" from the kernel configuration chapter to the tuning
kernel limits chapter.

Suggested by:	blackend (some time ago)
Approved by:	brueffer (mentor)
2005-08-25 09:01:08 +00:00
Pav Lucistnik
e55136d74d 8.3 Building and Installing a Custom Kernel
- Reemphasise the need of full source set for 'make buildkernel'

PR:		docs/75864 (inspired by)
Submitted by:	Eli K. Breen <eli@gopostal.ca>
Approved by:	keramida (mentor)
2005-08-19 09:31:33 +00:00
Joel Dahl
17f2481dd0 Update kernel configuration chapter:
o  Move device agp to the correct place.

o  Add arcmsr, cdce and ehci.

o  Update device bpf comment.

Approved by:	brueffer (mentor)
2005-04-14 18:40:33 +00:00
Remko Lodder
e0bf750b61 Move the Soft Updates section to a better section, to match GENERIC.
Add some more supported drivers for the GENERIC example, remove miibus.

PR:			docs/78486
Submitted by:		Joel Dahl <joel at automatvapen dot se>
Approved by:		simon (mentor)
2005-03-14 21:44:36 +00:00
Simon L. B. Nielsen
8ddd739127 Be consistent and change '[P|p]orts collection' -> 'Ports Collection'
as per the FDP Primer word list.

Submitted by:	Siebrand Mazeland <s.mazeland@xs4all.nl>
PR:		docs/76324
2005-02-13 10:24:10 +00:00
Martin Heinen
f6326324bb Reorder SYSV* options to match GENERIC in 5.X.
Submitted by:	Joel Dahl <joel@automatvapen.se>
2005-01-14 17:04:36 +00:00
Martin Heinen
d34acab93a - Reorder index entries:
anonymous CVS -> CVS, anonymous
  web browsers  -> browsers, web
- PAE got sorted into the symbol section;
  remove line feed after <primary> tag.
- Unify the entries "TCP Wrappers", "web servers".
- Add entries.
2005-01-12 23:56:25 +00:00
Martin Heinen
d824a9db88 Add index entries for ACPI and APM. 2005-01-12 00:24:21 +00:00
Martin Heinen
6cd9b594bd Fix whitespace damage from the previous commit.
Translators please ignore.
2005-01-11 12:42:02 +00:00
Martin Heinen
36c11b8489 Improve the index:
- lowercase/upercase entries
- remove the entry "basics"
- cross reference readers with <see> to variants
- remove an entry from a footnote
- unify entries of kernel options
2005-01-11 12:34:29 +00:00
Denis Peplin
b6549798ec Use sysinstall by default and /stand/sysinstall for systems older than 5.2 2004-12-22 11:13:24 +00:00
Marc Fonvieille
739cc1aaf4 ohci and uhci lines are not commented out in GENERIC. 2004-12-03 21:26:20 +00:00
Marc Fonvieille
caf7668a2a s/architecure/architecture/ 2004-11-22 20:10:08 +00:00
Ceri Davies
e3191b439b Sync with 5.3-RELEASE.
PR:		docs/73429
Submitted by:	Joel Dahl <joel at automatvapen dot se>
Reviewed by:	jhb
2004-11-08 21:05:23 +00:00