Commit graph

5743 commits

Author SHA1 Message Date
Chern Lee
2e4c283ab2 Move "Virtual Consoles and Terminals" to beginning of chapter. It
should be introduced first.

Sponsored by:	FreeBSD Mall, Inc.
2003-10-01 01:21:09 +00:00
Chern Lee
277441b9e8 - Revise some comma usage
- Revise wording of some sentences
- Use <acronym> and <filename> tags
- Follow FDP on continuous repetition of &man.command.#;
- Write out numbers under 10
- Show an example of complete output of "ls -l" command
- Mention after successfully logging in, you will see the MOTD, and
  the command prompt
- Remove misleading comment about how chmod ### can only "set and
  assign" permissions, but not remove them.
- "CPU time evenly to each user" -> "CPU time fairly to each user"
- "permissions stored as two octets" -> "permissions stored as three
  octets"

Sponsored by:	FreeBSD Mall, Inc.
2003-10-01 01:18:53 +00:00
Martin Heinen
0541916663 - remove contractions: it's -> it is
- possessive form it's -> its
- add serial commas
- remove an erroneous "for"
- kstash was renamed to k5stash on pre 5.X systems
- s/Kerberized/kerberized/
2003-10-01 00:22:31 +00:00
Martin Heinen
2fd7373b54 Use upper case for names of Kerberos realms
and lower case for DNS names.
2003-10-01 00:10:30 +00:00
Ceri Davies
593b5ba1a3 Note that "MFS" is also used when patches are merged to security branches. 2003-09-28 20:25:42 +00:00
Poul-Henning Kamp
bd1cf4541c Add entry for cdevsw updates. 2003-09-28 16:32:24 +00:00
Christian Brueffer
6ae4f0440d Fix the bz2 fileending in an example 2003-09-28 07:05:27 +00:00
Max Khon
231ca8bab0 Document __FreeBSD_version 501108 (PFIL_HOOKS API update)
and 501109 (kiconv(3)).
2003-09-27 10:31:41 +00:00
Marc Fonvieille
3f97937522 In MATLAB section: [1]
- Tell the reader he should ask The Mathworks for a native version
- Add more infos about Java support.

In SAP section:
- Add and remove wrong application & command tags
- more s/I/we and contractions removal

PR:		docs/57025 [1]
Submitted by:	Dan Pelleg <daniel+handbook@pelleg.org>
2003-09-27 08:57:25 +00:00
Chern Lee
37905c3a95 Move section about "Disk Organization" from Install to UNIX Basics
chapter.  This information is repeated in more basic terms in the
Install chapter, so this more in depth explanation is better suited in
Basics.

Sponsored by:	FreeBSD Mall, Inc.
2003-09-26 17:43:08 +00:00
Ken Smith
0faa41e1ff - "whitespace change" that coverts existing driver example code
to be style(9) compliant, matching format of new driver code

Approved: blackend (mentor)
2003-09-25 12:52:06 +00:00
Ken Smith
c6674adc3d - add example FreeBSD 5.X driver submitted by S<F8>ren (Xride) Straarup
(driver tested on i386 and sparc64 platforms)
	- minor formatting fixes (add <example></example>)
	- minor spelling/grammar fixes

