mirror of
https://github.com/david-schmidt/Davex.git
synced 2024-09-27 13:55:09 +00:00
47 lines
2.0 KiB
Plaintext
47 lines
2.0 KiB
Plaintext
|
|
combine -- combine files together (EXTERNAL) [v1.0]
|
|
Written by Jeff Ding
|
|
|
|
syntax: combine <input pathname1> [<input pathname2..5>]
|
|
[-o<output pathname>] [-w<margin>]
|
|
|
|
ex: combine text -m60
|
|
combine game.part1 game.part2 game.3 -o game
|
|
combine =.header =.doc -o documents
|
|
|
|
'Combine' combines files together. The input file is always appended to
|
|
the output file. A total of 5 input files on the same command line is
|
|
supported. Wildcards are supported in the first two input files only.
|
|
When using an output pathname, it is sometimes useful to use a wildcard in
|
|
the input pathname. This allows you to append several files onto one
|
|
output pathname.
|
|
|
|
A special case happens when using two wildcards in the input files. The
|
|
text matching the first wildcard is substituted into the second wildcard.
|
|
This makes it possible to include a special header or footer file for each
|
|
actual input file. The third example above demonstrates the use of a
|
|
header file.
|
|
|
|
Combine will work with any file type, but the files are treated only
|
|
as raw collections of bytes. This means, for example, that if you
|
|
combine two complete AWP files you will get a big mess. However,
|
|
you can always use 'combine' to reconstruct files that have been
|
|
split up using 'split'.
|
|
|
|
Options are as follows:
|
|
|
|
-o <pathname>: Copy of input file gets saved to this file. If
|
|
not specified, output goes to the screen. If the
|
|
file exists, the data will be appended and the type
|
|
not modified. If the output file does not exist,
|
|
it will be created with the same type as the original
|
|
file.
|
|
|
|
-w <margin>: wrap margin. Affects output to the screen only. This
|
|
forces a carriage return when either the margin or
|
|
a space within 9 characters of the margin is reached.
|
|
Allowed values are 0 through 255. A 0 value has the
|
|
same effect as not using the option.
|
|
|
|
(see also: split)
|