Generic Installation Procedure

Generic Installation Procedure

See if there is a special section for your computer/C compiler and follow the instructions given there. Most probably you will be directed back into this section after some initial actions.

See Section Using the kpathsea library and see if it applies to your setting.

To install BibTool you can try to apply the following instructions:

Copy one of the prepared makefiles to makefile and adjust it according to your C compiler. At least the following makefiles should be present in the distribution:

makefile.unx: This is the generic makefile. Especially it is for all UN*X systems and may provide a basis for compilation on systems not explicitly mentioned here.
makefile.dos: This is the makefile for MSDOS based machines.
makefile.ata: This is the makefile for Atari ST/TT computers.
makefile.ami: This is the makefile for Amiga computers (with SAS/C).

Edit the makefile and adjust the settings in the configuration section according to your needs.

Maybe you have to adapt the name and options for your C compiler. (Most of the time I prefer the GNU C compiler)

Maybe you want to change the location for the installation target, even though reasonable defaults are provided.

Look into the file include/bibtool/config.h to see if it fits your operating system and C compiler. Adjust things as required. Most probably you do not have to change anything in this file. This file is mainly for those with an old C compiler (non-ANSI).

If you want to configure some of the internals of BibTool you can have a look into config.h. It contains the internal configuration options. Most probably there is no need to change the defaults given there. One exception is the support for another language by specifying additional words to be ignored. (Maybe I could include them into the distribution; thus drop me a mail if you do so)

If you have a working makedepend command run

	make depend

Otherwise just skip this step. It is only helpful if you compile BibTool more than once.

This might cause problems if the makedepend command does not fit the C compiler used (e.g. proprietary makedepend together with gcc). This results in unknown files to show up. In this case also skip this step and revert to the original makefile.

Afterwards run

	make

Most probably this should produce the executable bibtool (or bibtool.exe, or bibtool.ttp, or ...) in the current directory.

If you have tried the command bibtool in the current directory you can install it with

	make install

to install the executable and the libraries and

	make install.man

to install the UN*X man pages. This is only useful if you can make use of them, i.e. on a UN*X-like system.

To get rid of all intermediate files run

	make clean

To prepare the documentation contained in the subdirectory Doc go into the Doc subdirectory and run

	latex   bibtool
	latex   bibtool
	bibtex  bibtool
	makeidx bibtool
	latex   bibtool
	latex   bibtool

The makeidx program may be named differently on your system or missing at all. In this case you can omit this step and do without the index.

On UN*X you can try

	make doc

which tries to perform the steps given above.

Getting Started with BibTool

Generic Installation Procedure