Approved: blackend (mentor)
2003-09-25 12:46:14 +00:00
Scott Long
2b76de551b Marcel has fixed KSE on ia64, mark it as working in the status table. 2003-09-21 04:35:31 +00:00
Marc Fonvieille
d0187c0c11 Fix dhcpd related manual page entities. 2003-09-20 08:37:27 +00:00
Marc Fonvieille
97dd84aa1f In SAP section:
- Add missing username, command, application and filename tags
- Remove useless '-'
- s/export/EXPORT for consitency
- s/I/We, s/my/our
- Some little rewordings (well the content is often disappointing, but
  I'm unable to do tests)
2003-09-20 08:00:01 +00:00
Chern Lee
bd303858f4 One big proper English and content sweep of this chapter:
Mention:
- this chapter is a general guide, not a literal reference manual
- what partition types PResizer, FIPS, and PartitionMagic deal with
- subnet mask as a requirement to configure Ethernet interface
- most computers can boot from CDROM/DVD drive
- Windows does not report bad blocks when formatting floppies
- BIOS "list of devices" is commonly known as "Boot Order"
- If old OS loads, BIOS may not support boooting from desired media
- use of "U"ndo in FDisk Editor
- one needs to change their Keymap only if they're using a
  non-standard keyboard
- in FDisk Editor, when hitting 'C', default value is the largest
  available block
- BootMgr needs to be installed on both disks 1 and 2 if FreeBSD is
  being installed on disk 2
- how much space the FreeBSD Ports Collection uses
- purpose of NFS client
- how an improper X configuration can freeze the machine/installation
- how to "Cancel" out of the Package installer
- C-shell (example uses bash)

Remove:
- extranneous words
- periods after list of information required to configure Ethernet and
  PPP interfaces
- mention that there is "always" conflicts in UserConfig

Change:
- "installation routine will prompt you several times before writing
  any data to disc" -> ... "will prompt you before" ...

  There's only one real FINAL warning

- "Skip to the next section" -> "skip this section"
- "Irrespective of whether" -> "Whether"
- "Newer devices..., and be" -> "Newer devices..., and are"
- "A tape" -> "SCSI or QIC tape"
- <important> -> <warning> in some cases
- Its -> it's in some cases
- "/var directory contains varible length files" -> ... "contains
  files that are constantly varying"
- Network File Service -> Network File System
- optimise -> optimize
- "then asked" -> "then be asked"
- FreeBSD 3.4 -> FreeBSD &rel.current;
- partition ID 165 -> partition ID of 165

* Insert many commas and remove many others
* Include a link to the latest FreeBSD errata page
* Make use of &ms-dos and &windows entities
* Make use of <filename class="directory"> tags
* Properly markup some <acronym>'s
* Explain when one would use Standard or None as their boot manager
* Clarify when to use IPv6 auto-detection
* Make use of <hostid> tags
* Clarify testing the mouse daemon during configuration
* Remove repeated content about creating installation floppies in
* Advanced Installation section
* Use /floppy when example mounts a floppy
* Remove mention of CDROMs #3-5, since the project no longer publishes them
* Remove mention of how the mini-ISO was not produced prior to 4.4

* Many other minor technical and English clarifications

Sponsored by:	FreeBSD Mall, Inc.
2003-09-20 01:49:54 +00:00
Scott Long
eecce34e99 Add two tables to show THR and KSE status. If anyone knows how to make the
tables be side-by-side, please be my guest and fix it.
2003-09-19 05:59:14 +00:00
Christian Brueffer
69be6f5e2c Convert an example from gzip to bzip2 usage 2003-09-18 20:55:48 +00:00
Simon L. B. Nielsen
b84b8d3939 - Add an entry for POLA, copied from the FAQ.
- Add a missing </glossdiv>.

Text reviewed by:	ceri, brueffer
2003-09-18 20:49:49 +00:00
Christian Brueffer
bfb7561e5b We don't distribute gzip compressed docs anymore, so don't
mention this format
2003-09-18 20:42:42 +00:00
Simon L. B. Nielsen
5f99e0afac Add a missing '>' to close a SGML tag.
Submitted by:	Lukas Ertl <l.ertl@univie.ac.at>
2003-09-18 19:25:51 +00:00
Ceri Davies
96fcec368a Add BSD and KSE. 2003-09-18 17:52:44 +00:00
Ceri Davies
bddac34733 Add a skeleton FreeBSD specific glossary, and the appropriate glue to the
handbook to allow it to be incorporated in the build.  This is not on by
default at the moment, and users who want it will need to set WITH_GLOSSARY
to a non-empty string when building ("make WITH_GLOSSARY=yes" being the
common case).

It is expected that committers will help to flesh out the glossary before
it is connected to the build by default; the current entries have been chosen
to illustrate the way that DocBook allows for "See also" and "See" in the
glossary elements.

This commit also takes the index out of the appendices in the handbook, as
this is not the usual place for an index to sit in a book, and moves it to
the end of the book.
2003-09-18 16:43:36 +00:00
Simon L. B. Nielsen
b8494fd2f5 - Use trademark entities.
- Add trademark attributions.
- Don't join trademarks with other words, e.g. using hyphens.
- Don't use trademarks as nouns (e.g. don't use "Windows NT's").
2003-09-18 15:32:54 +00:00
John Baldwin
71ec5dfb5c Document 501107 FreeBSD version bump. 2003-09-17 20:44:46 +00:00
Marc Fonvieille
819a08a54a Add missing items in Synopsis and remove some other one.
PR:		docs/56929 & docs/56930
Submitted by:	Marco Trentini <mark@remotelab.org>
2003-09-17 07:40:06 +00:00
Murray Stokely
e0a1640f51 Fix typos. 2003-09-17 06:33:45 +00:00
Simon L. B. Nielsen
6fb6200f97 - Improve markup for inetd references (use &man.inetd.8; and command
tags.
- Use filename tag for a file, instead of a literal tag.

PR:		docs/56900
Submitted by:	Josef El-Rayes <j.el-rayes@daemon.li> (original version)
2003-09-16 22:14:11 +00:00
Denis Peplin
0029986691 Add my pgp key
Approved by: phantom
2003-09-16 07:50:05 +00:00
Denis Peplin
f75533820c Move myself from additional contributors to developers.
Approved by: phantom
2003-09-16 07:32:50 +00:00
Marc Fonvieille
3597711395 Change Conrad Sabatier's email upon his request. 2003-09-15 19:45:26 +00:00
Hiten Pandya
630b39beda Fix URLs for the floppies.
Reported by:	Josef El-Rayes <j.el-rayes@daemon.li>
PR:      	docs/56639
2003-09-14 21:27:01 +00:00
Scott Long
e6909ee045 Update the 5-stable roadmap. Remove items that are done or no londer
relevant, add some new items, re-arrange the sections, and add a new
schedule.
2003-09-14 19:41:40 +00:00
Simon L. B. Nielsen
2993ccd69a *.sgml:
- Use trademark entities
 - Add trademark attributions.
 - Always use correct case for trademarks.
 - Don't join trademarks with other words, e.g. using hyphens.

trademark.ent:
 - Add entities for more trademarks / companies.
 - Sort the Sun trademark attribution entity.
2003-09-14 11:29:06 +00:00
Marc Fonvieille
ada8f32521 In SAP section:
- Various punctuation fixes
- Use of application, literal, acronym tags where needed
- s/I/We
- s/id/ID to be consistent with the rest of docs
- Some "little rewordings".
2003-09-14 09:14:54 +00:00
Christian Brueffer
0cd7a11f41 Add the 'dns' and 'polish' ports categories
Submitted by:	Oleksandr Listopad <laa@laa.zp.ua>
2003-09-13 12:12:48 +00:00
Marc Fonvieille
cc5db450ed Add a French Administrator guide about *BSD (Cahiers de l'Admin: BSD). 2003-09-13 09:04:03 +00:00
Christian Brueffer
f70f707489 Add and describe the 'dns' and 'polish' ports categories 2003-09-12 19:49:38 +00:00
Michael Lucas
f0d05bd7c1 Whitespace fix from last commit. No content changes. 2003-09-12 17:01:32 +00:00
Michael Lucas
bb2d175b60 Add missing <command> tags. 2003-09-12 16:56:22 +00:00
Tom Rhodes
9dd925cd20 Clean up the <indexterms> so that they are in a logical order. This
will index the KerberosIV entries under KerberosIV and Kerberos5
entries under Kerberos5.
2003-09-10 19:31:36 +00:00
Tom Rhodes
aef6aeb915 This commit:
o Adds <application>, <acronym>, and other tags as required.
o Uses the &os; entity.
o Cleans up the introduction by pointing out what
  version of Kerberos is in what FreeBSD Release.
o Modifies <indexterm> and titles to help seperate
  KerberosIV and Kerberos5.

Reviewed by:	-doc, make lint
2003-09-10 16:11:48 +00:00
Tom Hukins
1275e1cc67 Fix interaction between comm(1) and sort(1) for automated package list
building.

PR:		docs/55391
Submitted by:	Matthew Reimer <mreimer@bilbo.vpop.net>
2003-09-10 10:20:28 +00:00
Simon L. B. Nielsen
aaa0e036db Correct the category for the mozilla port: net/mozilla -> www/mozilla.
Submitted by:	Denis Peplin <info@volginfo.ru>
PR:		docs/56627
2003-09-09 12:21:13 +00:00
Tom Rhodes
57780decd8 Add a new section on Kerberos5.
Submitted by:	Tillman Hodgson <tillman@seekingfire.com> (original version)
Reviewed by:	-doc
2003-09-08 18:14:48 +00:00
Marc Fonvieille
cc1f38618d DEVFS is not only used on 5.0 but also on following versions.
While I'm there, use a manual page entity where needed.

PR:		docs/56592
Submitted by:	Denis Peplin <info@volginfo.ru>
2003-09-08 16:39:23 +00:00
Tim J. Robbins
37a87e7733 Document __FreeBSD_version bump for Coda 6.x support. 2003-09-08 12:04:55 +00:00
Sergey Skvortsov
3fde65da8c Add Roman V. Palagin <romanp@unshadow.net> for for his work on net/ipacctd, sysutils/pmap ports. 2003-09-08 11:56:04 +00:00
Peter Pentchev
5c8f4cd9f0 In the Automated plist generation chapter, note that an empty pkg-plist
file should be created before attempting a 'make install'.

Reported by:	sexbear <sexbear@tmu.edu.tw>
2003-09-08 07:47:30 +00:00
Ceri Davies
c30fbe14ae Add a missing full stop to a footnote. 2003-09-07 14:58:27 +00:00