Commit graph

6714 commits

Author SHA1 Message Date
Giorgos Keramidas
59b1918b83 Refer to sysutils/cdrtools instead of sysutils/mkisofs now that the
mkisofs port was merged into cdrtools.  I've also replaced most of the
references to the <filename role="package">mkisofs</filename> program
with an entity which we already have.

PR:		docs/69087
Submitted by:	Janos Mohasci <janos.mohasci@bsd.hu>
2004-07-16 08:38:33 +00:00
Gleb Smirnoff
2b6d0fac50 Move myself from additional contributos to developers.
Approved by:	julian (mentor)
2004-07-16 06:01:46 +00:00
Robert Watson
d2b9ad4b57 Improve documentation of sleeping/non-sleeping memory allocation
relating to init entry points: expand description of socket allocation
entry points, and prefer "sleeping" to "blocking".
2004-07-16 03:44:49 +00:00
Robert Watson
e74ed3c9a8 Provide more information on locking for MAC policies now that locking
is better defined.

Remove an inaccurate sentence describing how labels work with policies.
Maybe we should do it that way, but we don't yet :-).
2004-07-16 03:22:16 +00:00
Robert Watson
2fb74c2d5f A bunch of small wording changes, clarifications, etc, that I've had
sitting in my tree for a while.
2004-07-16 02:35:46 +00:00
Daniel Harris
8d6a226b69 Bring core (the subsection with pgp keys in repo, anyway) up to date
and alphabetize it.
2004-07-14 23:55:58 +00:00
Marc Fonvieille
72c2fb9cbf Typo fixing. 2004-07-14 20:24:41 +00:00
Ceri Davies
c73fe55c0d Mark up FreeBSD specific terms as such.
Note that this has no effect on any of the output formats at present.
2004-07-14 20:07:52 +00:00
Gleb Smirnoff
cb57091907 Add my PGP key.
Approved by:	julian
2004-07-14 17:25:19 +00:00
Marc Fonvieille
fac9d8f737 pkg_add(1) will fetch the latest version of the application if you run
-STABLE or -CURRENT.  For -RELEASE users, pkg_add(1) will download the
version of the package that was built with the release.
I added a note about this and mentioned PACKAGESITE to change this
behavior.

Submitted by:	Ken Tom <subd@mui.net>
2004-07-14 14:07:39 +00:00
Gleb Smirnoff
f16c1075b5 Add my author entity.
Approved by:	julian
2004-07-14 09:03:46 +00:00
Murray Stokely
cade92a188 Spellcheck: environment, appropriate, explanation, occasions
Found by:	make spellcheck
2004-07-14 05:33:13 +00:00
Marc Fonvieille
a1f77b1a3d s/md0c/md0 where needed. 2004-07-13 10:27:58 +00:00
Murray Stokely
4de99325fa Remove sentence fragment from chapter synopsis. 2004-07-13 08:55:44 +00:00
Murray Stokely
e489a014cc Update the preface to describe the new organization of the Handbook
into 5 logical parts.  Reorder the brief description of each chapter
to conform to the new layout.

Obtained from:	FreeBSD Mall, Inc. Third Edition FreeBSD Handbook
2004-07-13 08:52:37 +00:00
Murray Stokely
68bea02f82 Resurrect the top level Network Communication <part>. This <part> now
contains the following chapters: serialcomms, ppp-and-slip, mail,
network-servers, and advanced-networking.

This <part> existed up until 3 years ago when it was combined with
another to form the System Administration part.  That part is now too
large with over 15 chapters and needs to be split into two again.

Also, add some descriptive text to introduce the chapters in this part.

Obtained From:	FreeBSD Mall, Inc. 3rd Edition FreeBSD Handbook (Vol II)
2004-07-13 08:20:46 +00:00
Murray Stokely
9a10e8d1a0 Add a new top-level <part> titled 'Common Tasks' to hold the following chapters :
* Desktop
* Multimedia
* Kernel Configuration
* Printing
* Linux Emulation

This part provides more in depth coverage of some frequently used
features of FreeBSD, and assumes that the reader has read the first 5
chapters in the 'Getting Started' part.

This is the first new <part> since Nik and I reorganized in r1.108
almost 3 years ago, and it is long overdue.

Also add some introductory text describing what this part contains,
and how the material will be presented.

Obtained From:	FreeBSD Mall, Inc. Handbook 3rd Edition, Vol1: User Guide
2004-07-13 07:46:34 +00:00
Murray Stokely
ea5883b1d9 Add brief synopses of the new Mandatory Access Control and Network Servers
chapters of the Handbook.
2004-07-13 07:02:34 +00:00
Murray Stokely
c380a4da16 Improvements to the NTP section:
* Remove redundant sentence from introduction.
* Web server -> web server
* Add another example about why it's important to have an accurate clock
  (consistent timestamps on a shared fileserver)
2004-07-13 06:37:41 +00:00
Denis Peplin
e6c052b9c3 Fix crontab example for checkout every twelve hours 2004-07-13 06:21:04 +00:00
Murray Stokely
53d23b97e7 Clarify a sentence about configuring inetd. 2004-07-13 06:18:53 +00:00
Murray Stokely
bdd1483cee Use &nis; entity so that NIS is properly enclosed in <acronym> tags. 2004-07-13 05:55:02 +00:00
Murray Stokely
2427cd68b8 1. Move the section about inetd to the beginning of this chapter, rather
than the end.

2. Also, avoid acronyms in sect1 title's where possible.  Prefer Network
File System (NFS), Network Information System (NIS/YP), etc.. to just
the acronyms alone.

