- Remove the description of the doc packages, as they don't exist any more

PR:		docs/123920
Submitted by:	pgj
This commit is contained in:
Gabor Kovesdan 2008-05-27 23:51:07 +00:00
parent bd659fe874
commit b68f6a6117
Notes: svn2git 2020-12-08 03:00:23 +00:00
svn path=/head/; revision=32068

View file

@ -938,50 +938,7 @@
</itemizedlist>
<para>After choosing the format and compression mechanism that you
want to download, you must then decide whether or not you want to
download the document as a FreeBSD
<emphasis>package</emphasis>.</para>
<para>The advantage of downloading and installing the package is
that the documentation can then be managed using the normal
FreeBSD package management commands, such as &man.pkg.add.1; and
&man.pkg.delete.1;.</para>
<para>If you decide to download and install the package then
you must know the filename to download. The
documentation-as-packages files are stored in a directory
called <filename>packages</filename>. Each package file
looks like
<filename><replaceable>document-name</replaceable>.<replaceable>lang</replaceable>.<replaceable>encoding</replaceable>.<replaceable>format</replaceable>.tgz</filename>.</para>
<para>For example, the FAQ, in English, formatted as PDF, is in the
package called
<filename>faq.en_US.ISO8859-1.pdf.tgz</filename>.</para>
<para>Knowing this, you can use the following command to
install the English PDF FAQ package.</para>
<screen>&prompt.root; <userinput>pkg_add ftp://ftp.FreeBSD.org/pub/FreeBSD/doc/packages/faq.en_US.ISO8859-1.pdf.tgz</userinput></screen>
<para>Having done that, you can use &man.pkg.info.1; to determine
where the file has been installed.</para>
<screen>&prompt.root; <userinput>pkg_info -f faq.en_US.ISO8859-1.pdf</userinput>
Information for faq.en_US.ISO8859-1.pdf:
Packing list:
Package name: faq.en_US.ISO8859-1.pdf
CWD to /usr/share/doc/en_US.ISO8859-1/books/faq
File: book.pdf
CWD to .
File: +COMMENT (ignored)
File: +DESC (ignored)</screen>
<para>As you can see, <filename>book.pdf</filename> will
have been installed into
<filename>/usr/share/doc/en_US.ISO8859-1/books/faq</filename>.</para>
<para>If you do not want to use the packages then you will have to
want to download, you will have to
download the compressed files yourself, uncompress them, and then
copy the appropriate documents into place.</para>