Commit graph

253 commits

Author SHA1 Message Date
Giorgos Keramidas
9d95fe07bf Don't suggest that people add both a $Date$ and $Id$ RCS keyword
to their documents.  Also change $Id$ to $FreeBSD$ in the output.

Submitted by:	Christian Brueffer <chris@unixpages.org>
2002-10-08 01:27:37 +00:00
Giorgos Keramidas
89e96b7a6b Sort wordlist. 2002-08-31 20:14:13 +00:00
Giorgos Keramidas
4a85c1d9ac Add "file system" to the wordlist.
PR:		docs/42256
Submitted by:	Christian Brueffer <chris@unixpages.org>
2002-08-31 20:11:25 +00:00
Sebastien Gioria
f3e93cada2 Fix the broken link of the Documentation Project translations page 2002-08-30 13:16:37 +00:00
Bruce A. Mah
da3df16f33 Unbreak doc/web build. 2002-08-18 00:56:58 +00:00
Marc Fonvieille
24a0a68339 More consistency in capitalization of applications name. 2002-08-17 19:59:21 +00:00
Marc Fonvieille
7bfee4ec8b More consistency in capitalization of applications name.
PR:		docs/41726
Submitted by:	Christian Brueffer <chris@unixpages.org>
2002-08-17 19:59:05 +00:00
Marc Fonvieille
eb3bc028a6 More consistency in capitalization of applications name.
While I'm there: tags addition when needed.

PR:		docs/41725
Submitted by:	Christian Brueffer <chris@unixpages.org>
2002-08-17 19:58:12 +00:00
Marc Fonvieille
7a7cfccc15 Add missing parentheses and a missing slash for a markup example.
While I'm there: expand OS to operating system.

PR:		docs/41724
Submitted by:	Christian Brueffer <chris@unixpages.org>
2002-08-17 15:23:49 +00:00
Marc Fonvieille
39645a5306 s/These directories/These Makefiles
PR:		docs/40658
Submitted by:	Eric Anderson <anderson@centtech.com>
2002-07-16 23:12:56 +00:00
Tom Rhodes
d4b003e30a FreeBSD documentation project prefers to use manual pages over man pages,
hence some documents should reflect this.

Tossed around on: -doc -developers
2002-07-11 19:08:31 +00:00
Giorgos Keramidas
92cb93a0b9 Do not use /handbook to link to the Handbook, since some of these
links are broken now that /handbook is a redirection to the real
location of the Handbook at /doc/en_US.ISO8859-1/books/handbook.

PR:		docs/39967
Submitted by:	Mark J. Miller <mjm@CSUA.Berkeley.EDU>
2002-06-28 23:44:38 +00:00
Murray Stokely
76fb989a32 Grammar.
PR:		docs/38400
Submitted by:	Chris Pepper <pepper@rockefeller.edu>
2002-05-30 08:10:27 +00:00
Ceri Davies
4059045d53 Americanise^H^ze (s/behaviour/behavior/g). 2002-05-22 14:27:13 +00:00
Ceri Davies
900e71c276 Bring the FDP Primer in line with the FDP Primer :)
[s/colour/color/]
2002-05-22 14:17:37 +00:00
Ceri Davies
1f37332cae s/in to/into/ where it makes sense.
This commit can very likely be ignored by translators.
2002-05-22 08:36:43 +00:00
Giorgos Keramidas
831f707141 Fix a couple of typos:
Every one -> Everyone.
    translating in to -> translating into

PR:		docs/38399
Submitted by:	Chris Pepper <pepper@rockefeller.edu>
2002-05-22 04:45:43 +00:00
Giorgos Keramidas
329cfce818 www/links is not in the base system, we can do without &man.links.1;.
PR:		docs/38162
Submitted by:	Wouter Van Hemel <wouter@pair.com>
2002-05-19 13:45:38 +00:00
Giorgos Keramidas
67a1702cec Remove almost all instances of "try and <verb>" from the docs.
There is one remaining place in the fdp-primer, but that needs
a bit more work.

