View | Details | Raw Unified | Return to bug 13411
Collapse All | Expand All

(-)book.sgml (-68 / +66 lines)
Lines 133-140 Link Here
133
<emphasis>-current</emphasis> if you're sure that you're prepared for its
133
<emphasis>-current</emphasis> if you're sure that you're prepared for its
134
increased volatility (relative to <emphasis>-stable</emphasis>, that is).</para>
134
increased volatility (relative to <emphasis>-stable</emphasis>, that is).</para>
135
  
135
  
136
<para>Releases are only made <xref linkend="release-freq" remap="every few       months">. While many people stay more up-to-date with the
136
<para>Releases are only made <link linkend="release-freq">every few months</link>. While many people stay more up-to-date with the
137
FreeBSD sources (see the questions on <xref linkend="current" remap="FreeBSD-current"> and <xref linkend="stable" remap="FreeBSD-stable">) than that, doing so is more of a
137
FreeBSD sources (see the questions on <link linkend="current">FreeBSD-current</link> and <link linkend="stable">FreeBSD-stable</link>) than that, doing so is more of a
138
commitment, as the sources are a moving target.</para>
138
commitment, as the sources are a moving target.</para>
139
  
139
  
140
</answer></qandaentry>
140
</answer></qandaentry>
Lines 300-306 Link Here
300
FreeBSD source tree.</para>
300
FreeBSD source tree.</para>
301
  
301
  
302
<para>However, most non-trivial changes are discussed in advance in the
302
<para>However, most non-trivial changes are discussed in advance in the
303
<xref linkend="mailing" remap="mailing lists">, and there are no restrictions
303
<link linkend="mailing">mailing lists</link>, and there are no restrictions
304
on who may take part in the discussion.</para>
304
on who may take part in the discussion.</para>
305
  
305
  
306
</answer></qandaentry>
306
</answer></qandaentry>
Lines 346-352 Link Here
346
346
347
<listitem>
347
<listitem>
348
<para><ulink URL="ftp://current.FreeBSD.org/pub/FreeBSD/">4.0 Snapshot</ulink> releases are made once a day for the
348
<para><ulink URL="ftp://current.FreeBSD.org/pub/FreeBSD/">4.0 Snapshot</ulink> releases are made once a day for the
349
<xref linkend="current" remap="-current"> branch, these being of service
349
<link linkend="current">-current</link> branch, these being of service
350
purely to bleeding-edge testers and developers.</para>
350
purely to bleeding-edge testers and developers.</para>
351
</listitem>
351
</listitem>
352
352
Lines 355-392 Link Here
355
  
355
  
356
<para>FreeBSD is also available via CDROM, from the following place(s):</para>
356
<para>FreeBSD is also available via CDROM, from the following place(s):</para>
357
  
357
  
358
<para>Walnut Creek CDROM<!-- <br> -->
358
<para><literallayout>
359
4041 Pike Lane, Suite F<!-- <br> -->
359
         Walnut Creek CDROM
360
Concord, CA  94520  USA<!-- <br> -->
360
         4041 Pike Lane, Suite F
361
Orders:     +1 800 786-9907<!-- <br> -->
361
         Concord, CA  94520  USA
362
Questions:  +1 925 674-0783<!-- <br> -->
362
         Orders:     +1 800 786-9907
363
FAX:        +1 925 674-0821<!-- <br> -->
363
         Questions:  +1 925 674-0783
364
email:      <ulink URL="mailto:orders@cdrom.com">WC Orders address</ulink><!-- <br> -->
364
         FAX:        +1 925 674-0821
365
WWW:        <ulink URL="http://www.cdrom.com/">WC Home page</ulink><!-- <br> --></para>
365
         email:      <ulink URL="mailto:orders@cdrom.com">WC Orders address</ulink>
366
         WWW:        <ulink URL="http://www.cdrom.com/">WC Home page</ulink>
367
</literallayout></para>
366
  
368
  
367
<para>In Australia, you may find it at:</para>
369
<para>In Australia, you may find it at:</para>
368
  
370
  
369
<para>Advanced Multimedia Distributors<!-- <br> -->
371
<para><literallayout>
370
Factory 1/1 Ovata Drive<!-- <br> -->
372
         Advanced Multimedia Distributors
