README
1=======
2flpsed
3=======
4
5
6flpsed is a PostScript annotator. You can't actually
7edit existing PostScript documents, but you can add arbitrary text lines to
8existing documents.
9It is useful for filling in forms etc.
10
11Quick Start:
12- Open an existing PostScript document.
13- Click anywhere on the document and type a text line.
14- The frame around the text shows, which text line has the focus.
15- Click on the lower left corner of a text line to focus it or use the
16 Tab-key to cycle through the text lines on the current page.
17- Remove text, by hitting BackSpace.
18- Move text lines by dragging them with the mouse or using the arrow keys.
19- Navigate within the document with the Page->Next or Page->First menu buttons.
20- Save your document and preview it with ghostview or something similar.
21- If you reopen the document with flpsed, you can edit the added text lines.
22
23Features:
24- Add arbitrary text to existing PostScript documents.
25- Reedit text, that has been added with flpsed.
26- The overall structure of the PostScript document is not
27 modified. flpsed only adds the additional text.
28- Lines can be given names ("tags"). The text of these lines can
29 be replaced in batch mode (no X11 required).
30
31Restrictions:
32- flpsed probably does not work on all existing PostScript documents.
33 You simply have to test it for your documents.
34- Zooming depends on the availability of scalable fonts on your X11 system.
35 Font sizes might be wrong with zoom values other than 100% if these are
36 missing.
37- flpsed is alpha software, so please backup your files, before trying to
38 modify them.
39
40Building:
41- flpsed only works on X11-based systems.
42- You need to have ghostscript installed.
43- You need to have fltk-1.3.x from www.fltk.org installed.
44- Unpack the tarball and type "./configure", "make", and "make install".
45
46
47
48Tags and Batch Mode:
49
50To use batch mode, add text lines to your PostScript document as usual.
51Give all or some of the lines tag names (Tags->Edit Tag).
52Save the document. Now you can replace the text of the tagged line in batch
53mode using the -t flag (see usage).
54Example:
55Lets assume you have added text lines with tags "name", and "street"
56to your document letter.ps with flpsed in interactive mode and saved the
57result in letter-templ.ps.
58You can now call flpsed in batch mode to set the actual values:
59
60flpsed -b -t name="Hans Meier" -t street="Haupstr. 14" letter-templ.ps out.ps
61
62
63==================
64Mac OS X
65==================
66
67To compile flpsed on Mac OS X Panther, first make sure you have Fink
68installed. Make sure Fink is set up to install unstable packages.
69(See the Fink Docs about this at the Fink website.)
70
71Then use Fink to install the following packages.
72
73Apple X11, xfree, or xorg
74 If you choose Apple X11, make sure you install X11-SDK which is
75 found on the Panther install disks.
76
77fltk-x11
78fltk-x11-shlibs
79ghostscript
80
81DO NOT INSTALL the Fink package called fltk, as this appears to be for
82building aqua fltk applications rather than X11 apps.
83
84You must unset the C-preprocessor macro __APPLE__ to get flpsed to compile
85under OS X. This is can be done by calling
86"CPPFLAGS=-U__APPLE__; export CPPFLAGS" before running "./configure".
87
88
89Johannes Hofmann
90(Johannes.Hofmann@gmx.de)
91June 17, 2005
92