libabigail/COMPILING
Randy MacLeod 4aa7f38334 Improve some grammar
Fix typos and try to improve some grammar in the files
in the top level directory.

        * COMPILING: Improve grammar
        * CONTRIBUTING: Improve grammar
        * README: Improve grammar
        * VISIBILITY: Improve grammar

Signed-off-by: Randy MacLeod <Randy.MacLeod@windriver.com>
2022-02-25 11:24:20 +01:00

115 lines
3.0 KiB
Plaintext

To compile libabigail, you first need to install its dependencies. At
the moment the dependencies are the following Free Software packages:
elfutils
libtool
libxml2
If you are building from the Git repository, then you'd also need the
following packages:
autoconf
automake
pkg-config
If you want to build the documentation of libabigail, then you also
need these packages (and their dependencies):
doxygen
python-sphinx
Note that if you are installing these packages in a binary form
provided by your distribution, then you probably need to install the
development variant of those packages if the distribution has one.
Once you have installed the development packages of the dependencies,
there are two options for compiling libabigail, depending on the two
kinds of source code packages you have: either you have the source
code from our Git source control management system, or you have a
released tarball.
* Getting and compiling libabigail from Git
===========================================
To get the source code from git, you have to type:
git clone git://sourceware.org/git/libabigail.git
Please note that to compile libabigail from its sources in this case,
you need to have the 'autoconf' page installed on your machine.
Then go to your local libabigail.git directory where the source code
you've checked out lies and create a 'build' directory that will
receive the binaries resulting from the compilation:
cd libabigail.git
mkdir build
Generate the relevant build-system-related information needed to
configure the package for compilation, by typing:
autoreconf -i
Then configure the package:
cd build
../configure --prefix=<absolute-path-of-where-you-want-the-binaries-to-be-installed>
Then build the package
make
And then install its resulting binaries and documentation:
make install
* Getting and compiling libabigail from released tarballs
=========================================================
First, get a tarball from ftp://sourceware.org/pub/libabigail.
Then untar it and go to the resulting source directory.
Then create a build directory that is to receive the result of the
compilation and cd into it:
mkdir build
cd build
Then configure the package:
../configure --prefix=<absolute-path-of-where-you-want-the-binaries-to-be-installed>
Then compile it:
make
Then install the resulting binaries
make install
* Building the documentation of libabigail
==========================================
To build the documentation of libabigail, you need to install the
python-sphinx package prior to running configure.
Once you've done that, type:
make doc
This will generate the documentation in html, info and man format, in
the doc/ subdirectory of your build directory.
If you only want the html documentation (mainly the web site, apidoc and manuals) then just type:
make html-doc
If you only want to generate the man documentation, just type:
make man
If you only want to generate the info documentation, just type:
make info