diff options
Diffstat (limited to 'makefile')
| -rw-r--r-- | makefile | 88 |
1 files changed, 33 insertions, 55 deletions
@@ -1,6 +1,6 @@ ############################################################################### # # -# Make file for installing Basser Lout Version 3.29 # +# Make file for installing Basser Lout Version 3.30 # # # # Jeffrey H. Kingston # # undated # @@ -47,35 +47,13 @@ # # # These should appear like this below. # # # -# (3) This step is about to become obsolete. This version of Lout is not # -# affected by the value of DBFIX, and if beta testing shows that the # -# changes that have made DBFIX unnecessary actually work, then this step # -# will be deleted in subsequent releases. # -# # -# This may be the trickiest step of all. On some systems, for example # -# NT under Visual C++, Lout's use of the system ftell() call causes # -# a problem. This problem typically manifests itself on the *second* # -# pass over a large document such as the Lout User's Guide: a message # -# such as "error in database file" is printed and Lout aborts. The # -# precise error may vary but should say something about a problem with # -# a database file. # -# # -# If this problem occurs you can probably fix it by changing the value # -# of DBFIX below to 1. Many thanks to Valeriy E. Ushakov for this fix. # -# # -# Systems requiring DBFIX = 0 Systems requiring DBFIX = 1 # -# ------------------------------------------------------------- # -# Unix NT/Visual C++ # -# Cygnus gnuwin32 gcc djgpp # -# Mingw32 # -# # -# (4) Set the USESTAT macro defined below to 1 if the system you are # +# (3) Set the USESTAT macro defined below to 1 if the system you are # # compiling onto has the stat() file status system call. If you are # # unsure, or know it doesn't, set USESTAT to 0. The stat() call, # # if used, will allow Lout to determine the time of last change # # of database index files and rebuild them automatically if required. # # # -# (5) Set the SAFEDFT macro defined below to 1 if you want safe execution # +# (4) Set the SAFEDFT macro defined below to 1 if you want safe execution # # (i.e. disabling calls to system()) to be the default behaviour. You # # can always specify safe or unsafe execution by means of the -S and # # -U options to lout when processing a document; SAFEDFT means that # @@ -83,7 +61,7 @@ # required when formatting computer programs, so if in doubt, do not # # change the value of SAFEDFT. # # # -# (6) Set the following four macros defined below to appropriate values: # +# (5) Set the following four macros defined below to appropriate values: # # # # BINDIR Directory where Lout's binary goes. This directory is # # assumed to exist. # @@ -98,7 +76,7 @@ # MANDIR Directory where the lout and prg2lout online manual entries # # (in nroff -man) go. This directory is assumed to exist. # # # -# (7) Set the following two macros defined below to appropriate values. # +# (6) Set the following two macros defined below to appropriate values. # # I strongly recommend CHARIN=1 and CHAROUT=0 for all sites (English # # and non-English language). This way we get a truly international # # standard in which everyone has access to accented characters, yet # @@ -133,7 +111,7 @@ # as \ddd escape sequences and which are printed as one-byte # # literal characters. # # # -# (8) Set macro USELOC to one of the following values, NOT TO A LOCALE. # +# (7) Set macro USELOC to one of the following values, NOT TO A LOCALE. # # # # 0 Lout's error messages will always appear in English, and no # # source code related to locales will be executed (although # @@ -159,16 +137,16 @@ # # # For error messages in other languages, consult ./locale/README. # # # -# (9) Set macro COLLATE to either 0 or 1. If you set it to 1, Lout will # +# (8) Set macro COLLATE to either 0 or 1. If you set it to 1, Lout will # # use the strcoll() routine by default when sorting alphabetically # # (e.g. when sorting indexes), otherwise Lout will sort by default # # based on the ISO codes of the characters. This default setting may # # be changed during individual runs of Lout by the -l and -L flags. # # # -# (10) Execute "make prg2lout". This will compile the prg2lout program, # +# (9) Execute "make prg2lout". This will compile the prg2lout program, # # leaving its binary in this directory. Other directories unchanged. # # # -# (11) If you want to be able to produce compressed PDF files, as opposed to # +# (10) If you want to be able to produce compressed PDF files, as opposed to # # uncompressed ones, you need to: # # # # (a) obtain the zlib compression library from # @@ -192,16 +170,16 @@ # If you don't want zlib support or cannot obtain it or cannot use it, # # leave the PDF_COMPRESSION, ZLIB, and ZLIBPATH variables as they are. # # # -# (12) Execute "make lout". This will compile the Lout source, leaving the # +# (11) Execute "make lout". This will compile the Lout source, leaving the # # binary in this directory. No changes are made in other directories. # # # -# (13) This makefile assumes that Lout is not installed on your system # +# (12) This makefile assumes that Lout is not installed on your system # # already. If you do have an earlier version of Lout installed, # # the simplest way to get rid of it is to type "make uninstall" now. # # Of course, this is assuming that the old version was installed in the # # same directories as where you are about to install the new version. # # # -# (14) Execute "make install". This will do the following things: # +# (13) Execute "make install". This will do the following things: # # # # (a) It will copy the lout and prg2lout binaries into $(BINDIR); # # # @@ -224,24 +202,34 @@ # It is good to build the various files during installation because # # later runs will not have write permission in the library directories. # # # -# (15) Execute "make installman". This installs the manual entries for lout # +# (14) Execute "make installman". This installs the manual entries for lout # # and prg2lout into directory $(MANDIR), which is assumed to exist. # # These entries are troff files; plain text versions are also available # # in directory ./man if you need them (install them yourself). # # # -# (16) Execute "make installdoc". This creates directory $(DOCDIR) and # +# (15) Execute "make installdoc". This creates directory $(DOCDIR) and # # copies the Lout documentation into it. # # # -# (17) If you want French error messages, execute "make installfr" now. # +# (16) If you want French error messages, execute "make installfr" now. # # If you want German error messages, execute "make installde" now. # # These commands compile the error messages files into packed forms # # using the gencat command, and store them in $(LIBDIR)/locale. # # # -# (18) Execute "make clean". This cleans up this directory. # +# (17) Execute "make clean". This cleans up this directory. # +# # +# (18) If the usual language at your site is not English, you might like to # +# now change the default value of the @InitialLanguage option on line # +# 252 of file $(LIBDIR)/include/bsf. This will mean that by default # +# the date and words like Chapter and July will appear in a different # +# language, and hyphenation will be carried out according to patterns # +# designed for that language. You can find the list of known languages # +# in the User's Guide, or in file $(LIBDIR)/include/langdefs; if yours # +# is not on the list, let me know and we can work together to add it. # +# This has nothing to do with locales and USELOC. # # # # (19) If the usual size of a piece of paper at your site is not A4, you # # might like to now change the default value of the @PageType option # -# on line 59 of file $(LIBDIR)/include/dsf: # +# on line 64 of file $(LIBDIR)/include/dsf: # # # # named @PageType { A4 @OrIfPlain Other } # # # @@ -250,19 +238,9 @@ # type is Other, which means that the page dimensions come from the # # @PageWidth and @PageHeight options. Just change the A4, not the # # rest. You can find the list of known page types, alternative to A4, # -# in the User's Guide, and also at line 640 in $(LIBDIR)/include/dsf. # -# # -# (20) If the usual language at your site is not English, you might like to # -# now change the default value of the @InitialLanguage option on line # -# 255 of file $(LIBDIR)/include/bsf. This will mean that by default # -# the date and words like Chapter and July will appear in a different # -# language, and hyphenation will be carried out according to patterns # -# designed for that language. You can find the list of known languages # -# in the User's Guide, or in file $(LIBDIR)/include/langdefs; if yours # -# is not on the list, let me know and we can work together to add it. # -# This has nothing to do with locales and USELOC. # +# in the User's Guide, and also at line 721 in $(LIBDIR)/include/dsf. # # # -# Mail jeff@cs.usyd.edu.au if you have any problems. # +# Mail jeff@it.usyd.edu.au if you have any problems. # # # ############################################################################### @@ -275,11 +253,11 @@ DBFIX = 0 USESTAT = 1 SAFEDFT = 0 -DEBUGGING = 0 -TRACING = +# DEBUGGING = 0 +# TRACING = -# DEBUGGING = 1 -# TRACING = -g +DEBUGGING = 1 +TRACING = -g BINDIR = /home/jeff/bin LIBDIR = /home/jeff/lout.lib |