(2) Suggested by:	tom@
2004-07-13 05:32:42 +00:00
Murray Stokely
6f04b3910f Add prerequisites to the chapter synopsis. Users should know how to
build and install a custom kernel before reading these chapters.
2004-07-13 05:19:27 +00:00
Murray Stokely
1ffd2e8bc6 The advanced networking chapter had grown to almost 100 pages.
Split out the sections about network servers into a new chapter.

Reviewed by:	doc@
2004-07-13 03:48:29 +00:00
Simon L. B. Nielsen
bb5a806683 Actually include the glossary again... it is not included automatically
since since the generic make variable only add real chapters that are
called "chapter.sgml".

Pointy hat to:	simon
Noticed by:	ceri
2004-07-12 22:49:18 +00:00
Simon L. B. Nielsen
e111749acf Add an id attributes to the sect1 tags that does not have one already.
This fixes filenames like x31.html, which is generated in html-split
mode, that somebody will end up linking to at some point.
2004-07-12 22:25:11 +00:00
Simon L. B. Nielsen
3cdb8b5b09 - Make decencies work for the Glossary, so the Handbook is rebuild
when the Glossary is updated.
- While I'm here; sort a SRCS entry missed in revision 1.86.

Prodded by:	ceri [1]
2004-07-12 21:58:13 +00:00
Simon L. B. Nielsen
8b2c84f627 Retire the WITH_GLOSSARY option and enable the Glossary by default.
No objections:	-doc
2004-07-12 20:24:41 +00:00
Ceri Davies
169eed0d21 Whitespace cleanup from previous revision. 2004-07-12 20:01:06 +00:00
Ceri Davies
30feffd84b o Remove the requirement that this file contain FreeBSD specific
terminology.

o Be more specific in the comment about sorting within this file.
2004-07-12 19:59:54 +00:00
Hiroki Sato
c77902a017 Back out the previous change. The center justification is
intended for the abstract, not the title and the authorgroup.
2004-07-12 15:45:21 +00:00
Denis Peplin
b25e777ec2 Slightly improve fixed rules description for Biba 2004-07-12 09:45:11 +00:00
Marc Fonvieille
7ef9c72e02 In IPv6 section:
- Add missing devicename tags
- Some punctuation and upper/lowercase fixes
2004-07-12 09:43:06 +00:00
Murray Stokely
2d783cc50f Sort SRCS. 2004-07-12 09:26:16 +00:00
Alfred Perlstein
a82a9fd72d Document __FreeBSD_version bump for VFS_ROOT, vflush and kinfo_proc
changes.
2004-07-12 08:24:15 +00:00
Murray Stokely
bf58cc3177 Add colspec attributes so that tables are properly rendered in print. 2004-07-12 07:59:56 +00:00
Murray Stokely
e3caf28e18 Add missing frame='none' to two tables. 2004-07-12 07:40:51 +00:00
Murray Stokely
257aa7f2c6 Spelling corrections. 2004-07-12 07:26:10 +00:00
Murray Stokely
d1ec2ee4a0 Remove stub for Mini-cartridge section that has been here for at least
4 years.  No one is going to write this section anytime soon, it's not
really needed anyway, so remove the 'XXX' empty subsection and one
link to this empty section.
2004-07-12 07:15:49 +00:00
Murray Stokely
e72c968fbe Remove extraneous whitespace that misaligns the <programlisting>. 2004-07-12 07:06:47 +00:00
Murray Stokely
e55989777d Wrap long lines in <programlisting> and <screen> sections. These flow
over the page in print output, and make the user scroll in HTML
output.
2004-07-12 07:04:56 +00:00
Murray Stokely
d554acbbc3 Rewrite the synopsis. Merge two paragraphs into one. Start off this
chapter by talking about security features of FreeBSD, rather than the
history of the TrustedBSD project.
2004-07-12 05:29:37 +00:00
Murray Stokely
6ee331fa0a Technical corrections.
Confirmed with:	rwatson
2004-07-12 03:24:13 +00:00
Murray Stokely
f50407f8fc Use &tex; macro so that it can be rendered properly for print output. 2004-07-12 03:12:30 +00:00
Murray Stokely
a7df34cf30 Follow the conventions set out in the FreeBSD Doc Project Primer and
the O'Reilly word list :

'webpages' -> 'web pages'
'webserver' -> 'web server'
2004-07-12 02:59:57 +00:00
Murray Stokely
c3cfdf0dca * Notes in <warning> should not begin with 'Please note that'. The
<warning> tag already expresses this information and so the text will
  be rendered appropriately.
* Improve wording in synopsis.
* Remove redundant sentences and simplify section about what will not
  be covered in this chapter.
* Omit unnecessary words and improve grammar as appropriate
* Remove redundant paragraph.
* Use serial comma in list of elements, as mandated by doc project primer.
2004-07-12 02:55:07 +00:00
Murray Stokely
1643cf6500 * This chapter makes no mention of downloading -CURRENT or -STABLE
sources with CVSup, so remove that pre-requisite from the synopsis.

* Remove trhodes user id in a few examples with 'user1' and add a
  replaceable tag around this user id so that it is rendered in italics.

* Comment out a stub section that says something like "This should be
  written".  The text is quite good without it, and when this planned
  section is added it will be even better.  The Handbook is past
  the point where we should have 'This should be written' stub
  chapters or sections.
2004-07-12 01:45:27 +00:00
Hiroki Sato
4fc606fda7 Use left justification for trademarks and abstract section
in the title page.
2004-07-11 16:49:53 +00:00
Marc Fonvieille
2db28883ee Add a graphic version for a remaining ASCII art, in static routes
section.
2004-07-11 13:34:27 +00:00