Inspired by:	docs/36462 (Gary W. Swearingen <swear@blarg.net>)
Reviewed by:	ceri, trhodes
2002-04-07 23:52:37 +00:00
Giorgos Keramidas
c77870143a Fix duplicate 'the the' -> 'the'.
PR:		docs/36599
Submitted by:	Shaun Branden <shaun@pcuse.com>
2002-04-01 09:30:03 +00:00
Giorgos Keramidas
6ddd2cc0dc Fix &entities; that lacked an ending ';' character,
as reported by the following:

	% cd doc/en_US.ISO8859-1
	% find . -type f -name '*.sgml' |\
	  xargs grep '&[^[:space:];&][^[:space:];]*$' | grep -v '&$'
	% find . -type f -name '*.sgml' |\
	  xargs grep '&[^[:space:];&][^[:space:];]*[[:space:]<]' |\
	  grep -v '&[[: space:]]' | grep -v '[[:space:]]&&[[:space:]]'
2002-03-27 01:16:55 +00:00
Giorgos Keramidas
c52282a36f Fix a few typos.
PR:		docs/36334
Submitted by:	Martin Karlsson <martin.karlsson@visit.se>
2002-03-26 22:31:57 +00:00
Giorgos Keramidas
4eacce79e5 Fix example command lines, by adding missing continuation backslash \
at the end of the lines that need it.

PR:		docs/36100
Submitted by:	Martin Karlsson <martin.karlsson@visit.se>
2002-03-24 03:40:49 +00:00
Peter Pentchev
767c635e20 Whitespace-only fixups for the committers and lists entities conversion. 2002-03-15 07:57:16 +00:00
Peter Pentchev
eed41e97e6 Convert the names, descriptions and e-mail addresses of FreeBSD
committers and mailing lists to &a.xxx; entities.

Reviewed by:	keramida
Approved by:	keramida, silence on -doc
2002-03-15 07:46:22 +00:00
Michael Lucas
5ce4b99796 Correct examples of setting environment variables.
politely pointed out by:  pirat <pirat@access.inet.co.th>
copious abuse to: mwlucas
2002-03-06 16:47:57 +00:00
Dima Dorfman
60c2283e72 Change the <filename role="package"> example to make it clear in the
rendered version that "net/ethereal" (the example port) is a port.
I.e., change "Install net/ethereal" to "Install the net/ethereal
port".  I think this is how it should be done.  Nothing about
"net/ethereal" (or any other port described in this way) makes it
clear that this is indeed a port.  We can see that from the source,
but to a new user reading the rendered version it's a mystery.
2002-03-03 02:30:13 +00:00
Dima Dorfman
e3035101be Replace mention of the <port> tag with the new <filename>-based syntax. 2002-03-03 01:39:24 +00:00
Dima Dorfman
fcfccd4a32 <port>fish</port> -> <filename role="package">fish</filename>
Generated with:	s:<port>(.*?)</port>:<filename role="package">\1</filename>:g
2002-02-27 05:08:13 +00:00
Peter Pentchev
a3d3aeaf0b Add a description of the <quote> tag.
Reported by:	Tom Rhodes <darklogik@pittgoth.com>
Reviewed by:	dd
Approved by:	dd
2002-02-26 07:23:41 +00:00
Michael Lucas
8c54a4e432 Mention what catalog files are. Also suggest that people set the
FreeBSD-specific catalog files are set during this tutorial; this will
answer a common FreeBSD docproj complaint on complaints generated by
emacs.

"if it's wrong, fix it" by: nik
2002-02-14 19:31:09 +00:00
Giorgos Keramidas
c1ffcd271e Change <portname> to <port> to make example caption match sgml sample.
PR:		docs/34662
Submitted by:	Hiten Pandya <hiten@uk.FreeBSD.org>
2002-02-11 01:58:44 +00:00
Peter Pentchev
0837dba788 Change <filename> tags to <port> when the documentation is referring
to ports as in the FreeBSD Ports Collection.

As pointed out by Nik and others, the <port> tag is not the best way
to mark up Ports Collection ports.  However, for the present it is
the best we have, and the least we can do is be consistent in its
usage :)

