changeset 14187:53a9c916ba2f stable

doc: include tips for installing build dependencies on specific systems * install.txi: Add info for install build deps with apt-get and yum.
author John W. Eaton <jwe@octave.org>
date Tue, 10 Jan 2012 15:25:35 -0500
parents eb29a53834af
children 053404893d02
files doc/interpreter/install.txi
diffstat 1 files changed, 53 insertions(+), 0 deletions(-) [+]
line wrap: on
line diff
--- a/doc/interpreter/install.txi
+++ b/doc/interpreter/install.txi
@@ -64,6 +64,56 @@
 part of your system, or you may have to build some or all of them
 yourself.
 
+@menu
+* Tips for Specific Systems::
+* Build Tools::
+* External Packages::
+@end menu
+
+@node Tips for Specific Systems
+@subsection Tips for Specific Systems
+
+The names of pre-compiled packages vary by system and do not always
+match exactly the names listed above.
+
+You will usually need the development version of an external dependency
+so that you get the libraries and header files for building software,
+not just for running already compiled programs.  These packages
+typically have names that end with the suffix @code{-dev} or @code{-devel}.
+
+On systems with @code{apt-get} (Debian, Ubuntu, etc.), you may be able
+to install most of the tools and external packages using a command
+similar to
+
+@example
+apt-get build-dep octave
+@end example
+
+@noindent
+The specific package name may be @code{octave3.2} or @code{octave3.4}.
+The set of required tools and external dependencies does not change
+frequently, so it is not important that the version match exactly, but
+you should use the most recent one available.
+
+On systems with @code{yum} (Fedora, Red Hat, etc.), you may be able to
+install most of the tools and external packages using a command similar to
+
+@example
+yum-builddep octave
+@end example
+
+@noindent
+The @code{yum-builddep} utility is part of the @code{yum-utils} package.
+
+For either type of system, the package name may include a version
+number.  The set of required tools and external dependencies does not
+change frequently, so it is not important that the version exactly match
+the version you are installing, but you should use the most recent one
+available.
+
+@node Build Tools
+@subsection Build Tools
+
 The following tools are required:
 
 @table @asis
@@ -118,6 +168,9 @@
 Automake.
 @end table
 
+@node External Packages
+@subsection External Packages
+
 The following external packages are required:
 
 @table @asis