Annotation of coherent/g/usr/bin/gzip/INSTALL, revision 1.1.1.1

1.1       root        1: This is a generic INSTALL file for utilities distributions.
                      2: Some features specific to gzip have been added.
                      3: 
                      4: To compile this package:
                      5: 
                      6: 1.  Configure the package for your system.  In the directory that this
                      7: file is in, type `./configure'.  If you're using `csh' on an old
                      8: version of System V, you might need to type `sh configure' instead to
                      9: prevent `csh' from trying to execute `configure' itself.
                     10: 
                     11: The `configure' shell script attempts to guess correct values for
                     12: various system-dependent variables used during compilation, and
                     13: creates the Makefile(s) (one in each subdirectory of the source
                     14: directory).  In some packages it creates a C header file containing
                     15: system-dependent definitions.  It also creates a file `config.status'
                     16: that you can run in the future to recreate the current configuration.
                     17: 
                     18: Running `configure' takes a minute or two.  While it is running, it
                     19: prints some messages that tell what it is doing.  If you don't want to
                     20: see the messages, run `configure' with its standard output redirected
                     21: to `/dev/null'; for example, `./configure >/dev/null'.
                     22: 
                     23: To compile the package in a different directory from the one
                     24: containing the source code, you must use a version of make that
                     25: supports the VPATH variable, such as GNU make.  `cd' to the directory
                     26: where you want the object files and executables to go and run
                     27: `configure'.  `configure' automatically checks for the source code in
                     28: the directory that `configure' is in and in `..'.  If for some reason
                     29: `configure' is not in the source code directory that you are
                     30: configuring, then it will report that it can't find the source code.
                     31: In that case, run `configure' with the option `--srcdir=DIR', where
                     32: DIR is the directory that contains the source code.
                     33: 
                     34: By default, `make install' will install the package's files in
                     35: /usr/local/bin, /usr/local/lib, /usr/local/man, etc.  You can specify
                     36: an installation prefix other than /usr/local by giving `configure' the
                     37: option `--prefix=PATH'.  Alternately, you can do so by giving a value
                     38: for the `prefix' variable when you run `make', e.g.,
                     39:        make prefix=/usr/gnu
                     40: 
                     41: You can specify separate installation prefixes for
                     42: architecture-specific files and architecture-independent files.  If
                     43: you give `configure' the option `--exec_prefix=PATH' or set the
                     44: `make' variable `exec_prefix' to PATH, the package will use PATH as
                     45: the prefix for installing programs and libraries.  Data files and
                     46: documentation will still use the regular prefix.  Normally, all files
                     47: are installed using the regular prefix.
                     48: 
                     49: You can tell `configure' to figure out the configuration for your
                     50: system, and record it in `config.status', without actually configuring
                     51: the package (creating `Makefile's and perhaps a configuration header
                     52: file).  To do this, give `configure' the `--no-create' option.  Later,
                     53: you can run `./config.status' to actually configure the package.  This
                     54: option is useful mainly in `Makefile' rules for updating `config.status'
                     55: and `Makefile'.  You can also give `config.status' the `--recheck'
                     56: option, which makes it re-run `configure' with the same arguments you
                     57: used before.  This is useful if you change `configure'.
                     58: 
                     59: `configure' ignores any other arguments that you give it.
                     60: 
                     61: If your system requires unusual options for compilation or linking
                     62: that `configure' doesn't know about, you can give `configure' initial
                     63: values for some variables by setting them in the environment.  In
                     64: Bourne-compatible shells, you can do that on the command line like
                     65: this:
                     66:        CC='gcc -traditional' DEFS=-D_POSIX_SOURCE ./configure
                     67: 
                     68: The `make' variables that you might want to override with environment
                     69: variables when running `configure' are:
                     70: 
                     71: (For these variables, any value given in the environment overrides the
                     72: value that `configure' would choose:)
                     73: CC             C compiler program.
                     74:                Default is `cc', or `gcc' if `gcc' is in your PATH.
                     75: INSTALL                Program to use to install files.
                     76:                Default is `install' if you have it, `cp' otherwise.
                     77: 
                     78: (For these variables, any value given in the environment is added to
                     79: the value that `configure' chooses:)
                     80: DEFS           Configuration options, in the form `-Dfoo -Dbar ...'
                     81: LIBS           Libraries to link with, in the form `-lfoo -lbar ...'
                     82: 
                     83: If you need to do unusual things to compile the package, we encourage
                     84: you to figure out how `configure' could check whether to do them, and
                     85: mail diffs or instructions to the address given in the README so we
                     86: can include them in the next release.
                     87: 
                     88: On Xenix, some preprocessors do not define M_XENIX. You may have to do:
                     89: 
                     90:        DEFS='-DM_XENIX' ./configure
                     91: 
                     92: 2.  Type `make' to compile the package.  If you want, you can override
                     93: the `make' variables CFLAGS and LDFLAGS like this:
                     94: 
                     95:        make CFLAGS=-O2 LDFLAGS=-s
                     96: 
                     97: Try this if you get an error such as "ld: No such file or directory for libg"
                     98: which means that your system is not correctly set up to handle the
                     99: default -g option.
                    100: 
                    101: The man pages are installed by default with an extension `.1' (one).
                    102: If you want the extension `.l' (lower case L) use:
                    103: 
                    104:        make manext=l
                    105: 
                    106: and change the files gunzip.1 and zcat.1 accordingly.
                    107: 
                    108: 3.  The package comes with self-tests. If you want to run them,
                    109: type `make check'.
                    110: 
                    111: 4.  Type `make install' to install programs, data files, and
                    112: documentation. This creates links between gzip, gunzip and zcat.
                    113: You can create additional links uncompress, ungzip and gzcat if
                    114: you prefer these names. You can also create links to unpack and pcat
                    115: if your system uses packed files by default and you want to transform
                    116: them transparently to gzip'ed files.
                    117: 
                    118: 5.  You can remove the program binaries and object files from the
                    119: source directory by typing `make clean'.  To also remove the
                    120: Makefile(s), the header file containing system-dependent definitions
                    121: (if the package uses one), and `config.status' (all the files that
                    122: `configure' created), type `make distclean'.
                    123: 
                    124: The file `configure.in' is used as a template to create `configure' by
                    125: a program called `autoconf'.  You will only need it if you want to
                    126: regenerate `configure' using a newer version of `autoconf'.
                    127: Some bugs in autoconf have been fixed before generating `configure',
                    128: so you may not get exactly the same output.
                    129: 
                    130: 6.  You  can add the following  lines  to your  /etc/magic file so that
                    131: file(1), if  your system supports it,  will recognize files created by
                    132: gzip:
                    133: 
                    134: 0      short           0x1f8b          gzip compressed data
                    135: >2     byte            8               - deflate method
                    136: >3     byte            &0x1            , ascii
                    137: >3     byte            &0x2            , continuation
                    138: >3     byte            &0x4            , extra field
                    139: >3     byte            &0x8            , original file name
                    140: >3     byte            &0x10           , comment
                    141: >3     byte            &0x20           , encrypted
                    142: 
                    143: If your machine is a 386 or a Vax (little-endian machine), replace the
                    144: first line with:
                    145: 
                    146: 0      short           0x8b1f          gzip compressed data
                    147: 
                    148: There is no portable way working on both little-endian and
                    149: big-endian machines, since SVR4 does not like the string \037\213
                    150: as a magic number.

unix.superglobalmegacorp.com

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.