371
Tullamarine, Melbourne<!-- <br> -->
373
         Factory 1/1 Ovata Drive
372
Victoria<!-- <br> -->
374
         Tullamarine, Melbourne
373
Australia<!-- <br> -->
375
         Victoria
374
Voice: +61 3 9338 6777<!-- <br> --></para>
376
         Australia
375
  
377
         Voice: +61 3 9338 6777
376
<para>CDROM Support BBS<!-- <br> -->
378
</literallayout></para>
377
17 Irvine St<!-- <br> -->
379
  
378
Peppermint Grove  WA 6011<!-- <br> -->
380
<para><literallayout>
379
Voice: +61 9 385-3793<!-- <br> -->
381
         CDROM Support BBS
380
Fax:   +61 9 385-2360<!-- <br> --></para>
382
         17 Irvine St
383
         Peppermint Grove  WA 6011
384
         Voice: +61 9 385-3793
385
         Fax:   +61 9 385-2360
386
</literallayout></para>
381
  
387
  
382
<para>And in the UK:</para>
388
<para>And in the UK:</para>
383
  
389
  
384
<para>The Public Domain &amp; Shareware Library<!-- <br> -->
390
<para><literallayout>
385
Winscombe House, Beacon Rd<!-- <br> -->
391
         The Public Domain &amp; Shareware Library
386
Crowborough<!-- <br> -->
392
         Winscombe House, Beacon Rd
387
Sussex. TN6 1UL<!-- <br> -->
393
         Crowborough
388
Voice: +44 1892 663-298<!-- <br> -->
394
         Sussex. TN6 1UL
389
Fax:   +44 1892 667-473<!-- <br> --></para>
395
         Voice: +44 1892 663-298
396
         Fax:   +44 1892 667-473
397
</literallayout></para>
390
  
398
  
391
</answer></qandaentry>
399
</answer></qandaentry>
392
400
Lines 950-956 Link Here
950
that's supposed to let you *just* make those floppies, but it's not
958
that's supposed to let you *just* make those floppies, but it's not
951
really gelled yet.</para>
959
really gelled yet.</para>
952
  
960
  
953
<para>To make a custom release, follow the instructions <xref linkend="custrel" remap="here">.</para>
961
<para>To make a custom release, follow the instructions <link linkend="custrel">here</link>.</para>
954
  
962
  
955
</answer></qandaentry>
963
</answer></qandaentry>
956
964
Lines 1024-1030 Link Here
1024
That said, it does work on thousands of IDE based systems, so
1032
That said, it does work on thousands of IDE based systems, so
1025
you'd do well to try it first before simply giving up.</para>
1033
you'd do well to try it first before simply giving up.</para>
1026
  
1034
  
1027
<para>If you have a SCSI drive with bad blocks, see <xref linkend="awre" remap="this answer">.</para>
1035
<para>If you have a SCSI drive with bad blocks, see <link linkend="awre">this answer</link>.</para>
1028
  
1036
  
1029
</answer></qandaentry>
1037
</answer></qandaentry>
1030
1038
Lines 1305-1311 Link Here
1305
      </para></question><answer>
1313
      </para></question><answer>
1306
1314
1307
<para>This is classically a case of FreeBSD and DOS or some other OS
1315
<para>This is classically a case of FreeBSD and DOS or some other OS
1308
conflicting over their ideas of disk <xref linkend="geometry" remap="geometry.">  You will have to reinstall FreeBSD, but obeying the
1316
conflicting over their ideas of disk <link linkend="geometry">geometry</link>. You will have to reinstall FreeBSD, but obeying the
1309
instructions given above will almost always get you going.</para>
1317
instructions given above will almost always get you going.</para>
1310
  
1318
  
1311
</answer></qandaentry>
1319
</answer></qandaentry>
Lines 1332-1338 Link Here
1332
ISA devices, although one or two broken EISA and VLB devices may
1340
ISA devices, although one or two broken EISA and VLB devices may
1333
need it as well).</para>
1341
need it as well).</para>
1334
  
1342
  
1335
<para>Also look at the section on <xref linkend="reallybigram" remap="&gt;64M machines"> if you have that much memory,
1343
<para>Also look at the section on <link linkend="reallybigram">&gt;64M machines</link> if you have that much memory,
1336
or if you're using a Compaq or other BIOS that lies about
1344
or if you're using a Compaq or other BIOS that lies about
1337
the available memory.</para>
1345
the available memory.</para>
1338
  
