home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
The CDPD Public Domain Collection for CDTV 3
/
CDPDIII.bin
/
bbs
/
ff824.lha
/
FF824
/
Pager
/
Pager.doc
< prev
next >
Wrap
Text File
|
2001-02-25
|
6KB
|
205 lines
Documentation
Pager Version 1.0
® 1992/93 by H.P.G FreeWare
Index:
Overview
System Requirements
Legal Stuff
Cli-Parameters
Examples
Technical
Address
List Of File
Overview:
Pager is a little helpful utility that brings you the ability to add
line numbers and page numbers to texts, documents and any other kind
of files.
Its a cli tool that has a lot of commandline options which enables
you to control the form of the output in a very easy way.
Most formattings can be done with specifying format strings in a
printf style. You may use a format string like "%-3ld" for line
numbering or "%s Page No %3ld" for page numberings.
You are able to specify the number of lines per page.
To use Pager in batch scripts is also usable with the supported Quit
option.
System Requirements:
To run Pager you will need OS 2.04 or higher. Previous versions
doesn`t function.
Legal Stuff:
This program and all files come with it, also the docfiles, are
released as FREEWARE.
this means:
everybody may use Pager,
everybody may copy Pager, if:
1. You copy all included files, see list at the end of the
doc file.
2. No changes are made, this means the program and all
included files must stay in the original form.
Exception: you may archive it; but in this case you
must also archive the whole package.
3. If you decompile it, you have to include a notice to
the original author. If you also want to (re)distribute
in any new form you have to send me a copy.
4. You may not sell Pager.
Execption: you`re allowed to take a small copy fee
which should not extend 5US$.
5. If you want to include Pager or one of the included files
as a part of a commercial package, you must have written
permission from the author (address see below).
I take no warranty or guaranty for the function of this program.
The whole risk of using Pager stays only by the user.
Cli-Parameters
Pager understands the following cli options:
Syntax: Pager <File/M/A><TO/A> [Numbers=N/K][PLen=P/K/N]
[LnForm=L/K][Quiet=Q/S]
with
File = This is the source file you want to process. This argument
have to be given. You may also specify multiples sources,
but in this case you must take care not to forget to specify
a destination file, otherwise the last source file will be
used as destination and will be overwritten !!!
To = This is the output file. Dependent to the other settings
this contains the line and/or page numbers.
The source and destination file cannot be the same.
Numbers = This is the format string which should be used to add the
line numbers to the source(s). This format string must
contain a "%ld" anywhere. But you may also use "%#ld" or
"%-#ld", where # is the number of chars which should be
used and a leading `-` sign represents the filling direction.
Please refer also to the printf, scanf conventions.
PLen = This number represents the number of lines per page. This
option is importent for the page numbering. If this options
is omitted a default number of 65 lines per page will be
used.
LnForm = This is the format string which should be used for the page
numberings. You may include a "%s" with the commandline but
you have to specify a "%ld" anywhere. If you want to use
the "%s", it must be appear in the format string before the
"%ld" string.
Quiet = If this switch is given, no information to output will be
sent.
Examples
Here followes some examples how to change the behaviour of Pager
1. Add line numbers to a text file with the name MyText.asc.
The text contains ca. 500 lines, so we use a 3 digit page
numbering format string.
SHELL 1.> Pager MyText.asc to Ram:MyText.numbers.asc N "%3ld"
2. Add line numbers to a c source file and add also page numbers
after each 55 lines. The line numbers should include leading
0`s and 5 digits length.
SHELL 1.> Pager Source.c To Source.asc N "%05ld : " P 55
L "%s Now at page Number %ld"
3. Add line numbers to three header files and add page numbers.
The output should be Header.sample.list and no messages should
be sent to output.
SHELL 1.> Pager Header1.h Header2.h Header3.h To
Header.sample.list N "%3ld :" P "25"
L "File: %s Page: %3ld" QUIET
After formatting a file with Pager you can easily print it out to
the printer. You may also specify "PRT:" for output, in which case
the formatted output will be immediately sent to the printer.
Technical
Pager is written in C with the Manx Aztec 5.2a Compiler System.
I used the format string directly in those formatting function like
Printf etc.
Address
For all kind of suggestions, gifts, money etc. write to the
following address:
Hans-Peter Günther
Grüner Weg 5
W-3501 Fuldatal 2
GERMANY
List Of File
This package should contain the following files. IF you miss
something please le me know.
Pager : the binary
Pager.info :
Pager.doc : english documentation
Pager.doc.info :
Pager.dok : german documentation
Pager.dok.info :