Using Bitstream Humanist 521 (=Gill Sans) with LaTeX
======================================================================
                                                            2006-06-06
                                                      Michael Gaehrken
                                                      mgaehrken@gmx.de

This archive contains all required files for using Bitstream
Humanist521, a clone of Gill Sans, with LaTeX, with the exception of the
font itself, which is _not_ included. The font can be bought from
Bitstream, and is included in some versions of CorelDraw.

This distribution includes a script to generate SmallCaps and Oldstyle
figures. The SmallCaps and Oldstyle Figures generated by this
distribution are inferior compared to the originals available e.g. from
Adobe, but better than "faked SmallCaps". If you can affort to buy the
original fonts, please do it.

Only basic hinting is applied to the SC/OsF-fonts fonts.


--------------------------   Requirements   --------------------------

A recent version of the program FontForge is required to create the
SmallCaps and Oldstyle Figures. It is available for free from
<http://fontforge.sf.net>. Please install it according to the
instructions supplied on that site.


--------------------------   Installation   --------------------------

This describtion assumes a TDS-compliant TeX system.

1) Unpack the archive. The archive contains the following files and
folders:
    bgillsans.txt: This file
    Hum521.pe: Script-file for use with FontForge
    texmf/: Folder with all files required by TeX

2) Install the TeX/LaTeX files. The folder "texmf" contains all files
for TeX/LaTeX in their correct position in a virtual texmf-tree,
therefore you only need to move the files to their corresponding
location in your local texmf-tree. Some of the directorys might have to
be created first.

3) Prepare the PFB-files. At first, you have to rename your fonts
according to the following table. Depending on the source of your fonts,
they may have different names.

Bitstream:      Corel:              TeX:
0288A___.PFB    hum521l.pfb     ->  bgsl8a.pfb      (Light)
0289A___.PFB    hum521li.pfb    ->  bgsli8a.pfb     (LightItalic)
0290A___.PFB    hum521n.pfb     ->  bgsr8a.pfb      (Roman)
0291A___.PFB    hum521i.pfb     ->  bgsri8a.pfb     (RomanItalic)
0292A___.PFB    hum521b.pfb     ->  bgsb8a.pfb      (Bold)
0293A___.PFB    hum521bi.pfb    ->  bgsbi8a.pfb     (BoldItalic)
0294A___.PFB    hum521xb.pfb    ->  bgsxi8a.pfb     (ExtraBold)

Copy the file "Hum521.pe" into the directory containing the (renamed)
fonts.

4) Create the new fonts. Open a terminal and change into the directory
used in 3). Then run the following command to convert the fonts:

    fontforge --script Hum521.pe

You might get some warning messages, just ignore them. 

5) Install the fonts. The resulting eight PFB-files created under 4)
have to be moved to texmf/fonts/type1/bitstrea/gillsans/ (probably you have
to create the directory first) in your local texmf-tree.

6) Update your filename database. If your tex system maintains a
filename database, you might have to update manually now. Please consult
the documentation of your tex system.

7) Enable the map file. Please consult the documentation of your tex
system, how to enable the additional font map "bgs.map", which is
located in texmf/dvips/config/ and texmf/fonts/map/dvips/. Under teTeX
2.0 and later, run the following commands:

    texhash
    updmap --enable Map bgs.map

For other distributions, please consult your documentation!


-------------------   Using the fonts with LaTeX   -------------------

The supplied package "bgillsans.sty" selects Bitstream Humanist521 as the
default sans-serif font. As default it loads lining figures. The package
supports the following options:

  osf: Load font with oldstyle figures

  scaled=<scale>: Load font scaled by <scale>.

  commands: Load additional commands for selecting the font styles not
    supported by the LaTeX font management:
      -\osstyle, \textos{...} selects oldstyle figures
      -\lnstyle, \textln{...} selects lining figures
    Those commands are taken from "The Font Installation Guide" by
    Philipp Lehman.

Most of the code used in this package is adapted from packages by Walter
Schmidt.


-----------------------   Shapes and Series   ------------------------

bgs: (with lining figures)
l (light):       n (normal), it (italic)
n (roman):       n (normal), it (italic), sc (SmallCaps)
b (bold):        n (normal), it (italic)
eb (extrabold):  n (normal)

bgsj: (with oldstyle figures)
l (light):       n (normal), it (italic)
n (roman):       n (normal), it (italic), sc (SmallCaps)
b (bold):        n (normal), it (italic)
eb (extrabold):  n (normal)

All fonts are available only T1 and TS1 encoded, so you should include
the following commands in the preamble of your document:

    \usepackage[T1]{fontenc}
    \usepackage{textcomp}

Neither OT1 nor LY1 are supported at the moment.


----------------------------   History   -----------------------------

2006-06-06  Inital release


----------------------------    Legal    -----------------------------

This bundle "bgillsans.tgz" and the included files are
    Copyright (c) 2006 Michael Gaehrken

Distribution of single files prohibited.

----------------------------------------------------------------------
Michael Gaehrken
mgaehrken@gmx.de