Date: Sat, 18 May 2013 18:24:11 +0000 (UTC) From: Tom Rhodes <trhodes@FreeBSD.org> To: doc-committers@freebsd.org, svn-doc-projects@freebsd.org Subject: svn commit: r41663 - projects/ISBN_1-57176-407-0/en_US.ISO8859-1/books/handbook/ports Message-ID: <201305181824.r4IIOBcm068566@svn.freebsd.org>
next in thread | raw e-mail | index | archive | help
Author: trhodes Date: Sat May 18 18:24:11 2013 New Revision: 41663 URL: http://svnweb.freebsd.org/changeset/doc/41663 Log: Reword to avoid "you" in the ports after install section (which is where I performed work in the previous commit). Modified: projects/ISBN_1-57176-407-0/en_US.ISO8859-1/books/handbook/ports/chapter.xml Modified: projects/ISBN_1-57176-407-0/en_US.ISO8859-1/books/handbook/ports/chapter.xml ============================================================================== --- projects/ISBN_1-57176-407-0/en_US.ISO8859-1/books/handbook/ports/chapter.xml Sat May 18 18:09:00 2013 (r41662) +++ projects/ISBN_1-57176-407-0/en_US.ISO8859-1/books/handbook/ports/chapter.xml Sat May 18 18:24:11 2013 (r41663) @@ -1800,18 +1800,18 @@ ftp://ftp.FreeBSD.org/pub/FreeBSD/ports/ <itemizedlist> <listitem> - <para>Use &man.pkg.info.1; to find out which files were - installed, and where. For example, if you have just - installed FooPackage version 1.0.0, then this command</para> + <para>The &man.pkg.info.1; will print all installed + files and their location. For example, if the FooPackage + version 1.0.0 was just installed, then the following + command will show all the files installed with the + package.</para> <screen>&prompt.root; <userinput>pkg_info -L <replaceable>foopackage-1.0.0</replaceable> | less</userinput></screen> - <para>will show all the files installed by the package. Pay - special attention to files located in - <filename>man/</filename>, which will be manual pages, - <filename>etc/</filename>, which will be configuration - files, and <filename>doc/</filename>, which will be more - comprehensive documentation.</para> + <para>Configuration files are always installed in the + <filename role="directory">/usr/local/etc</filename> + and should definitely be consulted before attempting + to use the new application.</para> <para>To determine which version of the application was installed:</para> @@ -1825,17 +1825,18 @@ ftp://ftp.FreeBSD.org/pub/FreeBSD/ports/ </listitem> <listitem> - <para>Once you have identified where the application's manual - pages have been installed, review them using &man.man.1;. - Review the sample configuration files and any additional - documentation that may have been provided.</para> + <para>These commands will also show the names of any manual + pages installed with the application. This additional + documentation will now be available to the &man.man.1; + command.</para> </listitem> <listitem> - <para>If the application has a web site, check it for - additional documentation, frequently asked questions, and so - forth. If you are not sure of the web site address it may - be listed in the output from</para> + <para>If the application has a web site, consult it for + additional documentation, frequently asked questions, or + a forum. If the website is unknown, the following command + will be useful to print out this information if it's + available.</para> <screen>&prompt.root; <userinput>pkg_info <replaceable>foopackage-1.0.0</replaceable></userinput></screen>
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?201305181824.r4IIOBcm068566>