source: appendices/generic/generic.xml@ 167dc1dc

<appendix id="appendices-generic">
<?dbhtml filename="generic.html" dir="appendices"?>
<title>Installing in non-default locations</title>

<para>When you want to install a package to a location other than
<filename class='directory'>/</filename>, or <filename class='directory'>/usr</filename>, you are installing
outside the default environment settings on most machines.  The following
examples should assist you in determining how to correct this situation.
The examples cover the complete range of settings that may need
updating, but they are not all needed in every situation.</para>

<itemizedlist>
<listitem><para>Expand the <envar>PATH</envar> to include
<filename class='directory'>$PREFIX/bin</filename>.</para></listitem>
<listitem><para>Expand the <envar>PATH</envar> for root to include
<filename class='directory'>$PREFIX/sbin</filename>.</para></listitem>
<listitem><para>Add <filename class='directory'>$PREFIX/lib</filename>
to <filename>/etc/ld.so.conf</filename> or expand
<envar>LD_LIBRARY_PATH</envar> to include it. Before using the latter option,
check out <ulink url="http://www.visi.com/~barr/ldpath.html"/>. If you
modify <filename>/etc/ld.so.conf</filename> remember to update
<filename>/etc/ld.so.cache</filename> by executing <command>ldconfig</command>.</para></listitem>
<listitem><para>Add <filename class='directory'>$PREFIX/man</filename>
to <filename>/etc/man.conf</filename> or expand <envar>MANPATH</envar>.</para></listitem>
<listitem><para>Add <filename class='directory'>$PREFIX/info</filename>
to <envar>INFOPATH</envar>.</para></listitem>
<listitem><para>Add <filename
class='directory'>$PREFIX/lib/pkgconfig</filename> to
<envar>PKG_CONFIG_PATH</envar>.</para></listitem>
<listitem><para>Add <filename
class='directory'>$PREFIX/include</filename> to <envar>CPPFLAGS</envar> when compiling packages
that depend on the package you installed.</para></listitem>
</itemizedlist>

</appendix>