diff options
author | Christian Grothoff <christian@grothoff.org> | 2010-01-13 16:17:44 +0000 |
---|---|---|
committer | Christian Grothoff <christian@grothoff.org> | 2010-01-13 16:17:44 +0000 |
commit | 01e7d62c0740b69488164835360291c30df5d1c4 (patch) | |
tree | 0fa8ce7ea27f1312556cd08bc80e4db1722df163 | |
parent | 226573cd4846558620e4401f988e30765ccdfc86 (diff) | |
download | libextractor-01e7d62c0740b69488164835360291c30df5d1c4.tar.gz libextractor-01e7d62c0740b69488164835360291c30df5d1c4.zip |
release tag
-rw-r--r-- | ChangeLog | 3 | ||||
-rw-r--r-- | INSTALL | 97 | ||||
-rw-r--r-- | doc/texinfo.tex | 26 |
3 files changed, 96 insertions, 30 deletions
@@ -1,3 +1,6 @@ | |||
1 | Wed Jan 13 17:11:07 CET 2010 | ||
2 | Releasing libextractor 0.6.0. | ||
3 | |||
1 | Wed Jan 13 14:36:24 CET 2010 | 4 | Wed Jan 13 14:36:24 CET 2010 |
2 | Adding support for extracting data from the end of files. -CG | 5 | Adding support for extracting data from the end of files. -CG |
3 | 6 | ||
@@ -4,8 +4,10 @@ Installation Instructions | |||
4 | Copyright (C) 1994, 1995, 1996, 1999, 2000, 2001, 2002, 2004, 2005, | 4 | Copyright (C) 1994, 1995, 1996, 1999, 2000, 2001, 2002, 2004, 2005, |
5 | 2006, 2007, 2008, 2009 Free Software Foundation, Inc. | 5 | 2006, 2007, 2008, 2009 Free Software Foundation, Inc. |
6 | 6 | ||
7 | This file is free documentation; the Free Software Foundation gives | 7 | Copying and distribution of this file, with or without modification, |
8 | unlimited permission to copy, distribute and modify it. | 8 | are permitted in any medium without royalty provided the copyright |
9 | notice and this notice are preserved. This file is offered as-is, | ||
10 | without warranty of any kind. | ||
9 | 11 | ||
10 | Basic Installation | 12 | Basic Installation |
11 | ================== | 13 | ================== |
@@ -13,7 +15,11 @@ Basic Installation | |||
13 | Briefly, the shell commands `./configure; make; make install' should | 15 | Briefly, the shell commands `./configure; make; make install' should |
14 | configure, build, and install this package. The following | 16 | configure, build, and install this package. The following |
15 | more-detailed instructions are generic; see the `README' file for | 17 | more-detailed instructions are generic; see the `README' file for |
16 | instructions specific to this package. | 18 | instructions specific to this package. Some packages provide this |
19 | `INSTALL' file but do not implement all of the features documented | ||
20 | below. The lack of an optional feature in a given package is not | ||
21 | necessarily a bug. More recommendations for GNU packages can be found | ||
22 | in *note Makefile Conventions: (standards)Makefile Conventions. | ||
17 | 23 | ||
18 | The `configure' shell script attempts to guess correct values for | 24 | The `configure' shell script attempts to guess correct values for |
19 | various system-dependent variables used during compilation. It uses | 25 | various system-dependent variables used during compilation. It uses |
@@ -42,7 +48,7 @@ may remove or edit it. | |||
42 | you want to change it or regenerate `configure' using a newer version | 48 | you want to change it or regenerate `configure' using a newer version |
43 | of `autoconf'. | 49 | of `autoconf'. |
44 | 50 | ||
45 | The simplest way to compile this package is: | 51 | The simplest way to compile this package is: |
46 | 52 | ||
47 | 1. `cd' to the directory containing the package's source code and type | 53 | 1. `cd' to the directory containing the package's source code and type |
48 | `./configure' to configure the package for your system. | 54 | `./configure' to configure the package for your system. |
@@ -53,12 +59,22 @@ The simplest way to compile this package is: | |||
53 | 2. Type `make' to compile the package. | 59 | 2. Type `make' to compile the package. |
54 | 60 | ||
55 | 3. Optionally, type `make check' to run any self-tests that come with | 61 | 3. Optionally, type `make check' to run any self-tests that come with |
56 | the package. | 62 | the package, generally using the just-built uninstalled binaries. |
57 | 63 | ||
58 | 4. Type `make install' to install the programs and any data files and | 64 | 4. Type `make install' to install the programs and any data files and |
59 | documentation. | 65 | documentation. When installing into a prefix owned by root, it is |
60 | 66 | recommended that the package be configured and built as a regular | |
61 | 5. You can remove the program binaries and object files from the | 67 | user, and only the `make install' phase executed with root |
68 | privileges. | ||
69 | |||
70 | 5. Optionally, type `make installcheck' to repeat any self-tests, but | ||
71 | this time using the binaries in their final installed location. | ||
72 | This target does not install anything. Running this target as a | ||
73 | regular user, particularly if the prior `make install' required | ||
74 | root privileges, verifies that the installation completed | ||
75 | correctly. | ||
76 | |||
77 | 6. You can remove the program binaries and object files from the | ||
62 | source code directory by typing `make clean'. To also remove the | 78 | source code directory by typing `make clean'. To also remove the |
63 | files that `configure' created (so you can compile the package for | 79 | files that `configure' created (so you can compile the package for |
64 | a different kind of computer), type `make distclean'. There is | 80 | a different kind of computer), type `make distclean'. There is |
@@ -67,8 +83,15 @@ The simplest way to compile this package is: | |||
67 | all sorts of other programs in order to regenerate files that came | 83 | all sorts of other programs in order to regenerate files that came |
68 | with the distribution. | 84 | with the distribution. |
69 | 85 | ||
70 | 6. Often, you can also type `make uninstall' to remove the installed | 86 | 7. Often, you can also type `make uninstall' to remove the installed |
71 | files again. | 87 | files again. In practice, not all packages have tested that |
88 | uninstallation works correctly, even though it is required by the | ||
89 | GNU Coding Standards. | ||
90 | |||
91 | 8. Some packages, particularly those that use Automake, provide `make | ||
92 | distcheck', which can by used by developers to test that all other | ||
93 | targets like `make install' and `make uninstall' work correctly. | ||
94 | This target is generally not run by end users. | ||
72 | 95 | ||
73 | Compilers and Options | 96 | Compilers and Options |
74 | ===================== | 97 | ===================== |
@@ -93,7 +116,8 @@ same time, by placing the object files for each architecture in their | |||
93 | own directory. To do this, you can use GNU `make'. `cd' to the | 116 | own directory. To do this, you can use GNU `make'. `cd' to the |
94 | directory where you want the object files and executables to go and run | 117 | directory where you want the object files and executables to go and run |
95 | the `configure' script. `configure' automatically checks for the | 118 | the `configure' script. `configure' automatically checks for the |
96 | source code in the directory that `configure' is in and in `..'. | 119 | source code in the directory that `configure' is in and in `..'. This |
120 | is known as a "VPATH" build. | ||
97 | 121 | ||
98 | With a non-GNU `make', it is safer to compile the package for one | 122 | With a non-GNU `make', it is safer to compile the package for one |
99 | architecture at a time in the source code directory. After you have | 123 | architecture at a time in the source code directory. After you have |
@@ -120,7 +144,8 @@ Installation Names | |||
120 | By default, `make install' installs the package's commands under | 144 | By default, `make install' installs the package's commands under |
121 | `/usr/local/bin', include files under `/usr/local/include', etc. You | 145 | `/usr/local/bin', include files under `/usr/local/include', etc. You |
122 | can specify an installation prefix other than `/usr/local' by giving | 146 | can specify an installation prefix other than `/usr/local' by giving |
123 | `configure' the option `--prefix=PREFIX'. | 147 | `configure' the option `--prefix=PREFIX', where PREFIX must be an |
148 | absolute file name. | ||
124 | 149 | ||
125 | You can specify separate installation prefixes for | 150 | You can specify separate installation prefixes for |
126 | architecture-specific files and architecture-independent files. If you | 151 | architecture-specific files and architecture-independent files. If you |
@@ -131,15 +156,46 @@ Documentation and other data files still use the regular prefix. | |||
131 | In addition, if you use an unusual directory layout you can give | 156 | In addition, if you use an unusual directory layout you can give |
132 | options like `--bindir=DIR' to specify different values for particular | 157 | options like `--bindir=DIR' to specify different values for particular |
133 | kinds of files. Run `configure --help' for a list of the directories | 158 | kinds of files. Run `configure --help' for a list of the directories |
134 | you can set and what kinds of files go in them. | 159 | you can set and what kinds of files go in them. In general, the |
160 | default for these options is expressed in terms of `${prefix}', so that | ||
161 | specifying just `--prefix' will affect all of the other directory | ||
162 | specifications that were not explicitly provided. | ||
163 | |||
164 | The most portable way to affect installation locations is to pass the | ||
165 | correct locations to `configure'; however, many packages provide one or | ||
166 | both of the following shortcuts of passing variable assignments to the | ||
167 | `make install' command line to change installation locations without | ||
168 | having to reconfigure or recompile. | ||
169 | |||
170 | The first method involves providing an override variable for each | ||
171 | affected directory. For example, `make install | ||
172 | prefix=/alternate/directory' will choose an alternate location for all | ||
173 | directory configuration variables that were expressed in terms of | ||
174 | `${prefix}'. Any directories that were specified during `configure', | ||
175 | but not in terms of `${prefix}', must each be overridden at install | ||
176 | time for the entire installation to be relocated. The approach of | ||
177 | makefile variable overrides for each directory variable is required by | ||
178 | the GNU Coding Standards, and ideally causes no recompilation. | ||
179 | However, some platforms have known limitations with the semantics of | ||
180 | shared libraries that end up requiring recompilation when using this | ||
181 | method, particularly noticeable in packages that use GNU Libtool. | ||
182 | |||
183 | The second method involves providing the `DESTDIR' variable. For | ||
184 | example, `make install DESTDIR=/alternate/directory' will prepend | ||
185 | `/alternate/directory' before all installation names. The approach of | ||
186 | `DESTDIR' overrides is not required by the GNU Coding Standards, and | ||
187 | does not work on platforms that have drive letters. On the other hand, | ||
188 | it does better at avoiding recompilation issues, and works well even | ||
189 | when some directory options were not specified in terms of `${prefix}' | ||
190 | at `configure' time. | ||
191 | |||
192 | Optional Features | ||
193 | ================= | ||
135 | 194 | ||
136 | If the package supports it, you can cause programs to be installed | 195 | If the package supports it, you can cause programs to be installed |
137 | with an extra prefix or suffix on their names by giving `configure' the | 196 | with an extra prefix or suffix on their names by giving `configure' the |
138 | option `--program-prefix=PREFIX' or `--program-suffix=SUFFIX'. | 197 | option `--program-prefix=PREFIX' or `--program-suffix=SUFFIX'. |
139 | 198 | ||
140 | Optional Features | ||
141 | ================= | ||
142 | |||
143 | Some packages pay attention to `--enable-FEATURE' options to | 199 | Some packages pay attention to `--enable-FEATURE' options to |
144 | `configure', where FEATURE indicates an optional part of the package. | 200 | `configure', where FEATURE indicates an optional part of the package. |
145 | They may also pay attention to `--with-PACKAGE' options, where PACKAGE | 201 | They may also pay attention to `--with-PACKAGE' options, where PACKAGE |
@@ -152,6 +208,13 @@ find the X include and library files automatically, but if it doesn't, | |||
152 | you can use the `configure' options `--x-includes=DIR' and | 208 | you can use the `configure' options `--x-includes=DIR' and |
153 | `--x-libraries=DIR' to specify their locations. | 209 | `--x-libraries=DIR' to specify their locations. |
154 | 210 | ||
211 | Some packages offer the ability to configure how verbose the | ||
212 | execution of `make' will be. For these packages, running `./configure | ||
213 | --enable-silent-rules' sets the default to minimal output, which can be | ||
214 | overridden with `make V=1'; while running `./configure | ||
215 | --disable-silent-rules' sets the default to verbose, which can be | ||
216 | overridden with `make V=0'. | ||
217 | |||
155 | Particular systems | 218 | Particular systems |
156 | ================== | 219 | ================== |
157 | 220 | ||
@@ -288,7 +351,7 @@ operates. | |||
288 | `configure' can determine that directory automatically. | 351 | `configure' can determine that directory automatically. |
289 | 352 | ||
290 | `--prefix=DIR' | 353 | `--prefix=DIR' |
291 | Use DIR as the installation prefix. *Note Installation Names:: | 354 | Use DIR as the installation prefix. *note Installation Names:: |
292 | for more details, including other options available for fine-tuning | 355 | for more details, including other options available for fine-tuning |
293 | the installation locations. | 356 | the installation locations. |
294 | 357 | ||
diff --git a/doc/texinfo.tex b/doc/texinfo.tex index 0d3ba16..9140826 100644 --- a/doc/texinfo.tex +++ b/doc/texinfo.tex | |||
@@ -1,9 +1,9 @@ | |||
1 | % texinfo.tex -- TeX macros to handle Texinfo files. | 1 | % texinfo.tex -- TeX macros to handle Texinfo files. |
2 | % | 2 | % |
3 | % Load plain if necessary, i.e., if running under initex. | 3 | % Load plain if necessary, i.e., if running under initex. |
4 | \expandafter\ifx\csname fmtname\endcsname\relax\input plain\fi | 4 | \expandafter\ifx\csname fmtname\endcsname\relax\input plain\fi |
5 | % | 5 | % |
6 | \def\texinfoversion{2009-05-16.16} | 6 | \def\texinfoversion{2009-08-14.15} |
7 | % | 7 | % |
8 | % Copyright 1985, 1986, 1988, 1990, 1991, 1992, 1993, 1994, 1995, | 8 | % Copyright 1985, 1986, 1988, 1990, 1991, 1992, 1993, 1994, 1995, |
9 | % 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006, | 9 | % 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006, |
@@ -1332,13 +1332,16 @@ output) for that.)} | |||
1332 | 1332 | ||
1333 | \ifpdf | 1333 | \ifpdf |
1334 | % | 1334 | % |
1335 | % Color manipulation macros based on pdfcolor.tex. | 1335 | % Color manipulation macros based on pdfcolor.tex, |
1336 | \def\cmykDarkRed{0.28 1 1 0.35} | 1336 | % except using rgb instead of cmyk; the latter is said to render as a |
1337 | \def\cmykBlack{0 0 0 1} | 1337 | % very dark gray on-screen and a very dark halftone in print, instead |
1338 | % of actual black. | ||
1339 | \def\rgbDarkRed{0.50 0.09 0.12} | ||
1340 | \def\rgbBlack{0 0 0} | ||
1338 | % | 1341 | % |
1339 | % k sets the color for filling (usual text, etc.); | 1342 | % k sets the color for filling (usual text, etc.); |
1340 | % K sets the color for stroking (thin rules, e.g., normal _'s). | 1343 | % K sets the color for stroking (thin rules, e.g., normal _'s). |
1341 | \def\pdfsetcolor#1{\pdfliteral{#1 k #1 K}} | 1344 | \def\pdfsetcolor#1{\pdfliteral{#1 rg #1 RG}} |
1342 | % | 1345 | % |
1343 | % Set color, and create a mark which defines \thiscolor accordingly, | 1346 | % Set color, and create a mark which defines \thiscolor accordingly, |
1344 | % so that \makeheadline knows which color to restore. | 1347 | % so that \makeheadline knows which color to restore. |
@@ -1348,7 +1351,7 @@ output) for that.)} | |||
1348 | \pdfsetcolor{#1}% | 1351 | \pdfsetcolor{#1}% |
1349 | } | 1352 | } |
1350 | % | 1353 | % |
1351 | \def\maincolor{\cmykBlack} | 1354 | \def\maincolor{\rgbBlack} |
1352 | \pdfsetcolor{\maincolor} | 1355 | \pdfsetcolor{\maincolor} |
1353 | \edef\thiscolor{\maincolor} | 1356 | \edef\thiscolor{\maincolor} |
1354 | \def\lastcolordefs{} | 1357 | \def\lastcolordefs{} |
@@ -1443,8 +1446,8 @@ output) for that.)} | |||
1443 | % | 1446 | % |
1444 | % by default, use a color that is dark enough to print on paper as | 1447 | % by default, use a color that is dark enough to print on paper as |
1445 | % nearly black, but still distinguishable for online viewing. | 1448 | % nearly black, but still distinguishable for online viewing. |
1446 | \def\urlcolor{\cmykDarkRed} | 1449 | \def\urlcolor{\rgbDarkRed} |
1447 | \def\linkcolor{\cmykDarkRed} | 1450 | \def\linkcolor{\rgbDarkRed} |
1448 | \def\endlink{\setcolor{\maincolor}\pdfendlink} | 1451 | \def\endlink{\setcolor{\maincolor}\pdfendlink} |
1449 | % | 1452 | % |
1450 | % Adding outlines to PDF; macros for calculating structure of outlines | 1453 | % Adding outlines to PDF; macros for calculating structure of outlines |
@@ -4322,6 +4325,7 @@ end | |||
4322 | \definedummyword\code | 4325 | \definedummyword\code |
4323 | \definedummyword\command | 4326 | \definedummyword\command |
4324 | \definedummyword\dfn | 4327 | \definedummyword\dfn |
4328 | \definedummyword\email | ||
4325 | \definedummyword\emph | 4329 | \definedummyword\emph |
4326 | \definedummyword\env | 4330 | \definedummyword\env |
4327 | \definedummyword\file | 4331 | \definedummyword\file |
@@ -9272,12 +9276,8 @@ directory should work if nowhere else does.} | |||
9272 | @markupsetuplqdefault | 9276 | @markupsetuplqdefault |
9273 | @markupsetuprqdefault | 9277 | @markupsetuprqdefault |
9274 | 9278 | ||
9275 | @c Gnulib now utterly and painfully insists on no trailing whitespace. | ||
9276 | @c So we have to nuke it. | ||
9277 | |||
9278 | @c Local variables: | 9279 | @c Local variables: |
9279 | @c eval: (add-hook 'write-file-hooks 'time-stamp) | 9280 | @c eval: (add-hook 'write-file-hooks 'time-stamp) |
9280 | @c eval: (add-hook 'write-file-hooks 'nuke-trailing-whitespace) | ||
9281 | @c page-delimiter: "^\\\\message" | 9281 | @c page-delimiter: "^\\\\message" |
9282 | @c time-stamp-start: "def\\\\texinfoversion{" | 9282 | @c time-stamp-start: "def\\\\texinfoversion{" |
9283 | @c time-stamp-format: "%:y-%02m-%02d.%02H" | 9283 | @c time-stamp-format: "%:y-%02m-%02d.%02H" |