1346
  
Lines 1456-1467 Link Here
1456
current versions can generally be obtained by anonymous FTP from
1464
current versions can generally be obtained by anonymous FTP from
1457
<filename>braae.ru.ac.za</filename>.</para>
1465
<filename>braae.ru.ac.za</filename>.</para>
1458
  
1466
  
1459
<para>There is also a <xref linkend="mailing" remap="mailing list"> for the
1467
<para>There is also a <link linkend="mailing">mailing list</link> for the
1460
discussion of non-US encryption software.  For more information, send
1468
discussion of non-US encryption software.  For more information, send
1461
an email message with a single line saying ``<emphasis remap=tt>help</emphasis>'' in the body
1469
an email message with a single line saying ``<emphasis remap=tt>help</emphasis>'' in the body
1462
of your message to</para>
1470
of your message to</para>
1463
  
1471
  
1464
<para><email>&lt;majordomo@braae.ru.ac.za&gt;</email>.</para>
1472
<para><email>majordomo@braae.ru.ac.za</email>.</para>
1465
  
1473
  
1466
</answer></qandaentry>
1474
</answer></qandaentry>
1467
1475
Lines 1866-1872 Link Here
1866
  
1874
  
1867
<para>When the mouse daemon is running, access to the mouse needs to be
1875
<para>When the mouse daemon is running, access to the mouse needs to be
1868
coordinated between the mouse daemon and other programs such as the
1876
coordinated between the mouse daemon and other programs such as the
1869
X Window.  Refer to <xref linkend="x-and-moused" remap="another section"> 
1877
X Window.  Refer to <link linkend="x-and-moused">another section</link> 
1870
on this issue".</para>
1878
on this issue".</para>
1871
  
1879
  
1872
</answer></qandaentry>
1880
</answer></qandaentry>
Lines 1874-1880 Link Here
1874
<qandaentry><question>
1882
<qandaentry><question>
1875
<para>How do I cut and paste text with mouse in the text console?</para></question><answer>
1883
<para>How do I cut and paste text with mouse in the text console?</para></question><answer>
1876
1884
1877
<para>Once you get the mouse daemon running (see <xref linkend="moused" remap="previous section">), hold down the button 1 (left button) 
1885
<para>Once you get the mouse daemon running (see <link linkend="moused">previous section</link>), hold down the button 1 (left button) 
1878
and move the mouse to select a region of
1886
and move the mouse to select a region of
1879
text.  Then, press the button 2 (middle button) or the button 3 (right
1887
text.  Then, press the button 2 (middle button) or the button 3 (right
1880
button) to paste it at the text cursor.</para>
1888
button) to paste it at the text cursor.</para>
Lines 1977-1983 Link Here
1977
  
1985
  
1978
<para>In general this will not cause any problems, but there are
1986
<para>In general this will not cause any problems, but there are
1979
circumstances where you will take a hit, either in performance or
1987
circumstances where you will take a hit, either in performance or
1980
accuracy of the math emulation code (see the section <xref linkend="emul" remap="on FP emulation">).  In particular, drawing arcs in X will be
1988
accuracy of the math emulation code (see the section <link linkend="emul">on FP emulation</link>).  In particular, drawing arcs in X will be
1981
VERY slow.  It is highly recommended that you buy a math
1989
VERY slow.  It is highly recommended that you buy a math
1982
co-processor; it's well worth it.</para>
1990
co-processor; it's well worth it.</para>
1983
  
1991
  
Lines 2237-2243 Link Here
2237
to B-C, the default is A-B.</para>
2245
to B-C, the default is A-B.</para>
2238
  
2246
  
2239
<para>The 742a EISA cards never had the ``&gt;16MB'' problem mentioned in
2247
<para>The 742a EISA cards never had the ``&gt;16MB'' problem mentioned in
2240
the section <xref linkend="bigram" remap="on &gt;16 MB machines">. This is a
2248
the section <link linkend="bigram">on &gt;16 MB machines</link>. This is a
2241
problem that occurs with the Vesa-Local Buslogic SCSI cards.</para>
2249
problem that occurs with the Vesa-Local Buslogic SCSI cards.</para>
2242
  
