Commit graph

5806 commits

Author SHA1 Message Date
Nik Clayton
563344e601 Add an entry for myself in to "Who's Who".
This originally wasn't going to be quite so self-serving a commit.  But I
see that Dima has already committed the other patches to this file while
I wasn't paying attention. . .
2001-07-16 15:33:07 +00:00
Nik Clayton
08b0d4b4bc Use <prompt> in a couple of places it's appropriate. 2001-07-16 15:12:18 +00:00
Nik Clayton
9524fc725a Add JADEFLAGS to the nsgmls command line, so that any special "-i" settings
get passed down properly.  This fixes "make lint" for the Handbook, now that
the chapters are individually buildable.
2001-07-16 15:11:54 +00:00
Nik Clayton
7d44b5e448 + xref closes with '/>'. This causes a trailing '>'
at the end of the reference.  Removed the '/'.

+ Marked up 'log' and 'spool' as filenames
  in the discussion of the 'var' directory.

+ Changed fdisk to show up as command.

+ Marked up vn as device.

+ Marked up "sysinstall" using a man.systinstall.8; entity.

PR:		docs/28989
Submitted by:	Martin Heinen <mheinen0@wiesbaden-online.de>
2001-07-16 15:02:50 +00:00
Nik Clayton
b30b3464f5 Add a "Quick Start" section, based on one of my messages to -doc. 2001-07-16 14:45:56 +00:00
Murray Stokely
213a66a8d3 Introduce a 'NICE_HEADERS' tuneable knob that creates customized
chapter headers that you may find more aesthetically pleasing than the
rather spartan chapter headers in Norm's print stylesheets.  This
option only effects print output formats for English language books.

Also move the local-en-label-title-sep customization from share/sgml
to en_blah/share/sgml since the best values for this customization
depend on the locale.

This changes (make FORMATS=ps) :

    Chapter 7. Users and Basic Account Management

    7.1. Synopsis

into (make NICE_HEADERS=1 FORMATS=ps) :

    Chapter 7
    /Users and Basic Account Management/

    7.1  Synopsis

More work needs to be done for the NICE_HEADERS case to enhance the
output, but I think its an improvement.
2001-07-16 05:00:21 +00:00
Anton Berezin
060fb0d1c5 Update Flemming Jacobsen's E-mail address. 2001-07-15 19:57:41 +00:00
Nik Clayton
ee67001995 Show how to mark up keys, mouse buttons, and combinations (chords). 2001-07-15 11:17:05 +00:00
Dima Dorfman
62e08c0139 Use &os.current; and &os.stable; where appropriate.
Submitted by:	Mike Barcroft <mike@q9media.com>
2001-07-15 06:33:28 +00:00
Dima Dorfman
f5838bd6ef Document 'MFC after:'.
Submitted by:	Mike Barcroft <mike@q9media.com>
2001-07-15 05:22:50 +00:00
Dima Dorfman
d256565232 Fix URL to packages on ftp.freebsd.org.
Submitted by:	Josh Paetzel <jpaetzel@hutchtel.net>
2001-07-15 04:48:06 +00:00
Murray Stokely
bcf6db15c2 Our primary CVS repository is located in Santa Clara now, not Concord.
Location confirmed by: billf
2001-07-15 00:28:40 +00:00
Murray Stokely
cb5cb5afc9 Add the beginnings of a small word list and link to the O'Reilly word
list for more comprehensive coverage.
2001-07-15 00:16:23 +00:00
Murray Stokely
99c9a56f15 Consistently use an uppercase replaceable 'X' :
4.x-STABLE    -> 4.X-STABLE
   FreeBSD 2.2.x -> FreeBSD 2.2.X
2001-07-14 23:40:29 +00:00
Murray Stokely
d1fc97d13f FreeBSD SMP is no longer only for Intel machines. 2001-07-14 23:23:32 +00:00
Murray Stokely
b05f2d4e5b Add an entity &os.numports;, currently set to "5,400", so that we
don't have to keep this number updated at N different places
throughout the doc tree.

Update 3 instances of "4,000" in the Handbook to use this new entity.
2001-07-14 23:09:20 +00:00
Anton Berezin
9454f472b3 Add John Merryweather Cooper <jmcoopr@webmail.bmi.net> to the additional
contributors section for his update to mail/libesmtp port.
2001-07-14 21:48:52 +00:00
Anton Berezin
cf025b4ae5 Document parameters passed to pkg-req script.
Reviewed by:	dd
2001-07-14 20:56:36 +00:00
Chris Costello
dde382c2b4 Add a dependancy on ${CSS_SHEET} for the docbook.css target. Without this,
one must run a `make clean' (or `rm docbook.css') or the stylesheet is not
updated, regardless of whether or not it's been updated since the last
build.
2001-07-14 18:04:06 +00:00
David E. O'Brien
0caaf5d84f When PHK committed rev 1.50, he did not adjust the references to particular
rule numbers to take into account the new numbering.
2001-07-14 03:38:03 +00:00
Chern Lee
1c9cca9012 can not -> cannot
"Cannot" is proper English, has more instances in the handbook than "can not"
and conforms to O'Reilly's word list.

Approved by:	murray
2001-07-14 02:21:12 +00:00
Chern Lee
f05db19844 Standardize: Mhz -> MHz
The MHz notation for megahertz is used throughout the handbook, as well as
everywhere else.

