Genscript Frequently Asked Questions (FAQ)

Installation
Misc
Character Sets
Printing, Output Media

Installation

Make says "Don't know how to make getopt.o. Stop.", what's the problem?
Up to the version 1.2.20, genscript's makefile depend on the VPATH feature which is used to lookup source files from other directories besides the current working directory. Most modern make utilities like GNU make support the VPATH feature, but your make doesn't.
This problem is easy to solve, just copy all C-files from the compat subdirectory to the main directory and rebuilt:
```
cp compat/*.c .
make
       
```
This VPATH dependency is removed in the (yet unreleased) version 1.3 of Genscript.

Misc

Does genscript read PPD files?
No. PPD file support is on my TODO list, I will implement in the near future.

What is different between genscript and *enscript?

enscript
nenscript
What's missing / what's different in the enscript emulation?
- Currently following enscript options are not supported:
  - `-k' enable page prefeed
  - `-K' disable page prefeed
- Enscript's option `-o' has been changed. In enscript `-o' lists missing characters. In genscript `-o' is an alias for `-p' and missing characters are listed with an option `-O'.

Character Sets

How can I use ibmpc's line drawing characters?
XXX This is a demand documenting FAQ entry. Please, send me a mail and this question will be answered.
I tried the iso8859/2 input encoding but genscript says that 44 characters were missing and I get '?' on paper instead of latin2 characters. Did I missed something? (This answer holds also for other input encodings).
No, everything is ok but the problem is that Adobe's default Courier font does not have characters named: Aogonek, Lcaron, Sacute, Tcaron, Zacute, ... (those 44 missing characters) so genscript can't print them. You can solve this if you have a courier (or whatever) font that has those polish characters. For example, my work machine AIX had a good font named:
```
/usr/lpp/X11/lib/X11/fonts/Type1/cour.{afm,pfa}
       
```
This font contained all those characters so I could print that latin2.txt file without any missing charactes.
To solve this problem, you must:
1. find a nice font to do the job. Maybe you have access to a machine that has a good courier font: AIX, Sun/Solaris?, ... X11/R6 might also have one canditate:
```
/v/src/X6/pl11/xc/fonts/scaled/Type1/cour.afm
	      
```
  and I also found one from the TeX distribution:
```
.../texmf/tex/latex/inputs/latex209/contrib/ascii/cour.pfa
	      
```
2. copy this font and its AFM file to some appropriate directory, let's say `$HOME/fonts/':
```
mtr@ngs mtr % ls fonts/cour*
fonts/cour.afm  fonts/cour.pfa
	      
```
3. create a font map for this new font directory (mkafmmap program is a part of the genscript distribution):
```
mtr@ngs mtr % cd fonts
mtr@ngs fonts % mkafmmap *.afm
file=font.map
BrushScript.afm...
Hobo.afm...
Stencil.afm...
cour.afm...
uaqrrc.afm...
ugqb.afm...
unmr.afm...
unmrs.afm...
	      
```
4. edit genscript's personal (or the global) configuration file to use this new font:
```
mtr@ngs mtr % cat ~/.genscriptrc
#
# My genscript init file.
#

DefaultFancyHeader: emacs

AFMPath: /home/mtr/fonts:/usr/local/lib/genscript/afm
	      
```
5. now it should work:
```
mtr@ngs mtr % cd myprogs/genscript/
mtr@ngs genscript % genscript -v -G2r -pfoo.ps latin2.txt
AFM: scanning path...
AFM: reading font map "/home/mtr/fonts/font.map"
AFM: reading font map "/usr/local/lib/genscript/afm/font.map"
reading AFM info for font "Courier"
downloading font "Courier"
processing file latin2.txt...
[ 3 pages * 1 copy ] left in foo.ps
mtr@ngs genscript %
	      
```
Now genscript uses this new courier font that has those missing characters. Since the font file `.pfa' is found from the font path, genscript automatically includes that font file to your PostScript output. This means that it can be printed with any PostScript printer; now file really contains that font so it does not depend on printer's fonts.

Printing, Output Media

I printed some documents with options `-G2r', everything goes just fine but there are no page numbers in the upper right corner. What goes wrong?
You are probably using wrong output media; your printer uses different output media than genscript. Check what is your default output media in the genscript.cfg (and $HOME/.genscriptrc) file and change it if needed. For example, to change genscript's default media A4 to Letter, you must to do the following change:
```
       # Default output media.
       DefaultMedia: A4
       =>
       DefaultMedia: Letter
       
```

How can I change margins under genscript?
You have to define a new output media which has better margins. This is quite easy, just define the new media in genscript's configuration file. For example, below is a new `A4BigMargin' media with bigger margins:

       # Media definitions:
       #	name		width	height	llx	lly	urx	ury
       Media:	A3		839	1190	18	17	821	1173
       Media:	A4		595	839	18	17	581	822
       Media:	A5		420	595	18	17	406	578
       Media:   Letter		612	792	18	17	597	776
       Media:	Legal		612	1008	18	17	597	992  

       Media:   A4BigMargin	595	839	36	34	563	805

You can select this media by giving genscript option `-M A4BigMargin' or by setting it to be your default output media by editing genscript.cfg:

       # Default output media.
       DefaultMedia: A4
       =>
       DefaultMedia: A4BigMargin

Ghostscript does not show genscript's outputs correctly, what's the problem?
There is one minor problem in genscript / ghostscript co-operation. Genscript's default output media is A4 (because I live in Europe) and GhostScript's default output media is Letter. There are two solutions for this problem:
1. Fix Genscript
  Add / edit following line to file genscript.cfg:
```
# Default output media.
DefaultMedia: A4 

=>
  
# Default output media.
DefaultMedia: Letter
```
2. Fix GhostScript
  edit following line to file gs_init.ps:
```
% Optionally choose a default paper size other than U.S. letter.
% (a4) /PAPERSIZE where { pop pop } { /PAPERSIZE exch def } ifelse

=>

% Optionally choose a default paper size other than U.S. letter.
(a4) /PAPERSIZE where { pop pop } { /PAPERSIZE exch def } ifelse
```

Markku Rossi <mtr@iki.fi>

NOTscape certified.

Genscript Frequently Asked Questions (FAQ)

Contents

Installation

Misc

Character Sets

Printing, Output Media