diff options
author | Nik Clayton <nik@FreeBSD.org> | 1998-10-21 21:48:30 +0000 |
---|---|---|
committer | Nik Clayton <nik@FreeBSD.org> | 1998-10-21 21:48:30 +0000 |
commit | ce7ee35d241fad03c8bd869f125a4fb167b1be2f (patch) | |
tree | 2c8d868ea9e4f796e8984fc4253b245282dc76fc /en/handbook | |
parent | a28fe9ff33ccbb36b2695cde6f22643cc28b2a35 (diff) | |
download | doc-ce7ee35d241fad03c8bd869f125a4fb167b1be2f.tar.gz doc-ce7ee35d241fad03c8bd869f125a4fb167b1be2f.zip |
Finished sweep. If it's white space sensitive (examples, program
listings, PGP signatures...) the white space is now correct. I may
have missed one or two on the way, I'll catch them later.
Notes
Notes:
svn path=/head/; revision=3645
Diffstat (limited to 'en/handbook')
-rw-r--r-- | en/handbook/README | 4 | ||||
-rw-r--r-- | en/handbook/handbook.sgml | 4014 |
2 files changed, 2930 insertions, 1088 deletions
diff --git a/en/handbook/README b/en/handbook/README index dce776065f..9533747850 100644 --- a/en/handbook/README +++ b/en/handbook/README @@ -358,3 +358,7 @@ for example, 32. Continuing the work from the previous commit. This takes us up to the beginning of Chapter 16, "The Cutting Edge". + + 33. Finished sweep. If it's white space sensitive (examples, program + listings, PGP signatures...) the white space is now correct. I may + have missed one or two on the way, I'll catch them later. diff --git a/en/handbook/handbook.sgml b/en/handbook/handbook.sgml index ccd75e552f..1d16054aab 100644 --- a/en/handbook/handbook.sgml +++ b/en/handbook/handbook.sgml @@ -25278,8 +25278,12 @@ an A record in the DNS for "customer.com".</programlisting> to see the commit log entry for each change as it is made along with any pertinent information on possible side-effects. To join these lists, send mail to - &a.majordomo; and specify: <literallayout>subscribe - freebsd-current subscribe cvs-all</literallayout> In the + &a.majordomo; and specify: + + <programlisting> +subscribe freebsd-current +subscribe cvs-all + </programlisting> In the body of your message. Optionally, you can also say `help' and Majordomo will send you full help on how to subscribe and unsubscribe to the various other mailing lists we @@ -25310,7 +25314,16 @@ an A record in the DNS for "customer.com".</programlisting> <listitem> <para> Use ftp. The source tree for FreeBSD-current is always <quote>exported</quote> on: <ulink - URL="ftp://ftp.FreeBSD.ORG/pub/FreeBSD/FreeBSD-current">ftp://ftp.FreeBSD.ORG/pub/FreeBSD/FreeBSD-current</ulink> We also use `wu-ftpd' which allows compressed/tar'd grabbing of whole trees. e.g. you see: <literallayout> usr.bin/lex</literallayout> You can do: <literallayout> ftp> cd usr.bin ftp> get lex.tar.Z</literallayout> And it will get the whole directory for you as a compressed tar file.</para> + URL="ftp://ftp.FreeBSD.ORG/pub/FreeBSD/FreeBSD-current">ftp://ftp.FreeBSD.ORG/pub/FreeBSD/FreeBSD-current</ulink> We also use `wu-ftpd' which allows compressed/tar'd grabbing of whole trees. e.g. you see: + + <informalexample> + <screen>usr.bin/lex</screen> + </informalexample> You can do: + + <informalexample> + <screen><prompt>ftp></prompt> <userinput>cd usr.bin</userinput> +<prompt>ftp></prompt> <userinput>get lex.tar.Z</userinput></screen> + </informalexample> And it will get the whole directory for you as a compressed tar file.</para> </listitem> </orderedlist> @@ -25418,8 +25431,11 @@ an A record in the DNS for "customer.com".</programlisting> controversial fix or update, giving the users a chance to respond if they have any issues to raise concerning the proposed change. To join this list, send mail to - &a.majordomo; and say: <literallayout> subscribe - freebsd-stable</literallayout> In the body of your + &a.majordomo; and say: + + <programlisting> +subscribe freebsd-stable + </programlisting> In the body of your message. Optionally, you can also say `help' and Majordomo will send you full help on how to subscribe and unsubscribe to the various other mailing lists we support. @@ -25455,10 +25471,16 @@ an A record in the DNS for "customer.com".</programlisting> <para>We also use `wu-ftpd' which allows compressed/tar'd grabbing of whole trees. e.g. you - see: <literallayout> - usr.bin/lex</literallayout> You can do: - <literallayout> ftp> cd usr.bin ftp> - get lex.tar.Z</literallayout> And it will get the + see: + + <informalexample> + <screen>usr.bin/lex</screen> + </informalexample> You can do: + + <informalexample> + <screen><prompt>ftp></prompt> <userinput>cd usr.bin</userinput> +<prompt>ftp></prompt> <userinput>get lex.tar.Z</userinput></screen> + </informalexample> And it will get the whole directory for you as a compressed tar file.</para> </listitem> @@ -25687,10 +25709,8 @@ an A record in the DNS for "customer.com".</programlisting> <para>To apply the deltas, simply say: <informalexample> - <screen>&prompt.root; cd /where/ever/you/want/the/stuff - &prompt.root; ctm -v -v - /where/you/store/your/deltas/src-xxx.* - </screen> + <screen>&prompt.root; <userinput>cd /where/ever/you/want/the/stuff</userinput> +&prompt.root; <userinput>ctm -v -v /where/you/store/your/deltas/src-xxx.*</userinput></screen> </informalexample> </para> @@ -25789,10 +25809,8 @@ an A record in the DNS for "customer.com".</programlisting> <filename>lib/libc/Makefile</filename> from your collection of saved CTM deltas, run the commands: <informalexample> - <screen>&prompt.root; cd /where/ever/you/want/to/extract/it/ - &prompt.root; ctm -e - '^lib/libc/Makefile' ~ctm/src-xxx.* - </screen> + <screen>&prompt.root; <userinput>cd /where/ever/you/want/to/extract/it/</userinput> +&prompt.root; <userinput>ctm -e '^lib/libc/Makefile' ~ctm/src-xxx.*</userinput></screen> </informalexample> </para> @@ -26143,9 +26161,10 @@ an A record in the DNS for "customer.com".</programlisting> step toward constructing our <filename>supfile</filename>, we simply list these collections, one per line:</para> - <para> - <literallayout> src-all cvs-crypto</literallayout> - </para> + <programlisting> +src-all +cvs-crypto + </programlisting> </listitem> <listitem> @@ -26334,9 +26353,9 @@ an A record in the DNS for "customer.com".</programlisting> We add this line at the beginning of our <filename>supfile</filename>:</para> - <para> - <literallayout> *default tag=.</literallayout> - </para> + <programlisting> +*default tag=. + </programlisting> <para>There is an important special case that comes into play if you specify neither a <option>tag=</option> field nor a <option>date=</option> @@ -26364,10 +26383,9 @@ an A record in the DNS for "customer.com".</programlisting> primary FreeBSD distribution site, "cvsup.FreeBSD.org":</para> - <para> - <literallayout> *default - host=cvsup.FreeBSD.org</literallayout> - </para> + <programlisting> +*default host=cvsup.FreeBSD.org + </programlisting> <para>On any particular run of cvsup, you can override this setting on the command line, with <option>-h hostname</option>.</para> @@ -26386,9 +26404,9 @@ an A record in the DNS for "customer.com".</programlisting> chosen to receive, so this is the correct specification:</para> - <para> - <literallayout> *default prefix=/usr</literallayout> - </para> + <programlisting> +*default prefix=/usr + </programlisting> </listitem> <listitem> @@ -26403,10 +26421,9 @@ an A record in the DNS for "customer.com".</programlisting> updates you have already received. We will use the standard base directory, <filename>/usr/local/etc/cvsup</filename>:</para> - <para> - <literallayout> *default - base=/usr/local/etc/cvsup</literallayout> - </para> + <programlisting> +*default base=/usr/local/etc/cvsup + </programlisting> <para>This setting is used by default if it is not specified in the <filename>supfile</filename>, so we actually do not @@ -26425,29 +26442,28 @@ an A record in the DNS for "customer.com".</programlisting> <para>There is one more line of boiler plate that normally needs to be present in the <filename>supfile</filename>:</para> - <para> - <literallayout> *default release=cvs delete - use-rel-suffix compress</literallayout> - </para> + <programlisting> +*default release=cvs delete use-rel-suffix compress + </programlisting> - <para><option>release=cvs</option> indicates that the server should get its + <para><literal>release=cvs</literal> indicates that the server should get its information out of the main FreeBSD CVS repository. This is virtually always the case, but there are other possibilities which are beyond the scope of this discussion.</para> - <para><option>delete</option> gives CVSup permission to delete files. You + <para><literal>delete</literal> gives CVSup permission to delete files. You should always specify this, so that CVSup can keep your source tree fully up to date. CVSup is careful to delete only those files for which it is responsible. Any extra files you happen to have will be left strictly alone.</para> - <para><option>use-rel-suffix</option> is ... arcane. If you really want to + <para><literal>use-rel-suffix</literal> is ... arcane. If you really want to know about it, see the <citerefentry><refentrytitle>cvsup</refentrytitle><manvolnum>1</manvolnum></citerefentry> manual page. Otherwise, just specify it and do not worry about it.</para> - <para><option>compress</option> enables the use of gzip-style compression + <para><literal>compress</literal> enables the use of gzip-style compression on the communication channel. If your network link is T1 speed or faster, you probably should not use compression. Otherwise, it helps substantially.</para> @@ -26461,13 +26477,16 @@ an A record in the DNS for "customer.com".</programlisting> <para>Here is the entire <filename>supfile</filename> for our example:</para> - <para> - <literallayout> *default tag=. *default - host=cvsup.FreeBSD.org *default prefix=/usr *default - base=/usr/local/etc/cvsup *default release=cvs delete - use-rel-suffix compress src-all - cvs-crypto</literallayout> - </para> + <programlisting> +*default tag=. +*default host=cvsup.FreeBSD.org +*default prefix=/usr +*default base=/usr/local/etc/cvsup +*default release=cvs delete use-rel-suffix compress + +src-all +cvs-crypto + </programlisting> </listitem> </itemizedlist> @@ -26481,9 +26500,9 @@ an A record in the DNS for "customer.com".</programlisting> <para>You are now ready to try an update. The command line for doing this is quite simple:</para> - <para> - <literallayout> cvsup supfile</literallayout> - </para> + <informalexample> + <screen>&prompt.root; <userinput>cvsup supfile</userinput></screen> + </informalexample> <para>where <filename>supfile</filename> is of course the name of the supfile you have just created. Assuming you are running under X11, cvsup @@ -26500,10 +26519,10 @@ an A record in the DNS for "customer.com".</programlisting> convenient, and name it as an extra argument on the command line:</para> - <para> - <literallayout> mkdir /var/tmp/dest cvsup supfile - /var/tmp/dest</literallayout> - </para> + <informalexample> + <screen>&prompt.root; <userinput>mkdir /var/tmp/dest</userinput> +&prompt.root; <userinput>cvsup supfile /var/tmp/dest</userinput></screen> + </informalexample> <para>The directory you specify will be used as the destination directory for all file updates. CVSup will examine your usual @@ -26520,9 +26539,9 @@ an A record in the DNS for "customer.com".</programlisting> you should add a couple of options to the command line when you run cvsup:</para> - <para> - <literallayout> cvsup -g -L 2 supfile</literallayout> - </para> + <informalexample> + <screen>&prompt.root; <userinput>cvsup -g -L 2 supfile</userinput></screen> + </informalexample> <para>The <option>-g</option> tells cvsup not to use its GUI. This is automatic if you are not running X11, but otherwise you have to specify @@ -27940,10 +27959,10 @@ an A record in the DNS for "customer.com".</programlisting> the <citerefentry><refentrytitle>diff</refentrytitle><manvolnum>1</manvolnum></citerefentry> command, with the `context diff' form being preferred. For example: <informalexample> - <screen>&prompt.user; diff -c oldfile newfile</screen> + <screen>&prompt.user; <userinput>diff -c oldfile newfile</userinput></screen> </informalexample> or <informalexample> - <screen>&prompt.user; diff -c -r olddir newdir</screen> + <screen>&prompt.user; <userinput>diff -c -r olddir newdir</userinput></screen> </informalexample> would generate such a set of context diffs for the given source file or directory hierarchy. See the man page for <citerefentry><refentrytitle>diff</refentrytitle><manvolnum>1</manvolnum></citerefentry> for more details.</para> @@ -28034,33 +28053,36 @@ an A record in the DNS for "customer.com".</programlisting> <para>To place a <quote>BSD-style</quote> copyright on your work, include the following text at the very beginning of every source code file you - wish to protect, replacing the text between the <literal>%%</literal> with the appropriate information. - <informalexample> - <screen>Copyright (c) %%proper_years_here%% %%your_name_here%%, - %%your_state%% %%your_zip%%. All rights reserved. - Redistribution and use in source and binary forms, with or - without modification, are permitted provided that the - following conditions are met: 1. Redistributions of source - code must retain the above copyright notice, this list of - conditions and the following disclaimer as the first lines of - this file unmodified. 2. Redistributions in binary form must - reproduce the above copyright notice, this list of conditions - and the following disclaimer in the documentation and/or other - materials provided with the distribution. THIS SOFTWARE IS - PROVIDED BY %%your_name_here%% ``AS IS'' AND ANY EXPRESS OR - IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED - WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR - PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL %%your_name_here%% - BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, - EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT - LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS - OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER - CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, - STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) - ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF - ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. - $Id$</screen> - </informalexample> For your convenience, a copy of this text can + wish to protect, replacing the text between the + <literal>%%</literal> with the appropriate information. + + <programlisting> +Copyright (c) %%proper_years_here%% + %%your_name_here%%, %%your_state%% %%your_zip%%. All rights reserved. + +Redistribution and use in source and binary forms, with or without +modification, are permitted provided that the following conditions +are met: +1. Redistributions of source code must retain the above copyright + notice, this list of conditions and the following disclaimer as + the first lines of this file unmodified. +2. Redistributions in binary form must reproduce the above copyright + notice, this list of conditions and the following disclaimer in the + documentation and/or other materials provided with the distribution. + +THIS SOFTWARE IS PROVIDED BY %%your_name_here%% ``AS IS'' AND ANY EXPRESS OR +IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES +OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. +IN NO EVENT SHALL %%your_name_here%% BE LIABLE FOR ANY DIRECT, INDIRECT, +INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT +NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, +DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY +THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF +THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + + $Id$ + </programlisting> For your convenience, a copy of this text can be found in <filename>/usr/share/examples/etc/bsd-style-copyright</filename>.</para> @@ -28124,12 +28146,11 @@ an A record in the DNS for "customer.com".</programlisting> <filename><sys/param.h></filename>. Hopefully that file is already included; if not, add the code:</para> - <para> - <informalexample> - <screen>#ifdef (defined(__unix__) || defined(unix)) && - !defined(USG) #include <sys/param.h> #endif</screen> - </informalexample> - </para> + <programlisting> +#ifdef (defined(__unix__) || defined(unix)) && !defined(USG) +#include <sys/param.h> +#endif + </programlisting> <para>to the proper place in the <filename>.c</filename> file. We believe that every system that defines these to symbols has @@ -28140,12 +28161,11 @@ an A record in the DNS for "customer.com".</programlisting> <para>Another way is to use the GNU Autoconf style of doing this:</para> - <para> - <informalexample> - <screen>#ifdef HAVE_SYS_PARAM_H #include <sys/param.h> - #endif</screen> - </informalexample> - </para> + <programlisting> +#ifdef HAVE_SYS_PARAM_H +#include <sys/param.h> +#endif + </programlisting> <para>Don't forget to add <symbol>-DHAVE_SYS_PARAM_H</symbol> to the <acronym>CFLAGS</acronym> in the Makefile for this @@ -28154,12 +28174,9 @@ an A record in the DNS for "customer.com".</programlisting> <para>Once you have <filename>sys/param.h</filename> included, you may use:</para> - <para> - <informalexample> - <screen>#if (defined(BSD) && (BSD >= - 199103))</screen> - </informalexample> - </para> + <programlisting> +#if (defined(BSD) && (BSD >= 199103)) + </programlisting> <para>to detect if the code is being compiled on a 4.3 Net2 code base or newer (e.g. FreeBSD 1.x, 4.3/Reno, NetBSD 0.9, 386BSD, @@ -28167,12 +28184,9 @@ an A record in the DNS for "customer.com".</programlisting> <para>Use:</para> - <para> - <informalexample> - <screen>#if (defined(BSD) && (BSD >= - 199306))</screen> - </informalexample> - </para> + <programlisting> +#if (defined(BSD) && (BSD >= 199306)) + </programlisting> <para>to detect if the code is being compiled on a 4.4 code base or newer (e.g. FreeBSD 2.x, 4.4, NetBSD 1.0, BSD/386 2.0 or @@ -28221,40 +28235,152 @@ an A record in the DNS for "customer.com".</programlisting> detecting FreeBSD systems since 2.0-RELEASE you can use the following: - <informalexample> - <screen>#if __FreeBSD__ >= 2 #include - <osreldate.h> # if __FreeBSD_version >= - 199504 /* 2.0.5+ release specific code here */ # - endif #endif</screen> - </informalexample> <symbol>__FreeBSD_version</symbol> - values: - <informalexample> - <screen>2.0-RELEASE: 199411 - 2.1-current's: 199501, 199503 - 2.0.5-RELEASE: 199504 - 2.2-current before 2.1: 199508 - 2.1.0-RELEASE: 199511 - 2.2-current before 2.1.5: 199512 - 2.1.5-RELEASE: 199607 - 2.2-current before 2.1.6: 199608 - 2.1.6-RELEASE: 199612 - 2.1.7-RELEASE: 199612 - 2.2-RELEASE: 220000 - 2.2.1-RELEASE: 220000 (yes, - no change) 2.2-STABLE after 2.2.1-RELEASE: 220000 - (yes, still no change) 2.2-STABLE after texinfo-3.9: - 221001 2.2-STABLE after top: 221002 - 2.2.2-RELEASE: 222000 - 2.2-STABLE after 2.2.2-RELEASE: 222001 - 2.2.5-RELEASE: 225000 - 2.2-STABLE after 2.2.5-RELEASE: 225001 - 2.2-STABLE after ldconfig -R merge: 225002 - 2.2.6-RELEASE: 226000 - 2.2-STABLE after 2.2.6-RELEASE: 226001 - 3.0-current before mount(2) change: 300000 - 3.0-current as of Nov 1997: - 300001</screen> - </informalexample></para> + <programlisting> +#if __FreeBSD__ >= 2 +#include <osreldate.h> +# if __FreeBSD_version >= 199504 + /* 2.0.5+ release specific code here */ +# endif +#endif + </programlisting> + + <informaltable frame="none"> + <tgroup cols="2"> + <thead> + <row> + <entry>Release</entry> + <entry><literal>_FreeBSD_version</literal></entry> + </row> + </thead> + <tbody> + <row> + <entry>2.0-RELEASE</entry> + <entry>119411</entry> + </row> + + <row> + <entry>2.1-currents</entry> + <entry>199501, 199503</entry> + </row> + + <row> + <entry>2.0.5-RELEASE</entry> + <entry>199504</entry> + </row> + + <row> + <entry>2.2-current before 2.1</entry> + <entry>199508</entry> + </row> + + <row> + <entry>2.1.0-RELEASE</entry> + <entry>199511</entry> + </row> + + <row> + <entry>2.2-current before 2.1.5</entry> + <entry>199512</entry> + </row> + + <row> + <entry>2.1.5-RELEASE</entry> + <entry>199607</entry> + </row> + + <row> + <entry>2.2-current before 2.1.6</entry> + <entry>199608</entry> + </row> + + <row> + <entry>2.1.6-RELEASE</entry> + <entry>199612</entry> + </row> + + <row> + <entry>2.1.7-RELEASE</entry> + <entry>199612</entry> + </row> + + <row> + <entry>2.2-RELEASE</entry> + <entry>220000</entry> + </row> + + <row> + <entry>2.2.1-RELEASE</entry> + <entry>220000 (no change)</entry> + </row> + + <row> + <entry>2.2-STABLE after 2.2.1-RELEASE</entry> + <entry>220000 (no change)</entry> + </row> + + <row> + <entry>2.2-STABLE after texinfo-3.9</entry> + <entry>221001</entry> + </row> + + <row> + <entry>2.2-STABLE after top</entry> + <entry>221002</entry> + </row> + + <row> + <entry>2.2.2-RELEASE</entry> + <entry>222000</entry> + </row> + + <row> + <entry>2.2-STABLE after 2.2.2-RELEASE</entry> + <entry>222001</entry> + </row> + + <row> + <entry>2.2.5-RELEASE</entry> + <entry>225000</entry> + </row> + + <row> + <entry>2.2-STABLE after 2.2.5-RELEASE</entry> + <entry>225001</entry> + </row> + + <row> + <entry>2.2-STABLE after ldconfig -R merge</entry> + <entry>225002</entry> + </row> + + <row> + <entry>2.2.6-RELEASE</entry> + <entry>226000</entry> + </row> + + <row> + <entry>2.2.7-RELEASE</entry> + <entry>227000</entry> + </row> + + <row> + <entry>2.2-STABLE after 2.2.7-RELEASE</entry> + <entry>227001</entry> + </row> + + <row> + <entry>3.0-current before mount(2) change</entry> + <entry>300000</entry> + </row> + + <row> + <entry>3.0-current as of November 1996</entry> + <entry>300001</entry> + </row> + </tbody> + </tgroup> + </informaltable> + </para> </listitem> </itemizedlist> @@ -28302,17 +28428,27 @@ an A record in the DNS for "customer.com".</programlisting> <para>The minimal <filename>Makefile</filename> would look something like this:</para> - <para> - <informalexample> - <screen> # New ports collection makefile for: oneko # - Version required: 1.1b # Date created: 5 December - 1994 # Whom: asami # # $Id$ # - DISTNAME= oneko-1.1b CATEGORIES= games MASTER_SITES= - ftp://ftp.cs.columbia.edu/archives/X11R5/contrib/ - MAINTAINER= asami@FreeBSD.ORG USE_IMAKE= yes .include - <bsd.port.mk></screen> - </informalexample> - </para> + <programlisting> +# New ports collection makefile for: oneko +# Version required: 1.1b +# Date created: 5 December 1994 +# Whom: asami +# +# $Id: handbook.sgml,v 1.33 1998-10-21 21:48:30 nik Exp $ +# + +DISTNAME= oneko-1.1b +CATEGORIES= games +MASTER_SITES= ftp://ftp.cs.columbia.edu/archives/X11R5/contrib/ + +MAINTAINER= asami@FreeBSD.ORG + +MAN1= oneko.1 +MANCOMPRESSED= yes +USE_IMAKE= yes + +.include <bsd.port.mk> + </programlisting> <para>See if you can figure it out. Do not worry about the contents of the <literal>$Id$</literal> @@ -28342,10 +28478,10 @@ an A record in the DNS for "customer.com".</programlisting> <emphasis>PLEASE do not include the package name (or version number of the software) in the comment.</emphasis> Here is an example: - <informalexample> - <screen>A cat chasing a mouse all over the - screen.</screen> - </informalexample> + + <programlisting> +A cat chasing a mouse all over the screen. + </programlisting> </para> </sect5> @@ -28368,13 +28504,15 @@ an A record in the DNS for "customer.com".</programlisting> <para>It is recommended that you sign the name at the end of this file, as in:</para> - <para> - <informalexample> - <screen>This is a port of oneko, in which a cat chases a - poor mouse all over the screen. : (etc.) - Satoshi - asami@cs.berkeley.edu</screen> - </informalexample> - </para> + <programlisting> +This is a port of oneko, in which a cat chases a poor mouse all over +the screen. + : +(etc.) + +- Satoshi +asami@cs.berkeley.edu + </programlisting> </sect5> @@ -28391,13 +28529,14 @@ an A record in the DNS for "customer.com".</programlisting> <para>Here is a small example:</para> - <para> - <informalexample> - <screen>bin/oneko man/man1/oneko.1.gz - lib/X11/app-defaults/Oneko lib/X11/oneko/cat1.xpm - lib/X11/oneko/cat2.xpm lib/X11/oneko/mouse.xpm</screen> - </informalexample> - </para> + <programlisting> +bin/oneko +man/man1/oneko.1.gz +lib/X11/app-defaults/Oneko +lib/X11/oneko/cat1.xpm +lib/X11/oneko/cat2.xpm +lib/X11/oneko/mouse.xpm + </programlisting> <para>Refer to the <citerefentry><refentrytitle>pkg_create</refentrytitle><manvolnum>1</manvolnum></citerefentry> man page for details on the packing list.</para> @@ -28441,9 +28580,7 @@ an A record in the DNS for "customer.com".</programlisting> source tarball, the <filename>work</filename> subdirectory or the package) into a <filename>.tar.gz</filename> file, stick it in the directory - <informalexample> - <screen>ftp://ftp.FreeBSD.ORG/pub/FreeBSD/incoming/</screen> - </informalexample> and send mail to us using + <filename>ftp://ftp.FreeBSD.ORG/pub/FreeBSD/incoming/</filename> and send mail to us using <citerefentry><refentrytitle>send-pr</refentrytitle><manvolnum>1</manvolnum></citerefentry> (please classify it as category `ports' and class `change-request'). There is no need to upload the package, we will build it by ourselves. We will @@ -28481,10 +28618,10 @@ an A record in the DNS for "customer.com".</programlisting> <orderedlist> <listitem> - <para>The fetch target is run. The fetch target is + <para>The <maketarget>fetch</maketarget> target is run. The <maketarget>fetch</maketarget> target is responsible for making sure that the tarball exists locally in <makevar>${DISTDIR}</makevar>. - If fetch cannot find the required files in <makevar>${DISTDIR}</makevar> it will look up the + If <maketarget>fetch</maketarget> cannot find the required files in <makevar>${DISTDIR}</makevar> it will look up the URL <makevar>${MASTER_SITES}</makevar>, which is set in the Makefile, as well as our main ftp site at <ulink @@ -28493,7 +28630,7 @@ an A record in the DNS for "customer.com".</programlisting> </listitem> <listitem> - <para>The extract target is run. It looks for your ports' + <para>The <maketarget>extract</maketarget> target is run. It looks for your ports' distribution file in <makevar>${DISTDIR}</makevar> (typically a gzip'd tarball) and unpacks it into a temporary subdirectory specified by <makevar>${WRKDIR}</makevar> @@ -28502,7 +28639,7 @@ an A record in the DNS for "customer.com".</programlisting> </listitem> <listitem> - <para>The patch target is run. First, any patches defined + <para>The <maketarget>patch</maketarget> target is run. First, any patches defined in <makevar>${PATCHFILES}</makevar> are applied. Second, if any patches are found in <makevar>${PATCHDIR}</makevar> (defaults to the <filename>patches</filename> subdirectory), they are @@ -28511,7 +28648,7 @@ an A record in the DNS for "customer.com".</programlisting> </listitem> <listitem> - <para>The configure target is run. This can do any one of + <para>The <maketarget>configure</maketarget> target is run. This can do any one of many different things. <orderedlist> @@ -28545,7 +28682,7 @@ an A record in the DNS for "customer.com".</programlisting> </listitem> <listitem> - <para>The build target is run. This is responsible for + <para>The <maketarget>build</maketarget> target is run. This is responsible for descending into the ports' private working directory (<makevar>${WRKSRC}</makevar>) and building it. If <makevar>${USE_GMAKE}</makevar> is set, GNU @@ -28559,7 +28696,7 @@ an A record in the DNS for "customer.com".</programlisting> </para> <para>The above are the default actions. In addition, you can - define targets <maketarget>pre-<something></maketarget> or <maketarget>post-<something></maketarget>, or put scripts + define targets <maketarget>pre-<replaceable>something</replaceable></maketarget> or <maketarget>post-<replaceable>something</replaceable></maketarget>, or put scripts with those names, in the <filename>scripts</filename> subdirectory, and they will be run before or after the default actions are done.</para> @@ -28576,10 +28713,10 @@ an A record in the DNS for "customer.com".</programlisting> out what kind of non-default action the port requires.</para> <para>The default actions are done by the - <filename>bsd.port.mk</filename> targets <maketarget>do-<something></maketarget>. For example, the + <filename>bsd.port.mk</filename> targets <maketarget>do-<replaceable>something</replaceable></maketarget>. For example, the commands to extract a port are in the target <maketarget>do-extract</maketarget>. If you are not happy with the default target, you can fix it by redefining the - <maketarget>do-<something></maketarget> target in + <maketarget>do-<replaceable>something</replaceable></maketarget> target in your Makefile.</para> <note> @@ -28601,8 +28738,8 @@ an A record in the DNS for "customer.com".</programlisting> <title>Getting the original sources</title> <para>Get the original sources (normally) as a compressed - tarball (<filename><foo>.tar.gz</filename> or - <filename><foo>.tar.Z</filename>) and copy it into + tarball (<filename><replaceable>foo</replaceable>.tar.gz</filename> or + <filename><replaceable>foo</replaceable>.tar.Z</filename>) and copy it into <makevar>${DISTDIR}</makevar>. Always use <emphasis>mainstream</emphasis> sources when and where you can.</para> @@ -28610,10 +28747,7 @@ an A record in the DNS for "customer.com".</programlisting> <para>If you cannot find a ftp/http site that is well-connected to the net, or can only find sites that have irritatingly non-standard formats, we can `house' it ourselves by putting - it on - <informalexample> - <screen>ftp://ftp.freebsd.org/pub/FreeBSD/distfiles/LOCAL_PORTS/</screen> - </informalexample> as the last resort. Please refer to this + it on <filename>ftp://ftp.freebsd.org/pub/FreeBSD/distfiles/LOCAL_PORTS/</filename> as the last resort. Please refer to this location as <makevar>${MASTER_SITE_LOCAL}</makevar>. Send mail to the &a.ports;if you are not sure what to do.</para> @@ -28662,12 +28796,11 @@ an A record in the DNS for "customer.com".</programlisting> or changed can be picked up with a recursive diff for later feeding to patch. Each set of patches you wish to apply should be collected into a file named - <filename>patch-<xx></filename> where - <filename><xx></filename> denotes the sequence in which + <filename>patch-<replaceable>xx</replaceable></filename> where + <replaceable>xx</replaceable> denotes the sequence in which the patches will be applied -- these are done in - <emphasis>alphabetical order</emphasis>, thus <emphasis - remap=tt>aa</emphasis> first, <emphasis - remap=tt>ab</emphasis> second and so on. These files + <emphasis>alphabetical order</emphasis>, thus + <literal>aa</literal> first, <literal>ab</literal> second and so on. These files should be stored in <makevar>${PATCHDIR}</makevar>, from where they will be automatically applied. All patches should be relative to <makevar>${WRKSRC}</makevar> (generally the @@ -28745,18 +28878,14 @@ an A record in the DNS for "customer.com".</programlisting> list (<makevar>${DISTFILES}</makevar>) to be named <makevar>${DISTNAME}${EXTRACT_SUFX}</makevar> by default which, if it is a normal tarball, is going to be - something like: - <informalexample> - <screen> foozolix-1.0.tar.gz</screen> - </informalexample> for a setting of - <literal>DISTNAME=foozolix-1.0</literal>.</para> + something like <literal>foozolix-1.0.tar.gz</literal> for a setting of + <programlisting> +DISTNAME=foozolix-1.0 + </programlisting>.</para> <para>The default rules also expect the tarball(s) to extract into a subdirectory called - <filename>work/${DISTNAME}</filename>, e.g. - <informalexample> - <screen> work/foozolix-1.0/</screen> - </informalexample> + <filename>work/${DISTNAME}</filename>, e.g. <filename>work/foozolix-1.0/</filename>. </para> <para>All this behavior can be overridden, of course, it simply @@ -28814,10 +28943,11 @@ an A record in the DNS for "customer.com".</programlisting> MASTER_SITE_PERL_CPAN, MASTER_SITE_TEX_CTAN, and MASTER_SITE_SUNSITE. Simply set MASTER_SITE_SUBDIR to the path with in the archive. Here is an example: - <informalexample> - <screen>MASTER_SITES= ${MASTER_SITE_XCONTRIB} - MASTER_SITE_SUBDIR= applications</screen> - </informalexample> + + <programlisting> +MASTER_SITES= ${MASTER_SITE_XCONTRIB} +MASTER_SITE_SUBDIR= applications + </programlisting> </para> <para>The user can also set the MASTER_SITE_* variables in @@ -28859,7 +28989,7 @@ an A record in the DNS for "customer.com".</programlisting> the <maketarget>pre-patch</maketarget> target, apply the patch either by running the patch command from there, or copying the patch file into the <makevar>${PATCHDIR}</makevar> directory and calling it - <filename>patch-<xx></filename>.</para> + <filename>patch-<replaceable>xx</replaceable></filename>.</para> <note> <para>Note the tarball will have been extracted alongside the @@ -28903,10 +29033,10 @@ an A record in the DNS for "customer.com".</programlisting> <filename>lib</filename> is the name of the shared library, and <filename>dir</filename> is the directory in which to find it in case it is not available. For example, - <informalexample> - <screen>LIB_DEPENDS= - jpeg\\.6\\.:${PORTSDIR}/graphics/jpeg</screen> - </informalexample> will check for a shared jpeg library with + + <programlisting> +LIB_DEPENDS= jpeg\\.6\\.:${PORTSDIR}/graphics/jpeg + </programlisting> will check for a shared jpeg library with major version 6, and descend into the <filename>graphics/jpeg</filename> subdirectory of your ports tree to build and install it if it is not @@ -28943,11 +29073,11 @@ an A record in the DNS for "customer.com".</programlisting> program exists in the user's search path.</para> <para>For example, - <informalexample> - <screen>RUN_DEPENDS= - ${PREFIX}/etc/innd:${PORTSDIR}/news/inn \ - wish:${PORTSDIR}/x11/tk</screen> - </informalexample> will check if the file + + <programlisting> +RUN_DEPENDS= ${PREFIX}/etc/innd:${PORTSDIR}/news/inn \ + wish:${PORTSDIR}/x11/tk + </programlisting> will check if the file <filename>/usr/local/etc/innd</filename> exists, and build and install it from the <filename>news/inn</filename> subdirectory of the ports tree if it is not found. It will @@ -28977,10 +29107,10 @@ an A record in the DNS for "customer.com".</programlisting> requires to build. Like <symbol>RUN_DEPENDS</symbol>, it is a list of <emphasis remap=tt>path:dir</emphasis> pairs. For example, - <informalexample> - <screen>BUILD_DEPENDS= - unzip:${PORTSDIR}/archivers/unzip</screen> - </informalexample> will check for an executable called + + <programlisting> +BUILD_DEPENDS= unzip:${PORTSDIR}/archivers/unzip + </programlisting> will check for an executable called <command>unzip</command>, and descend into the <filename>archivers/unzip</filename> subdirectory of your ports tree to build and install it if it is not @@ -29000,10 +29130,10 @@ an A record in the DNS for "customer.com".</programlisting> requires to fetch. Like the previous two, it is a list of <emphasis remap=tt>path:dir</emphasis> pairs. For example, - <informalexample> - <screen>FETCH_DEPENDS= - ncftp2:${PORTSDIR}/net/ncftp2</screen> - </informalexample> will check for an executable called + + <programlisting> +FETCH_DEPENDS= ncftp2:${PORTSDIR}/net/ncftp2 + </programlisting> will check for an executable called <command>ncftp2</command>, and descend into the <filename>net/ncftp2</filename> subdirectory of your ports tree to build and install it if it is not found.</para> @@ -29140,17 +29270,19 @@ an A record in the DNS for "customer.com".</programlisting> <para>First, this is what you (as a porter) need to know:</para> - <para> - <informalexample> - <screen>&prompt.user; install-info --help install-info [OPTION]... - [INFO-FILE [DIR-FILE]] Install INFO-FILE in the Info - directory file DIR-FILE. Options: --delete Delete - existing entries in INFO-FILE; don't insert any new entries. - : --entry=TEXT Insert TEXT as an Info directory entry. - : --section=SEC Put this file's entries in section SEC - of the directory. :</screen> - </informalexample> - </para> + <informalexample> + <screen>&prompt.user; <userinput>install-info --help</userinput> +install-info [OPTION]... [INFO-FILE [DIR-FILE]] + Install INFO-FILE in the Info directory file DIR-FILE. + +Options: +--delete Delete existing entries in INFO-FILE; + don't insert any new entries. + : +--entry=TEXT Insert TEXT as an Info directory entry. + : +--section=SEC Put this file's entries in section SEC of the directory. :</screen> + </informalexample> <note> <para>This program will not actually @@ -29162,26 +29294,30 @@ an A record in the DNS for "customer.com".</programlisting> <command>install-info</command>. I will use <filename>editors/emacs</filename> as an example.</para> - <para> - <orderedlist> - - <listitem> - <para>Look at the texinfo sources and make a patch to insert - <email>@dircategory</email> and <email>@direntry</email> - statements to files that don't have them. This is part of - my patch: - - <informalexample> - <screen>--- ./man/vip.texi.org Fri Jun 16 15:31:11 - 1995 +++ ./man/vip.texi Tue May 20 01:28:33 1997 @@ - -2,6 +2,10 @@ @setfilename ../info/vip @settitle VIP - +@dircategory The Emacs editor and associated tools - +@direntry +* VIP: (vip). A VI-emulation - for Emacs. +@end direntry @iftex @finalout :</screen> - </informalexample> - - - </para> + <procedure> + <step> + <para>Look at the texinfo sources and make a patch to insert + <email>@dircategory</email> and <email>@direntry</email> + statements to files that don't have them. This is part of + my patch: + + <programlisting> +--- ./man/vip.texi.org Fri Jun 16 15:31:11 1995 ++++ ./man/vip.texi Tue May 20 01:28:33 1997 +@@ -2,6 +2,10 @@ + + @setfilename ../info/vip + @settitle VIP ++@dircategory The Emacs editor and associated tools ++@direntry ++* VIP: (vip). A VI-emulation for Emacs. ++@end direntry + + @iftex + @finalout + : + </programlisting> + </para> <para>The format should be self-explanatory. Many authors leave a <filename>dir</filename> file in the source tree @@ -29190,7 +29326,7 @@ an A record in the DNS for "customer.com".</programlisting> look into related ports and make the section names and entry indentations consistent (we recommend that all entry text start at the 4th tab stop).</para> - + <note> <para>Note that you can put only one info entry per file because of a bug in <command>install-info @@ -29215,9 +29351,9 @@ an A record in the DNS for "customer.com".</programlisting> <filename>PLIST</filename> of <filename>japanese/skk</filename> for examples on how to do this).</para> - </listitem> + </step> - <listitem> + <step> <para>Go back to the port directory and do a <command>make clean; make</command> and verify that the info files are regenerated from the texinfo sources. Since the texinfo sources are newer than the info files, @@ -29228,25 +29364,29 @@ an A record in the DNS for "customer.com".</programlisting> descend into the <filename>man</filename> subdirectory to rebuild the info pages. - <informalexample> - <screen>--- ./Makefile.in.org Mon Aug 19 21:12:19 - 1996 +++ ./Makefile.in Tue Apr 15 00:15:28 1997 @@ - -184,7 +184,7 @@ # Subdirectories to make recursively. - `lisp' is not included # because the compiled lisp - files are part of the distribution # and you cannot - remake them without installing Emacs first. -SUBDIR = - lib-src src +SUBDIR = lib-src src man # The makefiles - of the directories in $SUBDIR. SUBDIR_MAKEFILES = - lib-src/Makefile man/Makefile src/Makefile - oldXMenu/Makefile lwlib/Makefile --- - ./man/Makefile.in.org Thu Jun 27 15:27:19 1996 +++ - ./man/Makefile.in Tue Apr 15 00:29:52 1997 @@ - -66,6 +66,7 @@ ${srcdir}/gnu1.texi \ - ${srcdir}/glossary.texi +all: info info: - $(INFO_TARGETS) dvi: $(DVI_TARGETS)</screen> - </informalexample> - - + <programlisting> +--- ./Makefile.in.org Mon Aug 19 21:12:19 1996 ++++ ./Makefile.in Tue Apr 15 00:15:28 1997 +@@ -184,7 +184,7 @@ + # Subdirectories to make recursively. `lisp' is not included + # because the compiled lisp files are part of the distribution + # and you cannot remake them without installing Emacs first. +-SUBDIR = lib-src src ++SUBDIR = lib-src src man + + # The makefiles of the directories in $SUBDIR. + SUBDIR_MAKEFILES = lib-src/Makefile man/Makefile src/Makefile oldXMenu/Makefile lwlib/Makefile +--- ./man/Makefile.in.org Thu Jun 27 15:27:19 1996 ++++ ./man/Makefile.in Tue Apr 15 00:29:52 1997 +@@ -66,6 +66,7 @@ + ${srcdir}/gnu1.texi \ + ${srcdir}/glossary.texi + ++all: info + info: $(INFO_TARGETS) + + dvi: $(DVI_TARGETS) + </programlisting> </para> <para>The second hunk was necessary because the default @@ -29257,9 +29397,9 @@ an A record in the DNS for "customer.com".</programlisting> because we already have one with the same name in <filename>/usr/share/info</filename> (that patch is not shown here).</para> - </listitem> + </step> - <listitem> + <step> <para>If there is a place in the <filename>Makefile</filename> that is installing the <filename>dir</filename> file, delete it. Your @@ -29267,58 +29407,88 @@ an A record in the DNS for "customer.com".</programlisting> are otherwise mucking around with the <filename>dir</filename> file. - <informalexample> - <screen>--- ./Makefile.in.org Mon Aug 19 21:12:19 - 1996 +++ ./Makefile.in Mon Apr 14 23:38:07 1997 @@ - -368,14 +368,8 @@ if [ `(cd ${srcdir}/info && - /bin/pwd)` != `(cd ${infodir} && /bin/pwd)` ]; - \ then \ (cd ${infodir}; \ - if [ -f dir ]; then - \ - if [ ! -f dir.old ]; then mv -f dir - dir.old; \ - else mv -f dir dir.bak; fi; \ - - fi; \ cd ${srcdir}/info ; \ - (cd $${thisdir}; - ${INSTALL_DATA} ${srcdir}/info/dir ${infodir}/dir); \ - - (cd $${thisdir}; chmod a+r ${infodir}/dir); - \ for f in ccmode* cl* dired-x* ediff* emacs* forms* - gnus* info* message* mh-e* sc* vip*; do \ (cd - $${thisdir}; \ ${INSTALL_DATA} ${srcdir}/info/$$f - ${infodir}/$$f; \ chmod a+r ${infodir}/$$f); - \</screen> - </informalexample> - + <programlisting> +--- ./Makefile.in.org Mon Aug 19 21:12:19 1996 ++++ ./Makefile.in Mon Apr 14 23:38:07 1997 +@@ -368,14 +368,8 @@ + if [ `(cd ${srcdir}/info && /bin/pwd)` != `(cd ${infodir} && /bin/pwd)` ]; \ + then \ + (cd ${infodir}; \ +- if [ -f dir ]; then \ +- if [ ! -f dir.old ]; then mv -f dir dir.old; \ +- else mv -f dir dir.bak; fi; \ +- fi; \ + cd ${srcdir}/info ; \ +- (cd $${thisdir}; ${INSTALL_DATA} ${srcdir}/info/dir ${infodir}/dir); \ +- (cd $${thisdir}; chmod a+r ${infodir}/dir); \ + for f in ccmode* cl* dired-x* ediff* emacs* forms* gnus* info* message* mh-e* sc* vip*; do \ + (cd $${thisdir}; \ + ${INSTALL_DATA} ${srcdir}/info/$$f ${infodir}/$$f; \ + chmod a+r ${infodir}/$$f); \ + </programlisting> </para> - </listitem> + </step> - <listitem> + <step> <para>(This step is only necessary if you are modifying an existing port.) Take a look at <filename>pkg/PLIST</filename> and delete anything that is trying to patch up <filename>info/dir</filename>. They may be in <filename>pkg/INSTALL</filename> or some other - file, so search extensively. + file, so search extensively.</para> - <informalexample> - <screen>Index: pkg/PLIST - =================================================================== RCS file: /usr/cvs/ports/editors/emacs/pkg/PLIST,v retrieving revision 1.15 diff -u -r1.15 PLIST --- PLIST 1997/03/04 08:04:00 1.15 +++ PLIST 1997/04/15 06:32:12 @@ -15,9 +15,6 @@ man/man1/emacs.1.gz man/man1/etags.1.gz man/man1/ctags.1.gz -@unexec cp %D/info/dir %D/info/dir.bak -info/dir -@unexec cp %D/info/dir.bak %D/info/dir info/cl info/cl-1 info/cl-2</screen> - </informalexample> - - </para> - </listitem> + <programlisting> +Index: pkg/PLIST +=================================================================== +RCS file: /usr/cvs/ports/editors/emacs/pkg/PLIST,v +retrieving revision 1.15 +diff -u -r1.15 PLIST +--- PLIST 1997/03/04 08:04:00 1.15 ++++ PLIST 1997/04/15 06:32:12 +@@ -15,9 +15,6 @@ + man/man1/emacs.1.gz + man/man1/etags.1.gz + man/man1/ctags.1.gz +-@unexec cp %D/info/dir %D/info/dir.bak +-info/dir +-@unexec cp %D/info/dir.bak %D/info/dir + info/cl + info/cl-1 + info/cl-2 + </programlisting> + </step> - <listitem> + <step> <para>Add a <maketarget>post-install</maketarget> target to the <filename>Makefile</filename> to create a <filename>dir</filename> file if it is not there. Also, call <maketarget>install-info</maketarget> with the installed info files. - <informalexample> - <screen>Index: Makefile - =================================================================== RCS file: /usr/cvs/ports/editors/emacs/Makefile,v retrieving revision 1.26 diff -u -r1.26 Makefile --- Makefile 1996/11/19 13:14:40 1.26 +++ Makefile 1997/05/20 10:25:09 1.28 @@ -20,5 +20,11 @@ post-install: .for file in emacs-19.34 emacsclient etags ctags b2m strip ${PREFIX}/bin/${file} .endfor + if [ ! -f ${PREFIX}/info/dir ]; then \ + ${SED} -ne '1,/Menu:/p' /usr/share/info/dir > ${PREFIX}/info/dir; \ + fi +.for info in emacs vip viper forms gnus mh-e cl sc dired-x ediff ccmode + install-info ${PREFIX}/info/${info} ${PREFIX}/info/dir +.endfor .include <bsd.port.mk></screen> - </informalexample> - - + <programlisting> +Index: Makefile +=================================================================== +RCS file: /usr/cvs/ports/editors/emacs/Makefile,v +retrieving revision 1.26 +diff -u -r1.26 Makefile +--- Makefile 1996/11/19 13:14:40 1.26 ++++ Makefile 1997/05/20 10:25:09 1.28 +@@ -20,5 +20,11 @@ + post-install: + .for file in emacs-19.34 emacsclient etags ctags b2m + strip ${PREFIX}/bin/${file} + .endfor ++ if [ ! -f ${PREFIX}/info/dir ]; then \ ++ ${SED} -ne '1,/Menu:/p' /usr/share/info/dir > ${PREFIX}/info/dir; \ ++ fi ++.for info in emacs vip viper forms gnus mh-e cl sc dired-x ediff ccmode ++ install-info ${PREFIX}/info/${info} ${PREFIX}/info/dir ++.endfor + + .include <bsd.port.mk> + </programlisting> </para> - + <para>Do not use anything other than <filename>/usr/share/info/dir</filename> and the above command to create a new info file. In fact, I'd add the @@ -29326,21 +29496,41 @@ an A record in the DNS for "customer.com".</programlisting> <filename>bsd.port.mk</filename> if you (the porter) wouldn't have to do it in <filename>PLIST</filename> by yourself anyway.</para> - </listitem> + </step> - <listitem> + <step> <para>Edit <filename>PLIST</filename> and add equivalent <email>@exec</email> statements and also <email>@unexec</email> for <symbol>pkg_delete</symbol>. You do not need to delete <filename>info/dir</filename> with <email>@unexec</email>. - <informalexample> - <screen>Index: pkg/PLIST - =================================================================== RCS file: /usr/cvs/ports/editors/emacs/pkg/PLIST,v retrieving revision 1.15 diff -u -r1.15 PLIST --- PLIST 1997/03/04 08:04:00 1.15 +++ PLIST 1997/05/20 10:25:12 1.17 @@ -16,7 +14,15 @@ man/man1/etags.1.gz man/man1/ctags.1.gz +@unexec install-info --delete %D/info/emacs %D/info/dir : +@unexec install-info --delete %D/info/ccmode %D/info/dir info/cl info/cl-1 @@ -87,6 +94,18 @@ info/viper-3 info/viper-4 +@exec [ -f %D/info/dir ] || sed -ne '1,/Menu:/p' /usr/share/info/dir > %D/info/dir +@exec install-info %D/info/emacs %D/info/dir : +@exec install-info %D/info/ccmode %D/info/dir libexec/emacs/19.34/i386--freebsd/cvtmail libexec/emacs/19.34/i386--freebsd/digest-doc</screen> - </informalexample> - - + <programlisting> +Index: pkg/PLIST +=================================================================== +RCS file: /usr/cvs/ports/editors/emacs/pkg/PLIST,v +retrieving revision 1.15 +diff -u -r1.15 PLIST +--- PLIST 1997/03/04 08:04:00 1.15 ++++ PLIST 1997/05/20 10:25:12 1.17 +@@ -16,7 +14,15 @@ + man/man1/etags.1.gz + man/man1/ctags.1.gz ++@unexec install-info --delete %D/info/emacs %D/info/dir + : ++@unexec install-info --delete %D/info/ccmode %D/info/dir + info/cl + info/cl-1 +@@ -87,6 +94,18 @@ + info/viper-3 + info/viper-4 ++@exec [ -f %D/info/dir ] || sed -ne '1,/Menu:/p' /usr/share/info/dir > %D/info/dir ++@exec install-info %D/info/emacs %D/info/dir + : ++@exec install-info %D/info/ccmode %D/info/dir + libexec/emacs/19.34/i386--freebsd/cvtmail + libexec/emacs/19.34/i386--freebsd/digest-doc + </programlisting> </para> <note> @@ -29352,9 +29542,9 @@ an A record in the DNS for "customer.com".</programlisting> <email>@exec</email> command that creates the the <filename>dir</filename> file.</para> </note> - </listitem> + </step> - <listitem> + <step> <para>Test and admire your work. <emphasis remap=tt>:)</emphasis> The sequence I recommend is: <command>make package</command>, @@ -29362,10 +29552,10 @@ an A record in the DNS for "customer.com".</programlisting> <symbol>pkg_add</symbol>. Check the <emphasis remap=tt>dir</emphasis> file before and after each step.</para> - </listitem> + </step> - </orderedlist> - </para> + </procedure> + </sect3> @@ -29514,9 +29704,11 @@ an A record in the DNS for "customer.com".</programlisting> source already strips the binary, fine; otherwise, you can add a <maketarget>post-install</maketarget> rule to do it yourself. Here is an example: - <informalexample> - <screen> post-install: strip ${PREFIX}/bin/xdl</screen> - </informalexample> + + <programlisting> +post-install: + strip ${PREFIX}/bin/xdl + </programlisting> </para> <para>Use the <emphasis remap=tt>file</emphasis> command on the @@ -29530,10 +29722,12 @@ an A record in the DNS for "customer.com".</programlisting> <filename>/etc/make.conf</filename> to disable man page compression. Place them last in the section below the <acronym>MAINTAINER</acronym> variable. Here is an example: - <informalexample> - <screen>MAN1= foo.1 bar.1 MAN5= foo.conf.5 MAN8= - baz.8</screen> - </informalexample> + + <programlisting> +MAN1= foo.1 bar.1 +MAN5= foo.conf.5 +MAN8= baz.8 + </programlisting> </para> <note> @@ -29649,12 +29843,14 @@ an A record in the DNS for "customer.com".</programlisting> <para>Make the installation dependent to the variable <acronym>NOPORTDOCS</acronym> so that users can disable it in <filename>/etc/make.conf</filename>, like this: - <informalexample> - <screen> post-install: .if !defined(NOPORTDOCS) ${MKDIR} - ${PREFIX}/share/doc/xv ${INSTALL_MAN} - ${WRKSRC}/docs/xvdocs.ps ${PREFIX}/share/doc/xv - .endif</screen> - </informalexample> + + <programlisting> +post-install: +.if !defined(NOPORTDOCS) + ${MKDIR}${PREFIX}/share/doc/xv + ${INSTALL_MAN} ${WRKSRC}/docs/xvdocs.ps ${PREFIX}/share/doc/xv +.endif + </programlisting> </para> <para>Do not forget to add them to @@ -29774,7 +29970,14 @@ an A record in the DNS for "customer.com".</programlisting> variables mentioned above, not explicit pathnames. For instance, if your port requires a macro <acronym>PAGER</acronym> to be the full pathname of <command>less</command>, use the compiler flag: - <literallayout>-DPAGER=\"${PREFIX}/bin/less\"</literallayout> or <literallayout>-DPAGER=\"${LOCALBASE}/bin/less\"</literallayout> if this is an X port, instead of <literallayout>-DPAGER=\"/usr/local/bin/less\".</literallayout> This way it will have a better chance of working if the system administrator has moved the whole `/usr/local' tree somewhere else.</para> + + <programlisting> +-DPAGER=\"${PREFIX}/bin/less\" + </programlisting> or + + <programlisting> +-DPAGER=\"${LOCALBASE}/bin/less\" + </programlisting> if this is an X port, instead of <literallayout>-DPAGER=\"/usr/local/bin/less\".</literallayout> This way it will have a better chance of working if the system administrator has moved the whole `/usr/local' tree somewhere else.</para> </sect4> @@ -29817,10 +30020,11 @@ an A record in the DNS for "customer.com".</programlisting> installed the package can start using the shared library immediately. This line should immediately follow the line for the shared library itself, as in: - <informalexample> - <screen>lib/libtcl80.so.1.0 @exec /sbin/ldconfig -m - %D/lib</screen> - </informalexample> + + <programlisting> +lib/libtcl80.so.1.0 +@exec /sbin/ldconfig -m %D/lib + </programlisting> </para> <para>Never, ever, <emphasis>ever</emphasis> add a line that @@ -29852,24 +30056,26 @@ an A record in the DNS for "customer.com".</programlisting> or other ports. This is the current list of UIDs between 50 and 99.</para> - <para> - <informalexample> - <screen>majordom:*:54:1024:Majordomo Pseudo - User:/usr/local/majordomo:/nonexistent cyrus:*:60:248:the - cyrus mail server:/nonexistent:/nonexistent - gnats:*:61:1:GNATS database - owner:/usr/local/share/gnats/gnats-db:/bin/sh - uucp:*:66:66:UUCP - pseudo-user:/var/spool/uucppublic:/usr/libexec/uucp/uucico - xten:*:67:67:X-10 daemon:/usr/local/xten:/nonexistent - pop:*:68:6:Post Office Owner:/nonexistent:/nonexistent - wnn:*:69:7:Wnn:/nonexistent:/nonexistent - ifmail:*:70:66:Ifmail user:/nonexistent:/nonexistent - pgsql:*:71:246:PostgreSQL - pseudo-user:/usr/local/pgsql:/bin/sh msql:*:80:249:mSQL-2 - pseudo-user:/var/db/msqldb:/bin/sh</screen> - </informalexample> - </para> + <programlisting> +majordom:*:54:54:Majordomo Pseudo User:/usr/local/majordomo:/nonexistent +cyrus:*:60:60:the cyrus mail server:/nonexistent:/nonexistent +gnats:*:61:1:GNATS database owner:/usr/local/share/gnats/gnats-db:/bin/sh +uucp:*:66:66:UUCP pseudo-user:/var/spool/uucppublic:/usr/libexec/uucp/uucico +xten:*:67:67:X-10 daemon:/usr/local/xten:/nonexistent +pop:*:68:6:Post Office Owner (popper):/nonexistent:/nonexistent +wnn:*:69:7:Wnn:/nonexistent:/nonexistent +ifmail:*:70:66:Ifmail user:/nonexistent:/nonexistent +pgsql:*:70:70:PostgreSQL pseudo-user:/usr/local/pgsql:/bin/sh +ircd:*:72:72:IRCd hybrid:/nonexistent:/nonexistent +alias:*:81:81:QMail user:/var/qmail/alias:/nonexistent +qmaill:*:83:81:QMail user:/var/qmail:/nonexistent +qmaild:*:82:81:QMail user:/var/qmail:/nonexistent +qmailq:*:85:82:QMail user:/var/qmail:/nonexistent +qmails:*:87:82:QMail user:/var/qmail:/nonexistent +qmailp:*:84:81:QMail user:/var/qmail:/nonexistent +qmailr:*:86:82:QMail user:/var/qmail:/nonexistent +msql:*:87:87:mSQL-2 pseudo-user:/var/db/msqldb:/bin/sh + </programlisting> <para>Please send a notice to &a.ports; if you submit or commit a port that allocates a new UID in this range so we can keep @@ -29905,66 +30111,87 @@ an A record in the DNS for "customer.com".</programlisting> (mostly old ones), but we are trying to uniformize how they look. This format is designed so that the most important information is easy to locate.</para> - - <para> - <informalexample> - <screen> [the header...just to make it easier for us to - identify the ports.] # New ports collection makefile for: - xdvi [the version required header should updated when - upgrading a port.] # Version required: pl18 [things - like "1.5alpha" are fine here too] [this is the date when - the first version of this Makefile was created. Never - change this when doing an update of the port.] # Date - created: 26 May 1995 [this is the person who - did the original port to FreeBSD, in particular, the person - who wrote the first version of this Makefile. Remember, - this should not be changed when upgrading the port later.] # - Whom: Satoshi Asami - <asami@FreeBSD.ORG> # # $Id$ [ ^^^^ This will - be automatically replaced with RCS ID string by CVS when it - is committed to our repository.] # [section to describe the - port itself and the master site - DISTNAME is always first, - followed by PKGNAME (if necessary), CATEGORIES, and then - MASTER_SITES, which can be followed by MASTER_SITE_SUBDIR. - After those, one of EXTRACT_SUFX or DISTFILES can be - specified too.] DISTNAME= xdvi PKGNAME= xdvi-pl18 - CATEGORIES= print [do not forget the trailing slash ("/")! - if you aren't using MASTER_SITE_* macros] MASTER_SITES= - ${MASTER_SITE_XCONTRIB} MASTER_SITE_SUBDIR= applications - [set this if the source is not in the standard ".tar.gz" - form] EXTRACT_SUFX= .tar.Z [section for distributed - patches -- can be empty] PATCH_SITES= - ftp://ftp.sra.co.jp/pub/X11/japanese/ PATCHFILES= - xdvi-18.patch1.gz xdvi-18.patch2.gz [maintainer; - *mandatory*! This is the person (preferably with commit - privileges) who a user can contact for questions and bug - reports - this person should be the porter or someone who - can forward questions to the original porter reasonably - promptly. If you really do not want to have your address - here, set it to "ports@FreeBSD.ORG".] MAINTAINER= - asami@FreeBSD.ORG [dependencies -- can be empty] - RUN_DEPENDS= gs:${PORTSDIR}/print/ghostscript LIB_DEPENDS= - Xpm\\.4\\.:${PORTSDIR}/graphics/xpm [this section is for - other standard bsd.port.mk variables that do not belong to - any of the above] [If it asks questions during configure, - build, install...] IS_INTERACTIVE= yes [If it extracts to - a directory other than ${DISTNAME}...] WRKSRC= - ${WRKDIR}/xdvi-new [If the distributed patches were not made - relative to ${WRKSRC}, you may need to tweak this] - PATCH_DIST_STRIP= -p1 [If it requires a "configure" - script generated by GNU autoconf to be run] GNU_CONFIGURE= - yes [If it requires GNU make, not /usr/bin/make, to - build...] USE_GMAKE= yes [If it is an X application and - requires "xmkmf -a" to be run...] USE_IMAKE= yes [et - cetera.] [non-standard variables to be used in the rules - below] MY_FAVORITE_RESPONSE= "yeah, right" [then the - special rules, in the order they are called] pre-fetch: i go - fetch something, yeah post-patch: i need to do something - after patch, great pre-install: and then some more stuff - before installing, wow [and then the epilogue] .include - <bsd.port.mk></screen> - </informalexample> - </para> + + <programlisting> +[the header...just to make it easier for us to identify the ports.] +# New ports collection makefile for: xdvi +[the version required header should updated when upgrading a port.] +# Version required: pl18 [things like "1.5alpha" are fine here too] +[this is the date when the first version of this Makefile was created. +Never change this when doing an update of the port.] +# Date created: 26 May 1995 +[this is the person who did the original port to FreeBSD, in particular, the +person who wrote the first version of this Makefile. Remember, this should +not be changed when upgrading the port later.] +# Whom: Satoshi Asami &lgt;asami@FreeBSD.ORG> +# +# $Id$ +[ ^^^^ This will be automatically replaced with RCS ID string by CVS +when it is committed to our repository.] +# + +[section to describe the port itself and the master site - DISTNAME + is always first, followed by PKGNAME (if necessary), CATEGORIES, + and then MASTER_SITES, which can be followed by MASTER_SITE_SUBDIR. + After those, one of EXTRACT_SUFX or DISTFILES can be specified too.] +DISTNAME= xdvi +PKGNAME= xdvi-pl18 +CATEGORIES= print +[do not forget the trailing slash ("/")! + if you aren't using MASTER_SITE_* macros] +MASTER_SITES= ${MASTER_SITE_XCONTRIB} +MASTER_SITE_SUBDIR= applications +[set this if the source is not in the standard ".tar.gz" form] +EXTRACT_SUFX= .tar.Z + +[section for distributed patches -- can be empty] +PATCH_SITES= ftp://ftp.sra.co.jp/pub/X11/japanese/ +PATCHFILES= xdvi-18.patch1.gz xdvi-18.patch2.gz + +[maintainer; *mandatory*! This is the person (preferably with commit + privileges) who a user can contact for questions and bug reports - this + person should be the porter or someone who can forward questions to the + original porter reasonably promptly. If you really do not want to have + your address here, set it to "ports@FreeBSD.ORG".] +MAINTAINER= asami@FreeBSD.ORG + +[dependencies -- can be empty] +RUN_DEPENDS= gs:${PORTSDIR}/print/ghostscript +LIB_DEPENDS= Xpm\\.4\\.:${PORTSDIR}/graphics/xpm + +[this section is for other standard bsd.port.mk variables that do not + belong to any of the above] +[If it asks questions during configure, build, install...] +IS_INTERACTIVE= yes +[If it extracts to a directory other than ${DISTNAME}...] +WRKSRC= ${WRKDIR}/xdvi-new +[If the distributed patches were not made relative to ${WRKSRC}, you + may need to tweak this] +PATCH_DIST_STRIP= -p1 +[If it requires a "configure" script generated by GNU autoconf to be run] +GNU_CONFIGURE= yes +[If it requires GNU make, not /usr/bin/make, to build...] +USE_GMAKE= yes +[If it is an X application and requires "xmkmf -a" to be run...] +USE_IMAKE= yes +[et cetera.] + +[non-standard variables to be used in the rules below] +MY_FAVORITE_RESPONSE= "yeah, right" + +[then the special rules, in the order they are called] +pre-fetch: + i go fetch something, yeah + +post-patch: + i need to do something after patch, great + +pre-install: + and then some more stuff before installing, wow + +[and then the epilogue] +.include <bsd.port.mk> + </programlisting> </sect3> @@ -29976,13 +30203,7 @@ an A record in the DNS for "customer.com".</programlisting> easy to scan, as there are already lots and lots of packages and users are going to turn away if they hurt their eyes!</para> - <para>The package name should look like</para> - - <para> - <informalexample> - <screen>[<language>-]<name>[[-]<compiled.specifics>]-<version.string.numbers>;</screen> - </informalexample> - </para> + <para>The package name should look like <filename><replaceable>language-</replaceable>name<replaceable>-compiled.specifics</replaceable><replaceable>-version.numbers</replaceable></filename>.</para> <para>If your <makevar>${DISTNAME}</makevar> doesn't look like that, set <makevar>${PKGNAME}</makevar> to something in that @@ -29993,16 +30214,16 @@ an A record in the DNS for "customer.com".</programlisting> <listitem> <para>FreeBSD strives to support the native language of its - users. The `<language>' part should be a two letter + users. The <replaceable>language-</replaceable> part should be a two letter abbreviation of the natural language defined by ISO-639 if the port is specific to a certain language. Examples are - `ja' for Japanese, `ru' for Russian, `vi' for Vietnamese, - `zh' for Chinese, `ko' for Korean and `de' for German. + <literal>ja</literal> for Japanese, <literal>ru</literal> for Russian, <literal>vi</literal> for Vietnamese, + <literal>zh</literal> for Chinese, <literal>ko</literal> for Korean and <literal>de</literal> for German. </para> </listitem> <listitem> - <para>The <emphasis remap=tt><name></emphasis> part + <para>The <filename>name</filename> part should be all lowercases, except for a really large package (with lots of programs in it). Things like XFree86 (yes there really is a package of it, check it @@ -30018,7 +30239,7 @@ an A record in the DNS for "customer.com".</programlisting> <para>If the port can be built with different hardcoded defaults (usually specified as environment variables or on the <command>make</command> command line), the - `<compiled.specifics>' part should state the + <replaceable>-compiled.specifics</replaceable> part should state the compiled-in defaults (the hyphen is optional). Examples are papersize and font units. </para> @@ -30027,7 +30248,7 @@ an A record in the DNS for "customer.com".</programlisting> <listitem> <para>The version string should be a period-separated list of integers and single lowercase alphabetics. The only - exception is the string `pl' (meaning `patchlevel'), which + exception is the string <literal>pl</literal> (meaning `patchlevel'), which can be used <emphasis>only</emphasis> when there are no major and minor version numbers in the software.</para> </listitem> @@ -30036,34 +30257,112 @@ an A record in the DNS for "customer.com".</programlisting> </para> <para>Here are some (real) examples on how to convert a <makevar>${DISTNAME}</makevar> into a suitable <makevar>${PKGNAME}</makevar>:</para> - - <para> - <informalexample> - <screen>DISTNAME PKGNAME Reason - mule-2.2.2 mule-2.2.2 no prob at all - XFree86-3.1.2 XFree86-3.1.2 ditto EmiClock-1.0.2 - emiclock-1.0.2 no uppercase names for single - programs gmod1.4 gmod-1.4 need - hyphen after `<name>' xmris.4.02 xmris-4.02 - ditto rdist-1.3alpha rdist-1.3a no strings - like `alpha' allowed es-0.9-beta1 es-0.9b1 - ditto v3.3beta021.src tiff-3.3 what the heck - was that anyway? ;) tvtwm tvtwm-pl11 - version string always required piewm piewm-1.0 - ditto xvgr-2.10pl1 xvgr-2.10.1 `pl' allowed - only when no maj/minor numbers gawk-2.15.6 ja-gawk-2.15.6 - Japanese language version psutils-1.13 - psutils-letter-1.13 papersize hardcoded at package build - time pkfonts pkfonts300-1.0 package for - 300dpi fonts</screen> - </informalexample> - </para> + + <informaltable frame="none"> + <tgroup cols="3"> + <thead> + <row> + <entry>Distribution Name</entry> + <entry>Package Name</entry> + <entry>Reason</entry> + </row> + </thead> + <tbody> + <row> + <entry>mule-2.2.2.</entry> + <entry>mule-2.2.2</entry> + <entry>No changes required</entry> + </row> + + <row> + <entry>XFree86-3.1.2</entry> + <entry>XFree86-3.1.2</entry> + <entry>No changes required</entry> + </row> + + <row> + <entry>EmiClock-1.0.2</entry> + <entry>emiclock-1.0.2</entry> + <entry>No uppercase names for single programs</entry> + </row> + + <row> + <entry>gmod1.4</entry> + <entry>gmod-1.4</entry> + <entry>Need a hyphen before version numbers</entry> + </row> + + <row> + <entry>xmris.4.0.2</entry> + <entry>xmris-4.0.2</entry> + <entry>Need a hyphen before version numbers</entry> + </row> + + <row> + <entry>rdist-1.3alpha</entry> + <entry>rdist-1.3a</entry> + <entry>No strings like <literal>alpha</literal> + allowed</entry> + </row> + + <row> + <entry>es-0.9-beta1</entry> + <entry>es-0.9b1</entry> + <entry>No strings like <literal>beta</literal> + allowed</entry> + </row> + + <row> + <entry>v3.3beta021.src</entry> + <entry>tiff-3.3</entry> + <entry>What the heck was that anyway?</entry> + </row> + + <row> + <entry>tvtwm</entry> + <entry>tvtwm-pl11</entry> + <entry>Version string always required</entry> + </row> + + <row> + <entry>piewm</entry> + <entry>piewm-1.0</entry> + <entry>Version string always required</entry> + </row> + + <row> + <entry>xvgr-2.10pl1</entry> + <entry>xvgr-2.10.1</entry> + <entry><literal>pl</literal> allowed only when no + major/minor version numbers</entry> + </row> + + <row> + <entry>gawk-2.15.6</entry> + <entry>ja-gawk-2.15.6</entry> + <entry>Japanese language version</entry> + </row> + + <row> + <entry>psutils-1.13</entry> + <entry>psutils-letter-1.13</entry> + <entry>Papersize hardcoded at package build time</entry> + </row> + + <row> + <entry>pkfonts</entry> + <entry>pkfonts300-1.0</entry> + <entry>Package for 300dpi fonts</entry> + </row> + </tbody> + </tgroup> + </informaltable> <para>If there is absolutely no trace of version information in the original source and it is unlikely that the original author will ever release another version, just set the version string - to `1.0' (like the piewm example above). Otherwise, ask the - original author or use the date string (`yy.mm.dd') as the + to <literal>1.0</literal> (like the piewm example above). Otherwise, ask the + original author or use the date string (<literal><replaceable>yy</replaceable>.<replaceable>mm</replaceable>.<replaceable>dd</replaceable></literal>) as the version.</para> </sect3> @@ -30111,23 +30410,26 @@ an A record in the DNS for "customer.com".</programlisting> <para>Please make any checks payable to FreeBSD, Inc., sent in care of the following address:</para> - <para> - <informalexample> - <screen>FreeBSD, Inc. c/o Jordan Hubbard 4041 Pike Lane, suite - #D. Concord CA, 94520 [temporarily using the Walnut Creek - CDROM address until a PO box can be opened]</screen> - </informalexample> - </para> + <address> + <otheraddr>FreeBSD, Inc.</otheraddr> + <otheraddr>c/o Jordan Hubbard</otheraddr> + <street>4041 Pike Lane, Suite F</street> + <city>Concord</city> + <state>CA</state>, <postcode>94520</postcode> + </address> <para>Wire transfers may also be sent directly to:</para> - <para> - <informalexample> - <screen>Bank Of America Concord Main Office P.O. Box 37176 - San Francisco CA, 94137-5176 Routing #: 121-000-358 Account - #: 01411-07441 (FreeBSD, Inc.)</screen> - </informalexample> - </para> + <address> + <otheraddr>Bank Of America</otheraddr> + <otheraddr>Concord Main Office</otheraddr> + <pob>P.O. Box 37176</pob> + <city>San Francisco</city> + <state>CA</state>, <postcode>94137-5176</postcode> + + <otheraddr>Routing #: 121-000-358</otheraddr> + <otheraddr>Account #: 01411-07441 (FreeBSD, Inc.)</otheraddr> + </address> <para>Any correspondence related to donations should be sent to <ulink URL="mailto:jkh@FreeBSD.org">Jordan Hubbard</ulink>, @@ -32392,9 +32694,9 @@ an A record in the DNS for "customer.com".</programlisting> maintained by a person or group of persons, they can communicate this fact to the world by adding a</para> - <para> - <literallayout> MAINTAINER= email-addresses</literallayout> - </para> + <programlisting> +MAINTAINER= email-addresses + </programlisting> <para>line to the <filename>Makefile</filename>s covering this portion of the source tree.</para> @@ -32551,30 +32853,46 @@ an A record in the DNS for "customer.com".</programlisting> initial import. Example wording from <filename>src/contrib/cpio</filename> is below:</para> - <para> - <literallayout>This directory contains virgin sources of the - original distribution files on a "vendor" branch. Do not, under - any circumstances, attempt to upgrade the files in this directory - via patches and a cvs commit. New versions or official-patch - versions must be imported. For the import of GNU cpio 2.4.2, the - following files were removed: INSTALL cpio.info - mkdir.c Makefile.in cpio.texi mkinstalldirs - To upgrade to a newer version of cpio, when it is available: 1. - Unpack the new version into an empty directory. [Do not make ANY - changes to the files.] 2. Remove the files listed above and any - others that don't apply to FreeBSD. 3. Use the command: cvs import - -m 'Virgin import of GNU cpio v<version>' \ src/contrib/cpio - GNU v<version> For example, to do the import of version - 2.4.2, I typed: cvs import -m 'Virgin import of GNU v2.4.2' \ - src/contrib/cpio GNU v2.4.2 4. Follow the instructions printed out - in step 3 to resolve any conflicts between local FreeBSD changes - and the newer version. Do not, under any circumstances, deviate - from this procedure. To make local changes to cpio, simply patch - and commit to the main branch (aka HEAD). Never make local - changes on the GNU branch. All local changes should be submitted - to "cpio@gnu.ai.mit.edu" for inclusion in the next vendor release. - obrien@freebsd.org - 30 March 1997</literallayout> - </para> + <programlisting> +This directory contains virgin sources of the original distribution files +on a "vendor" branch. Do not, under any circumstances, attempt to upgrade +the files in this directory via patches and a cvs commit. New versions or +official-patch versions must be imported. Please remember to import with +"-ko" to prevent CVS from corrupting any vendor RCS Ids. + +For the import of GNU cpio 2.4.2, the following files were removed: + + INSTALL cpio.info mkdir.c + Makefile.in cpio.texi mkinstalldirs + +To upgrade to a newer version of cpio, when it is available: + 1. Unpack the new version into an empty directory. + [Do not make ANY changes to the files.] + + 2. Remove the files listed above and any others that don't apply to + FreeBSD. + + 3. Use the command: + cvs import -ko -m 'Virgin import of GNU cpio v<version>' \ + src/contrib/cpio GNU cpio_<version> + + For example, to do the import of version 2.4.2, I typed: + cvs import -ko -m 'Virgin import of GNU v2.4.2' \ + src/contrib/cpio GNU cpio_2_4_2 + + 4. Follow the instructions printed out in step 3 to resolve any + conflicts between local FreeBSD changes and the newer version. + +Do not, under any circumstances, deviate from this procedure. + +To make local changes to cpio, simply patch and commit to the main +branch (aka HEAD). Never make local changes on the GNU branch. + +All local changes should be submitted to "cpio@gnu.ai.mit.edu" for +inclusion in the next vendor release. + +obrien@freebsd.org - 30 March 1997 + </programlisting> </sect1> @@ -32686,10 +33004,11 @@ an A record in the DNS for "customer.com".</programlisting> overridable by the config option. This is usually done with something like:</para> - <para> - <literallayout>#ifndef THIS_OPTION #define THIS_OPTION - (some_default_value) #endif /* THIS_OPTION */</literallayout> - </para> + <programlisting> +#ifndef THIS_OPTION +#define THIS_OPTION (some_default_value) +#endif /* THIS_OPTION */ + </programlisting> <para>This way, an administrator mentioning another value for the option in his config file will take the default out of effect, and @@ -32702,10 +33021,13 @@ an A record in the DNS for "customer.com".</programlisting> enable or disable a particular piece of code by embracing it in</para> - <para> - <literallayout>#ifdef THAT_OPTION [your code here] - #endif</literallayout> - </para> + <programlisting> +#ifdef THAT_OPTION + +[your code here] + +#endif + </programlisting> <para>Simply mentioning <symbol>THAT_OPTION</symbol> in the config file (with or without any value) will then turn on the corresponding @@ -32717,9 +33039,9 @@ an A record in the DNS for "customer.com".</programlisting> referencing it... However, it's unlikely that many people would put</para> - <para> - <literallayout> options notyet,notdef</literallayout> - </para> + <programlisting> +options notyet,notdef + </programlisting> <para>in their config file, and then wonder why the kernel compilation falls over. :-)</para> @@ -32777,26 +33099,26 @@ an A record in the DNS for "customer.com".</programlisting> Unless you have just invented your option, and it does not exist anywhere yet,</para> - <para> - <literallayout> find /usr/src/sys -name type f | xargs fgrep - NEW_OPTION</literallayout> - </para> + <informalexample> + <screen>&prompt.user; <userinput>find /usr/src/sys -name type f | xargs fgrep NEW_OPTION</userinput></screen> + </informalexample> <para>is your friend in finding them. Go and edit all those files, and add</para> - <para> - <literallayout>#include "opt_foo.h"</literallayout> - </para> + <programlisting> +#include "opt_foo.h" + </programlisting> <para><emphasis>on top</emphasis>, before all the <literal>#include <xxx.h></literal> stuff. This sequence is most important as the options could override defaults from the regular include files, if the defaults are of the form</para> - <para> - <literallayout>#ifndef NEW_OPTION #define NEW_OPTION (something) - #endif</literallayout> - </para> + <programlisting> +#ifndef NEW_OPTION +#define NEW_OPTION (something) +#endif + </programlisting> <para>in the regular header.</para> @@ -32871,10 +33193,12 @@ an A record in the DNS for "customer.com".</programlisting> in order to get your system up and running again, boot it only into single user state using the <option>-s</option> flag at the boot prompt, and then perform the following steps: + <informalexample> - <screen>&prompt.root; fsck -p mount -a -t ufs # so your file system for - /var/crash is writable &prompt.root; savecore -N /kernel.panicked /var/crash - &prompt.root; exit # ...to multi-user</screen> + <screen>&prompt.root; <userinput>fsck -p</userinput> +&prompt.root; <userinput>mount -a -t ufs</userinput> # so your file system for /var/crash is writable +&prompt.root; <userinput>savecore -N /kernel.panicked /var/crash</userinput> +&prompt.root; <userinput>exit</userinput> # ...to multi-user</screen> </informalexample> This instructs <citerefentry><refentrytitle>savecore</refentrytitle><manvolnum>8</manvolnum></citerefentry> to use another kernel for symbol name extraction. It would otherwise default to the currently running kernel and most likely not do @@ -32885,8 +33209,9 @@ an A record in the DNS for "customer.com".</programlisting> <filename>/sys/compile/WHATEVER</filename> and run <command>kgdb</command>. From <command>kgdb</command> do: <informalexample> - <screen> symbol-file kernel.debug exec-file /var/crash/kernel.0 - core-file /var/crash/vmcore.0</screen> + <screen><userinput>symbol-file kernel.debug</userinput> +<userinput>exec-file /var/crash/kernel.0</userinput> +<userinput>core-file /var/crash/vmcore.0</userinput></screen> </informalexample> and voila, you can debug the crash dump using the kernel sources just like you can for any other program.</para> @@ -32895,65 +33220,88 @@ an A record in the DNS for "customer.com".</programlisting> improve readability, and the lines are numbered for reference. Despite this, it is a real-world error trace taken during the development of the pcvt console driver. + <informalexample> - <screen> 1:Script started on Fri Dec 30 23:15:22 1994 2:uriah # - cd /sys/compile/URIAH 3:uriah # kgdb kernel /var/crash/vmcore.1 - 4:Reading symbol data from - /usr/src/sys/compile/URIAH/kernel...done. 5:IdlePTD 1f3000 - 6:panic: because you said to! 7:current pcb at 1e3f70 8:Reading - in symbols for ../../i386/i386/machdep.c...done. 9:(kgdb) where - 10:#0 boot (arghowto=256) (../../i386/i386/machdep.c line 767) - 11:#1 0xf0115159 in panic () 12:#2 0xf01955bd in diediedie () - (../../i386/i386/machdep.c line 698) 13:#3 0xf010185e in - db_fncall () 14:#4 0xf0101586 in db_command (-266509132, - -266509516, -267381073) 15:#5 0xf0101711 in db_command_loop () - 16:#6 0xf01040a0 in db_trap () 17:#7 0xf0192976 in kdb_trap - (12, 0, -272630436, -266743723) 18:#8 0xf019d2eb in trap_fatal - (...) 19:#9 0xf019ce60 in trap_pfault (...) 20:#10 0xf019cb2f - in trap (...) 21:#11 0xf01932a1 in exception:calltrap () 22:#12 - 0xf0191503 in cnopen (...) 23:#13 0xf0132c34 in spec_open () - 24:#14 0xf012d014 in vn_open () 25:#15 0xf012a183 in open () - 26:#16 0xf019d4eb in syscall (...) 27:(kgdb) up 10 28:Reading in - symbols for ../../i386/i386/trap.c...done. 29:#10 0xf019cb2f in - trap (frame={tf_es = -260440048, tf_ds = 16, tf_\ 30:edi = 3072, - tf_esi = -266445372, tf_ebp = -272630356, tf_isp = -27\ - 31:2630396, tf_ebx = -266427884, tf_edx = 12, tf_ecx = - -266427884, tf\ 32:_eax = 64772224, tf_trapno = 12, tf_err = - -272695296, tf_eip = -26\ 33:6672343, tf_cs = -266469368, - tf_eflags = 66066, tf_esp = 3072, tf_\ 34:ss = -266427884}) - (../../i386/i386/trap.c line 283) 35:283 - (void) trap_pfault(&frame, FALSE); 36:(kgdb) frame - frame->tf_ebp frame->tf_eip 37:Reading in symbols for - ../../i386/isa/pcvt/pcvt_drv.c...done. 38:#0 0xf01ae729 in - pcopen (dev=3072, flag=3, mode=8192, p=(struct p\ 39:roc *) - 0xf07c0c00) (../../i386/isa/pcvt/pcvt_drv.c line 403) 40:403 - return ((*linesw[tp->t_line].l_open)(dev, tp)); 41:(kgdb) - list 42:398 43:399 tp->t_state |= - TS_CARR_ON; 44:400 tp->t_cflag |= CLOCAL; /* - cannot be a modem (:-) */ 45:401 46:402 #if PCVT_NETBSD - || (PCVT_FREEBSD >= 200) 47:403 return - ((*linesw[tp->t_line].l_open)(dev, tp)); 48:404 #else - 49:405 return ((*linesw[tp->t_line].l_open)(dev, - tp, flag)); 50:406 #endif /* PCVT_NETBSD || (PCVT_FREEBSD - >= 200) */ 51:407 } 52:(kgdb) print tp 53:Reading in - symbols for ../../i386/i386/cons.c...done. 54:$1 = (struct tty - *) 0x1bae 55:(kgdb) print tp->t_line 56:$2 = 1767990816 - 57:(kgdb) up 58:#1 0xf0191503 in cnopen (dev=0x00000000, - flag=3, mode=8192, p=(st\ 59:ruct proc *) 0xf07c0c00) - (../../i386/i386/cons.c line 126) 60: return - ((*cdevsw[major(dev)].d_open)(dev, flag, mode, p)); 61:(kgdb) up - 62:#2 0xf0132c34 in spec_open () 63:(kgdb) up 64:#3 0xf012d014 - in vn_open () 65:(kgdb) up 66:#4 0xf012a183 in open () - 67:(kgdb) up 68:#5 0xf019d4eb in syscall (frame={tf_es = 39, - tf_ds = 39, tf_edi =\ 69: 2158592, tf_esi = 0, tf_ebp = - -272638436, tf_isp = -272629788, tf\ 70:_ebx = 7086, tf_edx = 1, - tf_ecx = 0, tf_eax = 5, tf_trapno = 582, \ 71:tf_err = 582, - tf_eip = 75749, tf_cs = 31, tf_eflags = 582, tf_esp \ 72:= - -272638456, tf_ss = 39}) (../../i386/i386/trap.c line 673) - 73:673 error = (*callp->sy_call)(p, args, rval); - 74:(kgdb) up 75:Initial frame selected; you cannot go up. - 76:(kgdb) quit 77:uriah # exit 78:exit 79: 80:Script done on Fri - Dec 30 23:18:04 1994</screen> + <screen> 1:Script started on Fri Dec 30 23:15:22 1994 + 2:&prompt.root; <userinput>cd /sys/compile/URIAH</userinput> + 3:&prompt.root; <userinput>kgdb kernel /var/crash/vmcore.1</userinput> + 4:Reading symbol data from /usr/src/sys/compile/URIAH/kernel...done. + 5:IdlePTD 1f3000 + 6:panic: because you said to! + 7:current pcb at 1e3f70 + 8:Reading in symbols for ../../i386/i386/machdep.c...done. + 9:<prompt>(kgdb)</prompt> <userinput>where</userinput> +10:#0 boot (arghowto=256) (../../i386/i386/machdep.c line 767) +11:#1 0xf0115159 in panic () +12:#2 0xf01955bd in diediedie () (../../i386/i386/machdep.c line 698) +13:#3 0xf010185e in db_fncall () +14:#4 0xf0101586 in db_command (-266509132, -266509516, -267381073) +15:#5 0xf0101711 in db_command_loop () +16:#6 0xf01040a0 in db_trap () +17:#7 0xf0192976 in kdb_trap (12, 0, -272630436, -266743723) +18:#8 0xf019d2eb in trap_fatal (...) +19:#9 0xf019ce60 in trap_pfault (...) +20:#10 0xf019cb2f in trap (...) +21:#11 0xf01932a1 in exception:calltrap () +22:#12 0xf0191503 in cnopen (...) +23:#13 0xf0132c34 in spec_open () +24:#14 0xf012d014 in vn_open () +25:#15 0xf012a183 in open () +26:#16 0xf019d4eb in syscall (...) +27:<prompt>(kgdb)</prompt> <userinput>up 10</userinput> +28:Reading in symbols for ../../i386/i386/trap.c...done. +29:#10 0xf019cb2f in trap (frame={tf_es = -260440048, tf_ds = 16, tf_\ +30:edi = 3072, tf_esi = -266445372, tf_ebp = -272630356, tf_isp = -27\ +31:2630396, tf_ebx = -266427884, tf_edx = 12, tf_ecx = -266427884, tf\ +32:_eax = 64772224, tf_trapno = 12, tf_err = -272695296, tf_eip = -26\ +33:6672343, tf_cs = -266469368, tf_eflags = 66066, tf_esp = 3072, tf_\ +34:ss = -266427884}) (../../i386/i386/trap.c line 283) +35:283 (void) trap_pfault(&frame, FALSE); +36:<prompt>(kgdb)</prompt> <userinput>frame frame->tf_ebp frame->tf_eip</userinput> +37:Reading in symbols for ../../i386/isa/pcvt/pcvt_drv.c...done. +38:#0 0xf01ae729 in pcopen (dev=3072, flag=3, mode=8192, p=(struct p\ +39:roc *) 0xf07c0c00) (../../i386/isa/pcvt/pcvt_drv.c line 403) +40:403 return ((*linesw[tp->t_line].l_open)(dev, tp)); +41:<prompt>(kgdb)</prompt> <userinput>list</userinput> +42:398 +43:399 tp->t_state |= TS_CARR_ON; +44:400 tp->t_cflag |= CLOCAL; /* cannot be a modem (:-) */ +45:401 +46:402 #if PCVT_NETBSD || (PCVT_FREEBSD >= 200) +47:403 return ((*linesw[tp->t_line].l_open)(dev, tp)); +48:404 #else +49:405 return ((*linesw[tp->t_line].l_open)(dev, tp, flag)); +50:406 #endif /* PCVT_NETBSD || (PCVT_FREEBSD >= 200) */ +51:407 } +52:<prompt>(kgdb)</prompt> <userinput>print tp</userinput> +53:Reading in symbols for ../../i386/i386/cons.c...done. +54:$1 = (struct tty *) 0x1bae +55:<prompt>(kgdb)</prompt> <userinput>print tp->t_line</userinput> +56:$2 = 1767990816 +57:<prompt>(kgdb)</prompt> <userinput>up</userinput> +58:#1 0xf0191503 in cnopen (dev=0x00000000, flag=3, mode=8192, p=(st\ +59:ruct proc *) 0xf07c0c00) (../../i386/i386/cons.c line 126) +60: return ((*cdevsw[major(dev)].d_open)(dev, flag, mode, p)); +61:<prompt>(kgdb)</prompt> <userinput>up</userinput> +62:#2 0xf0132c34 in spec_open () +63:<prompt>(kgdb)</prompt> <userinput>up</userinput> +64:#3 0xf012d014 in vn_open () +65:<prompt>(kgdb)</prompt> <userinput>up</userinput> +66:#4 0xf012a183 in open () +67:<prompt>(kgdb)</prompt> <userinput>up</userinput> +68:#5 0xf019d4eb in syscall (frame={tf_es = 39, tf_ds = 39, tf_edi =\ +69: 2158592, tf_esi = 0, tf_ebp = -272638436, tf_isp = -272629788, tf\ +70:_ebx = 7086, tf_edx = 1, tf_ecx = 0, tf_eax = 5, tf_trapno = 582, \ +71:tf_err = 582, tf_eip = 75749, tf_cs = 31, tf_eflags = 582, tf_esp \ +72:= -272638456, tf_ss = 39}) (../../i386/i386/trap.c line 673) +73:673 error = (*callp->sy_call)(p, args, rval); +74:<prompt>(kgdb)</prompt> <userinput>up</userinput> +75:Initial frame selected; you cannot go up. +76:<prompt>(kgdb)</prompt> <userinput>quit</userinput> +77:&prompt.root; <userinput>exit</userinput> +78:exit +79: +80:Script done on Fri Dec 30 23:18:04 1994</screen> </informalexample> Comments to the above script:</para> <para> @@ -33073,9 +33421,10 @@ an A record in the DNS for "customer.com".</programlisting> the full debug information like <command>kgdb</command>.</para> <para>To configure your kernel to include DDB, add the option line - <informalexample> - <screen> options DDB</screen> - </informalexample> to your config file, and rebuild. (See <xref + + <programlisting> +options DDB + </programlisting> to your config file, and rebuild. (See <xref linkend="kernelconfig" remap="Kernel Configuration"> for details on configuring the FreeBSD kernel.</para> @@ -33111,7 +33460,8 @@ an A record in the DNS for "customer.com".</programlisting> <para>The DDB commands roughly resemble some <command>gdb</command> commands. The first thing you probably need to do is to set a breakpoint: <informalexample> - <screen> b function-name b address</screen> + <screen><userinput>b function-name</userinput> +<userinput>b address</userinput></screen> </informalexample> </para> @@ -33124,11 +33474,13 @@ an A record in the DNS for "customer.com".</programlisting> 0x103</literal>.</para> <para>To continue the operation of an interrupted kernel, simply type + <informalexample> - <screen> c</screen> + <screen><userinput>c</userinput></screen> </informalexample> To get a stack trace, use + <informalexample> - <screen> trace</screen> + <screen><userinput>trace</userinput></screen> </informalexample></para> <note> @@ -33138,21 +33490,26 @@ an A record in the DNS for "customer.com".</programlisting> </note> <para>If you want to remove a breakpoint, use + <informalexample> - <screen> del del address-expression</screen> + <screen><userinput>del</userinput> +<userinput>del address-expression</userinput></screen> </informalexample> The first form will be accepted immediately after a breakpoint hit, and deletes the current breakpoint. The second form can remove any breakpoint, but you need to specify the exact address; this can be obtained from + <informalexample> - <screen> show b</screen> + <screen><userinput>show b</userinput></screen> </informalexample> To single-step the kernel, try + <informalexample> - <screen> s</screen> + <screen><userinput>s</userinput></screen> </informalexample> This will step into functions, but you can make DDB trace them until the matching return statement is reached by + <informalexample> - <screen> n</screen> + <screen><userinput>n</userinput></screen> </informalexample> </para> @@ -33162,26 +33519,33 @@ an A record in the DNS for "customer.com".</programlisting> </note> <para>To examine data from memory, use (for example): + <informalexample> - <screen> x/wx 0xf0133fe0,40 x/hd db_symtab_space x/bc termbuf,10 - x/s stringbuf</screen> + <screen><userinput>x/wx 0xf0133fe0,40</userinput> +<userinput>x/hd db_symtab_space</userinput> +<userinput>x/bc termbuf,10</userinput> +<userinput>x/s stringbuf</userinput></screen> </informalexample> for word/halfword/byte access, and hexadecimal/decimal/character/ string display. The number after the comma is the object count. To display the next 0x10 items, simply use + <informalexample> - <screen> x ,10</screen> + <screen><userinput>x ,10</userinput></screen> </informalexample> Similarly, use + <informalexample> - <screen> x/ia foofunc,10</screen> + <screen><userinput>x/ia foofunc,10</userinput></screen> </informalexample> to disassemble the first 0x10 instructions of <emphasis remap=tt>foofunc</emphasis>, and display them along with their offset from the beginning of <emphasis remap=tt>foofunc</emphasis>.</para> <para>To modify memory, use the write command: + <informalexample> - <screen> w/b termbuf 0xa 0xb 0 w/w 0xf0010030 0 0</screen> + <screen><userinput>w/b termbuf 0xa 0xb 0</userinput> +<userinput>w/w 0xf0010030 0 0</userinput></screen> </informalexample> The command modifier (<emphasis remap=tt>b</emphasis>/<emphasis remap=tt>h</emphasis>/<emphasis remap=tt>w</emphasis>) specifies the size of the data to be @@ -33190,28 +33554,33 @@ an A record in the DNS for "customer.com".</programlisting> memory locations.</para> <para>If you need to know the current registers, use + <informalexample> - <screen> show reg</screen> + <screen><userinput>show reg</userinput></screen> </informalexample> Alternatively, you can display a single register value by e.g. + <informalexample> - <screen> p $eax</screen> + <screen><userinput>p $eax</userinput></screen> </informalexample> and modify it by + <informalexample> - <screen> set $eax new-value</screen> + <screen><userinput>set $eax new-value</userinput></screen> </informalexample> </para> <para>Should you need to call some kernel functions from DDB, simply say + <informalexample> - <screen> call func(arg1, arg2, ...)</screen> + <screen><userinput>call func(arg1, arg2, ...)</userinput></screen> </informalexample> The return value will be printed.</para> <para>For a <citerefentry><refentrytitle>ps</refentrytitle><manvolnum>1</manvolnum></citerefentry> style summary of all running processes, use + <informalexample> - <screen> ps</screen> + <screen><userinput>ps</userinput></screen> </informalexample> </para> @@ -33220,8 +33589,9 @@ an A record in the DNS for "customer.com".</programlisting> malfunctioning, not all parts of the kernel might still be working as expected. Perform one of the following actions to shut down and reboot your system: + <informalexample> - <screen> call diediedie()</screen> + <screen><userinput>call diediedie()</userinput></screen> </informalexample> </para> @@ -33232,7 +33602,7 @@ an A record in the DNS for "customer.com".</programlisting> <para> <informalexample> - <screen> call boot(0)</screen> + <screen><userinput>call boot(0)</userinput></screen> </informalexample> might be a good way to cleanly shut down the running system, <function>sync()</function> all disks, and finally reboot. As long as the disk and file system interfaces of the @@ -33241,13 +33611,13 @@ an A record in the DNS for "customer.com".</programlisting> <para> <informalexample> - <screen> call cpu_reset()</screen> + <screen><userinput>call cpu_reset()</userinput></screen> </informalexample> is the final way out of disaster and almost the same as hitting the Big Red Button.</para> <para>If you need a short command summary, simply type <informalexample> - <screen> help</screen> + <screen><userinput>help</userinput></screen> </informalexample> However, it is highly recommended to have a printed copy of the <citerefentry><refentrytitle>ddb</refentrytitle><manvolnum>4</manvolnum></citerefentry> manual page ready for a debugging session. Remember that it is hard to read the @@ -33279,28 +33649,33 @@ an A record in the DNS for "customer.com".</programlisting> option. Connect the first serial line of the target machine to any serial line of the debugging host. Now, on the debugging machine, go to the compile directory of the target kernel, and start gdb: + <informalexample> - <screen>&prompt.user; gdb -k kernel GDB is free software and you are welcome - to distribute copies of it under certain conditions; type "show - copying" to see the conditions. There is absolutely no warranty - for GDB; type "show warranty" for details. GDB 4.16 - (i386-unknown-freebsd), Copyright 1996 Free Software - Foundation, Inc... (kgdb) </screen> + <screen>&prompt.user; <userinput>gdb -k kernel</userinput> +GDB is free software and you are welcome to distribute copies of it + under certain conditions; type "show copying" to see the conditions. +There is absolutely no warranty for GDB; type "show warranty" for details. +GDB 4.16 (i386-unknown-freebsd), +Copyright 1996 Free Software Foundation, Inc... +<prompt>(kgdb)</prompt> </screen> </informalexample> </para> <para>Initialize the remote debugging session (assuming the first serial port is being used) by: + <informalexample> - <screen>(kgdb) target remote /dev/cuaa0</screen> + <screen><prompt>(kgdb)</prompt> <userinput>target remote /dev/cuaa0</userinput></screen> </informalexample> </para> <para>Now, on the target host (the one that entered DDB right before even starting the device probe), type: + <informalexample> - <screen>Debugger("Boot flags requested debugger") Stopped at - Debugger+0x35: movb $0, edata+0x51bc db> gdb</screen> + <screen>Debugger("Boot flags requested debugger") +Stopped at Debugger+0x35: movb $0, edata+0x51bc +<prompt>db></prompt> <userinput>gdb</userinput></screen> </informalexample> </para> @@ -33315,9 +33690,10 @@ an A record in the DNS for "customer.com".</programlisting> immediately, simply type <command>s</command> (step). Your hosting GDB will now gain control over the target kernel: <informalexample> - <screen>Remote debugging using /dev/cuaa0 Debugger (msg=0xf01b0383 - "Boot flags requested debugger") at - ../../i386/i386/db_interface.c:257 (kgdb) </screen> + <screen>Remote debugging using /dev/cuaa0 +Debugger (msg=0xf01b0383 "Boot flags requested debugger") + at ../../i386/i386/db_interface.c:257 +<prompt>(kgdb)</prompt></screen> </informalexample> </para> @@ -33328,19 +33704,22 @@ an A record in the DNS for "customer.com".</programlisting> <para>Remote GDB can also be used to debug LKMs. First build the LKM with debugging symbols: + <informalexample> - <screen>&prompt.root; cd /usr/src/lkm/linux &prompt.root; make clean; make - COPTS=-g</screen> + <screen>&prompt.root; <userinput>cd /usr/src/lkm/linux</userinput> +&prompt.root; <userinput>make clean; make COPTS=-g</userinput></screen> </informalexample> </para> <para>Then install this version of the module on the target machine, load it and use <command>modstat</command> to find out where it was loaded: + <informalexample> - <screen>&prompt.root; linux &prompt.root; modstat Type Id Off Loadaddr Size Info - Rev Module Name EXEC 0 4 f5109000 001c f510f010 1 - linux_mod</screen> + <screen>&prompt.root; <userinput>linux</userinput> +&prompt.root; <userinput>modstat</userinput> +Type Id Off Loadaddr Size Info Rev Module Name +EXEC 0 4 f5109000 001c f510f010 1 linux_mod</screen> </informalexample> </para> @@ -33348,11 +33727,12 @@ an A record in the DNS for "customer.com".</programlisting> account for the a.out header). This is the address that the module code was relocated to. Use the <command>add-symbol-file</command> command in GDB to tell the debugger about the module: + <informalexample> - <screen>(kgdb) add-symbol-file /usr/src/lkm/linux/linux_mod.o - 0xf5109020 add symbol table from file - "/usr/src/lkm/linux/linux_mod.o" at text_addr = 0xf5109020? (y - or n) y (kgdb)</screen> + <screen><prompt>(kgdb)</prompt> <userinput>add-symbol-file /usr/src/lkm/linux/linux_mod.o 0xf5109020</userinput> +add symbol table from file "/usr/src/lkm/linux/linux_mod.o" at +text_addr = 0xf5109020? (y or n) <userinput>y</userinput> +<prompt>(kgdb)</prompt></screen> </informalexample> </para> @@ -33402,11 +33782,7 @@ an A record in the DNS for "customer.com".</programlisting> <para>To tell whether your kernel is configured for Linux compatibility simply run any Linux binary. If it prints the error - message - <informalexample> - <screen>linux-executable: Exec format error. Wrong - Architecture.</screen> - </informalexample> then you do not have linux compatibility support + message <errorname> linux-executable: Exec format error. Wrong Architecture.</errorname> then you do not have linux compatibility support and you need to configure and install a new kernel.</para> <para>Depending on which version of FreeBSD you are running, how you @@ -33426,24 +33802,28 @@ an A record in the DNS for "customer.com".</programlisting> <para>To enable the emulator, add the following to your configuration file (c.f. <filename>/sys/i386/conf/LINT</filename>): - <informalexample> - <screen>options COMPAT_LINUX</screen> - </informalexample> If you want to run doom or other applications + + <programlisting> +options COMPAT_LINUX + </programlisting> If you want to run doom or other applications that need shared memory, also add the following. - <informalexample> - <screen>options SYSVSHM</screen> - </informalexample> The linux system calls require 4.3BSD system + + <programlisting> +options SYSVSHM + </programlisting> The linux system calls require 4.3BSD system call compatibility. So make sure you have the following. - <informalexample> - <screen>options "COMPAT_43"</screen> - </informalexample> + + <programlisting> +options "COMPAT_43" + </programlisting> </para> <para>If you prefer to statically link the emulator in the kernel rather than use the loadable kernel module (LKM), then add - <informalexample> - <screen>options LINUX</screen> - </informalexample> Then run config and install the new kernel as + + <programlisting> +options LINUX + </programlisting> Then run config and install the new kernel as described in the <xref linkend="kernelconfig" remap="kernel configuration"> section.</para> @@ -33452,30 +33832,36 @@ an A record in the DNS for "customer.com".</programlisting> loadable module. A mismatch of versions between the kernel and loadable module can cause the kernel to crash, so the safest thing to do is to reinstall the LKM when you install the kernel. + <informalexample> - <screen>&prompt.root; cd /usr/src/lkm/linux &prompt.root; make all install</screen> + <screen>&prompt.root; <userinput>cd /usr/src/lkm/linux</userinput> +&prompt.root; <userinput>make all install</userinput></screen> </informalexample> Once you have installed the kernel and the LKM, you can invoke `linux' as root to load the LKM. + <informalexample> - <screen>&prompt.root; linux Linux emulator installed Module loaded as ID 0 - &prompt.root;</screen> + <screen>&prompt.root; <userinput>linux</userinput> +Linux emulator installed +Module loaded as ID 0</screen> </informalexample> To see whether the LKM is loaded, run `modstat'. <informalexample> - <screen>&prompt.user; modstat Type Id Off Loadaddr Size Info Rev - Module Name EXEC 0 3 f0baf000 0018 f0bb4000 1 - linux_emulator &prompt.user;</screen> + <screen>&prompt.user; modstat +Type Id Off Loadaddr Size Info Rev +Module Name EXEC 0 3 f0baf000 0018 f0bb4000 1 linux_emulator</screen> &prompt.user;</screen> </informalexample> You can cause the LKM to be loaded when the system boots in either of two ways. In FreeBSD 2.2.1-RELEASE and 2.1-STABLE enable it in <filename>/etc/sysconfig</filename> - <informalexample> - <screen>linux=YES</screen> - </informalexample> by changing it from NO to YES. FreeBSD 2.1 + + <programlisting> +linux=YES + </programlisting> by changing it from NO to YES. FreeBSD 2.1 RELEASE and earlier do not have such a line and on those you will - need to edit /etc/rc.local to add the following line. - <informalexample> - <screen>linux</screen> - </informalexample> + need to edit <filename>/etc/rc.local</filename> to add the following line. + + <programlisting> +linux + </programlisting> </para> </sect2> @@ -33493,21 +33879,23 @@ an A record in the DNS for "customer.com".</programlisting> <listitem> <para> In <filename>/etc/rc.conf</filename>, you need the following line: - <informalexample> - <screen>linux_enable=YES</screen> - </informalexample> + + <programlisting> +linux_enable=YES + </programlisting> </para> </listitem> <listitem> <para> This, in turn, triggers the following action in <filename>/etc/rc.i386</filename>: - <informalexample> - <screen># Start the Linux binary emulation if requested. - if [ "X${linux_enable}" = X"YES" ]; then echo -n ' - linux'; linux > /dev/null 2>&1 - fi</screen> - </informalexample> + + <programlisting> +# Start the Linux binary emulation if requested. +if [ "X${linux_enable}" = X"YES" ]; then echo -n ' + linux'; linux > /dev/null 2>&1 +fi + </programlisting> </para> </listitem> @@ -33515,17 +33903,19 @@ an A record in the DNS for "customer.com".</programlisting> </para> <para>If you want to verify it is running, modstat will do that: + <informalexample> - <screen>&prompt.user; modstat Type Id Off Loadaddr Size Info Rev - Module Name EXEC 0 4 f09e6000 001c f09ec010 1 - linux_mod &prompt.user;</screen> + <screen>&prompt.user; modstat +Type Id Off Loadaddr Size Info Rev Module Name +EXEC 0 4 f09e6000 001c f09ec010 1 linux_mod</screen> </informalexample> However, there have been reports that this fails on some 2.2-RELEASE and later systems. If for some reason you cannot load the linux LKM, then statically link the emulator in the kernel by adding - <informalexample> - <screen>options LINUX</screen> - </informalexample> to your kernel config file. Then run config + + <programlisting> +options LINUX + </programlisting> to your kernel config file. Then run config and install the new kernel as described in the <xref linkend="kernelconfig" remap="kernel configuration"> section.</para> @@ -33543,9 +33933,10 @@ an A record in the DNS for "customer.com".</programlisting> still not done until you install the shared libraries. It is possible to do this by hand, however, it is vastly simpler to just grab the linux_lib port: + <informalexample> - <screen>&prompt.root; cd /usr/ports-current/emulators/linux_lib &prompt.root; make all - install</screen> + <screen>&prompt.root; <userinput>cd /usr/ports-current/emulators/linux_lib</userinput> +&prompt.root; <userinput>make all install</userinput></screen> </informalexample> </para> @@ -33612,10 +34003,10 @@ an A record in the DNS for "customer.com".</programlisting> <para> <informalexample> - <screen>&prompt.user; ldd linuxxdoom libXt.so.3 (DLL Jump 3.1) => - /usr/X11/lib/libXt.so.3.1.0 libX11.so.3 (DLL Jump 3.1) => - /usr/X11/lib/libX11.so.3.1.0 libc.so.4 (DLL Jump 4.5pl26) - => /lib/libc.so.4.6.29</screen> + <screen>&prompt.user; <userinput>ldd linuxxdoom</userinput> +libXt.so.3 (DLL Jump 3.1) => /usr/X11/lib/libXt.so.3.1.0 +libX11.so.3 (DLL Jump 3.1) => /usr/X11/lib/libX11.so.3.1.0 +libc.so.4 (DLL Jump 4.5pl26) => /lib/libc.so.4.6.29</screen> </informalexample> </para> @@ -33624,13 +34015,13 @@ an A record in the DNS for "customer.com".</programlisting> names in the first column as symbolic links pointing to them. This means you eventually have these files on your FreeBSD system: + <informalexample> <screen>/compat/linux/usr/X11/lib/libXt.so.3.1.0 - /compat/linux/usr/X11/lib/libXt.so.3 -> libXt.so.3.1.0 - /compat/linux/usr/X11/lib/libX11.so.3.1.0 - /compat/linux/usr/X11/lib/libX11.so.3 -> libX11.so.3.1.0 - /compat/linux/lib/libc.so.4.6.29 /compat/linux/lib/libc.so.4 - -> libc.so.4.6.29</screen> +/compat/linux/usr/X11/lib/libXt.so.3 -> libXt.so.3.1.0 +/compat/linux/usr/X11/lib/libX11.so.3.1.0 +/compat/linux/usr/X11/lib/libX11.so.3 -> libX11.so.3.1.0 +/compat/linux/lib/libc.so.4.6.29 /compat/linux/lib/libc.so.4 -> libc.so.4.6.29</screen> </informalexample> </para> @@ -33646,15 +34037,15 @@ an A record in the DNS for "customer.com".</programlisting> <informalexample> <screen>/compat/linux/lib/libc.so.4.6.27 - /compat/linux/lib/libc.so.4 -> libc.so.4.6.27</screen> +/compat/linux/lib/libc.so.4 -> libc.so.4.6.27</screen> </informalexample> </para> <para>and you find a new binary that claims to require a later version according to the output of ldd: + <informalexample> - <screen>libc.so.4 (DLL Jump 4.5pl26) -> - libc.so.4.6.29</screen> + <screen>libc.so.4 (DLL Jump 4.5pl26) -> libc.so.4.6.29</screen> </informalexample> </para> @@ -33665,9 +34056,10 @@ an A record in the DNS for "customer.com".</programlisting> However, if you like you can decide to replace the <filename>libc.so</filename> anyway, and that should leave you with: + <informalexample> <screen>/compat/linux/lib/libc.so.4.6.29 - /compat/linux/lib/libc.so.4 -> libc.so.4.6.29</screen> +/compat/linux/lib/libc.so.4 -> libc.so.4.6.29</screen> </informalexample> </para> </note> @@ -33692,9 +34084,10 @@ an A record in the DNS for "customer.com".</programlisting> your system. You should copy these files from the Linux system to their appropriate place on your FreeBSD system (to the <filename>/compat/linux</filename> tree): + <informalexample> <screen>/compat/linux/lib/ld.so - /compat/linux/etc/ld.so.config</screen> +/compat/linux/etc/ld.so.config</screen> </informalexample> </para> @@ -33708,13 +34101,16 @@ an A record in the DNS for "customer.com".</programlisting> <filename>/compat/linux</filename> (i.e. <filename>/foo/bar</filename> is installed as <filename>/compat/linux/foo/bar</filename>): + <informalexample> - <screen>/sbin/ldconfig /usr/bin/ldd /lib/libc.so.x.y.z - /lib/ld.so</screen> + <screen>/sbin/ldconfig +/usr/bin/ldd +/lib/libc.so.x.y.z +/lib/ld.so</screen> </informalexample> </para> - <para>ldconfig and ldd do not necessarily need to be under + <para><filename>ldconfig</filename> and <filename>ldd</filename> do not necessarily need to be under <filename>/compat/linux</filename>; you can install them elsewhere in the system too. Just make sure they do not conflict with their FreeBSD counterparts. A good idea would be to install @@ -33728,9 +34124,11 @@ an A record in the DNS for "customer.com".</programlisting> name on each line. <filename>/lib</filename> and <filename>/usr/lib</filename> are standard, you could add the following: - <informalexample> - <screen>/usr/X11/lib /usr/local/lib</screen> - </informalexample> + + <programlisting> +/usr/X11/lib +/usr/local/lib + </programlisting> </para> <para>When a linux binary opens a library such as @@ -33743,8 +34141,10 @@ an A record in the DNS for "customer.com".</programlisting> <para>Those running FreeBSD 2.2-RELEASE should run the Linux ldconfig program. + <informalexample> - <screen>&prompt.root cd /compat/linux/lib &prompt.root; /compat/linux/sbin/ldconfig + <screen>&prompt.root <userinput>cd /compat/linux/lib</userinput> +&prompt.root; <userinput>/compat/linux/sbin/ldconfig</userinput> </screen> </informalexample> </para> @@ -33765,9 +34165,10 @@ an A record in the DNS for "customer.com".</programlisting> a shared libc. You can test this by running the Linux ldd on itself. Supposing that you have it installed as ldd-linux, it should produce something like: + <informalexample> - <screen>&prompt.root; ldd-linux `which ldd-linux` libc.so.4 (DLL Jump - 4.5pl26) => /lib/libc.so.4.6.29</screen> + <screen>&prompt.root; <userinput>ldd-linux `which ldd-linux`</userinput> +libc.so.4 (DLL Jump 4.5pl26) => /lib/libc.so.4.6.29</screen> </informalexample> </para> @@ -33795,17 +34196,20 @@ an A record in the DNS for "customer.com".</programlisting> <title>Configuring the host name resolver</title> <para>If DNS does not work or you get the messages + <informalexample> - <screen>resolv+: "bind" is an invalid keyword resolv+: "hosts" - is an invalid keyword</screen> + <screen>resolv+: "bind" is an invalid keyword resolv+: +"hosts" is an invalid keyword</screen> </informalexample> </para> <para>then you need to configure a <filename>/compat/linux/etc/host.conf</filename> file containing: - <informalexample> - <screen>order hosts, bind multi on</screen> - </informalexample> + + <programlisting> +order hosts, bind +multi on + </programlisting> </para> <para>where the order here specifies that @@ -33823,16 +34227,16 @@ an A record in the DNS for "customer.com".</programlisting> know how to search the host tables. If you run FreeBSD 2.2-RELEASE, you can skip this. For the <filename>/bin/csh</filename> shell use: + <informalexample> - <screen>setenv RESOLV_HOST_CONF - /compat/linux/etc/host.conf</screen> + <screen>&prompt.user; <userinput>setenv RESOLV_HOST_CONF /compat/linux/etc/host.conf</userinput></screen> </informalexample> </para> <para>For <filename>/bin/sh</filename> use: + <informalexample> - <screen>RESOLV_HOST_CONF=/compat/linux/etc/host.conf; export - RESOLV_HOST_CONF</screen> + <screen>&prompt.user; <userinput>RESOLV_HOST_CONF=/compat/linux/etc/host.conf; export RESOLV_HOST_CONF</userinput></screen> </informalexample> </para> @@ -33856,14 +34260,33 @@ an A record in the DNS for "customer.com".</programlisting> stored in distribution sets, usually consisting of subdirectories with gzipped tar files in them. The primary ftp sites for the distributions are: - <literallayout>sunsite.unc.edu:/pub/Linux/distributions - tsx-11.mit.edu:/pub/linux/distributions</literallayout> + + <orderedlist> + <listitem> + <para>sunsite.unc.edu:/pub/Linux/distributions</para> + </listitem> + + <listitem> + <para>tsx-11.mit.edu:/pub/linux/distributions</para> + </listitem> + </orderedlist> </para> <para>Some European mirrors: - <literallayout>ftp.luth.se:/pub/linux/distributions - ftp.demon.co.uk:/pub/linux/distributions - src.doc.ic.ac.uk:/packages/linux/distributions</literallayout> + + <orderedlist> + <listitem> + <para>ftp.luth.se:/pub/linux/distributions</para> + </listitem> + + <listitem> + <para>ftp.demon.co.uk:/pub/linux/distributions</para> + </listitem> + + <listitem> + <para>src.doc.ic.ac.uk:/packages/linux/distributions</para> + </listitem> + </orderedlist> </para> <para>For simplicity, let us concentrate on Slackware here. This @@ -33877,11 +34300,17 @@ an A record in the DNS for "customer.com".</programlisting> subdirectory, and grep through them for the file you need. Here is an example of a list of files that you might need, and in which contents-file you will find it by grepping through them: - <table> - <title></title> + + <informaltable frame="none"> <tgroup cols="2"> + <thead> + <row> + <entry>Library</entry> + <entry>Package</entry> + </row> + </thead> + <tbody> - <row><entry>Library </entry><entry>Package </entry></row> <row><entry><filename>ld.so</filename> </entry><entry>ldso </entry></row> <row><entry><filename>ldconfig</filename> @@ -33904,7 +34333,7 @@ an A record in the DNS for "customer.com".</programlisting> </entry></row> </tbody> </tgroup> - </table> + </informaltable> </para> <para>So, in this case, you will need the packages ldso, shlibs, @@ -33913,18 +34342,24 @@ an A record in the DNS for "customer.com".</programlisting> tell you on which <quote>disk</quote> the package is, in our case it will tell us in which subdirectory we need to look. For our example, we would find the following locations: - <table> - <title></title> + + <informaltable frame="none"> <tgroup cols="2"> + <thead + <row> + <entry>Package</entry> + <entry>Location</entry> + </row> + </thead> + <tbody> - <row><entry>Package </entry><entry>Location </entry></row> <row><entry>ldso </entry><entry>diska2 </entry></row> <row><entry>shlibs </entry><entry>diska2 </entry></row> <row><entry>oldlibs </entry><entry>diskx6 </entry></row> <row><entry>xf_lib </entry><entry>diskx9 </entry></row> </tbody> </tgroup> - </table> + </informaltable> </para> <para>The locations called <quote>disk<replaceable>XX</replaceable></quote> refer to the <filename>slakware/<replaceable>XX</replaceable></filename> @@ -33933,10 +34368,24 @@ an A record in the DNS for "customer.com".</programlisting> could now retrieve the packages we need by retrieving the following files (relative to the root of the Slackware distribution tree): - <informalexample> - <screen>slakware/a2/ldso.tgz slakware/a2/shlibs.tgz - slakware/x6/oldlibs/tgz slakware/x9/xf_lib.tgz</screen> - </informalexample> + + <itemizedlist> + <listitem> + <para><filename>slakware/a2/ldso.tgz</filename></para> + </listitem> + + <listitem> + <para><filename>slakware/a2/shlibs.tgz</filename></para> + </listitem> + + <listitem> + <para><filename>slakware/x6/oldlibs/tgz</filename></para> + </listitem> + + <listitem> + <para><filename>slakware/x9/xf_lib.tgz</filename></para> + </listitem> + </itemizedlist> </para> <para>Extract the files from these gzipped tarfiles in your @@ -33945,7 +34394,7 @@ an A record in the DNS for "customer.com".</programlisting> done.</para> <para><emphasis remap=bf>See also:</emphasis> - <literallayout>ftp.freebsd.org:pub/FreeBSD/2.0.5-RELEASE/xperimnt/linux-emu/README /usr/src/sys/i386/ibcs2/README.iBCS2</literallayout> + <filename>ftp.freebsd.org:pub/FreeBSD/2.0.5-RELEASE/xperimnt/linux-emu/README</filename> and <filename>/usr/src/sys/i386/ibcs2/README.iBCS2</filename> </para> </sect2> @@ -33980,9 +34429,12 @@ an A record in the DNS for "customer.com".</programlisting> Linux is named <filename>LINUX.TAR</filename>. You can, for example, unpack this into <filename>/usr/local/Mathematica</filename>: + <informalexample> - <screen>&prompt.root; cd /usr/local &prompt.root; mkdir Mathematica &prompt.root; cd Mathematica &prompt.root; - tar -xvf /cdrom/LINUX.TAR</screen> + <screen>&prompt.root; <userinput>cd /usr/local</userinput> +&prompt.root; <userinput>mkdir Mathematica</userinput> +&prompt.root; <userinput>cd Mathematica</userinput> +&prompt.root; <userinput>tar -xvf /cdrom/LINUX.TAR</userinput></screen> </informalexample> </para> @@ -33998,10 +34450,12 @@ an A record in the DNS for "customer.com".</programlisting> <para>Once you have installed the linux compatibility runtime libraries and unpacked the mathematica you can obtain the `machine ID' by running the program `mathinfo' in the Install directory. + <informalexample> - <screen>&prompt.root; cd /usr/local/Mathematica/Install &prompt.root; mathinfo LINUX: - 'ioctl' fd=5, typ=0x89(), num=0x27 not implemented - richc.isdn.bcm.tmc.edu 9845-03452-90255 &prompt.root;</screen> + <screen>&prompt.root; <userinput>cd /usr/local/Mathematica/Install</userinput> +&prompt.root; <userinput>mathinfo</userinput> +LINUX: 'ioctl' fd=5, typ=0x89(), num=0x27 not implemented +richc.isdn.bcm.tmc.edu 9845-03452-90255</screen> </informalexample> So, for example, the `machine ID' of `richc' is `9845-03452-90255'. You can ignore the message about the ioctl that is not implemented. It will not prevent Mathematica from @@ -34015,9 +34469,10 @@ an A record in the DNS for "customer.com".</programlisting> your mathpass file.</para> <para>You can do this by invoking: + <informalexample> - <screen>&prompt.root; cd /usr/local/Mathematica/Install &prompt.root; - math.install</screen> + <screen>&prompt.root; <userinput>cd /usr/local/Mathematica/Install</userinput> +&prompt.root; <userinput>math.install</userinput></screen> </informalexample> It will ask you to enter your license number and the Wolfram supplied password. If you get them mixed up or for some reason the math.install fails, that is OK; you can simply @@ -34034,13 +34489,28 @@ an A record in the DNS for "customer.com".</programlisting> before you give them to the install program. Or, if it fails, you can create the directories and then restart the math.install program. The directories we chose to create beforehand and - specify to math.install were: - <informalexample> - <screen>/usr/local/Mathematica/bin for binaries - /usr/local/Mathematica/man/man1 for man pages - /usr/local/Mathematica/lib/X11 for the XKeysymb - file</screen> - </informalexample> You can also tell it to use + specify to <command>math.install</command> were: + + <informaltable frame="none"> + <tgroup cols="2"> + <tbody> + <row> + <entry><filename>/usr/local/Mathematica/bin</filename></entry> + <entry>for binaries</entry> + </row> + + <row> + <entry><filename>/usr/local/Mathematica/man/man1</filename></entry> + <entry>for man pages</entry> + </row> + + <row> + <entry>/usr/local/Mathematica/lib/X11</entry> + <entry>for the XKeysymb file</entry> + </row> + </tbody> + </tgroup> + </informaltable> You can also tell it to use <filename>/tmp/math.record</filename> for the system record file, where it puts logs of sessions. After this math.install will continue on to unpacking things and placing everything where it @@ -34050,7 +34520,7 @@ an A record in the DNS for "customer.com".</programlisting> the X Front End, and you have to install it separately. To get the X Front End stuff correctly installed, cd into the <filename>/usr/local/Mathematica/FrontEnd</filename> directory and - execute the ./xfe.install shell script. You will have to tell it + execute the <command>xfe.install</command> shell script. You will have to tell it where to put things, but you do not have to create any directories because it will use the same directories that had been created for math.install. When it finishes, there should be a new shell script @@ -34061,18 +34531,18 @@ an A record in the DNS for "customer.com".</programlisting> Mathematica has installed. At the beginning of every shell script in <filename>/usr/local/Mathematica/bin</filename> add the following line: + <informalexample> - <screen>XKEYSYMDB=/usr/local/Mathematica/lib/X11/XKeysymDB; - export XKEYSYMDB</screen> + <screen>&prompt.user; <userinput>XKEYSYMDB=/usr/local/Mathematica/lib/X11/XKeysymDB; export XKEYSYMDB</userinput></screen> </informalexample> This tells Mathematica were to find its own version of the key mapping file <filename>XKeysymDB</filename>. Without this you will get pages of error messages about missing key mappings.</para> <para>On 2.1-STABLE you need to add the following as well: + <informalexample> - <screen>RESOLV_HOST_CONF=/compat/linux/etc/host.conf; export - RESOLV_HOST_CONF</screen> + <screen>&prompt.user; <userinput>RESOLV_HOST_CONF=/compat/linux/etc/host.conf; export RESOLV_HOST_CONF</userinput></screen> </informalexample> This tells Mathematica to use the linux version of host.conf. This file has a different syntax from FreeBSD's host.conf, so you will get an error message about @@ -34099,8 +34569,7 @@ an A record in the DNS for "customer.com".</programlisting> <para>The Notebook front end is known to hang sometimes when reading notebook files with an error messages similar to: <informalexample> - <screen>File .../Untitled-1.mb appears to be broken for - OMPR.257.0</screen> + <screen><errorname>File .../Untitled-1.mb appears to be broken for OMPR.257.0</errorname></screen> </informalexample> </para> @@ -34883,38 +35352,213 @@ an A record in the DNS for "customer.com".</programlisting> 3)</title> <para>DMA Address and Count Registers</para> - - <para> - <literallayout>0x00 write Channel 0 starting address - 0x00 read Channel 0 current address 0x01 write - Channel 0 starting word count 0x01 read Channel 0 - remaining word count 0x02 write Channel 1 starting - address 0x02 read Channel 1 current address 0x03 write - Channel 1 starting word count 0x03 read Channel 1 - remaining word count 0x04 write Channel 2 starting - address 0x04 read Channel 2 current address 0x05 write - Channel 2 starting word count 0x05 read Channel 2 - remaining word count 0x06 write Channel 3 starting - address 0x06 read Channel 3 current address 0x07 write - Channel 3 starting word count 0x07 read Channel 3 - remaining word count</literallayout> - </para> - + + <informaltable frame="none"> + <tgroup cols="3"> + <tbody> + <row> + <entry>0x00</entry> + <entry>write</entry> + <entry>Channel 0 starting address</entry> + </row> + + <row> + <entry>0x00</entry> + <entry>read</entry> + <entry>Channel 0 current address</entry> + </row> + + <row> + <entry>0x01</entry> + <entry>write</entry> + <entry>Channel 0 starting word count</entry> + </row> + + <row> + <entry>0x01</entry> + <entry>read</entry> + <entry>Channel 0 remaining word count</entry> + </row> + + <row> + <entry>0x02</entry> + <entry>write</entry> + <entry>Channel 1 starting address</entry> + </row> + + <row> + <entry>0x02</entry> + <entry>read</entry> + <entry>Channel 1 current address</entry> + </row> + + <row> + <entry>0x03</entry> + <entry>write</entry> + <entry>Channel 1 starting word count</entry> + </row> + + <row> + <entry>0x03</entry> + <entry>read</entry> + <entry>Channel 1 remaining word count</entry> + </row> + + <row> + <entry>0x04</entry> + <entry>write</entry> + <entry>Channel 2 starting address</entry> + </row> + + <row> + <entry>0x04</entry> + <entry>read</entry> + <entry>Channel 2 current address</entry> + </row> + + <row> + <entry>0x05</entry> + <entry>write</entry> + <entry>Channel 2 starting word count</entry> + </row> + + <row> + <entry>0x05</entry> + <entry>read</entry> + <entry>Channel 2 remaining word count</entry> + </row> + + <row> + <entry>0x06</entry> + <entry>write</entry> + <entry>Channel 3 starting address</entry> + </row> + + <row> + <entry>0x06</entry> + <entry>read</entry> + <entry>Channel 3 current address</entry> + </row> + + <row> + <entry>0x07</entry> + <entry>write</entry> + <entry>Channel 3 starting word count</entry> + </row> + + <row> + <entry>0x07</entry> + <entry>read</entry> + <entry>Channel 3 remaining word count</entry> + </row> + </tbody> + </tgroup> + </informaltable> + <para>DMA Command Registers</para> - - <para> - <literallayout>0x08 write Command Register 0x08 read - Status Register 0x09 write Request Register 0x09 read - - 0x0a write Single Mask Register Bit 0x0a read - 0x0b - write Mode Register 0x0b read - 0x0c write Clear - LSB/MSB Flip-Flop 0x0c read - 0x0d write Master - Clear/Reset 0x0d read Temporary Register (not - available on newer versions) 0x0e write Clear Mask - Register 0x0e read - 0x0f write Write All Mask - Register Bits 0x0f read Read All Mask Register Bits - (only in Intel 82374)</literallayout> - </para> - + + <informaltable frame="none"> + <tgroup cols="3"> + <tbody> + <row> + <entry>0x08</entry> + <entry>write</entry> + <entry>Command Register</entry> + </row> + + <row> + <entry>0x08</entry> + <entry>read</entry> + <entry>Status Register</entry> + </row> + + <row> + <entry>0x09</entry> + <entry>write</entry> + <entry>Request Register</entry> + </row> + + <row> + <entry>0x09</entry> + <entry>read</entry> + <entry>-</entry> + </row> + + <row> + <entry>0x0a</entry> + <entry>write</entry> + <entry>Single Mask Register Bit</entry> + </row> + + <row> + <entry>0x0a</entry> + <entry>read</entry> + <entry>-</entry> + </row> + + <row> + <entry>0x0b</entry> + <entry>write</entry> + <entry>Mode Register</entry> + </row> + + <row> + <entry>0x0b</entry> + <entry>read</entry> + <entry>-</entry> + </row> + + <row> + <entry>0x0c</entry> + <entry>write</entry> + <entry>Clear LSB/MSB Flip-Flop</entry> + </row> + + <row> + <entry>0x0c</entry> + <entry>read</entry> + <entry>-</entry> + </row> + + <row> + <entry>0x0d</entry> + <entry>write</entry> + <entry>Master Clear/Reset</entry> + </row> + + <row> + <entry>0x0d</entry> + <entry>read</entry> + <entry>Termporary Register (not available on newer + versions)</entry> + </row> + <row> + <entry>0x0e</entry> + <entry>write</entry> + <entry>Clear Mask Register</entry> + </row> + + <row> + <entry>0x0e</entry> + <entry>read</entry> + <entry>-</entry> + </row> + + <row> + <entry>0x0f</entry> + <entry>write</entry> + <entry>Write All Mask Register Bits</entry> + </row> + + <row> + <entry>0x0f</entry> + <entry>read</entry> + <entry>Read All Mask Register Bits (only in Intel + 82374)</entry> + </row> + </tbody> + </tgroup> + </informaltable> </sect3> <sect3> @@ -34922,55 +35566,272 @@ an A record in the DNS for "customer.com".</programlisting> 7)</title> <para>DMA Address and Count Registers</para> - - <para> - <literallayout>0xc0 write Channel 4 starting address - 0xc0 read Channel 4 current address 0xc2 write - Channel 4 starting word count 0xc2 read Channel 4 - remaining word count 0xc4 write Channel 5 starting - address 0xc4 read Channel 5 current address 0xc6 write - Channel 5 starting word count 0xc6 read Channel 5 - remaining word count 0xc8 write Channel 6 starting - address 0xc8 read Channel 6 current address 0xca write - Channel 6 starting word count 0xca read Channel 6 - remaining word count 0xcc write Channel 7 starting - address 0xcc read Channel 7 current address 0xce write - Channel 7 starting word count 0xce read Channel 7 - remaining word count</literallayout> - </para> + + <informaltable frame="none"> + <tgroup cols="3"> + <tbody> + <row> + <entry>0xc0</entry> + <entry>write</entry> + <entry>Channel 4 starting address</entry> + </row> + + <row> + <entry>0xc0</entry> + <entry>read</entry> + <entry>Channel 4 current address</entry> + </row> + + <row> + <entry>0xc2</entry> + <entry>write</entry> + <entry>Channel 4 starting word count</entry> + </row> + + <row> + <entry>0xc2</entry> + <entry>read</entry> + <entry>Channel 4 remaining word count</entry> + </row> + + <row> + <entry>0xc4</entry> + <entry>write</entry> + <entry>Channel 5 starting address</entry> + </row> + + <row> + <entry>0xc4</entry> + <entry>read</entry> + <entry>Channel 5 current address</entry> + </row> + + <row> + <entry>0xc6</entry> + <entry>write</entry> + <entry>Channel 5 starting word count</entry> + </row> + + <row> + <entry>0xc6</entry> + <entry>read</entry> + <entry>Channel 5 remaining word count</entry> + </row> + + <row> + <entry>0xc8</entry> + <entry>write</entry> + <entry>Channel 6 starting address</entry> + </row> + + <row> + <entry>0xc8</entry> + <entry>read</entry> + <entry>Channel 6 current address</entry> + </row> + + <row> + <entry>0xca</entry> + <entry>write</entry> + <entry>Channel 6 starting word count</entry> + </row> + + <row> + <entry>0xca</entry> + <entry>read</entry> + <entry>Channel 6 remaining word count</entry> + </row> + + <row> + <entry>0xcc</entry> + <entry>write</entry> + <entry>Channel 7 starting address</entry> + </row> + + <row> + <entry>0xcc</entry> + <entry>read</entry> + <entry>Channel 7 current address</entry> + </row> + + <row> + <entry>0xce</entry> + <entry>write</entry> + <entry>Channel 7 starting word count</entry> + </row> + + <row> + <entry>0xce</entry> + <entry>read</entry> + <entry>Channel 7 remaining word count</entry> + </row> + </tbody> + </tgroup> + </informaltable> <para>DMA Command Registers</para> - - <para> - <literallayout>0xd0 write Command Register 0xd0 read - Status Register 0xd2 write Request Register 0xd2 read - - 0xd4 write Single Mask Register Bit 0xd4 read - 0xd6 - write Mode Register 0xd6 read - 0xd8 write Clear - LSB/MSB Flip-Flop 0xd8 read - 0xda write Master - Clear/Reset 0xda read Temporary Register (not - present in Intel 82374) 0xdc write Clear Mask Register - 0xdc read - 0xde write Write All Mask Register Bits - 0xdf read Read All Mask Register Bits (only in Intel - 82374)</literallayout> - </para> - + + <informaltable frame="none"> + <tgroup cols="3"> + <tbody> + <row> + <entry>0xd0</entry> + <entry>write</entry> + <entry>Command Register</entry> + </row> + + <row> + <entry>0xd0</entry> + <entry>read</entry> + <entry>Status Register</entry> + </row> + + <row> + <entry>0xd2</entry> + <entry>write</entry> + <entry>Request Register</entry> + </row> + + <row> + <entry>0xd2</entry> + <entry>read</entry> + <entry>-</entry> + </row> + + <row> + <entry>0xd4</entry> + <entry>write</entry> + <entry>Single Mask Register Bit</entry> + </row> + + <row> + <entry>0xd4</entry> + <entry>read</entry> + <entry>-</entry> + </row> + + <row> + <entry>0xd6</entry> + <entry>write</entry> + <entry>Mode Register</entry> + </row> + + <row> + <entry>0xd6</entry> + <entry>read</entry> + <entry>-</entry> + </row> + + <row> + <entry>0xd8</entry> + <entry>write</entry> + <entry>Clear LSB/MSB Flip-Flop</entry> + </row> + + <row> + <entry>0xd8</entry> + <entry>read</entry> + <entry>-</entry> + </row> + + <row> + <entry>0xda</entry> + <entry>write</entry> + <entry>Master Clear/Reset</entry> + </row> + + <row> + <entry>0xda</entry> + <entry>read</entry> + <entry>Termporary Register (not present in Intel + 82374)</entry> + </row> + + <row> + <entry>0xdc</entry> + <entry>write</entry> + <entry>Clear Mask Register</entry> + </row> + + <row> + <entry>0xdc</entry> + <entry>read</entry> + <entry>-</entry> + </row> + + <row> + <entry>0xde</entry> + <entry>write</entry> + <entry>Write All Mask Register Bits</entry> + </row> + + <row> + <entry>0xdf</entry> + <entry>read</entry> + <entry>Read All Mask Register Bits (only in Intel + 82374)</entry> + </row> + </tbody> + </tgroup> + </informaltable> </sect3> <sect3> <title>0x80 - 0x9f DMA Page Registers</title> - - <para> - <literallayout>0x87 r/w Channel 0 Low byte (23-16) - page Register 0x83 r/w Channel 1 Low byte (23-16) - page Register 0x81 r/w Channel 2 Low byte (23-16) - page Register 0x82 r/w Channel 3 Low byte (23-16) - page Register 0x8b r/w Channel 5 Low byte (23-16) - page Register 0x89 r/w Channel 6 Low byte (23-16) - page Register 0x8a r/w Channel 7 Low byte (23-16) - page Register 0x8f r/w Low byte page - Refresh</literallayout> - </para> - + + <informaltable frame="none"> + <tgroup cols="3"> + <tbody> + <row> + <entry>0x87</entry> + <entry>r/w</entry> + <entry>Channel 0 Low byte (23-16) page Register</entry> + </row> + + <row> + <entry>0x83</entry> + <entry>r/w</entry> + <entry>Channel 1 Low byte (23-16) page Register</entry> + </row> + + <row> + <entry>0x81</entry> + <entry>r/w</entry> + <entry>Channel 2 Low byte (23-16) page Register</entry> + </row> + + <row> + <entry>0x82</entry> + <entry>r/w</entry> + <entry>Channel 3 Low byte (23-16) page Register</entry> + </row> + + <row> + <entry>0x8b</entry> + <entry>r/w</entry> + <entry>Channel 5 Low byte (23-16) page Register</entry> + </row> + + <row> + <entry>0x89</entry> + <entry>r/w</entry> + <entry>Channel 6 Low byte (23-16) page Register</entry> + </row> + + <row> + <entry>0x8a</entry> + <entry>r/w</entry> + <entry>Channel 7 Low byte (23-16) page Register</entry> + </row> + + <row> + <entry>0x8f</entry> + <entry>r/w</entry> + <entry>Low byte page Refresh</entry> + </row> + </tbody> + </tgroup> + </informaltable> </sect3> <sect3> @@ -34994,75 +35855,397 @@ an A record in the DNS for "customer.com".</programlisting> some of the 82374 enhanced registers to zero to provide backward software compatibility.</para> - <para> - <literallayout>0x401 r/w Channel 0 High byte (bits - 23-16) word count 0x403 r/w Channel 1 High byte (bits - 23-16) word count 0x405 r/w Channel 2 High byte (bits - 23-16) word count 0x407 r/w Channel 3 High byte (bits - 23-16) word count 0x4c6 r/w Channel 5 High byte (bits - 23-16) word count 0x4ca r/w Channel 6 High byte (bits - 23-16) word count 0x4ce r/w Channel 7 High byte (bits - 23-16) word count 0x487 r/w Channel 0 High byte (bits - 31-24) page Register 0x483 r/w Channel 1 High byte - (bits 31-24) page Register 0x481 r/w Channel 2 High - byte (bits 31-24) page Register 0x482 r/w Channel 3 High - byte (bits 31-24) page Register 0x48b r/w Channel 5 High - byte (bits 31-24) page Register 0x489 r/w Channel 6 High - byte (bits 31-24) page Register 0x48a r/w Channel 6 High - byte (bits 31-24) page Register 0x48f r/w High byte page - Refresh 0x4e0 r/w Channel 0 Stop Register (bits 7-2) - 0x4e1 r/w Channel 0 Stop Register (bits 15-8) 0x4e2 - r/w Channel 0 Stop Register (bits 23-16) 0x4e4 r/w - Channel 1 Stop Register (bits 7-2) 0x4e5 r/w - Channel 1 Stop Register (bits 15-8) 0x4e6 r/w - Channel 1 Stop Register (bits 23-16) 0x4e8 r/w - Channel 2 Stop Register (bits 7-2) 0x4e9 r/w - Channel 2 Stop Register (bits 15-8) 0x4ea r/w - Channel 2 Stop Register (bits 23-16) 0x4ec r/w - Channel 3 Stop Register (bits 7-2) 0x4ed r/w - Channel 3 Stop Register (bits 15-8) 0x4ee r/w - Channel 3 Stop Register (bits 23-16) 0x4f4 r/w - Channel 5 Stop Register (bits 7-2) 0x4f5 r/w - Channel 5 Stop Register (bits 15-8) 0x4f6 r/w - Channel 5 Stop Register (bits 23-16) 0x4f8 r/w - Channel 6 Stop Register (bits 7-2) 0x4f9 r/w - Channel 6 Stop Register (bits 15-8) 0x4fa r/w - Channel 6 Stop Register (bits 23-16) 0x4fc r/w - Channel 7 Stop Register (bits 7-2) 0x4fd r/w - Channel 7 Stop Register (bits 15-8) 0x4fe r/w - Channel 7 Stop Register (bits 23-16) 0x40a write - Channels 0-3 Chaining Mode Register 0x40a read - Channel Interrupt Status Register 0x4d4 write Channels 4-7 - Chaining Mode Register 0x4d4 read Chaining Mode Status - 0x40c read Chain Buffer Expiration Control Register 0x410 - write Channel 0 Scatter-Gather Command Register 0x411 write - Channel 1 Scatter-Gather Command Register 0x412 write - Channel 2 Scatter-Gather Command Register 0x413 write - Channel 3 Scatter-Gather Command Register 0x415 write - Channel 5 Scatter-Gather Command Register 0x416 write - Channel 6 Scatter-Gather Command Register 0x417 write - Channel 7 Scatter-Gather Command Register 0x418 read - Channel 0 Scatter-Gather Status Register 0x419 read - Channel 1 Scatter-Gather Status Register 0x41a read - Channel 2 Scatter-Gather Status Register 0x41b read - Channel 3 Scatter-Gather Status Register 0x41d read - Channel 5 Scatter-Gather Status Register 0x41e read - Channel 5 Scatter-Gather Status Register 0x41f read - Channel 7 Scatter-Gather Status Register 0x420-0x423 r/w - Channel 0 Scatter-Gather Descriptor Table Pointer Register - 0x424-0x427 r/w Channel 1 Scatter-Gather Descriptor Table - Pointer Register 0x428-0x42b r/w Channel 2 - Scatter-Gather Descriptor Table Pointer Register 0x42c-0x42f - r/w Channel 3 Scatter-Gather Descriptor Table Pointer - Register 0x434-0x437 r/w Channel 5 Scatter-Gather - Descriptor Table Pointer Register 0x438-0x43b r/w - Channel 6 Scatter-Gather Descriptor Table Pointer Register - 0x43c-0x43f r/w Channel 7 Scatter-Gather Descriptor Table - Pointer Register</literallayout> - </para> - - <para> </para> - + <informaltable frame="none"> + <tgroup cols="3"> + <tbody> + <row> + <entry>0x401</entry> + <entry>r/w</entry> + <entry>Channel 0 High byte (bits 23-16) word count</entry> + </row> + + <row> + <entry>0x403</entry> + <entry>r/w</entry> + <entry>Channel 1 High byte (bits 23-16) word count</entry> + </row> + + <row> + <entry>0x405</entry> + <entry>r/w</entry> + <entry>Channel 2 High byte (bits 23-16) word count</entry> + </row> + + <row> + <entry>0x407</entry> + <entry>r/w</entry> + <entry>Channel 3 High byte (bits 23-16) word count</entry> + </row> + + <row> + <entry>0x4c6</entry> + <entry>r/w</entry> + <entry>Channel 5 High byte (bits 23-16) word count</entry> + </row> + + <row> + <entry>0x4ca</entry> + <entry>r/w</entry> + <entry>Channel 6 High byte (bits 23-16) word count</entry> + </row> + + <row> + <entry>0x4ce</entry> + <entry>r/w</entry> + <entry>Channel 7 High byte (bits 23-16) word count</entry> + </row> + + <row> + <entry>0x487</entry> + <entry>r/w</entry> + <entry>Channel 0 High byte (bits 31-24) page + Register</entry> + </row> + + <row> + <entry>0x483</entry> + <entry>r/w</entry> + <entry>Channel 1 High byte (bits 31-24) page + Register</entry> + </row> + + <row> + <entry>0x481</entry> + <entry>r/w</entry> + <entry>Channel 2 High byte (bits 31-24) page + Register</entry> + </row> + + <row> + <entry>0x482</entry> + <entry>r/w</entry> + <entry>Channel 3 High byte (bits 31-24) page + Register</entry> + </row> + + <row> + <entry>0x48b</entry> + <entry>r/w</entry> + <entry>Channel 5 High byte (bits 31-24) page + Register</entry> + </row> + + <row> + <entry>0x489</entry> + <entry>r/w</entry> + <entry>Channel 6 High byte (bits 31-24) page + Register</entry> + </row> + + <row> + <entry>0x48a</entry> + <entry>r/w</entry> + <entry>Channel 6 High byte (bits 31-24) page + Register</entry> + </row> + + <row> + <entry>0x48f</entry> + <entry>r/w</entry> + <entry>High byte page Refresh</entry> + </row> + + <row> + <entry>0x4e0</entry> + <entry>r/w</entry> + <entry>Channel 0 Stop Register (bits 7-2)</entry> + </row> + + <row> + <entry>0x4e1</entry> + <entry>r/w</entry> + <entry>Channel 0 Stop Register (bits 15-8)</entry> + </row> + + <row> + <entry>0x4e2</entry> + <entry>r/w</entry> + <entry>Channel 0 Stop Register (bits 23-16)</entry> + </row> + + <row> + <entry>0x4e4</entry> + <entry>r/w</entry> + <entry>Channel 1 Stop Register (bits 7-2)</entry> + </row> + + <row> + <entry>0x4e5</entry> + <entry>r/w</entry> + <entry>Channel 1 Stop Register (bits 15-8)</entry> + </row> + + <row> + <entry>0x4e6</entry> + <entry>r/w</entry> + <entry>Channel 1 Stop Register (bits 23-16)</entry> + </row> + + <row> + <entry>0x4e8</entry> + <entry>r/w</entry> + <entry>Channel 2 Stop Register (bits 7-2)</entry> + </row> + + <row> + <entry>0x4e9</entry> + <entry>r/w</entry> + <entry>Channel 2 Stop Register (bits 15-8)</entry> + </row> + + <row> + <entry>0x4ea</entry> + <entry>r/w</entry> + <entry>Channel 2 Stop Register (bits 23-16)</entry> + </row> + + <row> + <entry>0x4ec</entry> + <entry>r/w</entry> + <entry>Channel 3 Stop Register (bits 7-2)</entry> + </row> + + <row> + <entry>0x4ed</entry> + <entry>r/w</entry> + <entry>Channel 3 Stop Register (bits 15-8)</entry> + </row> + + <row> + <entry>0x4ee</entry> + <entry>r/w</entry> + <entry>Channel 3 Stop Register (bits 23-16)</entry> + </row> + + <row> + <entry>0x4f4</entry> + <entry>r/w</entry> + <entry>Channel 5 Stop Register (bits 7-2)</entry> + </row> + + <row> + <entry>0x4f5</entry> + <entry>r/w</entry> + <entry>Channel 5 Stop Register (bits 15-8)</entry> + </row> + + <row> + <entry>0x4f6</entry> + <entry>r/w</entry> + <entry>Channel 5 Stop Register (bits 23-16)</entry> + </row> + + <row> + <entry>0x4f8</entry> + <entry>r/w</entry> + <entry>Channel 6 Stop Register (bits 7-2)</entry> + </row> + + <row> + <entry>0x4f9</entry> + <entry>r/w</entry> + <entry>Channel 6 Stop Register (bits 15-8)</entry> + </row> + + <row> + <entry>0x4fa</entry> + <entry>r/w</entry> + <entry>Channel 6 Stop Register (bits 23-16)</entry> + </row> + + <row> + <entry>0x4fc</entry> + <entry>r/w</entry> + <entry>Channel 7 Stop Register (bits 7-2)</entry> + </row> + + <row> + <entry>0x4fd</entry> + <entry>r/w</entry> + <entry>Channel 7 Stop Register (bits 15-8)</entry> + </row> + + <row> + <entry>0x4fe</entry> + <entry>r/w</entry> + <entry>Channel 7 Stop Register (bits 23-16)</entry> + </row> + + <row> + <entry>0x40a</entry> + <entry>write</entry> + <entry>Channels 0-3 Chaining Mode Register</entry> + </row> + + <row> + <entry>0x40a</entry> + <entry>read</entry> + <entry>Channel Interrupt Status Register</entry> + </row> + + <row> + <entry>0x4d4</entry> + <entry>write</entry> + <entry>Channels 4-7 Chaining Mode Register</entry> + </row> + + <row> + <entry>0x4d4</entry> + <entry>read</entry> + <entry>Chaining Mode Status</entry> + </row> + + <row> + <entry>0x40c</entry> + <entry>read</entry> + <entry>Chain Buffer Expiration Control Register</entry> + </row> + + <row> + <entry>0x410</entry> + <entry>write</entry> + <entry>Channel 0 Scatter-Gather Command Register</entry> + </row> + + <row> + <entry>0x411</entry> + <entry>write</entry> + <entry>Channel 1 Scatter-Gather Command Register</entry> + </row> + + <row> + <entry>0x412</entry> + <entry>write</entry> + <entry>Channel 2 Scatter-Gather Command Register</entry> + </row> + + <row> + <entry>0x413</entry> + <entry>write</entry> + <entry>Channel 3 Scatter-Gather Command Register</entry> + </row> + + <row> + <entry>0x415</entry> + <entry>write</entry> + <entry>Channel 5 Scatter-Gather Command Register</entry> + </row> + + <row> + <entry>0x416</entry> + <entry>write</entry> + <entry>Channel 6 Scatter-Gather Command Register</entry> + </row> + + <row> + <entry>0x417</entry> + <entry>write</entry> + <entry>Channel 7 Scatter-Gather Command Register</entry> + </row> + + <row> + <entry>0x418</entry> + <entry>read</entry> + <entry>Channel 0 Scatter-Gather Status Register</entry> + </row> + + <row> + <entry>0x419</entry> + <entry>read</entry> + <entry>Channel 1 Scatter-Gather Status Register</entry> + </row> + + <row> + <entry>0x41a</entry> + <entry>read</entry> + <entry>Channel 2 Scatter-Gather Status Register</entry> + </row> + + <row> + <entry>0x41b</entry> + <entry>read</entry> + <entry>Channel 3 Scatter-Gather Status Register</entry> + </row> + + <row> + <entry>0x41d</entry> + <entry>read</entry> + <entry>Channel 5 Scatter-Gather Status Register</entry> + </row> + + <row> + <entry>0x41e</entry> + <entry>read</entry> + <entry>Channel 5 Scatter-Gather Status Register</entry> + </row> + + <row> + <entry>0x41f</entry> + <entry>read</entry> + <entry>Channel 7 Scatter-Gather Status Register</entry> + </row> + + <row> + <entry>0x420-0x423</entry> + <entry>r/w</entry> + <entry>Channel 0 Scatter-Gather Descriptor Table Pointer + Register</entry> + </row> + + <row> + <entry>0x424-0x427</entry> + <entry>r/w</entry> + <entry>Channel 1 Scatter-Gather Descriptor Table Pointer + Register</entry> + </row> + + <row> + <entry>0x428-0x42b</entry> + <entry>r/w</entry> + <entry>Channel 2 Scatter-Gather Descriptor Table Pointer + Register</entry> + </row> + + <row> + <entry>0x42c-0x42f</entry> + <entry>r/w</entry> + <entry>Channel 3 Scatter-Gather Descriptor Table Pointer + Register</entry> + </row> + + <row> + <entry>0x434-0x437</entry> + <entry>r/w</entry> + <entry>Channel 5 Scatter-Gather Descriptor Table Pointer + Register</entry> + </row> + + <row> + <entry>0x438-0x43b</entry> + <entry>r/w</entry> + <entry>Channel 6 Scatter-Gather Descriptor Table Pointer + Register</entry> + </row> + + <row> + <entry>0x43c-0x43f</entry> + <entry>r/w</entry> + <entry>Channel 7 Scatter-Gather Descriptor Table Pointer + Register</entry> + </row> + </tbody> + </tgroup> + </informaltable> </sect3> </sect2> </sect1> @@ -35082,16 +36265,19 @@ an A record in the DNS for "customer.com".</programlisting> <title>CD-ROM Publishers</title> <para>FreeBSD is available on CD-ROM from Walnut Creek CDROM: - <blockquote> - <para>Walnut Creek CDROM<!-- <br> --> 4041 Pike Lane, Suite F<!-- - <br> --> Concord CA 94520 USA<!-- <br> --> Phone: +1 925 - 674-0783<!-- <br> --> Fax: +1 925 674-0821<!-- <br> --> Email: - <ulink URL="mailto:info@cdrom.com">info@cdrom.com</ulink><!-- - <br> --> WWW: <ulink - URL="http://www.cdrom.com/">http://www.cdrom.com/</ulink></para> - </blockquote> + + <address> + <otheraddr>Walnut Creek CDROM</otheraddr> + <street>4041 Pike Lane, Suite F</street> + <city>Concord</city> + <state>CA</state>, <postcode>94520</postcode> + <country>USA</country> + Phone: <phone>+1 925 674-0783</phone> + Fax: <fax>+1 925 674-0821</fax> + Email: <email>info@cdrom.com</email> + WWW: <otheraddr>http://www.cdrom.com/</otheraddr> + </address> </para> - </sect1> <sect1 @@ -36948,18 +38134,173 @@ an A record in the DNS for "customer.com".</programlisting> <title>List summary</title> <para><emphasis remap=bf>General lists:</emphasis> The following are - general lists which anyone is free to join: <literallayout>List - Purpose - ---------------------------------------------------------------------- freebsd-announce Important events and project milestones freebsd-bugs Bug reports freebsd-chat Non-technical items related to the FreeBSD community freebsd-current Discussion concerning the use of FreeBSD-current freebsd-stable Discussion concerning the use of FreeBSD-stable freebsd-isp Issues for Internet Service Providers using FreeBSD freebsd-jobs FreeBSD employment and consulting opportunities freebsd-questions User questions</literallayout> - </para> + general lists which anyone is free to join: </para> + + <informaltable frame="none"> + <tgroup cols="2"> + <thead> + <row> + <entry>List</entry> + <entry>Purpose</entry> + </row> + </thead> + + <tbody> + <row> + <entry>freebsd-announce</entry> + <entry>Important events and project milestones</entry> + </row> + + <row> + <entry>freebsd-bugs</entry> + <entry>Bug reports</entry> + </row> + + <row> + <entry>freebsd-chat</entry> + <entry>Non-technical items related to the FreeBSD + community</entry> + </row> + + <row> + <entry>freebsd-current</entry> + <entry>Discussion concerning the use of + FreeBSD-current</entry> + </row> + + <row> + <entry>freebsd-stable</entry> + <entry>Discussion concerning the use of + FreeBSD-stable</entry> + </row> + + <row> + <entry>freebsd-isp</entry> + <entry>Issues for Internet Service Providers using + FreeBSD</entry> + </row> + + <row> + <entry>freebsd-jobs</entry> + <entry>FreeBSD employment and consulting + opportunities</entry> + </row> + + <row> + <entry>freebsd-questions</entry> + <entry>User questions</entry> + </row> + </tbody> + </tgroup> + </informaltable> <para><emphasis remap=bf>Technical lists:</emphasis> The following lists are for technical discussion. You should read the charter for each list carefully before joining or sending mail to one as - there are firm guidelines for their use and content. - <literallayout>List Purpose - ---------------------------------------------------------------------- freebsd-afs Porting AFS to FreeBSD freebsd-alpha Porting FreeBSD to the Alpha freebsd-doc The FreeBSD Documentation project freebsd-emulation Emulation of other systems such as Linux/DOS/Windows freebsd-fs Filesystems freebsd-hackers General technical discussion freebsd-hardware General discussion of hardware for running FreeBSD freebsd-isdn ISDN developers freebsd-java Java developers and people porting JDKs to FreeBSD freebsd-mobile Discussions about mobile computing freebsd-multimedia Multimedia discussion freebsd-platforms Concerning ports to non-Intel architecture platforms freebsd-ports Discussion of the ports collection freebsd-scsi The SCSI subsystem freebsd-security Security issues freebsd-smp Design discussions for [A]Symmetric MultiProcessing freebsd-sparc Porting FreeBSD to Sparc systems.</literallayout> - </para> + there are firm guidelines for their use and content.</para> + + <informaltable frame="none"> + <tgroup cols="2"> + <thead> + <row> + <entry>List</entry> + <entry>Purpose</entry> + </row> + </thead> + + <tbody> + <row> + <entry>freebsd-afs</entry> + <entry>Porting AFS to FreeBSD</entry> + </row> + + <row> + <entry>freebsd-alpha</entry> + <entry>Porting FreeBSD to the Alpha</entry> + </row> + + <row> + <entry>freebsd-doc</entry> + <entry>The FreeBSD Documentation project</entry> + </row> + + <row> + <entry>freebsd-emulation</entry> + <entry>Emulation of other systems such as + Linux/DOS/Windows</entry> + </row> + + <row> + <entry>freebsd-fs</entry> + <entry>Filesystems</entry> + </row> + + <row> + <entry>freebsd-hackers</entry> + <entry>General technical discussion</entry> + </row> + + <row> + <entry>freebsd-hardware</entry> + <entry>General discussion of hardware for running + FreeBSD</entry> + </row> + + <row> + <entry>freebsd-isdn</entry> + <entry>ISDN developers</entry> + </row> + + <row> + <entry>freebsd-java</entry> + <entry>Java developers and people porting JDKs to + FreeBSD</entry> + </row> + + <row> + <entry>freebsd-mobile</entry> + <entry>Discussions about mobile computing</entry> + </row> + + <row> + <entry>freebsd-multimedia</entry> + <entry>Multimedia discussion</entry> + </row> + + <row> + <entry>freebsd-platforms</entry> + <entry>Concerning ports to non-Intel architecture + platforms</entry> + </row> + + <row> + <entry>freebsd-ports</entry> + <entry>Discussion of the ports collection</entry> + </row> + + <row> + <entry>freebsd-scsi</entry> + <entry>The SCSI subsystem</entry> + </row> + + <row> + <entry>freebsd-security</entry> + <entry>Security issues</entry> + </row> + + <row> + <entry>freebsd-smp</entry> + <entry>Design discussions for [A]Symmetric + MultiProcessing</entry> + </row> + + <row> + <entry>freebsd-sparc</entry> + <entry>Porting FreeBSD to Sparc systems</entry> + </row> + </tbody> + </tgroup> + </informaltable> <para><emphasis remap=bf>Limited lists:</emphasis> The following lists require approval from <ulink @@ -36967,9 +38308,56 @@ an A record in the DNS for "customer.com".</programlisting> though anyone is free to send messages to them which fall within the scope of their charters. It is also a good idea establish a presence in the technical lists before asking to join one of these - limited lists. <literallayout>List Purpose - ---------------------------------------------------------------------- freebsd-admin Administrative issues freebsd-arch Architecture and design discussions freebsd-core FreeBSD core team freebsd-hubs People running mirror sites (infrastructural support) freebsd-install Installation development freebsd-security-notifications Security notifications freebsd-user-groups User group coordination</literallayout> - </para> + limited lists.</para> + + <informaltable frame="none"> + <tgroup cols="2"> + <thead> + <row> + <entry>List</entry> + <entry>Purpose</entry> + </row> + </thead> + + <tbody> + <row> + <entry>freebsd-admin</entry> + <entry>Administrative issues</entry> + </row> + + <row> + <entry>freebsd-arch</entry> + <entry>Architecture and design discussions</entry> + </row> + + <row> + <entry>freebsd-core</entry> + <entry>FreeBSD core team</entry> + </row> + + <row> + <entry>freebsd-hubs</entry> + <entry>People running mirror sites (infrastructural + support)</entry> + </row> + + <row> + <entry>freebsd-install</entry> + <entry>Installation development</entry> + </row> + + <row> + <entry>freebsd-security-notifications</entry> + <entry>Security notifications</entry> + </row> + + <row> + <entry>freebsd-user-groups</entry> + <entry>User group coordination</entry> + </row> + </tbody> + </tgroup> + </informaltable> <para><emphasis remap=bf>CVS lists:</emphasis> The following lists are for people interested in seeing the log messages for changes @@ -36977,12 +38365,115 @@ an A record in the DNS for "customer.com".</programlisting> remap=bf>Read-Only</emphasis> lists and should not have mail sent to them.</para> - <para> - <literallayout>List name Source area Area - Description (source for) - ---------------------------------------------------------------------- cvs-CVSROOT /usr/src/[A-Z]* Top level /usr/src file changes cvs-all /usr/src All changes to the tree (superset) cvs-bin /usr/src/bin System binaries cvs-etc /usr/src/etc System files cvs-games /usr/src/games Games cvs-gnu /usr/src/gnu GPL'd utilities cvs-include /usr/src/include Include files cvs-kerberosIV /usr/src/kerberosIV Kerberos encryption code cvs-lib /usr/src/lib System libraries cvs-libexec /usr/src/libexec System binaries cvs-ports /usr/ports Ported software cvs-sbin /usr/src/sbin System binaries cvs-share /usr/src/share System shared files cvs-sys /usr/src/sys Kernel cvs-usrbin /usr/src/usr.bin Use binaries cvs-usrsbin /usr/src/usr.sbin System binaries</literallayout> - </para> - + <informaltable frame="none"> + <tgroup cols="3"> + <thead> + <row> + <entry>List</entry> + <entry>Source area</entry> + <entry>Area Description (source for)</entry> + </row> + </thead> + + <tbody> + <row> + <entry>cvs-CVSROOT</entry> + <entry>/usr/src/[A-Z]*</entry> + <entry>Top level /usr/src file changes</entry> + </row> + + <row> + <entry>cvs-all</entry> + <entry>/usr/src</entry> + <entry>All changes to the tree (superset)</entry> + </row> + + <row> + <entry>cvs-bin</entry> + <entry>/usr/src/bin</entry> + <entry>System binaries</entry> + </row> + + <row> + <entry>cvs-etc</entry> + <entry>/usr/src/etc</entry> + <entry>System files</entry> + </row> + + <row> + <entry>cvs-games</entry> + <entry>/usr/src/games</entry> + <entry>Games</entry> + </row> + + <row> + <entry>cvs-gnu</entry> + <entry>/usr/src/gnu</entry> + <entry>GPL'd utilities</entry> + </row> + + <row> + <entry>cvs-include</entry> + <entry>/usr/src/include</entry> + <entry>Include files</entry> + </row> + + <row> + <entry>cvs-kerberosIV</entry> + <entry>/usr/src/kerberosIV</entry> + <entry>Kerberos encryption code</entry> + </row> + + <row> + <entry>cvs-lib</entry> + <entry>/usr/src/lib</entry> + <entry>System libraries</entry> + </row> + + <row> + <entry>cvs-libexec</entry> + <entry>/usr/src/libexec</entry> + <entry>System binaries</entry> + </row> + + <row> + <entry>cvs-ports</entry> + <entry>/usr/ports</entry> + <entry>Ported software</entry> + </row> + + <row> + <entry>cvs-sbin</entry> + <entry>/usr/src/sbin</entry> + <entry>System binaries</entry> + </row> + + <row> + <entry>cvs-share</entry> + <entry>/usr/src/share</entry> + <entry>System shared files</entry> + </row> + + <row> + <entry>cvs-sys</entry> + <entry>/usr/src/sys</entry> + <entry>Kernel</entry> + </row> + + <row> + <entry>cvs-usrbin</entry> + <entry>/usr/src/usr.bin</entry> + <entry>Use binaries</entry> + </row> + + <row> + <entry>cvs-usrsbin</entry> + <entry>/usr/src/usr.sbin</entry> + <entry>System binaries</entry> + </row> + </tbody> + </tgroup> + </informaltable> </sect2> <sect2 @@ -36995,29 +38486,36 @@ an A record in the DNS for "customer.com".</programlisting> then be redistributed to mailing list members world-wide.</para> <para>To subscribe to a list, send mail to &a.majordomo; and include - <informalexample> - <screen>subscribe <listname> [<optional - address>]</screen> - </informalexample> In the body of your message. For example, to + + <programlisting> +subscribe <listname> [<optional address>] + </programlisting> In the body of your message. For example, to subscribe yourself to freebsd-announce, you'd do: + <informalexample> - <screen>&prompt.user; mail majordomo@FreeBSD.ORG subscribe freebsd-announce - ^D</screen> + <screen>&prompt.user; <userinput>mail majordomo@FreeBSD.ORG</userinput> +subscribe freebsd-announce +^D</screen> </informalexample> If you want to subscribe yourself under a different name, or submit a subscription request for a local mailing list (note: this is more efficient if you have several interested parties at one site, and highly appreciated by us!), you would do something like: + <informalexample> - <screen>&prompt.user; mail majordomo@FreeBSD.ORG subscribe freebsd-announce - local-announce@somesite.com ^D</screen> + <screen>&prompt.user; <userinput>mail majordomo@FreeBSD.ORG</userinput> +subscribe freebsd-announce local-announce@somesite.com +^D</screen> </informalexample> Finally, it is also possible to unsubscribe yourself from a list, get a list of other list members or see the list of mailing lists again by sending other types of control messages to majordomo. For a complete list of available commands, do this: + <informalexample> - <screen>&prompt.user; mail majordomo@FreeBSD.ORG help ^D</screen> + <screen>&prompt.user; <userinput>mail majordomo@FreeBSD.ORG</userinput> +help +^D</screen> </informalexample> Again, we would like to request that you keep discussion in the technical mailing lists on a technical track. If you are only interested in the <quote>high points</quote> then it is @@ -37102,8 +38600,9 @@ an A record in the DNS for "customer.com".</programlisting> <variablelist> <varlistentry><term>FREEBSD-AFS</term> <listitem> - <para><emphasis>Andrew File System</emphasis><!-- <br> --> - This list is for discussion on porting and using AFS from + <para><emphasis>Andrew File System</emphasis></para> + + <para>This list is for discussion on porting and using AFS from CMU/Transarc</para> </listitem> </varlistentry> @@ -37111,8 +38610,9 @@ an A record in the DNS for "customer.com".</programlisting> <varlistentry><term>FREEBSD-ADMIN</term> <listitem> - <para><emphasis>Administrative issues</emphasis><!-- <br> - --> This list is purely for discussion of freebsd.org + <para><emphasis>Administrative issues</emphasis></para> + + <para>This list is purely for discussion of freebsd.org related issues and to report problems or abuse of project resources. It is a closed list, though anyone may report a problem (with our systems!) to it.</para> @@ -37122,8 +38622,10 @@ an A record in the DNS for "customer.com".</programlisting> <varlistentry><term>FREEBSD-ANNOUNCE</term> <listitem> - <para><emphasis>Important events / milestones</emphasis><!-- - <br> --> This is the mailing list for people interested only + <para><emphasis>Important events / + milestones</emphasis></para> + + <para>This is the mailing list for people interested only in occasional announcements of significant freebsd events. This includes announcements about snapshots and other releases. It contains announcements of new FreeBSD @@ -37137,7 +38639,9 @@ an A record in the DNS for "customer.com".</programlisting> <listitem> <para><emphasis>Architecture and design - discussions</emphasis><!-- <br> --> This is the mailing + discussions</emphasis></para> + + <para>This is the mailing list for people discussing FreeBSD architectural issues. It is a closed list, and not for general subscription.</para> @@ -37147,7 +38651,9 @@ an A record in the DNS for "customer.com".</programlisting> <varlistentry><term>FREEBSD-BUGS</term> <listitem> - <para><emphasis>Bug reports</emphasis><!-- <br> --> This is + <para><emphasis>Bug reports</emphasis></para> + + <para>This is the mailing list for reporting bugs in FreeBSD Whenever possible, bugs should be submitted using the <citerefentry><refentrytitle>send-pr</refentrytitle><manvolnum>1</manvolnum></citerefentry> command or the <ulink @@ -37160,7 +38666,9 @@ an A record in the DNS for "customer.com".</programlisting> <listitem> <para><emphasis>Non technical items related to the FreeBSD - community</emphasis><!-- <br> --> This list contains the + community</emphasis></para> + + <para>This list contains the overflow from the other lists about non-technical, social information. It includes discussion about whether Jordan looks like a toon ferret or not, whether or not to type in @@ -37176,7 +38684,9 @@ an A record in the DNS for "customer.com".</programlisting> <varlistentry><term>FREEBSD-CORE</term> <listitem> - <para><emphasis>FreeBSD core team</emphasis><!-- <br> --> + <para><emphasis>FreeBSD core team</emphasis></para> + + <para> This is an internal mailing list for use by the core members. Messages can be sent to it when a serious FreeBSD-related matter requires arbitration or high-level @@ -37188,7 +38698,9 @@ an A record in the DNS for "customer.com".</programlisting> <listitem> <para><emphasis>Discussions about the use of - FreeBSD-current</emphasis><!-- <br> --> This is the + FreeBSD-current</emphasis></para> + + <para>This is the mailing list for users of freebsd-current. It includes warnings about new features coming out in -current that will affect the users, and instructions on steps that must @@ -37202,7 +38714,9 @@ an A record in the DNS for "customer.com".</programlisting> <listitem> <para><emphasis>Discussions about the use of - FreeBSD-current</emphasis><!-- <br> --> This is the + FreeBSD-current</emphasis></para> + + <para>This is the digest version of the freebsd-current mailing list. The digest consists of all messages sent to freebsd-current bundled together and mailed out as a single message. The @@ -37216,7 +38730,9 @@ an A record in the DNS for "customer.com".</programlisting> <listitem> <para><emphasis>Discussions about the use of - FreeBSD-stable</emphasis><!-- <br> --> This is the + FreeBSD-stable</emphasis></para> + + <para>This is the mailing list for users of freebsd-stable. It includes warnings about new features coming out in -stable that will affect the users, and instructions on steps that must @@ -37230,8 +38746,9 @@ an A record in the DNS for "customer.com".</programlisting> <varlistentry><term>FREEBSD-DOC</term> <listitem> - <para><emphasis>Documentation project</emphasis><!-- <br> - --> This mailing list belongs to the FreeBSD Doc Project + <para><emphasis>Documentation project</emphasis></para> + + <para>This mailing list belongs to the FreeBSD Doc Project and is for the discussion of documentation related issues and projects.</para> </listitem> @@ -37240,7 +38757,9 @@ an A record in the DNS for "customer.com".</programlisting> <varlistentry><term>FREEBSD-FS</term> <listitem> - <para><emphasis>Filesystems</emphasis><!-- <br> --> + <para><emphasis>Filesystems</emphasis></para> + + <para> Discussions concerning FreeBSD filesystems. This is a technical mailing list for which strictly technical content is expected.</para> @@ -37250,7 +38769,9 @@ an A record in the DNS for "customer.com".</programlisting> <varlistentry><term>FREEBSD-ISDN</term> <listitem> - <para><emphasis>ISDN Communications</emphasis><!-- <br> --> + <para><emphasis>ISDN Communications</emphasis></para> + + <para> This is the mailing list for people discussing the development of ISDN support for FreeBSD.</para> </listitem> @@ -37259,7 +38780,9 @@ an A record in the DNS for "customer.com".</programlisting> <varlistentry><term>FREEBSD-JAVA</term> <listitem> - <para><emphasis>Java Development</emphasis><!-- <br> --> + <para><emphasis>Java Development</emphasis></para> + + <para> This is the mailing list for people discussing the development of significant Java applications for FreeBSD and the porting and maintenance of JDKs.</para> @@ -37269,8 +38792,9 @@ an A record in the DNS for "customer.com".</programlisting> <varlistentry><term>FREEBSD-HACKERS</term> <listitem> - <para><emphasis>Technical discussions</emphasis><!-- <br> - --> This is a forum for technical discussions related to + <para><emphasis>Technical discussions</emphasis></para> + + <para>This is a forum for technical discussions related to FreeBSD. This is the primary technical mailing list. It is for individuals actively working on FreeBSD, to bring up problems or discuss alternative solutions. Individuals @@ -37283,8 +38807,9 @@ an A record in the DNS for "customer.com".</programlisting> <varlistentry><term>FREEBSD-HACKERS-DIGEST</term> <listitem> - <para><emphasis>Technical discussions</emphasis><!-- <br> - --> This is the digest version of the freebsd-hackers + <para><emphasis>Technical discussions</emphasis></para> + + <para>This is the digest version of the freebsd-hackers mailing list. The digest consists of all messages sent to freebsd-hackers bundled together and mailed out as a single message. The average digest size is about 40kB. @@ -37297,7 +38822,9 @@ an A record in the DNS for "customer.com".</programlisting> <listitem> <para><emphasis>General discussion of FreeBSD - hardware</emphasis><!-- <br> --> General discussion + hardware</emphasis></para> + + <para>General discussion about the types of hardware that FreeBSD runs on, various problems and suggestions concerning what to buy or avoid.</para> @@ -37307,8 +38834,9 @@ an A record in the DNS for "customer.com".</programlisting> <varlistentry><term>FREEBSD-INSTALL</term> <listitem> - <para><emphasis>Installation discussion</emphasis><!-- <br> - --> This mailing list is for discussing FreeBSD + <para><emphasis>Installation discussion</emphasis></para> + + <para>This mailing list is for discussing FreeBSD installation development for the future releases and is closed.</para> </listitem> @@ -37318,7 +38846,9 @@ an A record in the DNS for "customer.com".</programlisting> <listitem> <para><emphasis>Issues for Internet Service - Providers</emphasis><!-- <br> --> This mailing list is + Providers</emphasis></para> + + <para>This mailing list is for discussing topics relevant to Internet Service Providers (ISPs) using FreeBSD. This is a technical mailing list for which strictly technical content is @@ -37329,8 +38859,9 @@ an A record in the DNS for "customer.com".</programlisting> <varlistentry><term>FREEBSD-MULTIMEDIA</term> <listitem> - <para><emphasis>Multimedia discussions</emphasis><!-- <br> - --> This is a forum about multimedia applications using + <para><emphasis>Multimedia discussions</emphasis></para> + + <para>This is a forum about multimedia applications using FreeBSD. Discussion center around multimedia applications, their installation, their development and their support within FreeBSD This is a technical mailing list for which @@ -37342,7 +38873,9 @@ an A record in the DNS for "customer.com".</programlisting> <listitem> <para><emphasis>Porting to Non-Intel - platforms</emphasis><!-- <br> --> Cross-platform freebsd + platforms</emphasis></para> + + <para>Cross-platform freebsd issues, general discussion and proposals for non-Intel FreeBSD ports. This is a technical mailing list for which strictly technical content is expected.</para> @@ -37352,8 +38885,10 @@ an A record in the DNS for "customer.com".</programlisting> <varlistentry><term>FREEBSD-PORTS</term> <listitem> - <para><emphasis>Discussion of <quote>ports</quote></emphasis><!-- <br> - --> Discussions concerning FreeBSD's <quote>ports collection</quote> + <para><emphasis>Discussion of + <quote>ports</quote></emphasis></para> + + <para>Discussions concerning FreeBSD's <quote>ports collection</quote> (/usr/ports), proposed ports, modifications to ports collection infrastructure and general coordination efforts. This is a technical mailing list for which @@ -37364,7 +38899,9 @@ an A record in the DNS for "customer.com".</programlisting> <varlistentry><term>FREEBSD-QUESTIONS</term> <listitem> - <para><emphasis>User questions</emphasis><!-- <br> --> This + <para><emphasis>User questions</emphasis></para> + + <para>This is the mailing list for questions about FreeBSD. You should not send <quote>how to</quote> questions to the technical lists unless you consider the question to be pretty @@ -37387,7 +38924,9 @@ an A record in the DNS for "customer.com".</programlisting> <varlistentry><term>FREEBSD-SCSI</term> <listitem> - <para><emphasis>SCSI subsystem</emphasis><!-- <br> --> This + <para><emphasis>SCSI subsystem</emphasis></para> + + <para>This is the mailing list for people working on the scsi subsystem for FreeBSD. This is a technical mailing list for which strictly technical content is expected.</para> @@ -37397,7 +38936,9 @@ an A record in the DNS for "customer.com".</programlisting> <varlistentry><term>FREEBSD-SECURITY</term> <listitem> - <para><emphasis>Security issues</emphasis><!-- <br> --> + <para><emphasis>Security issues</emphasis></para> + + <para> FreeBSD computer security issues (DES, Kerberos, known security holes and fixes, etc). This is a technical mailing list for which strictly technical content is @@ -37418,8 +38959,10 @@ an A record in the DNS for "customer.com".</programlisting> <varlistentry><term>FREEBSD-USER-GROUPS</term> <listitem> - <para><emphasis>User Group Coordination List</emphasis><!-- - <br> --> This is the mailing list for the coordinators from + <para><emphasis>User Group Coordination + List</emphasis></para> + + <para>This is the mailing list for the coordinators from each of the local area Users Groups to discuss matters with each other and a designated individual from the Core Team. This mail list should be limited to meeting @@ -38422,30 +39965,69 @@ an A record in the DNS for "customer.com".</programlisting> <title>FreeBSD Security Officer <security-officer@freebsd.org> </title> - <para> - <informalexample> - <screen>FreeBSD Security Officer - <security-officer@freebsd.org> Fingerprint = 41 08 4E BB - DB 41 60 71 F9 E5 0E 98 73 AF 3F 11 -----BEGIN PGP PUBLIC KEY - BLOCK----- Version: 2.6.3i - mQCNAzF7MY4AAAEEAK7qBgPuBejER5HQbQlsOldk3ZVWXlRj54raz3IbuAUrDrQL h3g57T9QY++f3Mot2LAf5lDJbsMfWrtwPrPwCCFRYQd6XH778a+l4ju5axyjrt/L Ciw9RrOC+WaPv3lIdLuqYge2QRC1LvKACIPNbIcgbnLeRGLovFUuHi5z0oilAAUR tDdGcmVlQlNEIFNlY3VyaXR5IE9mZmljZXIgPHNlY3VyaXR5LW9mZmljZXJAZnJl ZWJzZC5vcmc+iQCVAwUQMX6yrOJgpPLZnQjrAQHyowQA1Nv2AY8vJIrdp2ttV6RU tZBYnI7gTO3sFC2bhIHsCvfVU3JphfqWQ7AnTXcD2yPjGcchUfc/EcL1tSlqW4y7 PMP4GHZp9vHog1NAsgLC9Y1P/1cOeuhZ0pDpZZ5zxTo6TQcCBjQA6KhiBFP4TJql 3olFfPBh3B/Tu3dqmEbSWpuJAJUDBRAxez3C9RVb+45ULV0BAak8A/9JIG/jRJaz QbKom6wMw852C/Z0qBLJy7KdN30099zMjQYeC9PnlkZ0USjQ4TSpC8UerYv6IfhV nNY6gyF2Hx4CbEFlopnfA1c4yxtXKti1kSN6wBy/ki3SmqtfDhPQ4Q31p63cSe5A 3aoHcjvWuqPLpW4ba2uHVKGP3g7SSt6AOYkAlQMFEDF8mz0ff6kIA1j8vQEBmZcD /REaUPDRx6qr1XRQlMs6pfgNKEwnKmcUzQLCvKBnYYGmD5ydPLxCPSFnPcPthaUb 5zVgMTjfjS2fkEiRrua4duGRgqN4xY7VRAsIQeMSITBOZeBZZf2oa9Ntidr5PumS 9uQ9bvdfWMpsemk2MaRG9BSoy5Wvy8VxROYYUwpT8Cf2iQCVAwUQMXsyqWtaZ42B sqd5AQHKjAQAvolI30Nyu3IyTfNeCb/DvOe9tlOn/o+VUDNJiE/PuBe1s2Y94a/P BfcohpKC2kza3NiW6lLTp00OWQsuu0QAPc02vYOyseZWy4y3Phnw60pWzLcFdemT 0GiYS5Xm1o9nAhPFciybn9j1q8UadIlIq0wbqWgdInBT8YI/l4f5sf6JAJUDBRAx ezKXVS4eLnPSiKUBAc5OBACIXTlKqQC3B53qt7bNMV46m81fuw1PhKaJEI033mCD ovzyEFFQeOyRXeu25Jg9Bq0Sn37ynISucHSmt2tUD5W0+p1MUGyTqnfqejMUWBzO v4Xhp6a8RtDdUMBOTtro16iulGiRrCKxzVgEl4i+9Z0ZiE6BWlg5AetoF5n3mGk1 lw== =ipyA -----END PGP PUBLIC KEY BLOCK-----</screen> - </informalexample> - </para> + <programlisting> +FreeBSD Security Officer <security-officer@freebsd.org> +Fingerprint = 41 08 4E BB DB 41 60 71 F9 E5 0E 98 73 AF 3F 11 + +-----BEGIN PGP PUBLIC KEY BLOCK----- +Version: 2.6.3i + +mQCNAzF7MY4AAAEEAK7qBgPuBejER5HQbQlsOldk3ZVWXlRj54raz3IbuAUrDrQL +h3g57T9QY++f3Mot2LAf5lDJbsMfWrtwPrPwCCFRYQd6XH778a+l4ju5axyjrt/L +Ciw9RrOC+WaPv3lIdLuqYge2QRC1LvKACIPNbIcgbnLeRGLovFUuHi5z0oilAAUR +tDdGcmVlQlNEIFNlY3VyaXR5IE9mZmljZXIgPHNlY3VyaXR5LW9mZmljZXJAZnJl +ZWJzZC5vcmc+iQCVAwUQMX6yrOJgpPLZnQjrAQHyowQA1Nv2AY8vJIrdp2ttV6RU +tZBYnI7gTO3sFC2bhIHsCvfVU3JphfqWQ7AnTXcD2yPjGcchUfc/EcL1tSlqW4y7 +PMP4GHZp9vHog1NAsgLC9Y1P/1cOeuhZ0pDpZZ5zxTo6TQcCBjQA6KhiBFP4TJql +3olFfPBh3B/Tu3dqmEbSWpuJAJUDBRAxez3C9RVb+45ULV0BAak8A/9JIG/jRJaz +QbKom6wMw852C/Z0qBLJy7KdN30099zMjQYeC9PnlkZ0USjQ4TSpC8UerYv6IfhV +nNY6gyF2Hx4CbEFlopnfA1c4yxtXKti1kSN6wBy/ki3SmqtfDhPQ4Q31p63cSe5A +3aoHcjvWuqPLpW4ba2uHVKGP3g7SSt6AOYkAlQMFEDF8mz0ff6kIA1j8vQEBmZcD +/REaUPDRx6qr1XRQlMs6pfgNKEwnKmcUzQLCvKBnYYGmD5ydPLxCPSFnPcPthaUb +5zVgMTjfjS2fkEiRrua4duGRgqN4xY7VRAsIQeMSITBOZeBZZf2oa9Ntidr5PumS +9uQ9bvdfWMpsemk2MaRG9BSoy5Wvy8VxROYYUwpT8Cf2iQCVAwUQMXsyqWtaZ42B +sqd5AQHKjAQAvolI30Nyu3IyTfNeCb/DvOe9tlOn/o+VUDNJiE/PuBe1s2Y94a/P +BfcohpKC2kza3NiW6lLTp00OWQsuu0QAPc02vYOyseZWy4y3Phnw60pWzLcFdemT +0GiYS5Xm1o9nAhPFciybn9j1q8UadIlIq0wbqWgdInBT8YI/l4f5sf6JAJUDBRAx +ezKXVS4eLnPSiKUBAc5OBACIXTlKqQC3B53qt7bNMV46m81fuw1PhKaJEI033mCD +ovzyEFFQeOyRXeu25Jg9Bq0Sn37ynISucHSmt2tUD5W0+p1MUGyTqnfqejMUWBzO +v4Xhp6a8RtDdUMBOTtro16iulGiRrCKxzVgEl4i+9Z0ZiE6BWlg5AetoF5n3mGk1 +lw== +=ipyA +-----END PGP PUBLIC KEY BLOCK----- + </programlisting> </sect2> <sect2> <title>&a.imp;</title> - <para> - <informalexample> - <screen>Warner Losh <imp@village.org> aka - <imp@freebsd.org> Fingerprint = D4 31 FD B9 F7 90 17 E8 - 37 C5 E7 7F CF A6 C1 B9 -----BEGIN PGP PUBLIC KEY BLOCK----- - Version: 2.6.2 - mQCNAzDzTiAAAAEEAK8D7KWEbVFUrmlqhUEnAvphNIqHEbqqT8s+c5f5c2uHtlcH V4mV2TlUaDSVBN4+/D70oHmZc4IgiQwMPCWRrSezg9z/MaKlWhaslc8YT6Xc1q+o EP/fAdKUrq49H0QQbkQk6Ks5wKW6v9AOvdmsS6ZJEcet6d9G4dxynu/2qPVhAAUR tCBNLiBXYXJuZXIgTG9zaCA8aW1wQHZpbGxhZ2Uub3JnPokAlQMFEDM/SK1VLh4u c9KIpQEBFPsD/1n0YuuUPvD4CismZ9bx9M84y5sxLolgFEfP9Ux196ZSeaPpkA0g C9YX/IyIy5VHh3372SDWN5iVSDYPwtCmZziwIV2YxzPtZw0nUu82P/Fn8ynlCSWB 5povLZmgrWijTJdnUWI0ApVBUTQoiW5MyrNN51H3HLWXGoXMgQFZXKWYiQCVAwUQ MzmhkfUVW/uOVC1dAQG3+AP/T1HL/5EYF0ij0yQmNTzt1cLt0b1e3N3zN/wPFFWs BfrQ+nsv1zw7cEgxLtktk73wBGM9jUIdJu8phgLtl5a0m9UjBq5oxrJaNJr6UTxN a+sFkapTLT1g84UFUO/+8qRB12v+hZr2WeXMYjHAFUT18mp3xwjW9DUV+2fW1Wag YDKJAJUDBRAzOYK1s1pi61mfMj0BARBbA/930CHswOF0HIr+4YYUs1ejDnZ2J3zn icTZhl9uAfEQq++Xor1x476j67Z9fESxyHltUxCmwxsJ1uOJRwzjyEoMlyFrIN4C dE0C8g8BF+sRTt7VLURLERvlBvFrVZueXSnXvmMoWFnqpSpt3EmN6TNaLe8Cm87a k6EvQy0dpnkPKokAlQMFEDD9Lorccp7v9qj1YQEBrRUD/3N4cCMWjzsIFp2Vh9y+ RzUrblyF84tJyA7Rr1p+A7dxf7je3Zx5QMEXosWL1WGnS5vC9YH2WZwv6sCU61gU rSy9z8KHlBEHh+Z6fdRMrjd9byPf+n3cktT0NhS23oXB1ZhNZcB2KKhVPlNctMqO 3gTYx+Nlo6xqjR+J2NnBYU8p =7fQV -----END PGP PUBLIC KEY BLOCK-----</screen> - </informalexample> - </para> + <programlisting> +Warner Losh <imp@village.org> + aka <imp@freebsd.org> +Fingerprint = D4 31 FD B9 F7 90 17 E8 37 C5 E7 7F CF A6 C1 B9 +-----BEGIN PGP PUBLIC KEY BLOCK----- +Version: 2.6.2 + +mQCNAzDzTiAAAAEEAK8D7KWEbVFUrmlqhUEnAvphNIqHEbqqT8s+c5f5c2uHtlcH +V4mV2TlUaDSVBN4+/D70oHmZc4IgiQwMPCWRrSezg9z/MaKlWhaslc8YT6Xc1q+o +EP/fAdKUrq49H0QQbkQk6Ks5wKW6v9AOvdmsS6ZJEcet6d9G4dxynu/2qPVhAAUR +tCBNLiBXYXJuZXIgTG9zaCA8aW1wQHZpbGxhZ2Uub3JnPokAlQMFEDM/SK1VLh4u +c9KIpQEBFPsD/1n0YuuUPvD4CismZ9bx9M84y5sxLolgFEfP9Ux196ZSeaPpkA0g +C9YX/IyIy5VHh3372SDWN5iVSDYPwtCmZziwIV2YxzPtZw0nUu82P/Fn8ynlCSWB +5povLZmgrWijTJdnUWI0ApVBUTQoiW5MyrNN51H3HLWXGoXMgQFZXKWYiQCVAwUQ +MzmhkfUVW/uOVC1dAQG3+AP/T1HL/5EYF0ij0yQmNTzt1cLt0b1e3N3zN/wPFFWs +BfrQ+nsv1zw7cEgxLtktk73wBGM9jUIdJu8phgLtl5a0m9UjBq5oxrJaNJr6UTxN +a+sFkapTLT1g84UFUO/+8qRB12v+hZr2WeXMYjHAFUT18mp3xwjW9DUV+2fW1Wag +YDKJAJUDBRAzOYK1s1pi61mfMj0BARBbA/930CHswOF0HIr+4YYUs1ejDnZ2J3zn +icTZhl9uAfEQq++Xor1x476j67Z9fESxyHltUxCmwxsJ1uOJRwzjyEoMlyFrIN4C +dE0C8g8BF+sRTt7VLURLERvlBvFrVZueXSnXvmMoWFnqpSpt3EmN6TNaLe8Cm87a +k6EvQy0dpnkPKokAlQMFEDD9Lorccp7v9qj1YQEBrRUD/3N4cCMWjzsIFp2Vh9y+ +RzUrblyF84tJyA7Rr1p+A7dxf7je3Zx5QMEXosWL1WGnS5vC9YH2WZwv6sCU61gU +rSy9z8KHlBEHh+Z6fdRMrjd9byPf+n3cktT0NhS23oXB1ZhNZcB2KKhVPlNctMqO +3gTYx+Nlo6xqjR+J2NnBYU8p =7fQV +-----END PGP PUBLIC KEY BLOCK----- + </programlisting> </sect2> </sect1> @@ -38457,152 +40039,408 @@ an A record in the DNS for "customer.com".</programlisting> <sect2> <title>&a.asami;</title> - <para> - <informalexample> - <screen>Satoshi Asami <asami@cs.berkeley.edu> aka - <asami@FreeBSD.ORG> Fingerprint = EB 3C 68 9E FB 6C EB - 3F DB 2E 0F 10 8F CE 79 CA -----BEGIN PGP PUBLIC KEY - BLOCK----- Version: 2.6.2 - mQCNAzPVyoQAAAEEAL7W+kipxB171Z4SVyyL9skaA7hG3eRsSOWk7lfvfUBLtPog f3OKwrApoc/jwLf4+Qpdzv5DLEt/6Hd/clskhJ+q1gMNHyZ5ABmUxrTRRNvJMTrb 3fPU3oZj7sL/MyiFaT1zF8EaMP/iS2ZtcFsbYOqGeA8E/58uk4NA0SoeCNiJAAUR tCVTYXRvc2hpIEFzYW1pIDxhc2FtaUBjcy5iZXJrZWxleS5lZHU+iQCVAwUQM/AT +EqGN2HYnOMZAQF11QP/eSXb2FuTb1yX5yoo1Im8YnIk1SEgCGbyEbOMMBznVNDy 5g2TAD0ofLxPxy5Vodjg8rf+lfMVtO5amUH6aNcORXRncE83T10JmeM6JEp0T6jw zOHKz8jRzygYLBayGsNIJ4BGxa4LeaGxJpO1ZEvRlNkPH/YEXK5oQmq9/DlrtYOJ AEUDBRAz42JT8ng6GBbVvu0BAU8nAYCsJ8PiJpRUGlrz6rxjX8hqM1v3vqFHLcG+ G52nVMBSy+RZBgzsYIPwI5EZtWAKb22JAJUDBRAz4QBWdbtuOHaj97EBAaQPA/46 +NLUp+Wubl90JoonoXocwAg88tvAUVSzsxPXj0lvypAiSI2AJKsmn+5PuQ+/IoQy lywRsxiQ5GD7C72SZ1yw2WI9DWFeAi+qa4b8n9fcLYrnHpyCY+zxEpu4pam8FJ7H JocEUZz5HRoKKOLHErzXDiuTkkm72b1glmCqAQvnB4kAlQMFEDPZ3gyDQNEqHgjY iQEBFfUEALu2C0uo+1Z7C5+xshWRYY5xNCzK20O6bANVJ+CO2fih96KhwsMof3lw fDso5HJSwgFd8WT/sR+Wwzz6BAE5UtgsQq5GcsdYQuGI1yIlCYUpDp5sgswNm+OA bX5a+r4F/ZJqrqT1J56Mer0VVsNfe5nIRsjd/rnFAFVfjcQtaQmjiQCVAwUQM9uV mcdm8Q+/vPRJAQELHgP9GqNiMpLQlZig17fDnCJ73P0e5t/hRLFehZDlmEI2TK7j Yeqbw078nZgyyuljZ7YsbstRIsWVCxobX5eH1kX+hIxuUqCAkCsWUY4abG89kHJr XGQn6X1CX7xbZ+b6b9jLK+bJKFcLSfyqR3M2eCyscSiZYkWKQ5l3FYvbUzkeb6K0 IVNhdG9zaGkgQXNhbWkgPGFzYW1pQEZyZWVCU0QuT1JHPg== =39SC -----END PGP PUBLIC KEY BLOCK-----</screen> - </informalexample> - </para> - + <programlisting> +Satoshi Asami <asami@cs.berkeley.edu> + aka <asami@FreeBSD.ORG> +Fingerprint = EB 3C 68 9E FB 6C EB 3F DB 2E 0F 10 8F CE 79 CA + +-----BEGIN PGP PUBLIC KEY BLOCK----- +Version: 2.6.2 + +mQCNAzPVyoQAAAEEAL7W+kipxB171Z4SVyyL9skaA7hG3eRsSOWk7lfvfUBLtPog +f3OKwrApoc/jwLf4+Qpdzv5DLEt/6Hd/clskhJ+q1gMNHyZ5ABmUxrTRRNvJMTrb +3fPU3oZj7sL/MyiFaT1zF8EaMP/iS2ZtcFsbYOqGeA8E/58uk4NA0SoeCNiJAAUR +tCVTYXRvc2hpIEFzYW1pIDxhc2FtaUBjcy5iZXJrZWxleS5lZHU+iQCVAwUQM/AT ++EqGN2HYnOMZAQF11QP/eSXb2FuTb1yX5yoo1Im8YnIk1SEgCGbyEbOMMBznVNDy +5g2TAD0ofLxPxy5Vodjg8rf+lfMVtO5amUH6aNcORXRncE83T10JmeM6JEp0T6jw +zOHKz8jRzygYLBayGsNIJ4BGxa4LeaGxJpO1ZEvRlNkPH/YEXK5oQmq9/DlrtYOJ +AEUDBRAz42JT8ng6GBbVvu0BAU8nAYCsJ8PiJpRUGlrz6rxjX8hqM1v3vqFHLcG+ +G52nVMBSy+RZBgzsYIPwI5EZtWAKb22JAJUDBRAz4QBWdbtuOHaj97EBAaQPA/46 ++NLUp+Wubl90JoonoXocwAg88tvAUVSzsxPXj0lvypAiSI2AJKsmn+5PuQ+/IoQy +lywRsxiQ5GD7C72SZ1yw2WI9DWFeAi+qa4b8n9fcLYrnHpyCY+zxEpu4pam8FJ7H +JocEUZz5HRoKKOLHErzXDiuTkkm72b1glmCqAQvnB4kAlQMFEDPZ3gyDQNEqHgjY +iQEBFfUEALu2C0uo+1Z7C5+xshWRYY5xNCzK20O6bANVJ+CO2fih96KhwsMof3lw +fDso5HJSwgFd8WT/sR+Wwzz6BAE5UtgsQq5GcsdYQuGI1yIlCYUpDp5sgswNm+OA +bX5a+r4F/ZJqrqT1J56Mer0VVsNfe5nIRsjd/rnFAFVfjcQtaQmjiQCVAwUQM9uV +mcdm8Q+/vPRJAQELHgP9GqNiMpLQlZig17fDnCJ73P0e5t/hRLFehZDlmEI2TK7j +Yeqbw078nZgyyuljZ7YsbstRIsWVCxobX5eH1kX+hIxuUqCAkCsWUY4abG89kHJr +XGQn6X1CX7xbZ+b6b9jLK+bJKFcLSfyqR3M2eCyscSiZYkWKQ5l3FYvbUzkeb6K0 +IVNhdG9zaGkgQXNhbWkgPGFzYW1pQEZyZWVCU0QuT1JHPg== +=39SC +-----END PGP PUBLIC KEY BLOCK----- + </programlisting> </sect2> <sect2> <title>&a.jmb;</title> - <para> - <informalexample> - <screen>Jonathan M. Bresler <jmb@FreeBSD.org> Key - fingerprint = 31 57 41 56 06 C1 40 13 C5 1C E3 E5 DC 62 0E - FB -----BEGIN PGP PUBLIC KEY BLOCK----- Version: 2.6.2 - mQCNAzG2GToAAAEEANI6+4SJAAgBpl53XcfEr1M9wZyBqC0tzpie7Zm4vhv3hO8s o5BizSbcJheQimQiZAY4OnlrCpPxijMFSaihshs/VMAz1qbisUYAMqwGEO/T4QIB nWNo0Q/qOniLMxUrxS1RpeW5vbghErHBKUX9GVhxbiVfbwc4wAHbXdKX5jjdAAUR tCVKb25hdGhhbiBNLiBCcmVzbGVyIDxqbWJARnJlZUJTRC5PUkc+iQCVAwUQNA3x ffUVW/uOVC1dAQHGdAQAgsnYklBtVUdGuQwXB3bYp9omTD7CVD0aibVrz+lXiPDh aTVkOC1uhEwL59+R8VdpAnEDMobdZDA/ihCc+6/FW/eE0uyrWZzb5Ng9V1MfC6HI +sXpeXPy585Z56ewadV2yY9rvzcwmmUNHmAXT/5O0S2AWB0EJZ+cewTrokSTVVOJ AJUDBRA0C3EoVS4eLnPSiKUBASb+A/95g6w9DDPRGDlbsl4pN1BlSPKrmDQPRK1X C3bddDY2HNelSNhzp2FYD0WoN1re1vMJV0oaaJHwv7wjbe3+SYEX/IdmtfzI0MbZ Q/uPybPJOxi2ud6C6J+mEGJN9iBCnsaCz8CETuC9gR1mtxsxySUj9mk0fxKfdP6S 3QDrv6CQ1IkAlQMFEDKsi9CzWmLrWZ8yPQEBduUD/RhV4Qa89rYls9vtIFm6XBjZ 8mW37FYxeqIxg3ZrIyTMlghsOPV0f7zymCCWPRGKOLePRiGo0ZCEkDTYiM9tnwQI 09rmPWJb50yfTSZXjHx6+Hcm6O6BCmDFloo0Mxo6n9pvMH/TmmqHxCsAV+p8XEWy rMZvwVSynMxmJd17Y5HLtBNKb25hdGhhbiBNLiBCcmVzbGVyiQCVAwUQMbYtYQHb XdKX5jjdAQHEHwP/fEaQoTi7zKD1U/5kW2YPIBUyMTpLiO9QOr4stYjJvhHh4Ejw fGvMIhbFrPKtxSNH1s3m4jAXKXiQBDCz17IIzL4n8dlunxNGE5MHcsmpWzggyIg4 zbPqPOcg4gLFEWsEkr2o0akwzIGa3tbCvC+ITaX/rdlWV1jaQjTqSNyPZBM= =RV56 -----END PGP PUBLIC KEY BLOCK-----</screen> - </informalexample> - </para> - + <programlisting> +Jonathan M. Bresler <jmb@FreeBSD.org> +Key fingerprint = 31 57 41 56 06 C1 40 13 C5 1C E3 E5 DC 62 0E FB + +-----BEGIN PGP PUBLIC KEY BLOCK----- +Version: 2.6.2 + +mQCNAzG2GToAAAEEANI6+4SJAAgBpl53XcfEr1M9wZyBqC0tzpie7Zm4vhv3hO8s +o5BizSbcJheQimQiZAY4OnlrCpPxijMFSaihshs/VMAz1qbisUYAMqwGEO/T4QIB +nWNo0Q/qOniLMxUrxS1RpeW5vbghErHBKUX9GVhxbiVfbwc4wAHbXdKX5jjdAAUR +tCVKb25hdGhhbiBNLiBCcmVzbGVyIDxqbWJARnJlZUJTRC5PUkc+iQCVAwUQNA3x +ffUVW/uOVC1dAQHGdAQAgsnYklBtVUdGuQwXB3bYp9omTD7CVD0aibVrz+lXiPDh +aTVkOC1uhEwL59+R8VdpAnEDMobdZDA/ihCc+6/FW/eE0uyrWZzb5Ng9V1MfC6HI ++sXpeXPy585Z56ewadV2yY9rvzcwmmUNHmAXT/5O0S2AWB0EJZ+cewTrokSTVVOJ +AJUDBRA0C3EoVS4eLnPSiKUBASb+A/95g6w9DDPRGDlbsl4pN1BlSPKrmDQPRK1X +C3bddDY2HNelSNhzp2FYD0WoN1re1vMJV0oaaJHwv7wjbe3+SYEX/IdmtfzI0MbZ +Q/uPybPJOxi2ud6C6J+mEGJN9iBCnsaCz8CETuC9gR1mtxsxySUj9mk0fxKfdP6S +3QDrv6CQ1IkAlQMFEDKsi9CzWmLrWZ8yPQEBduUD/RhV4Qa89rYls9vtIFm6XBjZ +8mW37FYxeqIxg3ZrIyTMlghsOPV0f7zymCCWPRGKOLePRiGo0ZCEkDTYiM9tnwQI +09rmPWJb50yfTSZXjHx6+Hcm6O6BCmDFloo0Mxo6n9pvMH/TmmqHxCsAV+p8XEWy +rMZvwVSynMxmJd17Y5HLtBNKb25hdGhhbiBNLiBCcmVzbGVyiQCVAwUQMbYtYQHb +XdKX5jjdAQHEHwP/fEaQoTi7zKD1U/5kW2YPIBUyMTpLiO9QOr4stYjJvhHh4Ejw +fGvMIhbFrPKtxSNH1s3m4jAXKXiQBDCz17IIzL4n8dlunxNGE5MHcsmpWzggyIg4 +zbPqPOcg4gLFEWsEkr2o0akwzIGa3tbCvC+ITaX/rdlWV1jaQjTqSNyPZBM= +=RV56 +-----END PGP PUBLIC KEY BLOCK----- + </programlisting> </sect2> <sect2> <title>&a.ache;</title> - <para> - <informalexample> - <screen>Andrey A. Chernov <ache@FreeBSD.org> aka - <ache@nagual.pp.ru> Key fingerprint = 33 03 9F 48 33 7B - 4A 15 63 48 88 0A C4 97 FD 49 -----BEGIN PGP PUBLIC KEY - BLOCK----- Version: 2.6.3ia - mQCNAiqUMGQAAAEEAPGhcD6A2Buey5LYz0sphDLpVgOZc/bb9UHAbaGKUAGXmafs Dcb2HnsuYGgX/zrQXuCi/wIGtXcZWB97APtKOhFsZnPinDR5n/dde/mw9FnuhwqD m+rKSL1HlN0z/Msa5y7g16760wHhSR6NoBSEG5wQAHIMMq7Q0uJgpPLZnQjrAAUT tCVBbmRyZXkgQS4gQ2hlcm5vdiA8YWNoZUBuYWd1YWwucHAucnU+iQCVAwUQM2Ez u+JgpPLZnQjrAQEyugP8DPnS8ixJ5OeuYgPFQf5sy6l+LrB6hyaS+lgsUPahWjNY cnaDmfda/q/BV5d4+y5rlQe/pjnYG7/yQuAR3jhlXz8XDrqlBOnW9AtYjDt5rMfJ aGFTGXAPGZ6k6zQZE0/YurT8ia3qjvuZm3Fw4NJrHRx7ETHRvVJDvxA6Ggsvmr20 JEFuZHJleSBBLiBDaGVybm92IDxhY2hlQEZyZWVCU0Qub3JnPokAlQMFEDR5uVbi YKTy2Z0I6wEBLgED/2mn+hw4/3peLx0Sb9LNx//NfCCkVefSf2G9Qwhx6dvwbX7h mFca97h7BQN4GubU1Z5Ffs6TeamSBrotBYGmOCwvJ6S9WigF9YHQIQ3B4LEjskAt pcjU583y42zM11kkvEuQU2Gde61daIylJyOxsgpjSWpkxq50fgY2kLMfgl/ftCZB bmRyZXkgQS4gQ2hlcm5vdiA8YWNoZUBuaWV0enNjaGUubmV0PokAlQMFEDR5svDi YKTy2Z0I6wEBOTQD/0OTCAXIjuak363mjERvzSkVsNtIH9hA1l0w6Z95+iH0fHrW xXKT0vBZE0y0Em+S3cotLL0bMmVE3F3D3GyxhBVmgzjyx0NYNoiQjYdi+6g/PV30 Cn4vOO6hBBpSyI6vY6qGNqcsawuRtHNvK/53MpOfKwSlICEBYQimcZhkci+EtCJB bmRyZXkgQS4gQ2hlcm5vdiA8YWNoZUBuYWd1YWwucnU+iQCVAwUQMcm5HeJgpPLZ nQjrAQHwvQP9GdmAf1gdcuayHEgNkc11macPH11cwWjYjzA2YoecFMGV7iqKK8QY rr1MjbGXf8DAG8Ubfm0QbI8Lj8iG3NgqIru0c72UuHGSn/APfGGG0AtPX5UK/k7B gI0Ca2po6NA5nrSp8tDsdEz/4gyea84RXl2prtTf5Jj07hflbRstGXK0MkFuZHJl eSBBLiBDaGVybm92LCBCbGFjayBNYWdlIDxhY2hlQGFzdHJhbC5tc2suc3U+iQCV AwUQMCsAo5/rGryoL8h3AQHq1QQAidyNFqA9hvrmMcjpY7csJVFlGvj574Wj4GPa o3pZeuQaMBmsWqaXLYnWU/Aldb6kTz6+nRcQX50zFH0THSPfApwEW7yybSTI5apJ mWT3qhKN2vmLNg2yNzhqLTzHLD1lH3i1pfQq8WevrNfjLUco5S/VuekTma/osnzC Cw7fQzCJAJUDBRAwKvwoa1pnjYGyp3kBARihBACoXr3qfG65hFCyKJISmjOvaoGr anxUIkeDS0yQdTHzhQ+dwB1OhhK15E0Nwr0MKajLMm90n6+Zdb5y/FIjpPriu8dI rlHrWZlewa88eEDM+Q/NxT1iYg+HaKDAE171jmLpSpCL0MiJtO0i36L3ekVD7Hv8 vffOZHPSHirIzJOZTYkAlQMFEDAau6zFLUdtDb+QbQEBQX8D/AxwkYeFaYxZYMFO DHIvSk23hAsjCmUA2Uil1FeWAusb+o8xRfPDc7TnosrIifJqbF5+fcHCG5VSTGlh Bhd18YWUeabf/h9O2BsQX55yWRuB2x3diJ1xI/VVdG+rxlMCmE4ZR1Tl9x+Mtun9 KqKVpB39VlkCBYQ3hlgNt/TJUY4riQCVAwUQMBHMmyJRltlmbQBRAQFQkwP/YC3a hs3ZMMoriOlt3ZxGNUUPTF7rIER3j+c7mqGG46dEnDB5sUrkzacpoLX5sj1tGR3b vz9a4vmk1Av3KFNNvrZZ3/BZFGpq3mCTiAC9zsyNYQ8L0AfGIUO5goCIjqwOTNQI AOpNsJ5S+nMAkQB4YmmNlI6GTb3D18zfhPZ6uciJAJUCBRAwD0sl4uW74fteFRkB AWsAA/9NYqBRBKbmltQDpyK4+jBAYjkXBJmARFXKJYTlnTgOHMpZqoVyW96xnaa5 MzxEiu7ZWm5oL10QDIp1krkBP2KcmvfSMMHb5aGCCQc2/P8NlfXAuHtNGzYiI0UA Iwi8ih/S1liVfvnqF9uV3d3koE7VsQ9OA4Qo0ZL2ggW+/gEaYIkAlQMFEDAOz6qx /IyHe3rl4QEBIvYD/jIr8Xqo/2I5gncghSeFR01n0vELFIvaF4cHofGzyzBpYsfA +6pgFI1IM+LUF3kbUkAY/2uSf9U5ECcaMCTWCwVgJVO+oG075SHEM4buhrzutZiM 1dTyTaepaPpTyRMUUx9ZMMYJs7sbqLId1eDwrJxUPhrBNvf/w2W2sYHSY8cdiQCV AwUQMAzqgHcdkq6JcsfBAQGTxwQAtgeLFi2rhSOdllpDXUwz+SS6bEjFTWgRsWFM y9QnOcqryw7LyuFmWein4jasjY033JsODfWQPiPVNA3UEnXVg9+n8AvNMPO8JkRv Cn1eNg0VaJy9J368uArio93agd2Yf/R5r+QEuPjIssVk8hdcy/luEhSiXWf6bLMV HEA0J+OJAJUDBRAwDUi+4mCk8tmdCOsBAatBBACHB+qtW880seRCDZLjl/bT1b14 5po60U7u6a3PEBkY0NA72tWDQuRPF/Cn/0+VdFNxQUsgkrbwaJWOoi0KQsvlOm3R rsxKbn9uvEKLxExyKH3pxp76kvz/lEWwEeKvBK+84Pb1lzpG3W7u2XDfi3VQPTi3 5SZMAHc6C0Ct/mjNlYkAlQMFEDAMrPD7wj+NsTMUOQEBJckD/ik4WsZzm2qOx9Fw erGq7Zwchc+Jq1YeN5PxpzqSf4AG7+7dFIn+oe6X2FcIzgbYY+IfmgJIHEVjDHH5 +uAXyb6l4iKc89eQawO3t88pfHLJWbTzmnvgz2cMrxt94HRvgkHfvcpGEgbyldq6 EB33OunazFcfZFRIcXk1sfyLDvYE =1ahV -----END PGP PUBLIC KEY BLOCK-----</screen> - </informalexample> - </para> - + <programlisting> +Andrey A. Chernov <ache@FreeBSD.org> + aka <ache@nagual.pp.ru> +Key fingerprint = 33 03 9F 48 33 7B 4A 15 63 48 88 0A C4 97 FD 49 + +-----BEGIN PGP PUBLIC KEY BLOCK----- +Version: 2.6.3ia + +mQCNAiqUMGQAAAEEAPGhcD6A2Buey5LYz0sphDLpVgOZc/bb9UHAbaGKUAGXmafs +Dcb2HnsuYGgX/zrQXuCi/wIGtXcZWB97APtKOhFsZnPinDR5n/dde/mw9FnuhwqD +m+rKSL1HlN0z/Msa5y7g16760wHhSR6NoBSEG5wQAHIMMq7Q0uJgpPLZnQjrAAUT +tCVBbmRyZXkgQS4gQ2hlcm5vdiA8YWNoZUBuYWd1YWwucHAucnU+iQCVAwUQM2Ez +u+JgpPLZnQjrAQEyugP8DPnS8ixJ5OeuYgPFQf5sy6l+LrB6hyaS+lgsUPahWjNY +cnaDmfda/q/BV5d4+y5rlQe/pjnYG7/yQuAR3jhlXz8XDrqlBOnW9AtYjDt5rMfJ +aGFTGXAPGZ6k6zQZE0/YurT8ia3qjvuZm3Fw4NJrHRx7ETHRvVJDvxA6Ggsvmr20 +JEFuZHJleSBBLiBDaGVybm92IDxhY2hlQEZyZWVCU0Qub3JnPokAlQMFEDR5uVbi +YKTy2Z0I6wEBLgED/2mn+hw4/3peLx0Sb9LNx//NfCCkVefSf2G9Qwhx6dvwbX7h +mFca97h7BQN4GubU1Z5Ffs6TeamSBrotBYGmOCwvJ6S9WigF9YHQIQ3B4LEjskAt +pcjU583y42zM11kkvEuQU2Gde61daIylJyOxsgpjSWpkxq50fgY2kLMfgl/ftCZB +bmRyZXkgQS4gQ2hlcm5vdiA8YWNoZUBuaWV0enNjaGUubmV0PokAlQMFEDR5svDi +YKTy2Z0I6wEBOTQD/0OTCAXIjuak363mjERvzSkVsNtIH9hA1l0w6Z95+iH0fHrW +xXKT0vBZE0y0Em+S3cotLL0bMmVE3F3D3GyxhBVmgzjyx0NYNoiQjYdi+6g/PV30 +Cn4vOO6hBBpSyI6vY6qGNqcsawuRtHNvK/53MpOfKwSlICEBYQimcZhkci+EtCJB +bmRyZXkgQS4gQ2hlcm5vdiA8YWNoZUBuYWd1YWwucnU+iQCVAwUQMcm5HeJgpPLZ +nQjrAQHwvQP9GdmAf1gdcuayHEgNkc11macPH11cwWjYjzA2YoecFMGV7iqKK8QY +rr1MjbGXf8DAG8Ubfm0QbI8Lj8iG3NgqIru0c72UuHGSn/APfGGG0AtPX5UK/k7B +gI0Ca2po6NA5nrSp8tDsdEz/4gyea84RXl2prtTf5Jj07hflbRstGXK0MkFuZHJl +eSBBLiBDaGVybm92LCBCbGFjayBNYWdlIDxhY2hlQGFzdHJhbC5tc2suc3U+iQCV +AwUQMCsAo5/rGryoL8h3AQHq1QQAidyNFqA9hvrmMcjpY7csJVFlGvj574Wj4GPa +o3pZeuQaMBmsWqaXLYnWU/Aldb6kTz6+nRcQX50zFH0THSPfApwEW7yybSTI5apJ +mWT3qhKN2vmLNg2yNzhqLTzHLD1lH3i1pfQq8WevrNfjLUco5S/VuekTma/osnzC +Cw7fQzCJAJUDBRAwKvwoa1pnjYGyp3kBARihBACoXr3qfG65hFCyKJISmjOvaoGr +anxUIkeDS0yQdTHzhQ+dwB1OhhK15E0Nwr0MKajLMm90n6+Zdb5y/FIjpPriu8dI +rlHrWZlewa88eEDM+Q/NxT1iYg+HaKDAE171jmLpSpCL0MiJtO0i36L3ekVD7Hv8 +vffOZHPSHirIzJOZTYkAlQMFEDAau6zFLUdtDb+QbQEBQX8D/AxwkYeFaYxZYMFO +DHIvSk23hAsjCmUA2Uil1FeWAusb+o8xRfPDc7TnosrIifJqbF5+fcHCG5VSTGlh +Bhd18YWUeabf/h9O2BsQX55yWRuB2x3diJ1xI/VVdG+rxlMCmE4ZR1Tl9x+Mtun9 +KqKVpB39VlkCBYQ3hlgNt/TJUY4riQCVAwUQMBHMmyJRltlmbQBRAQFQkwP/YC3a +hs3ZMMoriOlt3ZxGNUUPTF7rIER3j+c7mqGG46dEnDB5sUrkzacpoLX5sj1tGR3b +vz9a4vmk1Av3KFNNvrZZ3/BZFGpq3mCTiAC9zsyNYQ8L0AfGIUO5goCIjqwOTNQI +AOpNsJ5S+nMAkQB4YmmNlI6GTb3D18zfhPZ6uciJAJUCBRAwD0sl4uW74fteFRkB +AWsAA/9NYqBRBKbmltQDpyK4+jBAYjkXBJmARFXKJYTlnTgOHMpZqoVyW96xnaa5 +MzxEiu7ZWm5oL10QDIp1krkBP2KcmvfSMMHb5aGCCQc2/P8NlfXAuHtNGzYiI0UA +Iwi8ih/S1liVfvnqF9uV3d3koE7VsQ9OA4Qo0ZL2ggW+/gEaYIkAlQMFEDAOz6qx +/IyHe3rl4QEBIvYD/jIr8Xqo/2I5gncghSeFR01n0vELFIvaF4cHofGzyzBpYsfA ++6pgFI1IM+LUF3kbUkAY/2uSf9U5ECcaMCTWCwVgJVO+oG075SHEM4buhrzutZiM +1dTyTaepaPpTyRMUUx9ZMMYJs7sbqLId1eDwrJxUPhrBNvf/w2W2sYHSY8cdiQCV +AwUQMAzqgHcdkq6JcsfBAQGTxwQAtgeLFi2rhSOdllpDXUwz+SS6bEjFTWgRsWFM +y9QnOcqryw7LyuFmWein4jasjY033JsODfWQPiPVNA3UEnXVg9+n8AvNMPO8JkRv +Cn1eNg0VaJy9J368uArio93agd2Yf/R5r+QEuPjIssVk8hdcy/luEhSiXWf6bLMV +HEA0J+OJAJUDBRAwDUi+4mCk8tmdCOsBAatBBACHB+qtW880seRCDZLjl/bT1b14 +5po60U7u6a3PEBkY0NA72tWDQuRPF/Cn/0+VdFNxQUsgkrbwaJWOoi0KQsvlOm3R +rsxKbn9uvEKLxExyKH3pxp76kvz/lEWwEeKvBK+84Pb1lzpG3W7u2XDfi3VQPTi3 +5SZMAHc6C0Ct/mjNlYkAlQMFEDAMrPD7wj+NsTMUOQEBJckD/ik4WsZzm2qOx9Fw +erGq7Zwchc+Jq1YeN5PxpzqSf4AG7+7dFIn+oe6X2FcIzgbYY+IfmgJIHEVjDHH5 ++uAXyb6l4iKc89eQawO3t88pfHLJWbTzmnvgz2cMrxt94HRvgkHfvcpGEgbyldq6 +EB33OunazFcfZFRIcXk1sfyLDvYE +=1ahV +-----END PGP PUBLIC KEY BLOCK----- + </programlisting> </sect2> <sect2> <title>&a.jkh;</title> - <para> - <informalexample> - <screen>Jordan K. Hubbard <jkh@FreeBSD.org> Fingerprint = - 3C F2 27 7E 4A 6C 09 0A 4B C9 47 CD 4F 4D 0B 20 -----BEGIN - PGP PUBLIC KEY BLOCK----- Version: 2.6.2i - mQCNAzFjX0IAAAEEAML+nm9/kDNPp43ZUZGjYkm2QLtoC1Wxr8JulZXqk7qmhYcQ jvX+fyoriJ6/7ZlnLe2oG5j9tZOnRLPvMaz0g9CpW6Dz3nkXrNPkmOFV9B8D94Mk tyFeRJFqnkCuqBj6D+H8FtBwEeeTecSh2tJ0bZZTXnAMhxeOdvUVW/uOVC1dAAUR tCNKb3JkYW4gSy4gSHViYmFyZCA8amtoQEZyZWVCU0Qub3JnPokAlQMFEDF75D1r WmeNgbKneQEBXtcD+gJIv8JzZRKlDZyTCQanK8iRgE+zMhxptI0kDObaGxT1BrpY 4/EPyiUN10G4k2Jb+DOc8Lg2xDQ3xmvgipFf9NMNV/ThaEuZ3wA31I6tW/arQEqB Tp8u6T3v20m62t7Afo9HaoE6MBpHQUk2TilxgAd5P57sporL3pgW9YojIO9ziQCV AwUQMXyV2h9/qQgDWPy9AQEMfgP/RmbSg2WlesATUQ4WuanjcdREduKPyfQatrXD 2xt+jg9X78dTyiNN1YvLqvT6msfs04MKSC0hA2mou6ozw8Xak+1QmP0fBOZKp9pP 8szO188Do9ByzJPvHF1eXT7jFMOXVq8ZIl9iwjxcIDLzlxOz49DC7LO6AT+LKQk7 UGeP+lqJAJUDBRAxe+UG9RVb+45ULV0BAXZ9A/9F9gLpGukVNkeOjaqxQdJGTS+a xh/Abk0c/nKhAEyxpAl5JyQ3ifYk6BHhPvlTi9LrZoXGA8sk/eU4eRTZVzvGEC4G +xsavlE/xzku8855QTLPpkCunUpQeu1wzaIrUUE6Zjh05imFbJYyQOBgTFpuqWsC rsUpl+2mr8IGIxG5rA== =LW9i -----END PGP PUBLIC KEY BLOCK-----</screen> - </informalexample> - </para> - + <programlisting> +Jordan K. Hubbard <jkh@FreeBSD.org> +Fingerprint = 3C F2 27 7E 4A 6C 09 0A 4B C9 47 CD 4F 4D 0B 20 + +-----BEGIN PGP PUBLIC KEY BLOCK----- +Version: 2.6.2i + +mQCNAzFjX0IAAAEEAML+nm9/kDNPp43ZUZGjYkm2QLtoC1Wxr8JulZXqk7qmhYcQ +jvX+fyoriJ6/7ZlnLe2oG5j9tZOnRLPvMaz0g9CpW6Dz3nkXrNPkmOFV9B8D94Mk +tyFeRJFqnkCuqBj6D+H8FtBwEeeTecSh2tJ0bZZTXnAMhxeOdvUVW/uOVC1dAAUR +tCNKb3JkYW4gSy4gSHViYmFyZCA8amtoQEZyZWVCU0Qub3JnPokAlQMFEDF75D1r +WmeNgbKneQEBXtcD+gJIv8JzZRKlDZyTCQanK8iRgE+zMhxptI0kDObaGxT1BrpY +4/EPyiUN10G4k2Jb+DOc8Lg2xDQ3xmvgipFf9NMNV/ThaEuZ3wA31I6tW/arQEqB +Tp8u6T3v20m62t7Afo9HaoE6MBpHQUk2TilxgAd5P57sporL3pgW9YojIO9ziQCV +AwUQMXyV2h9/qQgDWPy9AQEMfgP/RmbSg2WlesATUQ4WuanjcdREduKPyfQatrXD +2xt+jg9X78dTyiNN1YvLqvT6msfs04MKSC0hA2mou6ozw8Xak+1QmP0fBOZKp9pP +8szO188Do9ByzJPvHF1eXT7jFMOXVq8ZIl9iwjxcIDLzlxOz49DC7LO6AT+LKQk7 +UGeP+lqJAJUDBRAxe+UG9RVb+45ULV0BAXZ9A/9F9gLpGukVNkeOjaqxQdJGTS+a +xh/Abk0c/nKhAEyxpAl5JyQ3ifYk6BHhPvlTi9LrZoXGA8sk/eU4eRTZVzvGEC4G ++xsavlE/xzku8855QTLPpkCunUpQeu1wzaIrUUE6Zjh05imFbJYyQOBgTFpuqWsC +rsUpl+2mr8IGIxG5rA== +=LW9i +-----END PGP PUBLIC KEY BLOCK----- + </programlisting> </sect2> <sect2> <title>&a.phk;</title> - <para> - <informalexample> - <screen>Poul-Henning Kamp <phk@FreeBSD.org> Fingerprint = - A3 F3 88 28 2F 9B 99 A2 49 F4 E2 FA 5A 78 8B 3E -----BEGIN - PGP PUBLIC KEY BLOCK----- Version: 2.6.3ia - mQCNAzAdpMIAAAEEALHDgrFUwhZtb7PbXg3upELoDVEUPFRwnmpJH1rRqyROUGcI ooVe7u+FQlIs5OsXK8ECs/5Wpe2UrZSzHvjwBYOND5H42YtI5UULZLRCo5bFfTVA K9Rpo5icfTsYihrzU2nmnycwFMk+jYXyT/ZDYWDP/BM9iLjj0x9/qQgDWPy9AAUR tCNQb3VsLUhlbm5pbmcgS2FtcCA8cGhrQEZyZWVCU0Qub3JnPokAlQMFEDMGK9qz WmLrWZ8yPQEB4iED/18bQVhV2gUYFSxIUTaUtO2HVPi7GRpSzmXoTfS+FJyRR0ED zTqTHstoBe2PeWgTsOf9cUub5UKcJkRQp7VrJv4Kncyuq7pX69a+QMveCzuUwAur nDbt/emOL6NU8g9Uk50QuOuipb5rULQLRRoF5TkViy/VES83ERXdYQ9Ml3fWiQCV AwUQMX6NfWtaZ42Bsqd5AQEKsgP+L+uLz95dRdEmnZ+omrO+tYZM/0jHU7i8yC5q H0gguKOCljI4liR7NkqKONUJWYtfsTB81d9iSosBZRrTx6i/hB8l8kOB975n/f9S hftFwmjLYCNMFlDM4j0kySvMV20UZjAyv9BeE51VWlIZ5n/oeSuzul3Znow02tF/ zVnInJiJAJUDBRAxfJXn9RVb+45ULV0BAXJ8A/9K6NT6VLZZC5q3g7bBk5DWuzBS 3oK2Ebww6xzsD2R9edltoz1J3GPngK0CWpHh4kw5iTaRWoC2YJYRNG6icnGvlMAl 1/urqQHJVhxATINm8oljDKsj1RBJ6VKBzNbCJIHTVpX0AJoqUQX2Idi8goFr0fAm 7cD2CBb1JhoAdzEfO4kAlQMFEDFLHlwff6kIA1j8vQEBj5MD/1hA8hJdhpL7mvQj rTAIn6Ldr08Lr1lqTaKSBMdCL3suGlW0Sw/dIBgicPDhgxLahT3DVfGiIst32FSl xmWY7wine80X4TZkJ9Hiw3Mpqtjl92j6zHNq0ZZE+CceNubpEdYLDqokAIMPdWlo WPHZcPxCs5PKI5udseFYF2gQAjI2iQCVAwUQMTlDoO9huekR1Y7VAQGy+AP/Rzp+ UGtJavbSiPx5EnXOXxkA/+ulXQgQG9vdkWwewkvxDNOzHW3KkUWCGtPtIMENznbF j3QlYB+USIaf1ogvlD5EdXGPDfTINpE8CX2WXzajfgYFpYETDzduwjoWDZfEN9zZ fQqQS62VgAReOIz3k9BL708z/+WUO0++RLGCmImJAJUDBRAw5q8kAPLZCeu7G0EB AT3bBACwo+r9TgbiSyyU5cZpq5KgGT1c7eUHXjtxKmtrXD1nFNJ6j7x2DM2XGe6B YOfDWbFq4UkEAyAeXviuuUP4enQu1v2g7JGXeuI8bRM519pLdPzDq/DnbA4rNStn /SkH7awMfNSplcFuE6rc5ezVkw17eOHzDrYmwsFavL9gxZEycg== =Q45T -----END PGP PUBLIC KEY BLOCK-----</screen> - </informalexample> - </para> - + <programlisting> +Poul-Henning Kamp <phk@FreeBSD.org> +Fingerprint = A3 F3 88 28 2F 9B 99 A2 49 F4 E2 FA 5A 78 8B 3E + +-----BEGIN PGP PUBLIC KEY BLOCK----- +Version: 2.6.3ia + +mQCNAzAdpMIAAAEEALHDgrFUwhZtb7PbXg3upELoDVEUPFRwnmpJH1rRqyROUGcI +ooVe7u+FQlIs5OsXK8ECs/5Wpe2UrZSzHvjwBYOND5H42YtI5UULZLRCo5bFfTVA +K9Rpo5icfTsYihrzU2nmnycwFMk+jYXyT/ZDYWDP/BM9iLjj0x9/qQgDWPy9AAUR +tCNQb3VsLUhlbm5pbmcgS2FtcCA8cGhrQEZyZWVCU0Qub3JnPokAlQMFEDMGK9qz +WmLrWZ8yPQEB4iED/18bQVhV2gUYFSxIUTaUtO2HVPi7GRpSzmXoTfS+FJyRR0ED +zTqTHstoBe2PeWgTsOf9cUub5UKcJkRQp7VrJv4Kncyuq7pX69a+QMveCzuUwAur +nDbt/emOL6NU8g9Uk50QuOuipb5rULQLRRoF5TkViy/VES83ERXdYQ9Ml3fWiQCV +AwUQMX6NfWtaZ42Bsqd5AQEKsgP+L+uLz95dRdEmnZ+omrO+tYZM/0jHU7i8yC5q +H0gguKOCljI4liR7NkqKONUJWYtfsTB81d9iSosBZRrTx6i/hB8l8kOB975n/f9S +hftFwmjLYCNMFlDM4j0kySvMV20UZjAyv9BeE51VWlIZ5n/oeSuzul3Znow02tF/ +zVnInJiJAJUDBRAxfJXn9RVb+45ULV0BAXJ8A/9K6NT6VLZZC5q3g7bBk5DWuzBS +3oK2Ebww6xzsD2R9edltoz1J3GPngK0CWpHh4kw5iTaRWoC2YJYRNG6icnGvlMAl +1/urqQHJVhxATINm8oljDKsj1RBJ6VKBzNbCJIHTVpX0AJoqUQX2Idi8goFr0fAm +7cD2CBb1JhoAdzEfO4kAlQMFEDFLHlwff6kIA1j8vQEBj5MD/1hA8hJdhpL7mvQj +rTAIn6Ldr08Lr1lqTaKSBMdCL3suGlW0Sw/dIBgicPDhgxLahT3DVfGiIst32FSl +xmWY7wine80X4TZkJ9Hiw3Mpqtjl92j6zHNq0ZZE+CceNubpEdYLDqokAIMPdWlo +WPHZcPxCs5PKI5udseFYF2gQAjI2iQCVAwUQMTlDoO9huekR1Y7VAQGy+AP/Rzp+ +UGtJavbSiPx5EnXOXxkA/+ulXQgQG9vdkWwewkvxDNOzHW3KkUWCGtPtIMENznbF +j3QlYB+USIaf1ogvlD5EdXGPDfTINpE8CX2WXzajfgYFpYETDzduwjoWDZfEN9zZ +fQqQS62VgAReOIz3k9BL708z/+WUO0++RLGCmImJAJUDBRAw5q8kAPLZCeu7G0EB +AT3bBACwo+r9TgbiSyyU5cZpq5KgGT1c7eUHXjtxKmtrXD1nFNJ6j7x2DM2XGe6B +YOfDWbFq4UkEAyAeXviuuUP4enQu1v2g7JGXeuI8bRM519pLdPzDq/DnbA4rNStn +/SkH7awMfNSplcFuE6rc5ezVkw17eOHzDrYmwsFavL9gxZEycg== +=Q45T +-----END PGP PUBLIC KEY BLOCK----- + </programlisting> </sect2> <sect2> <title>&a.rich;</title> - <para> - <informalexample> - <screen>Rich Murphey <rich@FreeBSD.org> fingerprint = AF - A0 60 C4 84 D6 0C 73 D1 EF C0 E9 9D 21 DB E4 -----BEGIN PGP - PUBLIC KEY BLOCK----- Version: 2.6.2 - mQCNAy97V+MAAAEEALiNM3FCwm3qrCe81E20UOSlNclOWfZHNAyOyj1ahHeINvo1 FBF2Gd5Lbj0y8SLMno5yJ6P4F4r+x3jwHZrzAIwMs/lxDXRtB0VeVWnlj6a3Rezs wbfaTeSVyh5JohEcKdoYiMG5wjATOwK/NAwIPthB1RzRjnEeer3HI3ZYNEOpAAUR tCRSaWNoIE11cnBoZXkgPHJpY2hAbGFtcHJleS51dG1iLmVkdT6JAJUDBRAve15W vccjdlg0Q6kBAZTZBACcNd/LiVnMFURPrO4pVRn1sVQeokVX7izeWQ7siE31Iy7g Sb97WRLEYDi686osaGfsuKNA87Rm+q5F+jxeUV4w4szoqp60gGvCbD0KCB2hWraP /2s2qdVAxhfcoTin/Qp1ZWvXxFF7imGA/IjYIfB42VkaRYu6BwLEm3YAGfGcSw== =QoiM -----END PGP PUBLIC KEY BLOCK-----</screen> - </informalexample> - </para> - + <programlisting> +Rich Murphey <rich@FreeBSD.org> +fingerprint = AF A0 60 C4 84 D6 0C 73 D1 EF C0 E9 9D 21 DB E4 + +-----BEGIN PGP PUBLIC KEY BLOCK----- +Version: 2.6.2 + +mQCNAy97V+MAAAEEALiNM3FCwm3qrCe81E20UOSlNclOWfZHNAyOyj1ahHeINvo1 +FBF2Gd5Lbj0y8SLMno5yJ6P4F4r+x3jwHZrzAIwMs/lxDXRtB0VeVWnlj6a3Rezs +wbfaTeSVyh5JohEcKdoYiMG5wjATOwK/NAwIPthB1RzRjnEeer3HI3ZYNEOpAAUR +tCRSaWNoIE11cnBoZXkgPHJpY2hAbGFtcHJleS51dG1iLmVkdT6JAJUDBRAve15W +vccjdlg0Q6kBAZTZBACcNd/LiVnMFURPrO4pVRn1sVQeokVX7izeWQ7siE31Iy7g +Sb97WRLEYDi686osaGfsuKNA87Rm+q5F+jxeUV4w4szoqp60gGvCbD0KCB2hWraP +/2s2qdVAxhfcoTin/Qp1ZWvXxFF7imGA/IjYIfB42VkaRYu6BwLEm3YAGfGcSw== +=QoiM +-----END PGP PUBLIC KEY BLOCK----- + </programlisting> </sect2> <sect2> <title>&a.jdp;</title> - <para> - <informalexample> - <screen>John D. Polstra <jdp@polstra.com> Fingerprint = 54 - 3A 90 59 6B A4 9D 61 BF 1D 03 09 35 8D F6 0D -----BEGIN PGP - PUBLIC KEY BLOCK----- Version: 2.6.2 - mQCNAzMElMEAAAEEALizp6ZW9QifQgWoFmG3cXhzQ1+Gt+a4S1adC/TdHdBvw1M/ I6Ok7TC0dKF8blW3VRgeHo4F3XhGn+n9MqIdboh4HJC5Iiy63m98sVLJSwyGO4oM dkEGyyCLxqP6h/DU/tzNBdqFzetGtYvU4ftt3RO0a506cr2CHcdm8Q+/vPRJAAUR tCFKb2huIEQuIFBvbHN0cmEgPGpkcEBwb2xzdHJhLmNvbT6JAJUDBRAzBNBE9RVb +45ULV0BAWgiA/0WWO3+c3qlptPCHJ3DFm6gG/qNKsY94agL/mHOr0fxMP5l2qKX O6a1bWkvGoYq0EwoKGFfn0QeHiCl6jVi3CdBX+W7bObMcoi+foqZ6zluOWBC1Jdk WQ5/DeqQGYXqbYjqO8voCScTAPge3XlMwVpMZTv24u+nYxtLkE0ZcwtY9IkAlQMF EDMEt/DHZvEPv7z0SQEBXh8D/2egM5ckIRpGz9kcFTDClgdWWtlgwC1iI2p9gEhq aufy+FUJlZS4GSQLWB0BlrTmDC9HuyQ+KZqKFRbVZLyzkH7WFs4zDmwQryLV5wkN C4BRRBXZfWy8s4+zT2WQD1aPO+ZsgRauYLkJgTvXTPU2JCN62Nsd8R7bJS5tuHEm 7HGmiQCVAwUQMwSvHB9/qQgDWPy9AQFAhAQAgJ1AlbKITrEoJ0+pLIsov3eQ348m SVHEBGIkU3Xznjr8NzT9aYtq4TIzt8jplqP3QoV1ka1yYpZf0NjvfZ+ffYp/sIaU wPbEpgtmHnVWJAebMbNs/Ad1w8GDvxEt9IaCbMJGZnHmfnEqOBIxF7VBDPHHoJxM V31K/PIoYsHAy5w= =cHFa -----END PGP PUBLIC KEY BLOCK-----</screen> - </informalexample> - </para> - + <programlisting> +John D. Polstra <jdp@polstra.com> +Fingerprint = 54 3A 90 59 6B A4 9D 61 BF 1D 03 09 35 8D F6 0D + +-----BEGIN PGP PUBLIC KEY BLOCK----- +Version: 2.6.2 + +mQCNAzMElMEAAAEEALizp6ZW9QifQgWoFmG3cXhzQ1+Gt+a4S1adC/TdHdBvw1M/ +I6Ok7TC0dKF8blW3VRgeHo4F3XhGn+n9MqIdboh4HJC5Iiy63m98sVLJSwyGO4oM +dkEGyyCLxqP6h/DU/tzNBdqFzetGtYvU4ftt3RO0a506cr2CHcdm8Q+/vPRJAAUR +tCFKb2huIEQuIFBvbHN0cmEgPGpkcEBwb2xzdHJhLmNvbT6JAJUDBRAzBNBE9RVb ++45ULV0BAWgiA/0WWO3+c3qlptPCHJ3DFm6gG/qNKsY94agL/mHOr0fxMP5l2qKX +O6a1bWkvGoYq0EwoKGFfn0QeHiCl6jVi3CdBX+W7bObMcoi+foqZ6zluOWBC1Jdk +WQ5/DeqQGYXqbYjqO8voCScTAPge3XlMwVpMZTv24u+nYxtLkE0ZcwtY9IkAlQMF +EDMEt/DHZvEPv7z0SQEBXh8D/2egM5ckIRpGz9kcFTDClgdWWtlgwC1iI2p9gEhq +aufy+FUJlZS4GSQLWB0BlrTmDC9HuyQ+KZqKFRbVZLyzkH7WFs4zDmwQryLV5wkN +C4BRRBXZfWy8s4+zT2WQD1aPO+ZsgRauYLkJgTvXTPU2JCN62Nsd8R7bJS5tuHEm +7HGmiQCVAwUQMwSvHB9/qQgDWPy9AQFAhAQAgJ1AlbKITrEoJ0+pLIsov3eQ348m +SVHEBGIkU3Xznjr8NzT9aYtq4TIzt8jplqP3QoV1ka1yYpZf0NjvfZ+ffYp/sIaU +wPbEpgtmHnVWJAebMbNs/Ad1w8GDvxEt9IaCbMJGZnHmfnEqOBIxF7VBDPHHoJxM +V31K/PIoYsHAy5w= +=cHFa +-----END PGP PUBLIC KEY BLOCK----- + </programlisting> </sect2> <sect2> <title>&a.guido;</title> - <para> - <informalexample> - <screen>Guido van Rooij <guido@gvr.win.tue.nl> Fingerprint - = 16 79 09 F3 C0 E4 28 A7 32 62 FA F6 60 31 C0 ED -----BEGIN - PGP PUBLIC KEY BLOCK----- Version: 2.6.2 - mQCNAzGeO84AAAEEAKKAY91Na//DXwlUusr9GVESSlVwVP6DyH1wcZXhfN1fyZHq SwhMCEdHYoojQds+VqD1iiZQvv1RLByBgj622PDAPN4+Z49HjGs7YbZsUNuQqPPU wRPpP6ty69x1hPKq1sQIB5MS4radpCM+4wbZbhxv7l4rP3RWUbNaYutZnzI9AAUR tCZHdWlkbyB2YW4gUm9vaWogPGd1aWRvQGd2ci53aW4udHVlLm5sPokAlQMFEDMG Hcgff6kIA1j8vQEBbYgD/jm9xHuUuY+iXDkOzpCXBYACYEZDV913MjtyBAmaVqYo Rh5HFimkGXe+rCo78Aau0hc57fFMTsJqnuWEqVt3GRq28hSK1FOZ7ni9/XibHcmN rt2yugl3hYpClijo4nrDL1NxibbamkGW/vFGcljS0jqXz6NDVbGx5Oo7HBByxByz iQCVAwUQMhmtVjt/x7zOdmsfAQFuVQQApsVUTigT5YWjQA9Nd5Z0+a/oVtZpyw5Z OljLJP3vqJdMa6TidhfcatjHbFTve5x1dmjFgMX/MQTd8zf/+Xccy/PX4+lnKNpP eSf1Y4aK+E8KHmBGd6GzX6CIboyGYLS9e3kGnN06F2AQtaLyJFgQ71wRaGuyKmQG FwTn7jiKb1aJAJUDBRAyEOLXPt3iN6QQUSEBATwQA/9jqu0Nbk154+Pn+9mJX/YT fYR2UqK/5FKCqgL5Nt/Deg2re0zMD1f8F9Dj6vuAAxq8hnOkIHKlWolMjkRKkzJi mSPEWl3AuHJ31k948J8it4f8kq/o44usIA2KKVMlI63Q/rmNdfWCyiYQEVGcRbTm GTdZIHYCOgV5dOo4ebFqgYkAlQMFEDIE1nMEJn15jgpJ0QEBW6kEAKqN8XSgzTqf CrxFXT07MlHhfdbKUTNUoboxCGCLNW05vf1A8F5fdE5i14LiwkldWIzPxWD+Sa3L fNPCfCZTaCiyGcLyTzVfBHA18MBAOOX6JiTpdcm22jLGUWBf/aJK3yz/nfbWntd/ LRHysIdVp29lP5BF+J9/Lzbb/9LxP1taiQCVAwUQMgRXZ44CzbsJWQz9AQFf7gP/ Qa2FS5S6RYKG3rYanWADVe/ikFV2lxuM1azlWbsmljXvKVWGe6cV693nS5lGGAjx lbd2ADwXjlkNhv45HLWFm9PEveO9Jjr6tMuXVt8N2pxiX+1PLUN9CtphTIU7Yfjn s6ryZZfwGHSfIxNGi5ua2SoXhg0svaYnxHxXmOtH24iJAJUDBRAyAkpV8qaAEa3W TBkBARfQBAC+S3kbulEAN3SI7/A+A/dtl9DfZezT9C4SRBGsl2clQFMGIXmMQ/7v 7lLXrKQ7U2zVbgNfU8smw5h2vBIL6f1PyexSmc3mz9JY4er8KeZpcf6H0rSkHl+i d7TF0GvuTdNPFO8hc9En+GG6QHOqbkB4NRZ6cwtfwUMhk2FHXBnjF4kAlQMFEDH5 FFukUJAsCdPmTQEBe74EAMBsxDnbD9cuI5MfF/QeTNEG4BIVUZtAkDme4Eg7zvsP d3DeJKCGeNjiCWYrRTCGwaCWzMQk+/+MOmdkI6Oml+AIurJLoHceHS9jP1izdP7f N2jkdeJSBsixunbQWtUElSgOQQ4iF5kqwBhxtOfEP/L9QsoydRMR1yB6WPD75H7V iQCVAwUQMZ9YNGtaZ42Bsqd5AQH0PAQAhpVlAc3ZM/KOTywBSh8zWKVlSk3q/zGn k7hJmFThnlhH1723+WmXE8aAPJi+VXOWJUFQgwELJ6R8jSU2qvk2m1VWyYSqRKvc VRQMqT2wjss0GE1Ngg7tMrkRHT0il7E2xxIb8vMrIwmdkbTfYqBUhhGnsWPHZHq7 MoA1/b+rK7CJAJUDBRAxnvXh3IDyptUyfLkBAYTDA/4mEKlIP/EUX2Zmxgrd/JQB hqcQlkTrBAaDOnOqe/4oewMKR7yaMpztYhJs97i03Vu3fgoLhDspE55ooEeHj0r4 cOdiWfYDsjSFUYSPNVhW4OSruMA3c29ynMqNHD7hpr3rcCPUi7J2RncocOcCjjK2 BQb/9IAUNeK4C9gPxMEZLokAlQMFEDGeO86zWmLrWZ8yPQEBEEID/2fPEUrSX3Yk j5TJPFZ9MNX0lEo7AHYjnJgEbNI4pYm6C3PnMlsYfCSQDHuXmRQHAOWSdwOLvCkN F8eDaF3M6u0urgeVJ+KVUnTz2+LZoZs12XSZKCte0HxjbvPpWMTTrYyimGezH79C mgDVjsHaYOx3EXF0nnDmtXurGioEmW1J =mSvM -----END PGP PUBLIC KEY BLOCK-----</screen> - </informalexample> - </para> - + <programlisting> +Guido van Rooij <guido@gvr.win.tue.nl> +Fingerprint = 16 79 09 F3 C0 E4 28 A7 32 62 FA F6 60 31 C0 ED + +-----BEGIN PGP PUBLIC KEY BLOCK----- +Version: 2.6.2 + +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 +mgDVjsHaYOx3EXF0nnDmtXurGioEmW1J +=mSvM +-----END PGP PUBLIC KEY BLOCK----- + </programlisting> </sect2> <sect2> <title>&a.peter;</title> - <para> - <informalexample> - <screen>Peter Wemm <peter@FreeBSD.org> aka - <peter@spinner.dialix.com> aka - <peter@haywire.dialix.com> aka - <peter@perth.dialix.oz.au> Key fingerprint = 47 05 04 CA - 4C EE F8 93 F6 DB 02 92 6D F5 58 8A -----BEGIN PGP PUBLIC KEY - BLOCK----- Version: 2.6.3ia - mQCNAy9/FJwAAAEEALxs9dE9tFd0Ru1TXdq301KfEoe5uYKKuldHRBOacG2Wny6/ W3Ill57hOi2+xmq5X/mHkapywxvy4cyLdt31i4GEKDvxpDvEzAYcy2n9dIup/eg2 kEhRBX9G5k/LKM4NQsRIieaIEGGgCZRm0lINqw495aZYrPpO4EqGN2HYnOMZAAUT tCVQZXRlciBXZW1tIDxwZXRlckBoYXl3aXJlLmRpYWxpeC5jb20+iQCVAwUQMwWT cXW7bjh2o/exAQEFkQP+LIx5zKlYp1uR24xGApMFNrNtjh+iDIWnxxb2M2Kb6x4G 9z6OmbUCoDTGrX9SSL2Usm2RD0BZfyv9D9QRWC2TSOPkPRqQgIycc11vgbLolJJN eixqsxlFeKLGEx9eRQCCbo3dQIUjc2yaOe484QamhsK1nL5xpoNWI1P9zIOpDiGJ AJUDBRAxsRPqSoY3Ydic4xkBAbWLA/9q1Fdnnk4unpGQsG31Qbtr4AzaQD5m/JHI 4gRmSmbj6luJMgNG3fpO06Gd/Z7uxyCJB8pTst2a8C/ljOYZxWT+5uSzkQXeMi5c YcI1sZbUpkHtmqPW623hr1PB3ZLA1TIcTbQW+NzJsxQ1Pc6XG9fGkT9WXQW3Xhet AP+juVTAhLQlUGV0ZXIgV2VtbSA8cGV0ZXJAcGVydGguZGlhbGl4Lm96LmF1PokA lQMFEDGxFCFKhjdh2JzjGQEB6XkD/2HOwfuFrnQUtdwFPUkgtEqNeSr64jQ3Maz8 xgEtbaw/ym1PbhbCk311UWQq4+izZE2xktHTFClJfaMnxVIfboPyuiSF99KHiWnf /Gspet0S7m/+RXIwZi1qSqvAanxMiA7kKgFSCmchzas8TQcyyXHtn/gl9v0khJkb /fv3R20btB5QZXRlciBXZW1tIDxwZXRlckBGcmVlQlNELm9yZz6JAJUDBRAxsRJd SoY3Ydic4xkBAZJUA/4i/NWHz5LIH/R4IF/3V3LleFyMFr5EPFY0/4mcv2v+ju9g brOEM/xd4LlPrx1XqPeZ74JQ6K9mHR64RhKR7ZJJ9A+12yr5dVqihe911KyLKab9 4qZUHYi36WQu2VtLGnw/t8Jg44fQSzbBF5q9iTzcfNOYhRkSD3BdDrC3llywO7Ql UGV0ZXIgV2VtbSA8cGV0ZXJAc3Bpbm5lci5kaWFsaXguY29tPokAlQMFEDGxEi1K hjdh2JzjGQEBdA4EAKmNFlj8RF9HQsoI3UabnvYqAWN5wCwEB4u+Zf8zq6OHic23 TzoK1SPlmSdBE1dXXQGS6aiDkLT+xOdeewNs7nfUIcH/DBjSuklAOJzKliXPQW7E kuKNwy4eq5bl+j3HB27i+WBXhn6OaNNQY674LGaR41EGq44Wo5ATcIicig/z =gv+h -----END PGP PUBLIC KEY BLOCK-----</screen> - </informalexample> - </para> - + <programlisting> +Peter Wemm <peter@FreeBSD.org> + aka <peter@spinner.dialix.com> + aka <peter@haywire.dialix.com> + aka <peter@perth.dialix.oz.au> +Key fingerprint = 47 05 04 CA 4C EE F8 93 F6 DB 02 92 6D F5 58 8A + +-----BEGIN PGP PUBLIC KEY BLOCK----- +Version: 2.6.3ia + +mQCNAy9/FJwAAAEEALxs9dE9tFd0Ru1TXdq301KfEoe5uYKKuldHRBOacG2Wny6/ +W3Ill57hOi2+xmq5X/mHkapywxvy4cyLdt31i4GEKDvxpDvEzAYcy2n9dIup/eg2 +kEhRBX9G5k/LKM4NQsRIieaIEGGgCZRm0lINqw495aZYrPpO4EqGN2HYnOMZAAUT +tCVQZXRlciBXZW1tIDxwZXRlckBoYXl3aXJlLmRpYWxpeC5jb20+iQCVAwUQMwWT +cXW7bjh2o/exAQEFkQP+LIx5zKlYp1uR24xGApMFNrNtjh+iDIWnxxb2M2Kb6x4G +9z6OmbUCoDTGrX9SSL2Usm2RD0BZfyv9D9QRWC2TSOPkPRqQgIycc11vgbLolJJN +eixqsxlFeKLGEx9eRQCCbo3dQIUjc2yaOe484QamhsK1nL5xpoNWI1P9zIOpDiGJ +AJUDBRAxsRPqSoY3Ydic4xkBAbWLA/9q1Fdnnk4unpGQsG31Qbtr4AzaQD5m/JHI +4gRmSmbj6luJMgNG3fpO06Gd/Z7uxyCJB8pTst2a8C/ljOYZxWT+5uSzkQXeMi5c +YcI1sZbUpkHtmqPW623hr1PB3ZLA1TIcTbQW+NzJsxQ1Pc6XG9fGkT9WXQW3Xhet +AP+juVTAhLQlUGV0ZXIgV2VtbSA8cGV0ZXJAcGVydGguZGlhbGl4Lm96LmF1PokA +lQMFEDGxFCFKhjdh2JzjGQEB6XkD/2HOwfuFrnQUtdwFPUkgtEqNeSr64jQ3Maz8 +xgEtbaw/ym1PbhbCk311UWQq4+izZE2xktHTFClJfaMnxVIfboPyuiSF99KHiWnf +/Gspet0S7m/+RXIwZi1qSqvAanxMiA7kKgFSCmchzas8TQcyyXHtn/gl9v0khJkb +/fv3R20btB5QZXRlciBXZW1tIDxwZXRlckBGcmVlQlNELm9yZz6JAJUDBRAxsRJd +SoY3Ydic4xkBAZJUA/4i/NWHz5LIH/R4IF/3V3LleFyMFr5EPFY0/4mcv2v+ju9g +brOEM/xd4LlPrx1XqPeZ74JQ6K9mHR64RhKR7ZJJ9A+12yr5dVqihe911KyLKab9 +4qZUHYi36WQu2VtLGnw/t8Jg44fQSzbBF5q9iTzcfNOYhRkSD3BdDrC3llywO7Ql +UGV0ZXIgV2VtbSA8cGV0ZXJAc3Bpbm5lci5kaWFsaXguY29tPokAlQMFEDGxEi1K +hjdh2JzjGQEBdA4EAKmNFlj8RF9HQsoI3UabnvYqAWN5wCwEB4u+Zf8zq6OHic23 +TzoK1SPlmSdBE1dXXQGS6aiDkLT+xOdeewNs7nfUIcH/DBjSuklAOJzKliXPQW7E +kuKNwy4eq5bl+j3HB27i+WBXhn6OaNNQY674LGaR41EGq44Wo5ATcIicig/z +=gv+h +-----END PGP PUBLIC KEY BLOCK----- + </programlisting> </sect2> <sect2> <title>&a.joerg;</title> - <para> - <informalexample> - <screen>Type Bits/KeyID Date User ID pub 1024/76A3F7B1 - 1996/04/27 Joerg Wunsch <joerg_wunsch@uriah.heep.sax.de> - Key fingerprint = DC 47 E6 E4 FF A6 E9 8F 93 21 E0 7D F9 12 - D6 4E Joerg Wunsch <joerg_wunsch@interface-business.de> - Joerg Wunsch <j@uriah.heep.sax.de> Joerg Wunsch - <j@interface-business.de> -----BEGIN PGP PUBLIC KEY - BLOCK----- Version: 2.6.3ia - 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 =97h7 -----END PGP PUBLIC KEY BLOCK-----</screen> - </informalexample> - - </para> - + <programlisting> +Type Bits/KeyID Date User ID +pub 1024/76A3F7B1 1996/04/27 Joerg Wunsch <joerg_wunsch@uriah.heep.sax.de> + Key fingerprint = DC 47 E6 E4 FF A6 E9 8F 93 21 E0 7D F9 12 D6 4E + Joerg Wunsch <joerg_wunsch@interface-business.de> + Joerg Wunsch <j@uriah.heep.sax.de> + Joerg Wunsch <j@interface-business.de> + +-----BEGIN PGP PUBLIC KEY BLOCK----- +Version: 2.6.3ia + +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 +=97h7 +-----END PGP PUBLIC KEY BLOCK----- + </programlisting> </sect2> </sect1> </chapter> - </part></book> + </part> +</book> |