http://sourceforge.net/projects/littool
as a gzipped tar archive. The filename is bibtex2bibtex-version.tar.gz
, where version is the version number.
Unzip and unpack the archive:
gunzip bibtex2bibtex-version.tar.gz ; tar xf bibtex2bibtex-version.tar
This will generate files in directory bibtex2bibtex-version
. Change to this directory, which we will call the distribution root.
Configure the package (see also the generic instructions in file INSTALL in the distribution root; this assumes that you have the autotools
installed on your computer):
./configure
will allow you to install into /usr/local
. You may need root privileges to do that. If you want to install into another directory, which we will call install-directory
, use the --prefix
option:
./configure --prefix=install-directory
Compile the sources:
make
Install the program:
make install
Make, install, and access the documentation (local version):
This is optional and requires the program doxygen to be installed on your computer.
make doc
You can access the documentation with any browser by pointing to file:///distribution_root/documentation/html/index.html (exchange distribution_root
to the respective path on your system) on your local computer. The documentation generated in this way is up-to-date for your distribution/version of bibtex2bibtex. Documentation for other versions may be found here.
The bibtex2bibtex documentation refers to the documentation of WoStransform, which is also part of LibTool. In order to create direct links from the present document, first prepare the WoStransform documentation (see WoStransform README). Then, create a link to file WoStransform.tag
from the distribution root of bibtex2bibtex with an identical name:
ln -s relative_path_to_WoStransform/documentation/WoStransform.tag WoStransform.tag
Finally, edit the line containing TAGFILES in Doxyfile
in the distribution directory and substitute the path to WoStransform's documentation/html directory at the right hand side of the "=" sign. The path must be relative to bibtex2bibtex's documentation/html directory. An absolute path does not seem to work.
Then rerun
make doc
Use the man page (deprecated): Copy the man page bibtex2bibtex.1.gz (in subdirectory documentation
of your distribution root) into a directory in your MANPATH
, e.g. into /usr/share/man/man1
. You may need root privileges to do this. Note, that the man page is no longer maintained (after version 1.2). Please use the html documentation generated above if at all possible or the web documentation .
In the distribution root type
./bootstrap libtoolize ./bootstrap
(ignore the messages) and then continue with the configure
and make
sequence described above. For full instructions, read the file README_FIRST in the distribution root.