Approved as a temp "best current practice" measure by:	bmah, -doc
2002-01-18 07:57:33 +00:00
Murray Stokely
6f26cb1384 Update copyright years. 2002-01-01 09:43:38 +00:00
Giorgos Keramidas
96e9fe2ad3 Expand contractions in the fdp-primer.
Also replace a few erroneous "it's" with the possessive "its".
2001-12-08 12:12:47 +00:00
Nik Clayton
19b04dea07 Damn. "rationalize" -> "rationalise". 2001-11-30 09:50:48 +00:00
Nik Clayton
bb399b1df9 Note that American English is the preferred variant for spelling. 2001-11-29 23:20:56 +00:00
Giorgos Keramidas
6f5417d33e Add aparagraph that notes CDATA and RCDATA is not validated, and
suggest that SGML examples are validated externally.

Approved by:	   nik
Original idea by:  Michael Lucas <mwlucas@blackhelicopters.org>
2001-11-14 01:16:34 +00:00
Bruce A. Mah
7abba1b857 Document "port" tag. From the PR, but with the text moved to a more
suitable section (DocBook vs. HTML section) and with an explanatory
note that this element is a FreeBSD extension to DocBook.

PR:		31934
Submitted by:	mwlucas@blackhelicopters.org
2001-11-13 18:07:39 +00:00
Bruce A. Mah
edf26dccd4 Document the "errorname" tag.
PR:		31776
Submitted by:	Michael Lucas <mwlucas@blackhelicopters.org>
2001-11-13 08:14:49 +00:00
Tom Hukins
64ac5cb25a Fix typo
PR:		docs/31909
Submitted by:	Shaun Branden <shaun@pcuse.com>
2001-11-11 21:30:04 +00:00
Murray Stokely
b98392cee3 By default, emacs doesn't set tab fillers and page width correctly for
the docproj materials.  This adds a sample .emacs entry to set this
properly.

PR:		docs/31707
Submitted by:	Michael Lucas <mwlucas@blackhelicopters.org>, and
		keramida
2001-11-05 07:13:36 +00:00
Chern Lee
efda86a986 Spelling Fixes:
* overridable -> overridden
 * documention -> documentation
 * preceeding -> preceding
 * preceeded -> preceded
 * harddisk -> hard disk
 * analagous -> analogous
 * togther -> together
 * timelines -> time lines
 * philisophy-> philosophy
 * differentation -> differentiation
 * knowledgable -> knowledgeable
 * occurence -> occurrence
 * occured -> occurred
 * greek -> Greek
 * aready -> already
 * commandline -> command line
 * latin -> Latin
 * seperate -> separate
2001-10-31 23:47:32 +00:00
Murray Stokely
bc83273cff * Correct some links
* Use ftp.hostname.com/directory rather than
  ftp.hostname.com:directory.
* s/freebsd.org/FreeBSD.org/
* Use relative links for FreeBSD.org documents

PR:		31447
Submitted by:	Cyrille Lefevre
Found by:	linbot
2001-10-23 21:54:19 +00:00
Giorgos Keramidas
4593fd98a7 Sweep through english docs and replace &ldquot; and friends with <quote>.
Approved by:	nik
2001-10-10 11:47:30 +00:00
Murray Stokely
b6c1d3fcbf Clarify an example.
PR:		docs/30975
Submitted by:	Giorgos Keramidas <charon@labs.gr>, bmah
2001-10-02 06:00:27 +00:00
Murray Stokely
c0425835ca Whitespace change only. Translators please ignore.
PR:		docs/30977
Submitted by:	Giorgos Keramidas <charon@labs.gr>
2001-10-02 05:28:57 +00:00
Murray Stokely
ec23fd4f46 Fix a couple of links.
PR:		docs/30976
Submitted by:	Giorgos Keramidas <charon@labs.gr>
2001-10-02 05:24:37 +00:00
Murray Stokely
16dcb50ab9 Fix typo.
PR:		docs/30851
Submitted by:	Giorgos Keramidas <charon@labs.gr>
2001-09-26 21:49:28 +00:00
Nik Clayton
8556d28c40 s/tex/pdftex/ as appropriate.
Submitted by:	Hiroki Sato <hrs@eos.ocn.ne.jp>
2001-08-29 00:34:27 +00:00