Approved by:	murray
2001-07-14 02:06:29 +00:00
Chern Lee
a3496b5d17 Standardize internet -> Internet
Approved by:	murray
2001-07-14 01:56:33 +00:00
Murray Stokely
e8ca7d55f8 PC-DOS/DOS -> MS-DOS 2001-07-14 01:47:38 +00:00
Chern Lee
f760bc9faf Make <indexterm> more specific with rc files/rc.conf.
Submitted by:	Valentino Vaschetto <valentino.vaschetto@windriver.com>
Approved by:	murray
2001-07-14 01:09:40 +00:00
Murray Stokely
1853b9bcf6 CD-ROM -> CDROM
O'Reilly has standardized on 'CD-ROM' as have several other
publishers, however 'CDROM' outnumbers 'CD-ROM' 2 to 1 in our
documentation and it has always appeared this way on FreeBSD CDs from
Walnut Creek/BSDi/WRS.  I don't have a preference either way as long
as it stays consistent.
2001-07-14 00:57:56 +00:00
Chern Lee
0cd5b44fec Add <indexterm>'s to contrib chapter.
Fix <command>man 9 intro</command <command>man 9 style</command> -> proper man
entities.

Submitted by:	Valentino Vaschetto <valentino.vaschetto@windriver.com>
Approved by:	murray
2001-07-14 00:06:54 +00:00
Murray Stokely
8f28d1f75d Remove Appendix F from the Handbook build. The two most complete
sections have been moved off into separate tutorials and "Jordan's
picks" of Pentium-class motherboards will just have to be missed ;)

The Handbook is now "only" 681 pages (without the index turned on).
2001-07-13 22:55:52 +00:00
Murray Stokely
1fffa4c4ce Remove a reference to the UART section in Appendix F. Point users to
the tutorial instead.
2001-07-13 22:44:03 +00:00
Chern Lee
6d49e84b0b Enclose XF86Config.new in <filename> tags and use third-person voice
consistently in X 4 section.

Submitted by:	Chris Shumway <cshumway@FreeBSD.org>
2001-07-13 22:34:29 +00:00
Murray Stokely
26569d38b9 Add a tutorial about storage device hardware. This was previously
part of Appendix F in the Handbook.
2001-07-13 22:30:40 +00:00
Chern Lee
66585ffb37 Add indexterms to policy chapter.
Contributed by Valentino Vaschetto <logo@blackened.com>
2001-07-13 22:21:27 +00:00
Bill Fumerola
c86c27cff9 use entity names instead of <email></email> for Paul Saab and John Baldin(sic) 2001-07-13 22:03:55 +00:00
Murray Stokely
788d821de5 Add a tutorial on serial communications, multiport cards, and UARTs.
This information is from the outdated and out-of-scope Appendix F of
the Handbook which will shortly be removed.
2001-07-13 22:01:35 +00:00
Chern Lee
d9d621e76e Correct:
http://www.freebsdmall.com/books -> http://www.freebsdmall.com

Only the front page currently remains.

Approved by:	murray
2001-07-13 21:29:54 +00:00
Chern Lee
07ea524120 Added Chris Shumway to contributers section and added author entity 2001-07-13 21:22:49 +00:00
Nik Clayton
389c5ab0f0 s/eps2png/peps/
Remove the LinuxDoc info.

Reword the DocBook info.
2001-07-13 20:50:29 +00:00
Nik Clayton
dc54c20da7 Add some info about CSS stylesheets. 2001-07-13 20:49:53 +00:00
Nik Clayton
ab06efc7f1 Update a few paths. 2001-07-13 20:49:35 +00:00
Nik Clayton
35548e2f83 Remove out of date info about Linuxdoc. 2001-07-13 20:49:09 +00:00
Nik Clayton
4c9997edb4 Link to the home page for "DocBook: The Definitive Guide" and the stylesheet
project on SourceForge.
2001-07-13 20:48:01 +00:00
Chern Lee
d43549e1de Add myself to staff, remove from additional contributers. 2001-07-13 19:14:48 +00:00
Nik Clayton
ed30795a49 Switch to version 4.1 of the DTD. 2001-07-13 16:34:19 +00:00
Nik Clayton
7a6b4455b4 Switch to version 4.1 of the DTD. 2001-07-13 16:24:13 +00:00
Nik Clayton
d0c1820c08 Switch to DocBook 4.1 2001-07-13 16:11:04 +00:00
Nik Clayton
08b5dc0800 Switch to version 4.1 of the DTD.
This breaks the build for this document.  However, it was already broken,
and it's not included in the top level Makefile yet.  The specific problem
is that <segmentedlists> must now have a <segtitle> for each column with
4.1, and I don't know nearly enough Japanese to do that.

Adding in the correct <segtitle>s is 30 seconds work.
2001-07-13 16:09:15 +00:00
Nik Clayton
dc394d4f9a Switch to version 4.1 of the DTD. 2001-07-13 15:58:41 +00:00
Nik Clayton
4aea5c734b Switch to version 4.1 of the DTD. 2001-07-13 15:48:41 +00:00
Nik Clayton
d6235a672f Switch to version 4.1 of the DTD. 2001-07-13 15:39:51 +00:00
Nik Clayton
5a8491908e Switch to using version 4.1 of the DTD. 2001-07-13 15:36:28 +00:00