Date: Sat, 28 Aug 1999 00:58:30 +0800 (CST) From: Foxfair Hu <foxfair@drago.cert.org.tw> To: FreeBSD-gnats-submit@freebsd.org Subject: docs/13411: Update book.sgml of en_US.ISO_8859-1/books/faq Message-ID: <199908271658.AAA31552@drago.cert.org.tw>
next in thread | raw e-mail | index | archive | help
>Number: 13411 >Category: docs >Synopsis: Update book.sgml of en_US.ISO_8859-1/books/faq >Confidential: no >Severity: non-critical >Priority: low >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: doc-bug >Submitter-Id: current-users >Arrival-Date: Fri Aug 27 10:10:00 PDT 1999 >Closed-Date: >Last-Modified: >Originator: Foxfair Hu >Release: FreeBSD 4.0-CURRENT i386 >Organization: >Environment: FreeBSD 4.0-CURRENT i386. doc tree update to 1999/8/26. >Description: 1. I made some changes to the FAQ file, the old one will make some strange link (Like this : "Q:Q:") in the html files. So change <xref...> to <link ...>. 2. In the Chapter 9, Networking section, there is a wrong link. GaTeD has a new location now.(http://www.gated.org/). 3. Fix a weird <email>@</email> tag, It looks like we just need a single "@" but not to mail somebody anonymous. I proposed to use <emphasis remap=tt><@></emphasis> instead of <email>@</email>. 4. Others changes, too long and trivial to say, see the patch. >How-To-Repeat: Go to http://www.FreeBSD.org/FAQ/ and pick up [networking,ppp,else] chapters , you will see the Q: Q: links and something wrong. >Fix: Apply this patch, it has 339 lines and need *somebody else* to check it :-) --- book.sgml.org Fri Aug 27 23:54:27 1999 +++ book.sgml Sat Aug 28 00:37:46 1999 @@ -133,8 +133,8 @@ <emphasis>-current</emphasis> if you're sure that you're prepared for its increased volatility (relative to <emphasis>-stable</emphasis>, that is).</para> -<para>Releases are only made <xref linkend="release-freq" remap="every few months">. While many people stay more up-to-date with the -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 +<para>Releases are only made <link linkend="release-freq">every few months</link>. While many people stay more up-to-date with the +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 commitment, as the sources are a moving target.</para> </answer></qandaentry> @@ -300,7 +300,7 @@ FreeBSD source tree.</para> <para>However, most non-trivial changes are discussed in advance in the -<xref linkend="mailing" remap="mailing lists">, and there are no restrictions +<link linkend="mailing">mailing lists</link>, and there are no restrictions on who may take part in the discussion.</para> </answer></qandaentry> @@ -346,7 +346,7 @@ <listitem> <para><ulink URL="ftp://current.FreeBSD.org/pub/FreeBSD/">4.0 Snapshot</ulink> releases are made once a day for the -<xref linkend="current" remap="-current"> branch, these being of service +<link linkend="current">-current</link> branch, these being of service purely to bleeding-edge testers and developers.</para> </listitem> @@ -355,38 +355,46 @@ <para>FreeBSD is also available via CDROM, from the following place(s):</para> -<para>Walnut Creek CDROM<!-- <br> --> -4041 Pike Lane, Suite F<!-- <br> --> -Concord, CA 94520 USA<!-- <br> --> -Orders: +1 800 786-9907<!-- <br> --> -Questions: +1 925 674-0783<!-- <br> --> -FAX: +1 925 674-0821<!-- <br> --> -email: <ulink URL="mailto:orders@cdrom.com">WC Orders address</ulink><!-- <br> --> -WWW: <ulink URL="http://www.cdrom.com/">WC Home page</ulink><!-- <br> --></para> +<para><literallayout> + Walnut Creek CDROM + 4041 Pike Lane, Suite F + Concord, CA 94520 USA + Orders: +1 800 786-9907 + Questions: +1 925 674-0783 + FAX: +1 925 674-0821 + email: <ulink URL="mailto:orders@cdrom.com">WC Orders address</ulink> + WWW: <ulink URL="http://www.cdrom.com/">WC Home page</ulink> +</literallayout></para> <para>In Australia, you may find it at:</para> -<para>Advanced Multimedia Distributors<!-- <br> --> -Factory 1/1 Ovata Drive<!-- <br> --> -Tullamarine, Melbourne<!-- <br> --> -Victoria<!-- <br> --> -Australia<!-- <br> --> -Voice: +61 3 9338 6777<!-- <br> --></para> - -<para>CDROM Support BBS<!-- <br> --> -17 Irvine St<!-- <br> --> -Peppermint Grove WA 6011<!-- <br> --> -Voice: +61 9 385-3793<!-- <br> --> -Fax: +61 9 385-2360<!-- <br> --></para> +<para><literallayout> + Advanced Multimedia Distributors + Factory 1/1 Ovata Drive + Tullamarine, Melbourne + Victoria + Australia + Voice: +61 3 9338 6777 +</literallayout></para> + +<para><literallayout> + CDROM Support BBS + 17 Irvine St + Peppermint Grove WA 6011 + Voice: +61 9 385-3793 + Fax: +61 9 385-2360 +</literallayout></para> <para>And in the UK:</para> -<para>The Public Domain & Shareware Library<!-- <br> --> -Winscombe House, Beacon Rd<!-- <br> --> -Crowborough<!-- <br> --> -Sussex. TN6 1UL<!-- <br> --> -Voice: +44 1892 663-298<!-- <br> --> -Fax: +44 1892 667-473<!-- <br> --></para> +<para><literallayout> + The Public Domain & Shareware Library + Winscombe House, Beacon Rd + Crowborough + Sussex. TN6 1UL + Voice: +44 1892 663-298 + Fax: +44 1892 667-473 +</literallayout></para> </answer></qandaentry> @@ -950,7 +958,7 @@ that's supposed to let you *just* make those floppies, but it's not really gelled yet.</para> -<para>To make a custom release, follow the instructions <xref linkend="custrel" remap="here">.</para> +<para>To make a custom release, follow the instructions <link linkend="custrel">here</link>.</para> </answer></qandaentry> @@ -1024,7 +1032,7 @@ That said, it does work on thousands of IDE based systems, so you'd do well to try it first before simply giving up.</para> -<para>If you have a SCSI drive with bad blocks, see <xref linkend="awre" remap="this answer">.</para> +<para>If you have a SCSI drive with bad blocks, see <link linkend="awre">this answer</link>.</para> </answer></qandaentry> @@ -1305,7 +1313,7 @@ </para></question><answer> <para>This is classically a case of FreeBSD and DOS or some other OS -conflicting over their ideas of disk <xref linkend="geometry" remap="geometry."> You will have to reinstall FreeBSD, but obeying the +conflicting over their ideas of disk <link linkend="geometry">geometry</link>. You will have to reinstall FreeBSD, but obeying the instructions given above will almost always get you going.</para> </answer></qandaentry> @@ -1332,7 +1340,7 @@ ISA devices, although one or two broken EISA and VLB devices may need it as well).</para> -<para>Also look at the section on <xref linkend="reallybigram" remap=">64M machines"> if you have that much memory, +<para>Also look at the section on <link linkend="reallybigram">>64M machines</link> if you have that much memory, or if you're using a Compaq or other BIOS that lies about the available memory.</para> @@ -1456,12 +1464,12 @@ current versions can generally be obtained by anonymous FTP from <filename>braae.ru.ac.za</filename>.</para> -<para>There is also a <xref linkend="mailing" remap="mailing list"> for the +<para>There is also a <link linkend="mailing">mailing list</link> for the discussion of non-US encryption software. For more information, send an email message with a single line saying ``<emphasis remap=tt>help</emphasis>'' in the body of your message to</para> -<para><email><majordomo@braae.ru.ac.za></email>.</para> +<para><email>majordomo@braae.ru.ac.za</email>.</para> </answer></qandaentry> @@ -1866,7 +1874,7 @@ <para>When the mouse daemon is running, access to the mouse needs to be coordinated between the mouse daemon and other programs such as the -X Window. Refer to <xref linkend="x-and-moused" remap="another section"> +X Window. Refer to <link linkend="x-and-moused">another section</link> on this issue".</para> </answer></qandaentry> @@ -1874,7 +1882,7 @@ <qandaentry><question> <para>How do I cut and paste text with mouse in the text console?</para></question><answer> -<para>Once you get the mouse daemon running (see <xref linkend="moused" remap="previous section">), hold down the button 1 (left button) +<para>Once you get the mouse daemon running (see <link linkend="moused">previous section</link>), hold down the button 1 (left button) and move the mouse to select a region of text. Then, press the button 2 (middle button) or the button 3 (right button) to paste it at the text cursor.</para> @@ -1977,7 +1985,7 @@ <para>In general this will not cause any problems, but there are circumstances where you will take a hit, either in performance or -accuracy of the math emulation code (see the section <xref linkend="emul" remap="on FP emulation">). In particular, drawing arcs in X will be +accuracy of the math emulation code (see the section <link linkend="emul">on FP emulation</link>). In particular, drawing arcs in X will be VERY slow. It is highly recommended that you buy a math co-processor; it's well worth it.</para> @@ -2237,7 +2245,7 @@ to B-C, the default is A-B.</para> <para>The 742a EISA cards never had the ``>16MB'' problem mentioned in -the section <xref linkend="bigram" remap="on >16 MB machines">. This is a +the section <link linkend="bigram">on >16 MB machines</link>. This is a problem that occurs with the Vesa-Local Buslogic SCSI cards.</para> </answer></qandaentry> @@ -2987,7 +2995,7 @@ <para>Please take a look at <ulink URL="../ports/">the ports page</ulink> for info on software packages ported to FreeBSD. The list currently tops 1800 and is growing daily, so come back to check often or subscribe to the <emphasis remap=tt>freebsd-announce</emphasis> -<xref linkend="mailing" remap="mailing list"> for periodic updates on new +<link linkend="mailing">mailing list</link> for periodic updates on new entries.</para> <para>Most ports should be available for the 2.2, 3.x and 4.0 @@ -4807,7 +4815,7 @@ </literallayout> </para> -<para>See the section on <xref linkend="make-kernel" remap="building a kernel"> +<para>See the section on <link linkend="make-kernel">building a kernel</link> if you've no experience with building kernels.</para> <para>With this option, there should be less chance of synchronization @@ -4864,7 +4872,7 @@ <para>Unfortunately there is no workaround for versions 2.0.X and 2.1.X. In versions 2.2 through 2.2.5, apply the following patch to <filename>/sys/i386/isa/psm.c</filename> and rebuild the kernel. See the -section on <xref linkend="make-kernel" remap="building a kernel"> +section on <link linkend="make-kernel">building a kernel</link> if you've no experience with building kernels.</para> <para> @@ -5062,7 +5070,7 @@ tell other systems on your network about your router; FreeBSD comes with the standard BSD routing daemon <ulink URL="http://www.FreeBSD.org/cgi/man.cgi?routed">routed</ulink>, or for more complex situations you may want to try -<emphasis>GaTeD</emphasis> (available by FTP from <filename>ftp.gated.Merit.EDU</filename>) which +<emphasis>GaTeD</emphasis> (available from <ulink URL="http://www.gated.org/">; http://www.gated.org/ </ulink>) which supports FreeBSD as of 3_5Alpha7.</para> <para>It is our duty to warn you that, even when FreeBSD is configured @@ -5093,7 +5101,7 @@ <ulink URL="http://www.tis.com/">the TIS firewall toolkit</ulink> on your FreeBSD box.</para> -<para>See also the section on <xref linkend="natd" remap="natd">.</para> +<para>See also the section on <link linkend="natd">natd</link>.</para> </answer></qandaentry> @@ -6051,7 +6059,7 @@ trying to resolve a host name. A lot of the time, <ulink URL="http://www.FreeBSD.org/cgi/man.cgi?sendmail">sendmail</ulink>; is the culprit. You should make sure that you tell sendmail not to do any DNS lookups in its configuration file. See -the section on <xref linkend="ispmail" remap="Mail Configuration"> for +the section on <link linkend="ispmail">Mail Configuration</link> for details on how to create your own configuration file and what should go into it. You may also want to add the following line to your <filename>.mc</filename> file:</para> @@ -6503,16 +6511,6 @@ </qandaset> </chapter> - - - - - - - - - - <chapter id="serial"> <title>Serial Communications</title> @@ -6558,7 +6556,7 @@ example. If these settings aren't right for your system, or if you've added modem cards or have more serial ports than your kernel is configured for, just reconfigure your kernel. See -section <xref linkend="make-kernel" remap="about building a kernel"> for +section <link linkend="make-kernel">about building a kernel</link> for more details.</para> </answer></qandaentry> @@ -6706,7 +6704,7 @@ </literallayout> </para> -<para>See the section <xref linkend="direct-at" remap="on sending AT commands"> below for information on how to make these settings +<para>See the section <link linkend="direct-at">on sending AT commands</link> below for information on how to make these settings without resorting to an MS-DOS terminal program.</para> <para>Next, make an entry in <ulink URL="http://www.FreeBSD.org/cgi/man.cgi?ttys">/etc/ttys</ulink>; for the @@ -6870,10 +6868,10 @@ </answer></qandaentry> <qandaentry><question> -<para>The <email>@</email> sign for the pn capability doesn't work!</para></question><answer> +<para>The <emphasis remap=tt><@></emphasis> sign for the pn capability doesn't work!</para></question><answer> -<para>The <email>@</email> sign in the phone number capability tells tip to look in -<ulink URL="http://www.FreeBSD.org/cgi/man.cgi?phones(5)">/etc/phones</ulink>; for a phone number. But the <email>@</email> sign is +<para>The <emphasis remap=tt><@></emphasis> sign in the phone number capability tells tip to look in +<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 also a special character in capability files like <ulink URL="http://www.FreeBSD.org/cgi/man.cgi?remote">/etc/remote</ulink>. Escape it with a backslash:</para> @@ -6953,7 +6951,7 @@ and several thousand students trying to use them...</para> <para>Make an entry for your university in <ulink URL="http://www.FreeBSD.org/cgi/man.cgi?remote">/etc/remote</ulink>; -and use <email>\@</email> for the <emphasis remap=tt>pn</emphasis> capability:</para> +and use <emphasis remap=tt><\@></emphasis> for the <emphasis remap=tt>pn</emphasis> capability:</para> <para> <literallayout> big-university:\ @@ -7821,13 +7819,13 @@ number of working ports and packages. FreeBSD/AXP should be considered BETA quality software at this time. For status information, please join the -<email><freebsd-alpha@FreeBSD.org></email><xref linkend="mailing" remap="mailing list">.</para> +<email>freebsd-alpha@FreeBSD.org</email><link linkend="mailing">mailing list</link>.</para> <para>Interest has also been expressed in a port of FreeBSD to -the SPARC architecture, join the <email><freebsd-sparc@FreeBSD.org></email><xref linkend="mailing" remap="mailing list"> if you are interested +the SPARC architecture, join the <email>freebsd-sparc@FreeBSD.org</email><link linkend="mailing">mailing list</link> if you are interested in joining that project. For general discussion on new architectures, -join the <email><freebsd-platforms@FreeBSD.org></email> -<xref linkend="mailing" remap="mailing list">.</para> +join the <email>freebsd-platforms@FreeBSD.org</email> +<link linkend="mailing">mailing list</link>.</para> </answer></qandaentry> @@ -7843,7 +7841,7 @@ character major number 32 and block major number 8 have been reserved specifically for this purpose; please use them. In any case, we'd appreciate hearing about your driver on -<email><freebsd-hackers@FreeBSD.org></email>.</para> +<email>freebsd-hackers@FreeBSD.org</email>.</para> </answer></qandaentry> @@ -7879,7 +7877,7 @@ <para> <emphasis>[This section was extracted from a mail written by <ulink URL="mailto:wpaul@FreeBSD.org">Bill Paul</ulink> on the -freebsd-current <xref linkend="mailing" remap="mailing list"> by <ulink URL="mailto:des@FreeBSD.org">Dag-Erling Coïdan Smørgrav</ulink>, who fixed a few typos and added the bracketed +freebsd-current <link linkend="mailing">mailing list</link> by <ulink URL="mailto:des@FreeBSD.org">Dag-Erling Coïdan Smørgrav</ulink>, who fixed a few typos and added the bracketed comments]</emphasis></para> <para> >Release-Note: >Audit-Trail: >Unformatted: To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?199908271658.AAA31552>