============
codeprint.py
============
codeprint is meant primarily for printing out sets of small scripts.
It will try to place the texts so that they only break across pages when
necessary and prefers to move them to the next page when the whole file
can't.
The output file should be suitable for printing with f.eks :hardcopy in vim,
which outputs 73 lines per page on my system (which is the default here).
Runtime examples
----------------
When the program reads a file it will look for runtime examples with the same
filename plus the extension .run. If such a file is found it will be appended
with after the main file, separated by a marker:
*** runtime example ***
Parameters
==========
-o, --out <file> write output to the specified file
the default output is "printfile"
-p, --print print the file immediately (see useful options below)
-e, --reencode use latin-1 for the output file, this might be needed
on utf-8 systems when printing directly
--header text header text for the print when printing directly
This defaults to "codeprint.py: username"
--language lang Specify the language for the syntax highlighting
--lpp int The number of lines per page to use for positioning
The default is 73 lines.
Dependencies
============
The script uses enscript to print directly, but you can still compose files
without having it installed.
Installation
============
Clone this repository or download the tar and unpack, then install with
python3 setup.py install