Installation

These installation instructions are valid for bibtex2bibtex version 1.3 and after.

How to Get bibtex2bibtex

Get bibtex2bibtex from sourceforge.net, project LitTool:

http://sourceforge.net/projects/littool

as a gzipped tar archive. The filename is bibtex2bibtex-version.tar.gz, where version is the version number.

Basic Installation

Copy or move the archive to a directory of your choice.

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 .

Installation for Developers

Developers may download the cvs version of bibtex2bibtex from http://littool.cvs.sourceforge.net or through the project page.

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.


Generated on Tue Mar 24 21:01:34 2009 for bibtex2bibtex by  doxygen 1.5.3