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

93 commits

Author SHA1 Message Date
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
Murray Stokely
a04cbb22cc Add ~96 index entries 2001-06-26 00:09:52 +00:00
Murray Stokely
ca002b6606 The author of this section was slightly confused about the terminology 
used to describe network topology.  Change instances of '10 base T' to
'10 base 2' and adjust sentence structure when describing a bus-based
topology.

While I'm here, consistently use 'LAN' instead of 'lan' for local area
networks.
 2001-06-24 03:22:48 +00:00
Murray Stokely
506d3469cb Add graphical figures for the network diagrams in the ISDN section. 
Submitted by:	G. Adam Stanislav
 2001-06-24 03:06:38 +00:00
Murray Stokely
8d2a434262 Add a graphical figure for the natd chapter to replace the ASCII art 
when the output format supports it.

The PNG driver for Ghostscript doesn't support anti-aliasing on
FreeBSD, so the PNG file was created on another platform and should
not be automatically generated from the eps file.

Submitted by:	G. Adam Stanislav (created the EPS file with a text editor)
 2001-06-23 22:46:16 +00:00
Murray Stokely
88f3235bb0 Spelling corrections : 
transalates    -> translates
  indictes       -> indicates
  ficticious     -> fictitious
  sandox         -> sandbox
  priveleged     -> privileged
  unix           -> Unix
  versatily      -> (sentence reworded)
  inerface       -> interface
  internet       -> Internet
  appriate       -> appropriate
  Logictech      -> Logitech
  extetions      -> extensions
  occuring       -> ocurring
  keypair        -> key pair
  tunnelled      -> tunneled
  inializes      -> initializes
  ommitted       -> omitted
  seperate       -> separate
  unintelligable -> unintelligible
  signalling     -> signaling
  appearence     -> appearance
  descision      -> decision

Pointed out by: ispell(1)
 2001-06-21 17:21:01 +00:00
Murray Stokely
001e62c2c9 Add a section on using natd to share an internet connection, do port 
forwarding, etc.

Submitted by:	Chern Lee <chern.lee@windriver.com>
Obtained from:	based on the natd man page, and online documentation
 2001-06-15 21:47:55 +00:00