os/doc
3
0
Fork 0
Code Issues Pull requests Projects Releases Wiki Activity
9975 commits 1 branch 79 tags 298 MiB
Commit graph

166 commits

Author SHA1 Message Date
Murray Stokely
dc4773d579 Clarify history of DocBook. 
PR:		docs/50824
Submitted by:	Oliver Fischer <plexus@snafu.de>
 2003-04-26 07:40:04 +00:00
Hiroki Sato
f6cd99b654 Back out WITH_DOCFORMAT_NAVI_LINK?=YES in Makefile. The navi-link 
is generated when ${WITH_DOCFORMAT_NAVI_LINK} is defined or
${FORMATS} includes "html" and "html-split."
 2003-04-22 18:35:44 +00:00
Hiroki Sato
4f8b26641c - Add WITH_DOCFORMAT_NAVI_LINK to mk/doc.docbook.mk and 
enable it in en_US.ISO8859-1/ and ja_JP.eucJP/.

- Add PUBLIC "-//FreeBSD//ENTITIES DocBook Language Specific Entities//EN"
  and l10n.ent for entity localization.

- Use share/misc/docbook.css for indentiation of <programlisting>
  and <screen>.

- Add some missing $FreeBSD$.
 2003-04-19 11:39:30 +00:00
Christian Brueffer
7aa6b25f4a Add 'IPsec' to the word list 
Requested by:	murray
 2003-04-17 02:09:32 +00:00
Giorgos Keramidas
6dd95937d9 Put my flame resistant suit on, and remove all unnecessary duplication 
of URL text in <ulink> attributes, reducing the probability of typos
in future changes to the docs.
 2003-04-11 01:11:39 +00:00
Tom Hukins
825301e946 Clarify the use of tabs in documentation and add a Vim configuration 
example.
 2003-04-10 21:13:09 +00:00
Ceri Davies
be816809c0 Correct a broken tag within an example: s/pubdata/pubdate/ 
PR:		docs/48817
Submitted by:	Martin Karlsson <martin.karlsson@visit.se>
 2003-03-01 18:53:38 +00:00
Marc Fonvieille
af1f249135 Add 2003 to the copyright. 2003-02-17 13:47:07 +00:00
Christian Brueffer
a157b39ac4 Add 'Soft Updates' to the wordlist 
Approved by: ceri (mentor)
 2003-01-13 18:20:59 +00:00
Peter Pentchev
1f359cbbab /tmp/msg 2003-01-12 18:20:55 +00:00
Giorgos Keramidas
5fb7901b07 Make sure that users understand the output format limitations 
of a doc toolchain installed with JADETEX=no.

Suggested by:	   Joseph King <king@v2project.com>
Helpful comments:  freebsd-doc folks
 2002-12-17 23:32:50 +00:00
Ceri Davies
abb230d42c Spell "inadvertent" correctly. 2002-12-15 21:49:34 +00:00
Martin Heinen
2bfcee3890 Add a section explaining &nbsp; 
Reviewed by:	Lukasz Bojarski <ni@merkury.pol.lublin.pl>
Approved by:	murray, alex (mentor)
 2002-10-10 08:40:52 +00:00
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