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

249 commits

Author SHA1 Message Date
Chern Lee
74c4bf6395 RFCs are no longer on the web at 
http://info.internet.isi.edu:80/in-notes/rfc/files/rfcXXXX.txt

Update three instances to correct location.

Partially Submitted by: Kjetil Høie" <kjetil-h@freenix.no>
 2001-09-21 22:18:39 +00:00
Murray Stokely
f0042b1654 Reword a couple of sentences that I found very confusing. Often this 
was due to missing words or sentences that made it very difficult to
understand the text.
 2001-08-24 07:27:05 +00:00
Chern Lee
a14cad024a Change standard chapter sypnosis to form complete sentences: 
Before reading this chapter you should:
 "understand"...
 "be familiar with"...
 2001-08-22 21:40:11 +00:00
Chern Lee
ec971dcb65 Place a host -> gateway list into an informaltable. 2001-08-22 21:36:25 +00:00
Chern Lee
34fbc5dd5e Cosmetic changes. Placed a couple lists into <informaltable>s. 2001-08-20 22:13:36 +00:00
Chern Lee
d9b35c6b35 Nitpick English changes to make the chapter more understandable. 2001-08-20 18:48:45 +00:00
Chern Lee
f3be431385 Spelling Fixes: 
* signalling -> signaling
 * keypresses -> key presses
 2001-08-16 18:42:51 +00:00
Chern Lee
6c21f4c1e9 Change all contractions to proper form. 
don't -> do not
isn't -> is not
let's -> let us
... and so on
 2001-08-16 18:35:08 +00:00
Chern Lee
2fbbb3c1ef Update ISDN Cards section of Advanced Networking. 
Submitted by: Hellmuth
Docs bullied out of Hellmuth by: murray
 2001-08-15 17:55:32 +00:00
Valentino Vaschetto
0f839c1480 Put ids into sect2 tags so that they can be xref'd 
Approved by:	murray
 2001-08-15 00:51:25 +00:00
Chern Lee
d9b1288ac8 Markup Changes, place terms in: 
* <application>
 * <username>
 * <command>
 * <literal>
 * <devicename>

Reviewed by:	murray
 2001-08-14 22:06:11 +00:00
Dima Dorfman
daccd2d939 NFS is not unique or unusual, so don't all it so. It's different from 
some of the more conventional filesystems, but pseudo-filesystems are
more unusual (at least NFS stores data), and all filesystems are
"unique" by definition.

PR:		29503
Approved by:	jim
 2001-08-14 05:28:12 +00:00
Jim Mock
74dca37255 Add periods to the ends of the sentences in the synopsis. While I'm 
here, wrap inetd in <command></command> tags and /etc/rc in
<filename></filename> tags.
 2001-08-13 19:05:55 +00:00
Jim Mock
80761b83da Whitespace changes only, translators can ignore this commit. 
* Two spaces after a period.

   * Fix up the spacing in the listitems.

     <itemizedlist>
       <listitem>
         <para></para>
       </listitem>

       <listitem>
         <para></para>
       </listitem>
     </itemizedlist>

     This is covered in the fdp-primer.  Please read it.
 2001-08-13 19:03:39 +00:00
Valentino Vaschetto
becdab0f46 Added a standardized chapter synopsis. 2001-08-13 18:46:37 +00:00
Chern Lee
34153285f8 Rewrite NFS/amd section. Better English, more concise and informative. 
Reviewed by:	murray
 2001-08-13 18:38:28 +00:00
Jim Mock
40274f387b Change "manpage" and "man page" to "manual pages". 2001-08-11 21:34:53 +00:00
Jim Mock
1de28e1e1d Argh, forgot this in my last commit. 
freebsd.org -> FreeBSD.org
 2001-08-11 20:45:09 +00:00
Jim Mock
f43590590d Attack of the spelling and grammar police. Things like nameserver and 
mailserver are two words, folks.
 2001-08-11 20:27:42 +00:00
Chern Lee
205cf1b49a Standardize capitalization of titles: 
* First and last word uppercase
* Prepositions, articles, and short conjunctions lowercase
* The word 'to' lowercase
* Preserved capitalization for program/command names

Reviewed by:	murray
 2001-08-10 22:58:17 +00:00
Murray Stokely
126c118090 *smack* ;) 
You can't put a <varname> inside a <filename>.
 2001-08-10 01:06:45 +00:00
Valentino Vaschetto
8cc2fd88ac Added subsection about AMD to the NFS section. 
Submitted by:	Wylie Stilwell <wylie@beerho.com>
Approved by:	murray
 2001-08-10 00:14:55 +00:00
Chern Lee
2b61014302 Properly markup contributions in <chapterinfo>/<sect1info>/<sect2info> tags 
according to recent changes for entire Handbook.

Reviewed by:	murray
 2001-08-09 23:42:35 +00:00
Valentino Vaschetto
6cf123d6cf Closed a couple of open tags which were not closed. 
Reviewed by:	murray
 2001-08-09 22:50:10 +00:00
Chern Lee
46b6b8fe06 * procces -> process 
* Link text of redundant "Send HUP to inetd" back to previous example

Reviewed by:	murray
 2001-08-08 18:44:56 +00:00
