X-Git-Url: http://git.savannah.gnu.org/gitweb/?p=enscript.git;a=blobdiff_plain;f=README;h=12deb631d96432a980d1c419ec16c2e838aa8c7f;hp=83c62433436066d8c990d94cedaea2f917a5dba1;hb=refs%2Ftags%2Fv1.7.rc;hpb=c856104cc2a9f8d1ad7d0a1f38c1a492e4c5f483
diff --git a/README b/README
index 83c6243..12deb63 100644
--- a/README
+++ b/README
@@ -10,27 +10,102 @@
$ ./configure --with-media=Letter
- You have been warned.... ;-) // mtr@iki.fi
-GNU enscript is a drop-in replacement for the enscript program.
+GNU Enscript is a drop-in replacement for the enscript program.
Enscript converts ASCII files to PostScript and stores generated
output to a file or sends it directly to the printer.
-Enscript is free software; you can redistribute it and/or modify it
-under the terms of the GNU General Public License as published by the
-Free Software Foundation; either version 2, or (at your option) any
-later version.
-Enscript is distributed in the hope that it will be useful, but
-WITHOUT ANY WARRANTY; without even the implied warranty of
-MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
-General Public License for more details.
+Enscript is free software: you can redistribute it and/or modify
+it under the terms of the GNU General Public License as published by
+the Free Software Foundation, either version 3 of the License, or
+(at your option) any later version.
+
+Enscript is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+GNU General Public License for more details.
You should have received a copy of the GNU General Public License
-along with enscript; see the file COPYING. If not, write to the Free
-Software Foundation, 51 Franklin Street, Fifth Floor, Boston, MA
-02110-1301, USA.
+along with Enscript. If not, see .
+
+
+* Configuring Enscript for your system
+
+There are some options in enscript you might want to modify to meet
+your system's needs. You can change them all after the compilation by
+editing the global configuration file `enscript.cfg' at the directory
+`PREFIX/etc/'. You can also change some of the during the `configure'
+step by giving the configure script appropriate options. Please,
+check the following things before reporting bugs; for the most cases
+these help:
+
+** Paper size
+
+ As a default enscript uses A4 paper. To change default paper to be
+ for example `Letter', edit following line in the config file:
+
+ # Default output media.
+ DefaultMedia: A4
+
+ => DefaultMedia: Letter
+
+ You can also select the default paper size during the configuration
+ by giving the configure script option --with-media=MEDIA, where
+ media is one of the media listed in the `lib/enscript.cfg.in' file:
+ A3, A4, A5, Legal, Letter, A4dj or Letterdj.
+
+** Default output device
+
+ As a default (without any explicit options) enscript spools its
+ output to the printer. If you want to send outputs to stdout, edit
+ following line:
+
+ # Where output goes as a default.
+ DefaultOutputMethod: printer
+
+ => DefaultOutputMethod: stdout
+
+** Printer command
+
+ Enscript's default printer command is `lpr'. To change it to be for
+ example `lp', edit following line:
+
+ # Printer spooler command name.
+ Spooler: lpr
+
+ => Spooler: lp
+
+ You can also set the spooler command during the configuration by
+ giving the configure script option `--with-spooler=SPOOLER'.
+ On SystemV machines, you might also want to change the printer queue
+ name switch from `-P' to `-d':
+
+ # The spooler command switch to select the printer queue.
+ QueueParam: -P
+
+ => QueueParam: -d
+
+** PostScript language level
+
+ The PostScript language level that enscript uses for its output.
+ The default values is 2 (PostScript 2). If your printer supports
+ only level 1 PostScript, you can set it to default by giving the
+ configure script option `--with-ps-level=1'. You can also set the
+ level by editing the enscript.cfg file:
+
+ # The PostScript language level that enscript should use.
+ PostScriptLevel: 2
+
+ => PostScriptLevel: 1
+
+ Or, you can select it at the print time with the `--ps-level=LEVEL'
+ option:
+
+ $ enscript --ps-level=1 ...
+
+
* Supported Character Sets
Enscript supports following character sets:
@@ -41,6 +116,7 @@ Enscript supports following character sets:
- ISO-8859-4 ISO Latin4
- ISO-8859-5 ISO Cyrillic
- ISO-8859-7 ISO Greek
+ - ISO-8859-15 ISO Latin9
- ascii 7 bit ascii
- ascii fi se 7 bit ascii with following encodings:
'{' = รค (adieresis)
@@ -64,7 +140,7 @@ Enscript supports following character sets:
- ps PostScript font's default encoding
- pslatin1 PostScript interpreter's `ISOLatin1Encoding'
-
+
* Special Escapes
Enscript supports special escapes sequences that can be used to add
@@ -72,7 +148,7 @@ simple page formatting commands to ASCII documents. User can inline
EPS files, change font on-the-fly insert comments and shade regions of
text. See file README.ESCAPES for details.
-
+
* Language sensitive highlighting
Enscript supports language sensitive code highlighting. Highlighting
@@ -81,12 +157,12 @@ files and annotates them with enscript's special escapes. The states
definition file `enscript.st' is a machine independent ASCII file and
it can be updated without re-compilation of the enscript program. The
most recent version of this file can be downloaded from the GNU
-enscript WWW home page: .
+enscript WWW home page: .
New highlighting definitions for different languages are welcome,
-please send them directly to me: .
-
+please send them to:
+
* PostScript font support
** AFM files
@@ -155,18 +231,16 @@ option `DownloadFont: name'.
option `-o' lists missing characters. In GNU enscript `-o' is an
alias for `-p' and missing characters are listed with an option `-O'.
+* Example Usage:
-* Misc
-
-I am dedicated to make the GNU enscript the best a2ps converter ever,
-this includes adding all the GNU features and cookies to it ;)
-
-Comments, suggestions, bug fixes, bug reports, etc. are welcome.
+1) Defaults: create document in Helvetica 14 with default headers
+ $ enscript -f Helvetica@14 -o myfile.ps myfile.txt
- Markku Rossi
+2) Create document with a Latin 9 font encoding from example utf-8 with no header
-
+ $ cat myfile.txt | iconv -f utf-8 -t latin9 | enscript -f FreeMono@14 -B -o myfile.ps
- GNU Enscript WWW home page:
-
+ Don't forget to install the latin9 font afm!
+ You can use the tool convertfontto.sh
+