2250
  
2243
</answer></qandaentry>
2251
</answer></qandaentry>
Lines 2987-2993 Link Here
2987
<para>Please take a look at <ulink URL="../ports/">the ports page</ulink> for info on software packages ported to
2995
<para>Please take a look at <ulink URL="../ports/">the ports page</ulink> for info on software packages ported to
2988
FreeBSD.  The list currently tops 1800 and is growing daily, so come
2996
FreeBSD.  The list currently tops 1800 and is growing daily, so come
2989
back to check often or subscribe to the <emphasis remap=tt>freebsd-announce</emphasis>
2997
back to check often or subscribe to the <emphasis remap=tt>freebsd-announce</emphasis>
2990
<xref linkend="mailing" remap="mailing list"> for periodic updates on new
2998
<link linkend="mailing">mailing list</link> for periodic updates on new
2991
entries.</para>
2999
entries.</para>
2992
  
3000
  
2993
<para>Most ports should be available for the 2.2, 3.x and 4.0
3001
<para>Most ports should be available for the 2.2, 3.x and 4.0
Lines 4807-4813 Link Here
4807
      </literallayout>
4815
      </literallayout>
4808
</para>
4816
</para>
4809
  
4817
  
4810
<para>See the section on <xref linkend="make-kernel" remap="building a kernel">
4818
<para>See the section on <link linkend="make-kernel">building a kernel</link>
4811
if you've no experience with building kernels.</para>
4819
if you've no experience with building kernels.</para>
4812
  
4820
  
4813
<para>With this option, there should be less chance of synchronization
4821
<para>With this option, there should be less chance of synchronization
Lines 4864-4870 Link Here
4864
<para>Unfortunately there is no workaround for versions 2.0.X and 
4872
<para>Unfortunately there is no workaround for versions 2.0.X and 
4865
2.1.X.  In versions 2.2 through 2.2.5, apply the following patch 
4873
2.1.X.  In versions 2.2 through 2.2.5, apply the following patch 
4866
to <filename>/sys/i386/isa/psm.c</filename> and rebuild the kernel.  See the 
4874
to <filename>/sys/i386/isa/psm.c</filename> and rebuild the kernel.  See the 
4867
section on <xref linkend="make-kernel" remap="building a kernel">
4875
section on <link linkend="make-kernel">building a kernel</link>
4868
if you've no experience with building kernels.</para>
4876
if you've no experience with building kernels.</para>
4869
  
4877
  
