Changeset 11757

Timestamp:

Feb 12, 2007, 3:28:42 PM (19 years ago)

Author:

jhoblitt

Message:

add "Trouble Shooting Build Issues" section

File:

• trunk/doc/manual/manual.tex (modified) (2 diffs)

trunk/doc/manual/manual.tex

@@ -1 @@
- %%% $Id: manual.tex,v 1.4 2007-02-03 04:48:45 jhoblitt Exp $
+ %%% $Id: manual.tex,v 1.5 2007-02-13 01:28:42 jhoblitt Exp $
 \documentclass[panstarrs,spec]{panstarrs}
 
@@ -1108 +1108 @@
 
 
+\section{Trouble Shooting Build Issues}
+
+\subsection{missing libX11.so}
+
+RedHat RHEL 3 & 4 (likely other RedHat variants as well) for \emph{amd64} seem
+to often be installed without a \code{libX11.so} under
+\code{/usr/X11R6/lib64/}.  This will cause 64bit builds trying to link against
+libX11 (\code{-lX11}) to fail.
+
+If you have root access you can fix this by adding the missing symlink
+yourself.  Eg..
+
+\begin{verbatium}
+su -
+cd /usr/X116/lib64
+ln -s libX11.so.6.2 libX11.so
+\end{verbatium}
+
+or with \code{sudo}:
+
+\begin{verbatium}
+cd /usr/X116/lib64
+sudo ln -s libX11.so.6.2 libX11.so
+\end{verbatium}
+
+
+For users without root access to thier system ,a symlink needs to be installed
+under \code{\$prefix/lib}, where \code{\$prefix} is the path underwhich your
+installing IPP software.  Note that \code{\$prefix/lib} will also need to be manually added the enviroment variable \code{LD_LIBRARY_PATH} if your not using jhbuild. E.g for ksh/bash users:
+
+\begin{verbatium}
+export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/home/[foo]/[yourinstallprefix]/lib
+\end{verbatium}
+
+
 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%