autoconf
-package is used to configure and
build the library. imake
is no longer supported. Furthermore, starting
with version 0.8-beta GNU libtool
is used for managing library-specific
stuff.
Here is how to build and install t1lib:
T1
-directory.
./configure
. This will check your system's setup and generate
the Makefile
s. By default, shared and static versions of the
libraries are built.
Specifying --disable-shared
or --disable-static
as a
commandline option to configure
will suppress the generation of the
respective library type. Of course, these rules are superseded by the
capability of the system to manage those library types.
If you know shared libraries are supported on your system but
configure
says that no dll can be built, some compiler option
may be setup incorrect. Please refer to ().
If the X11 window system is installed on the target system t1lib is
automatically build with special X11 support. In cases where this is
explicitly not desired the commandline option
--without-x
may be used to configure a library without extended X11
support. In this case the test program xglyph
is also not build since
it needs X11.
make
. This will build all the stuff including the
documentation. If you do not have LATEX2e run
make without_doc
. This will skip generating the documentation.
make install
to install the package. You'll
probably need to be superuser for installing the package at the standard
locations. However, the files may be
located wherever the user wants, as long as the compiler
finds them at compile time. So, place them where you want.
The following files are installed when doing a make install
:
lib/libt1.a
and/or lib/libt1.so.
v.
r.
p if the system supports shared libraries. In
the latter case, also two symbolic links to the shared library,
libt1.so.
v and libt1.so
, are generated. Here,
v and r mean version and revision of the shared
library. p is the patch level. Library and links are
installed in the directory
specified by the autoconf
-variable libdir
which is by
default /usr/local/lib
.
lib/libt1x.a
or
lib/libt1x.so.
v.
r.
p
respectively, which contain the X11 interface functions. This
library is only installed if X11 support was possible and not
suppressed.
lib/t1lib.h
and optionally lib/t1libx.h
. They are installed
in the directory pointed to by the autoconf
-variable includedir
which is by default
/usr/local/include
.
xglyph/xglyph
. If shared libraries are
supported (and not suppressed by --with-static-lib
) this
executable is dynamically linked to libt1.so
and
libt1x.so
. It is installed in the directory pointed to by
the autoconf
-variable bindir
(by default
/usr/local/bin
).
type1afm
. The same applies as above for
xglyph
.
t1lib-
v.
r is created in
the directory pointed to by the autoconf
-variable datadir
(default
/usr/local/share
) and a default global configuration file
t1lib.config
is installed there. Note that this configuration is
not of any use. It has to be setup by the administrator to specify the
paths to the system's Type 1 fonts and AFM files as well as any
t1lib encoding files. Notice also that the global configuration file
is not installed if it already exists. This is to prevent from deletion of
an existent setup.
doc
is created in the directory where the global
configuration file resides (see above). The LATEX2e-documentation
t1lib_doc.dvi
as well as all needed graphics files is installed
there. The LATEX2e-sources are not installed!
make uninstall
. This reverts all steps
described above. Of course, this works only if t1lib has not been
reconfigured using different parameters since the time of install.
The top level Makefile
further supports the targets clean
and
distclean
. The latter is an extension of clean
which also
removes the makefiles as well as the log and cache files of the configuration
process. It forces thus a new call to configure
.
A make clean
is needed, for example, if someone experiments with static
and shared libraries since the object files for shared libraries require the
additional position independent code options.
The directory T1/parse_afm
is not needed at all, it is included only
for completeness. The parts needed from this have been copied to the
lib/t1lib
-subdirectory.