Dima Dorfman
ce3a4f2ccb Note that copyright doesn't have anything to do with names (those are 
trademarks), and improve the text a little.

PR:		29501
Submitted by:	Gary W. Swearingen <swear@aa.net>
 2001-08-08 17:35:54 +00:00
Chern Lee
be2032ed93 Add section about configuring inetd. 
Reviewed by:	murray
 2001-08-07 23:58:38 +00:00
Chern Lee
8821260cc9 Reworded sections of "Reasons to run a name server" and changed 
definition of "Origin" in DNS section.

Reviewed by:	murray
 2001-08-06 22:50:16 +00:00
Chern Lee
c20dd61362 Spelling Changes: 
* OSs -> Operating Systems
* commmunications -> communications
* realise -> realize
* customising -> customizing
* customise -> customize
* realise -> realize
* behaviour -> behavior

British to American spelling for some of the above words only in the
Handbook as discussed on -doc.

Reviewed by:	murray
 2001-08-06 21:25:28 +00:00
Chern Lee
2ed036cc7c Structural Markup Changes to DNS: 
* Terminology -> <informaltable>
* File list -> <informaltable>
* Record Types -> <variablelist>
* Links -> <itemizedlist>

Reviewed by:	murray
 2001-08-06 20:25:01 +00:00
Jim Mock
f1d9605e83 Change the remaining instances of e-mail to email. 2001-08-04 20:06:22 +00:00
Chern Lee
e4aad960d6 Revised wording of DNS section, added some content. 
Minor markup changes:
 * Cuddle up <programlisting>
 * Placed hostnames in <hostid>
 * Placed some terms in <literal>

Reviewed by:	murray
 2001-08-02 01:57:08 +00:00
Murray Stokely
2fdac55c46 * Combine singular/plural index terms. 
* Add a few section id's so that the printed index can find the page
  number.

Submitted by:	Valentino Vaschetto <valentino.vaschetto@windriver.com>
 2001-07-30 17:18:54 +00:00
Murray Stokely
cbe8d4a8bd * Enclose author attributions in <chapterinfo>, <sect1info>, etc. 
* Modify an example `ls /usr/lib/*crypt*' listing so that it doesn't
  wrap on a printed page.
 2001-07-27 22:03:56 +00:00
Chern Lee
aa873b5501 Remove smileys/emoticons as discussed in -doc to give the handbook a more 
formal look.

Reviewed by:	murray
 2001-07-23 22:51:33 +00:00
Murray Stokely
3741b3edfb Add ID attributes to <indexterms> 
Add <see> tags to cross-reference similar indexed topics
 2001-07-21 09:13:55 +00:00
Chern Lee
474756bf03 Markup Fixes: 
Place some terms in <varname>
Change <emphasis> -> <varname> in some intstances
Place commands in <command> or man entitiy
Place applications in <application>
Place filenames in <filename>
Place hostnames in <hostid>
One instance of <quote> -> <errorname>

Spelling/Terminology Fixes:
ip -> IP address
IPs/ips -> IP addresses
cfg -> config
Unice -> Unix systems

Reviewed by:	murray
 2001-07-19 18:38:43 +00:00
Chern Lee
4593015dcc Modified existing <indexterm>'s to make them more specific using 
<filename>, <command>, and <application> tags.

Submitted by:	Valentino Vaschetto <valentino.vaschetto@windriver.com>
Approved by:	murray
 2001-07-17 23:33:28 +00:00
Chern Lee
3e8d98b70a Standardize: 
TCL -> Tcl
ethernet -> Ethernet
ftp (noun) -> FTP

Approved by:	murray
 2001-07-17 22:20:51 +00:00
Chern Lee
6dbf07d805 Fix/Standardize: 
internet -> Internet
can not -> cannot
CD-ROM -> CDROM
cdrom -> CDROM
UNIX -> Unix

To be standardized with the rest of the doc tree.

Approved by:	murray
 2001-07-17 20:51:52 +00:00
Chern Lee
7001f29865 Standardize: 
UNIX -> Unix
UNIX's -> Unixes (one instance)

Unix is a proper noun, not an acronym.  Also conforms to O'Reilly's word list.

Approved by:	murray
 2001-07-17 00:11:24 +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
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
a3496b5d17 Standardize internet -> Internet 
Approved by:	murray
 2001-07-14 01:56:33 +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
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
Nik Clayton
ef12bb1d4c Remove these -- now that peps is being used the automatic conversion from 
the EPS originals suffices.
 2001-07-13 12:12:41 +00:00
Dima Dorfman
4a5e851cb2 DocBook police: open and close tags for <screen> should cuddle up to 
the contents within.
 2001-07-06 13:03:06 +00:00
Nik Clayton
4e521b8bb2 Makefile's to make it easy to build individual handbook chapters. These 
are *not* recursed in to by the top level Makefile.
 2001-06-30 14:55:40 +00:00
Murray Stokely
e6917a777e Properly wrap indexterm entries that exceed 80 characters. Also move 
<indexterm> tags outside of <para>s since this can add extra
whitespace characters to the output (for print stylesheets).

Pointed out by: Chris Costello
 2001-06-26 20:10:25 +00:00