Commit graph

10812 commits

Author SHA1 Message Date
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
Simon L. B. Nielsen
4c6ebf3b41 Change the default Tidy options so it doesn't indent, and so it wraps
the lines at column 90, instead of the default 68.  This makes the
resulting HTML considerably smaller.

The change also band-aid a problem where Tidy wrap lines which shouldn't
have been wrapped.  This can cause extra spaces in the resulting HTML,
e.g. resulting in "( audio/lame)" instead of "(audio/lame)".

Discussed on:	-doc
2003-09-18 21:39:37 +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
a2b43f527b Add forgotten entity
Approved by: phantom
2003-09-16 09:12:37 +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
Hiten Pandya
aeebbcd658 Add entities for the FreeBSD Snapshots. These are handy. 2003-09-14 21:21:12 +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
16d9a01672 Add support for optionally showing all trademark symbols, not just the
required symbols, by setting the make variable
WITH_ALL_TRADEMARK_SYMBOLS, to any non empty value.

This feature is mainly useful for document writers, to make sure all
trademarks are marked up correctly.
2003-09-14 13:11:43 +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
Ceri Davies
67334bfa0d The latest ports/INDEX contains 9210 ports. Update os.numports accordingly. 2003-09-11 20:51:23 +00:00
Bruce A. Mah
a2afb04afc Add entities for my(4) and uart(4). 2003-09-11 15:59:34 +00:00
Bruce A. Mah
1294a001b0 Manpage entities for bfe(4) and re(4). 2003-09-11 15:45:23 +00:00
Andrey Zakhvatov
5b7c843ece Synchronize with The FreeBSD Russian Documentation Project 2003-09-11 09:57:17 +00:00
Andrey Zakhvatov
68988bd434 Sync with Russian Doc.Project 2003-09-11 09:53:06 +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
Kazuo Horikawa
ea47f7a67c Initial Japanese translations 2003-09-07 21:26:00 +00:00
Kazuo Horikawa
6aedbb7b9c Small corrections
last.1 (rev 1.15->1.16)
mkstr.1 (rev 1.11->1.12)
top.1 (remove wrong original revision number)
2003-09-07 20:57:41 +00:00
Kazuo Horikawa
84a273e1ce Fix item orders. Improve wording. Fix some mdoc(7) macros.
Submitted by:	mistral@imasy.or.jp (Yoshihiko Sarumaru)
2003-09-07 18:46:13 +00:00
Kazuo Horikawa
03a951cfac Remove a sentense which does not have corresponding sentense in the
original factor.6

Submitted by:	Koizumi Satoru <koizumistr@minos.ocn.ne.jp>
2003-09-07 18:32:48 +00:00
Ceri Davies
c30fbe14ae Add a missing full stop to a footnote. 2003-09-07 14:58:27 +00:00
Ceri Davies
311250560d o Change one usage of "i.e." to "e.g." where it makes more sense, and remove
an unnecessary colon.

o If X is the chief weakness of something, then it actually is the most
  important one.  Remove some confusing text from a sentence.
2003-09-07 14:49:26 +00:00
Anders Nordby
82fbc33aef Add Ferruccio Vitale to additional contributors, for contributing the
mysqlcc port.
2003-09-07 13:06:45 +00:00