[lucida] revised instructions

[Karl Berry]

Here is my attempt at a slightly revised README.TUG file with
instructions for Lucida, with a new step about enabling the map file.
Any comments or suggestions before I push this out?


--
To install the Lucida font distribution from TUG:

1) download the zip file from TUG via the url given to you after ordering.

2) change directories to a suitable texmf hierarchy; your "local texmf"
   tree is a good choice if you already have one.  More info below(*).

3) unzip the archive as retrieved.  It unpacks into subdirectories
   fonts/, tex/, and so on.  These directories will probably already
   exist if you already have a local texmf tree; that's ok.  You must
   use an unzip program or settings which does *not* create any
   top-level directory of its own (such as "lucida-complete/"), but just
   unpacks what is in the zip file.

4) remake the so-called "filename database", unless you unpacked in a
    personal directory, such as ~/Library/texmf on MacOSX.
   Under Unix, this is generally done by running the command mktexlsr.
   Under MiKTeX, it is generally done in the MiKTeX program:
   Start > Programs > MiKTeX > MiKTeX Options > General
     > Refresh Now (the file name database).

5) enable the Lucida "map files", unless your distribution already did.
   Under Unix, this is generally done by running the command
updmap-sys --enable Map lucida.map
   (on MacOSX, typically as root, so  sudo updmap-sys ...)
   For MiKTeX, the procedure is more complicated; see below(**).
   
   Some distributions already have the map file enabled.  You can just
   tell by running the sample document below.  If it starts calling
   programs like mktexpk, and you don't get any actual Lucida in the
   output, then you need to enable the map file.  If the output is fine,
   you're all set.
   
6) the document doc/fonts/lucidabr/lucida-sample.pdf explains the basic
   usage of the fonts in LaTeX, and is itself typeset using Lucida.  The
   LaTeX source is also included (lucida-sample.tex) so that you can see
   how it was produced.  Running this file through LaTeX yourself is a
   good test of the installation.(***)  Some additional documentation and
   samples are included in doc/fonts/lucidabr and doc/fonts/lucida.

If you have questions or problems regarding installation or use, please
email lucida at tug.org; this is an open list for Lucida discussion, and
you can subscribe via http://tug.org/mailman/listinfo/lucida.  Questions
or problems related to ordering or licensing should go to
lucida-admin at tug.org.

The TUG Lucida home page is http://tug.org/lucida. 
Happy typesetting!

--
(*) Finding and choosing a texmf tree:

TeX systems generally come with thousands of support files, arranged in
a "tree" of directories.  When you install TeX, you generally set up a
"local" tree, for your own macros and other files.  For example, it
might be the directory c:\localtexmf on Windows or
/usr/local/texlive/texmf-local on Unix.  It might be entirely empty.

This local tree is the best place to install the Lucida fonts.  That
way, when and if you upgrade your main TeX installation, they will not
be lost.

Although you can also use the main texmf tree (the one containing
tex/plain/base/plain.tex, for example), then you will probably have to
reinstall Lucida when you upgrade your TeX system.

If you did not set up a local texmf tree, or do not know where it is,
you might look for the file plain.tex on your system, and then try to
find some sibling directory to whatever top-level directory it is in.
The resources listed at http://tug.org/begin.html might help if none of
this is getting you anywhere.


(**) Enabling the Lucida map file under MiKTeX:

1. Navigate to Start > Programs > MiKTeX > MiKTeX Options > Roots.
   Write down or keep in mind the Path with the description
   "Common Data, CommonConfig".

2. Open the file "Common Data, CommonConfig"\miktex\config\updmap.cfg
   in a text editor such as Notepad.  If the file or any of the
   leading directories do not exist, create them.

3. Add this line:
Map lucida.map
   to the updmap.cfg file and save it.

4. Open a DOS Window/DOX Box, and enter these two commands:
initexmf --update-fndb
updmap

Hopefully that is it.


(***) Potential problems:

1. If when you run a Lucida document you get complaints about missing
   fonts, mktexpk could not make bitmaps, etc., most likely you need to
   enable the Lucida map file.  See step 5 above.

2. If you do try latex-ing lucida-sample.tex and get an error at the line:
  \DeclareEncodingSubset{TS1}{hlh}{1}  % including \oldstylenums
Please check your version of the textcomp.sty style file against 
the current release, available at:
  http://www.ctan.org/tex-archive/macros/latex/unpacked/textcomp.sty


--
Legal: the Lucida fonts are made available only under an end-user or
site license, which you must have agreed to when you ordered the fonts.
The license text is available in the distribution files
doc/fonts/lucidabr/lucida-license-*.txt, or online at
http://tug.org/store/lucida.

The Lucida typeface family was designed by Charles Bigelow and Kris Holmes.  
(R) Lucida is a trademark of Bigelow & Holmes Inc.
registered in the U.S. Patent & Trademark Office and other
jurisdictions.

TUG gratefully acknowledges Y&Y for the original Lucida TeX distribution,
Walter Schmidt for creating and updating the TeX font support files,
PCTeX for sponsoring him and allowing his work to be redistributed, and
Morten Høgholm for working on the samples and other TeXnical help.