MANIPULL(1L)

NAME
manipull - extract entries out of an existing manifest

SYNOPSIS
    manipull [ -f# ] [ -h# ] [ -iname ] [ -m ] [ -oname ] [ -s ] [ -v ] file...

DESCRIPTION
Manipull reads an existing ``manifest'' (usually created and maintained by makekit(1L)) and pulls the indicated entries out of it, making a new manifest.

A manifest consist of some header lines, followed by a series of lines that describe the files contained in the shell archives. Each line looks like this;
    filename spaces optional-digits spaces text
For more information on the interpretation of the file, see the makekit documentation.

The original manifest is read from the standard input. An alternate input file may be given by using the ``-i'' option. The generated manifest will be sent to the standard output. An alternate output file may be given by using the ``-o'' option. The ``-m'' option is the same as giving the options ``-iMANIFEST -oMANIFEST.NEW -h2'' and is commonly used when reading existing manifests.

The ``-f'' option may be necessary if the original manifest has more than a couple of hundred lines. The existance of this option can be taken as evidence that the program's author is lazy. The ``-h'' option may be given to have the program skip the indicated number of lines in the input before beginning parsing.

After all the options have been read, any remaining arguments are taken to be a list of files to extract from the manifest. If a file named on the command line does not appear in the existing manifest, it is added to the new one, with a placeholder for both the archive number and the description.

As it is processing, manipull normally prints a message to standard error when it adds a file that isn't in the initial manifest, or when a file in that manifest is omitted. These messages may be suppressed by using the ``-s'' option.

The ``-v'' option prints out the current version and exits.

SEE ALSO
makekit(1L).