4870
<para>
4878
<para>
Lines 5062-5068 Link Here
5062
tell other systems on your network about your router; FreeBSD
5070
tell other systems on your network about your router; FreeBSD
5063
comes with the standard BSD routing daemon 
5071
comes with the standard BSD routing daemon 
5064
<ulink URL="http://www.FreeBSD.org/cgi/man.cgi?routed">routed</ulink>, or for more complex situations you may want to try
5072
<ulink URL="http://www.FreeBSD.org/cgi/man.cgi?routed">routed</ulink>, or for more complex situations you may want to try
5065
<emphasis>GaTeD</emphasis> (available by FTP from <filename>ftp.gated.Merit.EDU</filename>) which
5073
<emphasis>GaTeD</emphasis> (available from <ulink URL="http://www.gated.org/"> http://www.gated.org/ </ulink>) which
5066
supports FreeBSD as of 3_5Alpha7.</para>
5074
supports FreeBSD as of 3_5Alpha7.</para>
5067
  
5075
  
5068
<para>It is our duty to warn you that, even when FreeBSD is configured
5076
<para>It is our duty to warn you that, even when FreeBSD is configured
Lines 5093-5099 Link Here
5093
<ulink URL="http://www.tis.com/">the TIS firewall toolkit</ulink>
5101
<ulink URL="http://www.tis.com/">the TIS firewall toolkit</ulink>
5094
on your FreeBSD box.</para>
5102
on your FreeBSD box.</para>
5095
  
5103
  
5096
<para>See also the section on <xref linkend="natd" remap="natd">.</para>
5104
<para>See also the section on <link linkend="natd">natd</link>.</para>
5097
  
5105
  
5098
</answer></qandaentry>
5106
</answer></qandaentry>
5099
5107
Lines 6051-6057 Link Here
6051
trying to resolve a host name.  A lot of the time, 
6059
trying to resolve a host name.  A lot of the time, 
6052
<ulink URL="http://www.FreeBSD.org/cgi/man.cgi?sendmail">sendmail</ulink> is the culprit.  You should make sure that you tell
6060
<ulink URL="http://www.FreeBSD.org/cgi/man.cgi?sendmail">sendmail</ulink> is the culprit.  You should make sure that you tell
6053
sendmail not to do any DNS lookups in its configuration file.  See
6061
sendmail not to do any DNS lookups in its configuration file.  See
6054
the section on <xref linkend="ispmail" remap="Mail Configuration"> for
6062
the section on <link linkend="ispmail">Mail Configuration</link> for
6055
details on how to create your own configuration file and what should
6063
details on how to create your own configuration file and what should
6056
go into it.  You may also want to add the following line to your
6064
go into it.  You may also want to add the following line to your
6057
<filename>.mc</filename> file:</para>
6065
<filename>.mc</filename> file:</para>
Lines 6503-6518 Link Here
6503
</qandaset>
6511
</qandaset>
6504
</chapter>
6512
</chapter>
6505
6513
6506
6507
6508
6509
6510
6511
6512
6513
6514
6515
6516
<chapter
6514
<chapter
6517
id="serial">
6515
id="serial">
6518
<title>Serial Communications</title>
6516
<title>Serial Communications</title>
Lines 6558-6564 Link Here
6558
example.  If these settings aren't right for your system, or if
6556
example.  If these settings aren't right for your system, or if
6559
you've added modem cards or have more serial ports than your
6557
you've added modem cards or have more serial ports than your
6560
kernel is configured for, just reconfigure your kernel.  See
6558
kernel is configured for, just reconfigure your kernel.  See
6561
section <xref linkend="make-kernel" remap="about building a kernel"> for
6559
section <link linkend="make-kernel">about building a kernel</link> for
6562
more details.</para>
6560
more details.</para>
6563
  
6561
  
6564
</answer></qandaentry>
6562
</answer></qandaentry>
Lines 6706-6712 Link Here
6706
      </literallayout>
6704
      </literallayout>
6707
</para>
6705
</para>
6708
  
6706
  
6709
<para>See the section <xref linkend="direct-at" remap="on sending AT       commands"> below for information on how to make these settings
6707
<para>See the section <link linkend="direct-at">on sending AT commands</link> below for information on how to make these settings
6710
without resorting to an MS-DOS terminal program.</para>
6708
without resorting to an MS-DOS terminal program.</para>
6711
  
6709
  
6712
<para>Next, make an entry in <ulink URL="http://www.FreeBSD.org/cgi/man.cgi?ttys">/etc/ttys</ulink> for the
6710
<para>Next, make an entry in <ulink URL="http://www.FreeBSD.org/cgi/man.cgi?ttys">/etc/ttys</ulink> for the
Lines 6870-6879 Link Here
6870
</answer></qandaentry>
6868
</answer></qandaentry>
6871
6869
6872
<qandaentry><question>
6870
<qandaentry><question>
6873
<para>The <email>@</email> sign for the pn capability doesn't work!</para></question><answer>
6871
<para>The <emphasis remap=tt><@></emphasis> sign for the pn capability doesn't work!</para></question><answer>
6874
6872
6875
<para>The <email>@</email> sign in the phone number capability tells tip to look in
6873
<para>The <emphasis remap=tt><@></emphasis> sign in the phone number capability tells tip to look in
6876
<ulink URL="http://www.FreeBSD.org/cgi/man.cgi?phones(5)">/etc/phones</ulink> for a phone number.  But the <email>@</email> sign is
6874
<ulink URL="http://www.FreeBSD.org/cgi/man.cgi?phones(5)">/etc/phones</ulink> for a phone number.  But the <emphasis remap=tt><@></emphasis> sign is
6877
also a special character in capability files like
6875
also a special character in capability files like
6878
<ulink URL="http://www.FreeBSD.org/cgi/man.cgi?remote">/etc/remote</ulink>.  Escape it with a backslash:</para>
6876
<ulink URL="http://www.FreeBSD.org/cgi/man.cgi?remote">/etc/remote</ulink>.  Escape it with a backslash:</para>
6879
  
6877
  
Lines 6953-6959 Link Here
6953
and several thousand students trying to use them...</para>
6951
and several thousand students trying to use them...</para>
6954
  
6952
  
6955
<para>Make an entry for your university in <ulink URL="http://www.FreeBSD.org/cgi/man.cgi?remote">/etc/remote</ulink>
6953
<para>Make an entry for your university in <ulink URL="http://www.FreeBSD.org/cgi/man.cgi?remote">/etc/remote</ulink>
6956
and use <email>\@</email> for the <emphasis remap=tt>pn</emphasis> capability:</para>
6954
and use <emphasis remap=tt><\@></emphasis> for the <emphasis remap=tt>pn</emphasis> capability:</para>
6957
  
6955
  
6958
<para>
6956
<para>
6959
<literallayout>        big-university:\
6957
<literallayout>        big-university:\
Lines 7821-7833 Link Here
7821
number of working ports and packages.
7819
number of working ports and packages.
7822
FreeBSD/AXP should be considered BETA quality software at this
7820
FreeBSD/AXP should be considered BETA quality software at this
7823
time.  For status information, please join the
7821
time.  For status information, please join the
7824
<email>&lt;freebsd-alpha@FreeBSD.org&gt;</email><xref linkend="mailing" remap="mailing list">.</para>
7822
<email>freebsd-alpha@FreeBSD.org</email><link linkend="mailing">mailing list</link>.</para>
7825
  
7823
  
7826
<para>Interest has also been expressed in a port of FreeBSD to
7824
<para>Interest has also been expressed in a port of FreeBSD to
7827
the SPARC architecture, join the <email>&lt;freebsd-sparc@FreeBSD.org&gt;</email><xref linkend="mailing" remap="mailing list"> if you are interested
7825
the SPARC architecture, join the <email>freebsd-sparc@FreeBSD.org</email><link linkend="mailing">mailing list</link> if you are interested
7828
in joining that project.  For general discussion on new architectures,
7826
in joining that project.  For general discussion on new architectures,
7829
join the <email>&lt;freebsd-platforms@FreeBSD.org&gt;</email>
7827
join the <email>freebsd-platforms@FreeBSD.org</email>
7830
<xref linkend="mailing" remap="mailing list">.</para>
7828
<link linkend="mailing">mailing list</link>.</para>
7831
  
7829
  
7832
</answer></qandaentry>
7830
</answer></qandaentry>
7833
7831
Lines 7843-7849 Link Here
7843
character major number 32 and block major number 8 have been reserved
7841
character major number 32 and block major number 8 have been reserved
7844
specifically for this purpose; please use them.  In any case, we'd
7842
specifically for this purpose; please use them.  In any case, we'd
7845
appreciate hearing about your driver on
7843
appreciate hearing about your driver on
7846
<email>&lt;freebsd-hackers@FreeBSD.org&gt;</email>.</para>
7844
<email>freebsd-hackers@FreeBSD.org</email>.</para>
7847
  
7845
  
7848
</answer></qandaentry>
7846
</answer></qandaentry>
7849
7847
Lines 7879-7885 Link Here
7879
7877
7880
<para>      
7878
<para>      
7881
<emphasis>[This section was extracted from a mail written by <ulink URL="mailto:wpaul@FreeBSD.org">Bill Paul</ulink> on the
7879
<emphasis>[This section was extracted from a mail written by <ulink URL="mailto:wpaul@FreeBSD.org">Bill Paul</ulink> on the
7882
freebsd-current <xref linkend="mailing" remap="mailing list"> by <ulink URL="mailto:des@FreeBSD.org">Dag-Erling Co&iuml;dan       Sm&oslash;rgrav</ulink>, who fixed a few typos and added the bracketed
7880
freebsd-current <link linkend="mailing">mailing list</link> by <ulink URL="mailto:des@FreeBSD.org">Dag-Erling Co&iuml;dan       Sm&oslash;rgrav</ulink>, who fixed a few typos and added the bracketed
7883
comments]</emphasis></para>
7881
comments]</emphasis></para>
7884
  
7882
  
7885
<para>
7883
<para>

Return to bug 13411