summaryrefslogtreecommitdiff
path: root/texmf-dist/doc/latex/lucidabr/README.TUG
diff options
context:
space:
mode:
Diffstat (limited to 'texmf-dist/doc/latex/lucidabr/README.TUG')
-rw-r--r--texmf-dist/doc/latex/lucidabr/README.TUG135
1 files changed, 135 insertions, 0 deletions
diff --git a/texmf-dist/doc/latex/lucidabr/README.TUG b/texmf-dist/doc/latex/lucidabr/README.TUG
new file mode 100644
index 00000000..a536ad01
--- /dev/null
+++ b/texmf-dist/doc/latex/lucidabr/README.TUG
@@ -0,0 +1,135 @@
+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 the best choice. 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).
+ (or from a DOS command line, if you prefer: initexmf --update-fndb)
+
+5) enable the Lucida "map files", if necessary.
+ 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 tell
+ by running the sample document mentioned below on your system. If it
+ starts calling programs like mktexpk, and fonts are unable to be
+ loaded, 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) remake the filename database again; this is not always necessary,
+ depending on your setup, but should never hurt.
+
+7) 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@tug.org; this is an open and publicly archived 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@tug.org.
+
+The TUG Lucida home page is http://tug.org/lucida.
+Happy typesetting!
+
+--
+(*) Finding and/or creating your texmf-local tree:
+
+TeX systems have thousands of files, arranged in one or more
+"trees" of directories. Your system can quickly look through
+the trees that it knows about.
+
+When you install TeX, you may have noticed or set up a "local" tree,
+used for your own macros and other files. The advantage of a local tree
+is that if you install an new version of your TeX system then these
+local materials will not be overwritten. A local tree is the best place
+to install the Lucida fonts.
+
+Typical names for local trees are "C:\Local TeX Files" on Windows or
+"/usr/local/texlive/texmf-local" on Unix. They might be entirely empty.
+How to find any local trees that you have depends on your system:
+
+ MiKTeX
+ From inside MiKTeX click on "MiKTeX Settings" and go to the Roots
+ tab. Some paths shown there have a "Description" such as UserConfig
+ or UserData; these are not local paths. For your local path you can
+ use any path without a Description.
+
+ If you see only paths that have a description then you can create a new
+ local path by clicking on "Add" (for more info, see the MiKTeX page
+ http://docs.miktex.org/manual/localadditions.html).
+
+ TeX Live and MacTeX
+ From a system terminal (aka command prompt and shell window) enter the
+ command
+ kpsewhich --var-value TEXMFLOCAL
+ to see the directory name.
+
+
+(**) Enabling the Lucida map file under MiKTeX:
+
+1. Edit the map configuration file updmap.cfg. In a DOS Window/Command
+Prompt window, run:
+initexmf --edit-config-file updmap
+ You'll want to edit this in a text editor such as Notepad. If the
+ file or any of the leading directories do not exist, create them.
+
+2. Add this one line to updmap.cfg and save it.
+Map lucida.map
+
+3. Back at the DOS prompt, run
+initexmf --mkmaps
+ (Ignore any error messages.)
+
+Hopefully that is it. Resume above at step 5.
+
+
+(***) 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 4 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. (This README.TUG file itself may be freely
+used, modified and/or distributed.)
+
+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 Hoegholm for working on the samples and other TeXnical help.