From b65b857f84146f36f44098048261c18126ce6148 Mon Sep 17 00:00:00 2001 From: Johannes Hofmann Date: Wed, 11 Nov 2020 20:19:31 +0100 Subject: README->README.md --- README | 91 --------------------------------------------------------------- README.md | 91 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 91 insertions(+), 91 deletions(-) delete mode 100644 README create mode 100644 README.md diff --git a/README b/README deleted file mode 100644 index 77b9955..0000000 --- a/README +++ /dev/null @@ -1,91 +0,0 @@ -======= -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 diff --git a/README.md b/README.md new file mode 100644 index 0000000..77b9955 --- /dev/null +++ b/README.md @@ -0,0 +1,91 @@ +======= +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 -- cgit v1.2.3