git ssb

1
FreeCheck v0.30 October 17,2002
2
Eric Sandeen, <sandeen-freecheck@sandeen.net>
3
James Klicman, <james@klicman.org>
4
5
-----------------------------------------------
6
| READ THE "WARNING" FILE BEFORE YOU PROCEED! |
7
-----------------------------------------------
8
9
WHY DID YOU WRITE THIS?
10
-----------------------
11
I wanted a free alternative to MIPS/VersaCheck.  'nuff said.
12
13
REQUIREMENTS
14
------------
15
The first thing that you MUST have to be able to use FreeCheck is a
16
good Type 1 MICR font.  I have created one, called "GnuMICR" that I think
17
is pretty excellent - but it has not been well tested.  :)  There are also
18
commercial fonts you can buy, if that floats your boat.  See
19
www.bizfonts.com, for example.
20
21
You must also have either a PostScript printer, or a recent version
22
of GhostScript.  FreeCheck generates the check as a PostScript file.
23
24
Technically, you must also use MICR toner.  At a minimum, use a real
25
laser printer.
26
27
Also, you should use security blank check stock, not just plain
28
paper.
29
30
CONFIGURATION
31
-------------
32
Edit the file freecheck.cfg to add your account information, and define
33
any new check blanks or styles you want.   Take a look at the [Global]
34
section, too, to set things up for your system.  Pay close attention
35
to the MICR line specification instructions.  Most configuration instructions
36
can be found in this file.  If something's too confusing, let me know.
37
38
USAGE
39
-----
40
FreeCheck just prints a PostScript file to STDOUT.  That means that you
41
must either redirect it to a file, a printer, or a viewer (ggv accepts
42
a file on STDIN - I don't think gv does).
43
44
So, to print (assuming a PostScript printer, or GhostView filter):
45
freecheck.pl <options> | lpr
46
47
To view:
48
freecheck.pl <options> | ggv
49
50
To save a file:
51
freecheck.pl <options> > mycheckfile.ps
52
53
OPTIONS
54
-------
55
freecheck doesn't require any options, unless you want it to do something
56
useful.  By itself, it will print a couple sheets of standard checks
57
with a dummy account.
58
59
Type "freecheck --help" to see what options are available
60
61
For now, if you get tired of typing all those command line options, just
62
edit the defaults at the top of the main script.
63
64
HOW DOES IT WORK?
65
-----------------
66
FreeCheck is a Frankenstein-like combination of PostScript and Perl,
67
at this point.  The guts of the check layout are in PostScript, which
68
is embedded at the end of the Perl script.  This PostScript depends on
69
lots of variable definitions to decide what it should actually print.
70
That's where the Perl comes in - reading a config file, and generating
71
lots of lines of the type
72
	/foo {bar} def
73
which define what's shown on the page.
74
75