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


flpsed is a PostScript annotator. 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.
- Click on the lower left corner of a text line to focus it or use the 
  Tab-key to cycle through the text lines on the current page. 
- Remove text, by hitting BackSpace.
- Move text lines by dragging them with the mouse or using the arrow keys.
- 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.
- Zooming depends on the availability of scalable fonts on your X11 system.
  Font sizes might be wrong with zoom values other than 100% if these are 
  missing.
- 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.3.x from www.fltk.org installed.
- Unpack the tarball and type "./configure", "make", and "make install".



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


==================
Mac OS X 
==================

To compile flpsed on Mac OS X Panther, first make sure you have Fink
installed.  Make sure Fink is set up to install unstable packages.
(See the Fink Docs about this at the Fink website.)

Then use Fink to install the following packages.

Apple X11, xfree, or xorg
	If you choose Apple X11, make sure you install X11-SDK which is
	found on the Panther install disks.

fltk-x11
fltk-x11-shlibs
ghostscript

DO NOT INSTALL the Fink package called fltk, as this appears to be for
building aqua fltk applications rather than X11 apps.

You must unset the C-preprocessor macro __APPLE__ to get flpsed to compile
under OS X. This is can be done by calling 
"CPPFLAGS=-U__APPLE__; export CPPFLAGS" before running "./configure".


Johannes Hofmann
(Johannes.Hofmann@gmx.de)
June 17, 2005
