README


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61

=======
flpsed
=======


flpsed is a pseudo PostScript editor. Pseudo, because you can't actually 
edit existing PostScript documents, but you can add arbitrary text lines to
existing documents.
It is useful for filling in forms etc. 

Quick Start:
- open an existing PostScript document.
- click anywhere on the document and type a text line.
- the frame around the text shows, which text line has the focus.
- remove text, by hitting BackSpace.
- click on the lower left corner of a text line, to focus it.
- navigate within the document with the Page->Next or Page->First menu buttons.
- save your document and preview it with ghostview or something similar.
- if you reopen the document with flpsed, you can edit the added text lines.

Features:
- add arbitrary text to existing PostScript documents.
- reedit text, that has been added with flpsed.
- the overall structure of the PostScript document is not
  modified. flpsed only adds the additional text.
- lines can be given names ("tags"). The text of these lines can
  be replaced in batch mode (no X11 required).
 
Restrictions:
- flpsed probably does not work on all existing PostScript documents.
  You simply have to test it for your documents.
- flpsed is alpha software, so please backup your files, before trying to 
  modify them.

Building:
- flpsed only works on X11-based systems.
- you need to have ghostscript installed.
- you need to have fltk-1.1.x from www.fltk.org installed.
- unpack the tarball and type "make".


Tags and Batch Mode:

to use batch mode, add text lines to your PostScript document as usual. 
Give all or some of the lines tag names (Tags->Edit Tag). 
Save the document. Now you can replace the text of the tagged line in batch
mode using the -t flag (see usage).
Example:
Lets assume you have added text lines with tags "name", and "street"
to your document letter.ps with flpsed in interactive mode and saved the
result in letter-templ.ps.
You can now call flpsed in batch mode to set the actual values:

flpsed -b -t name="Hans Meier" -t street="Haupstr. 14" letter-templ.ps out.ps


Johannes Hofmann
(Johannes.Hofmann@gmx.de)
October 26, 2004