%%% ==================================================================== %%% @TeX-file{ %%% filename = "amsfndoc.ins", %%% version = "2.2e", %%% date = "2002/01/18", %%% time = "15:20:31 EST", %%% checksum = "08238 498 2587 20382" %%% author = "American Mathematical Society", %%% copyright = "Copyright 1994, 2002 American Mathematical Society, %%% all rights reserved. Copying of this file is %%% authorized only if either: %%% (1) you make absolutely no changes to your copy, %%% including name; OR %%% (2) if you do make changes, you first rename it %%% to some other name.", %%% address = "American Mathematical Society, %%% Technical Support, %%% Publications Technical Group, %%% P. O. Box 6248, %%% Providence, RI 02940, %%% USA", %%% telephone = "401-455-4080 or (in the USA and Canada) %%% 800-321-4AMS (321-4267)", %%% FAX = "401-331-3842", %%% email = "tech-support@ams.org (Internet)", %%% codetable = "ISO/ASCII", %%% keywords = "amsfonts, msam, msbm, eufm, eusm, eurm, Euler, %%% blackboard bold, fraktur", %%% supported = "yes", %%% abstract = "This is part of the AMSFonts distribution. It is %%% the plain TeX source file for the appendices of the %%% AMSFonts user's guide which contain installation %%% instructions.", %%% docstring = "The checksum field above contains a CRC-16 checksum %%% as the first value, followed by the equivalent of %%% the standard UNIX wc (word count) utility output of %%% lines, words, and characters. This is produced by %%% Robert Solovay's checksum utility.", %%% } %%% ==================================================================== % If these installation instructions are processed by themselves, we % will add a bit of extra information \InstName in the appendix titles. \ifx\undefined\InstName \let\InstName\relax \input amsfndoc.def \def\InstName{ for AMSFonts 2.2d}% \fi \def\AFUG{{\sl AMSFonts 2.2d User's Guide\/}} \def\TEXMF{{\tt TEXMF}} \appendix{A}{Installation Procedures\InstName} \instsec Introduction ``AMSFonts'' is a collection of fonts that supplement the basic Computer Modern fonts, for use with the \TeX\ typesetting system. These fonts were originally intended for use with the \AmSTeX\ or \AmS-\LaTeX\ macro packages, but they can also be used with plain \TeX{} or \LaTeX, independently of the AMS formatting packages. AMSFonts can be used with any full implementation of \TeX. Many \TeX{} distributions include the AMSFonts; check the documentation that came with the \TeX{} distribution you are using. When a new version of AMSFonts is released, all distributors are notified, so if your \TeX{} system is up to date, it is likely that you don't need to do anything at all. Most current \TeX{} installations are organized according to the \TeX{} Directory Structure (TDS)\null. This is a tree structure whose root is identified as something like {\tt /usr/local/share/texmf} or {\tt c:\char`\\sw\char`\\texmf}. In the following instructions, we will use the name \TEXMF{} to identify the root directory of a TDS or similar structure. (For detailed documentation of the TDS, see the report at\newline \null\indent {\tt http://www.ctan.org/tex-archive/tds/standard/tds/}\newline for a browsable version, or the file {\tt tds.pdf} in the same area if you prefer a copy formatted for printing.) When installing a new release of the AMSFonts, you may want to first back up your old version, if you have existing documents that use it. Although new releases are intended to be backward compatible, a backup provides insurance in case something goes wrong. \instsec Location of AMSFonts files in a TDS tree Files in the AMSFonts distribution fall into several categories: \fn{.tfm} (metric) files, macro files for use with \TeX{}, source files, documentation, and raster image (\fn{.pk}) files. The following list shows the files in the current distribution, along with their recommended locations in a TDS tree. \medskip \begingroup \parskip=0pt \obeylines\obeyspaces\tt% TEXMF/ \ fonts/source/ \ ams/ \ README \ amsfonts.lst \ cmextra/ \ cmbsy*.mf \hbox{\rm(5 files)} \ cmcsc*.mf \hbox{\rm(2 files)} \ cmex*.mf \hbox{\rm(3 files)} \ cmmib*.mf \hbox{\rm(5 files)} \ \null \ cyrillic/ \phantom{\rm(99 files)}% \ cyr-alt/ \ cyr*.mf \hbox{\rm(9 files)\phantom{9}}% \ README \ serb*.mf \hbox{\rm(2 files)\phantom{9}}% \ wkcy*.vpl \hbox{\rm(5 files)} \ wncy*.mf \hbox{\rm(22 files)}% \ wlcy*.vpl \hbox{\rm(5 files)} \ \phantom{\rm(99 files)}% \ wvcy*.vpl \hbox{\rm(5 files)} \ euler/ \phantom{\rm(99 files)}% \ symbols/ \ ebigop.mf \phantom{\rm(99 files)}% \ amsy*.mf \hbox{\rm(2 files)} \ eubase.mf \phantom{\rm(99 files)}% \ *symbols.mf \hbox{\rm(2 files)} \ euex*.mf \hbox{\rm(4 files)\phantom{9}}% \ msam*.mf \hbox{\rm(6 files)} \ eufb*.mf \hbox{\rm(7 files)\phantom{9}}% \ msbm*.mf \hbox{\rm(6 files)} \ eufm*.mf \hbox{\rm(7 files)\phantom{9}}% \ xb*.mf \hbox{\rm(3 files)} \ eurb*.mf \hbox{\rm(7 files)} \ eurm*.mf \hbox{\rm(7 files)} \ eusb*.mf \hbox{\rm(7 files)} \ eusm*.mf \hbox{\rm(7 files)} \ public/misc/ \ dummy.mf \ fonts/pk/ \ \/ \ \hbox{\rm (not included in bundled collection)} \ fonts/tfm/ \ ams/ \ cmextra/ \ cyrillic/ \ euler/ \ symbols/ \ public/misc/ \ dummy.tfm \ tex/latex/amsfonts/ \ amsdtx.cls % \ eucal.sty \ amsfonts.sty % \ eufrak.sty \ amssymb.sty % \ euscript.sty \ cmmib7.sty % \ ueu*.fd \hbox{\rm(8 files)} \ % \ ums*.fd \hbox{\rm(4 files)} \ tex/plain/amsfonts/ \ amssym.def \ amssym.tex \ cyracc.def \ doc/ams/amsfonts/ \ amsfndoc.tex % \ amsfonts.ins \ amsfndoc.def % \ amsfonts.bug \ amsfndoc.cyr % \ amsfonts.faq \ amsfndoc.fnt % \ amssymb.dtx \ amsfndoc.ins % \ cmmib57.dtx \ amsfndoc.ps % \ eufrak.dtx \ amsfonts.dtx % \ euscript.dtx \ amsfonts.fdd \endgroup \medskip \noindent The AMSFonts distribution can be retrieved in bundled form from the AMS web site, e.g., as a \fn{.zip}, \fn{.tar} or \fn{.hqx} file. In this form, the files are already arranged according to the TDS structure. The \fn{.pk} files are not included in the main bundle; they are bundled separately, by output device resolution or by platform. To install the main bundle, place the bundled file into a convenient directory and unpack it using the \TEXMF{} directory as the ``Extract to'' target. Some examples: \halign{\quad#\hfil\quad & #\hfil \cr WinZip: & Click on ``Extract'' and then in the ``Extract to'' box, enter\cr & {\tt\char`\\sw\char`\\texmf}\quad (or whatever {\tt TEXMF} is on your system)\cr gzip: & {\tt gzip -dc amstex.tgz \char`\|\ (cd TEXMF; tar xvf -)}\cr unzip: & {\tt unzip amstex2.zip -d TEXMF}\cr } \noindent The bundled file may be deleted after unpacking. \goodbreak \instsec Installing the \fn{.pk} files Many modern \TeX{} installations incorporate a feature called MakeTeXPk that creates a \fn{.pk} file only when it has actually been requested by a job. Check the documentation that came with your system; if MakeTeXPk is available, you may choose to omit installing any \fn{.pk} files, but let the system generate them on demand. Alternatively, if you are using a PostScript output device, you will probably want to use Postscript (Type~1) outline files rather than \fn{.pk} files. Type~1 versions of the AMSFonts are available separately from the AMS web site,\newline \null\indent{\tt http://www.ams.org/tex/amsfonts.html}\newline The fonts in the Type~1 collection do not include all sizes; for details, see the appropriate section of the \AFUG{} and the documentation that comes with the collection. If you do decide you want to install the \fn{.pk} files from the AMS server, consult the TDS tree shown above to identify the proper location. The amount of disk space required for installation of the AMSFonts depends on the resolution of your output device and on which families of fonts you choose to install. There are five families of fonts, and you may choose to install any or all of these families. Also, you may choose to install all magnifications or only magnifications 100\%, 109.5\% and 120\% (\TeX{} magsteps 0, $1\over 2$ and 1). For a more complete description of these families and magnifications, please see the appropriate sections of the \AFUG{}. The following table lists all the families and the disk space required for their installation. Before you begin the installation, decide which fonts and which magnifications you will choose, and make sure that you have enough disk space available. %%%%%%%%%%%%%%%%%%% this is the table of required disk space \bigskip \centerline{\bf Approximate Disk Space Required for AMSFonts Installation} \nobreak \bigskip \begingroup \parindent0pt \leavevmode\hfil\vbox{\font\eightrm=cmr9 \eightrm %\def\1#1<{\def\\{\cr}\baselineskip=10pt % \vbox{\halign{\hss##\hss\cr#1\crcr}}} \def\dropentry#1{\smash{\lower.5\baselineskip\hbox{#1}}} \setbox0\hbox{9} \def~{\kern\wd0 } \settabs\+400dpi\ \ &100\% thru 120\%\ \ &\hskip3pc&\hskip3pc &\hskip3pc&\hskip3pc&\hskip3pc&\hskip3pc&\cr \newbox\tablerulebox \setbox\tablerulebox=\vbox{\+400dpi\ \ &100\% thru 120\%\ \ &\hskip3pc &\hskip3pc&\hskip3pc&\hskip3pc&\hskip3pc&\hskip3pc&\cr} \def\tablerule{\smallskip\hrule width 1\wd\tablerulebox \smallskip} \baselineskip=10pt \+&&\hss Extra\hss&\hss Euler\hss&\hss Other\hss&\hss Extra\hss&\hss \hss&\hss All\hss&\cr \+&&\hss CM\hss&\hss Fraktur\hss&\hss Euler\hss&\hss Symbols\hss&\hss Cyrillic\hss&\hss Fonts\hss&\cr %\+&&\relax\1Extra\\CM<&\relax\1Euler\\Fraktur<&\relax\1Other\\Euler<& % \relax\1Extra\\Symbols<&\relax\1Cyrillic<&\relax\1All\\Fonts<&\cr \tablerule \baselineskip=11pt \+\dropentry{118dpi}&100\% thru 120\%\hss&\hss~200K\hss&\hss~150K\hss&\hss ~350K\hss&\hss~150K\hss&\hss~250K\hss&\hss 1100K\hss&\cr \+&all mags\hss&\hss\ 550K\hss&\hss\ 350K\hss&\hss~850K\hss&\hss ~450K\hss&\hss~750K\hss&\hss 2950K\hss&\cr \tablerule \+\dropentry{180dpi}&100\% thru 120\%\hss&\hss~250K\hss&\hss~150K\hss&\hss ~350K\hss&\hss~200K\hss&\hss~300K\hss&\hss 1250K\hss&\cr \+&all mags\hss&\hss~750K\hss&\hss~450K\hss&\hss~950K\hss&\hss ~650K\hss&\hss 1000K\hss&\hss 3800K\hss&\cr \tablerule \+\dropentry{240dpi}&100\% thru 120\%\hss&\hss~300K\hss&\hss~150K\hss&\hss ~350K\hss&\hss~250K\hss&\hss~400K\hss&\hss 1450K\hss&\cr \+&all mags\hss&\hss~900K\hss&\hss~500K\hss&\hss 1000K\hss&\hss ~800K\hss&\hss 1200K\hss&\hss 4400K\hss&\cr \tablerule \+\dropentry{300dpi}&100\% thru 120\%\hss&\hss~350K\hss&\hss~200K\hss&\hss ~450K\hss&\hss~350K\hss&\hss~500K\hss&\hss 1850K\hss&\cr \+&all mags\hss&\hss 1100K\hss&\hss~700K\hss&\hss 1300K\hss&\hss\ 1000K\hss&\hss 1500K\hss&\hss 5600K\hss&\cr \tablerule \+\dropentry{400dpi}&100\% thru 120\%\hss&\hss~450K\hss&\hss~250K\hss&\hss ~500K\hss&\hss~400K\hss&\hss~550K\hss&\hss 2150K\hss&\cr \+&all mags\hss&\hss 1450K\hss&\hss~825K\hss&\hss 1625K\hss&\hss 1250K\hss&\hss 1850K\hss&\hss 7000K\hss&\cr \tablerule \+\dropentry{600dpi}&100\% thru 120\%\hss&\hss~650K\hss&\hss~325K\hss&\hss ~600K\hss&\hss~500K\hss&\hss~725K\hss&\hss 2800K\hss&\cr \+&all mags\hss&\hss 2000K\hss&\hss1150K\hss&\hss 2150K\hss&\hss 1750K\hss&\hss 2650K\hss&\hss 9700K\hss&\cr \tablerule }\endgraf \endgroup %%%%%%%%%%%%%%%%%%%%%%%%%%% end of table \instsec What if your \TeX{} system isn't in a TDS tree? If your \TeX{} system is arranged in some other way, you must consult the user documentation for guidance. The hints that follow are just that---hints. If your \TeX{} system documentation recommends something different, you should follow that procedure. We recommend placing AMSFonts files into distinct subdirectories or folders, to simplify installation of future versions. First, determine where \TeX{} will look for its files. The AMSFonts collection contains not only fonts, but also support for their use with plain \TeX{} and \LaTeX. Look first for files listed in the tree above; if you find them, you should simply install the new versions in the same areas. If you don't find them, some more specific hints follow. To install plain \TeX{} support files, look on your system for the file \fn{plain.tex}; the files listed above under {\tt tex/plain/amsfonts/} should go into (a subarea of) that area. To install \LaTeX{} support files, look for the file \fn{article.sty}; the files listed above under {\tt tex/latex/amsfonts/} should go into (a subarea of) that area. To install the \fn{.tfm} files, look for the file \fn{cmr10.tfm}. Raster image files may or may not have {\tt pk} in the file extension, depending on the system. These files are used by the output device drivers, not by \TeX{} itself. Consult the documentation for your drivers to see where they look for \fn{.pk} files. In the AMSFonts distribution, the directories are labeled {\tt \bs amsfonts\bs dpiXXX}, where {\tt XXX} is the resolution of the output device multiplied by the magnification (for example, for a 300dpi printer, {\tt XXX} would be {\tt 300} for a font at 100\% or {\tt 360} for a font at 120\%). Unix users will have to rename the \fn{.pk} files in each directory to the extension \fn{.XXXpk}, where \filename{XXX} is the number in the directory \filename{dpiXXX} in which the file is located. Once all the files have been renamed, they can be placed all together in the directory where your drivers will find them. \instsec Font definition files for \LaTeX{} {\bf Warning:} If your version of \LaTeXe{} is earlier than December 1996, {\it and} if your operating system and \TeX{} implementation both refer to filenames in a case-sensitive manner, the \fn{.fd} files you need are not included in the bundled AMSFonts distribution; you will need to retrieve them explicitly from the AMS FTP server, at\newline \null\indent{\tt ftp://ftp.ams.org/pub/tex/amsfonts/latex/obsolete/}\newline This warning may apply to users of Unix systems; it does not generally apply to users of Windows or DOS. A better option, which we recommend strongly, is to update your version of \LaTeX{}; the case-sensitive \fn{.fd} filenames were made obsolete with the December 1996 release of \LaTeX{}, so if you are still using an older version, it is overdue for update. \instsec Additional note for all users of AMSFonts The device driver with which you are using these fonts may have a font table that needs to be updated in order for the driver to recognize the fonts. In order to use AMSFonts with any software that uses such a table, you must enter the names of each of the fonts in the AMSFonts package and the effective resolutions at which you have them installed. The file \fn{amsfonts.lst}, which appears at the same level in the TDS tree as the \fn{README} file, contains a list of all of the font names and all of the resolutions contained in the distribution. You may have to alter the format of this file to make it conform to your driver's needs or to reflect installation of only some of the fonts, but it provides you with the necessary data. See the documentation for your device driver to see what format is required. If your device driver does not depend on such a table, this step is not necessary. \instsec Note for users of \Textures{} on Macintosh The AMSFonts distribution for \Textures{} is different from what has been described above; the fonts are distributed in several different suitcase files rather than in a TDS tree. This distribution is bundled in the file\newline \null\indent{\tt /pub/macintosh/amsfonts2-2.hqx}\newline which is available from the AMS FTP server or web site. %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% \appendix{B}{Using the PostScript (Type 1) AMSFonts} The AMSFonts were reimplemented in Type 1 outline form jointly by Blue Sky Research and Y\&Y, and made freely available for general use through a consortium of scientific publishers. These Type~1 fonts are not part of the main AMSFonts distribution, but are available separately from the AMS web site:\newline \null\indent{\tt http://www.ams.org/tex/type1-fonts.html}\newline The web page contains a more detailed history of these fonts than is given here. This collection can also be found on CTAN (the Comprehensive \TeX{} Archive Network), at\newline \null\indent{\tt http://www.ctan.org/tex-archive/amsfonts/ps-type1/}\newline The CTAN entry is mirrored directly from the AMS server. The symbols and fonts of mathematical alphabets in the Type~1 collection are provided only in sizes 5, 7, and 10 point, with additional sizes produced by interpolation. To accommodate this reduced set of sizes, a ``PS AMS fonts'' option is provided with both \LaTeX{} and \AmSTeX; see the relevant sections of this guide for details. Papers and monographs submitted to the AMS for publication are required to use this option. \Warn Adding the ``PS AMS fonts'' option to an existing file may result in changed line and page breaks, owing to the fact that sizes 6, 8, and 9 are produced by interpolation. \endx The Type~1 cyrillic fonts are provided only in 10 point. The ``PS AMS fonts'' option does not apply to cyrillic at the present time. Some output device drivers (e.g., {\tt dvips}) require a ``map'' file to identify Type~1 fonts; for details, see the documentation for your device driver. If you are using the Type~1 AMSFonts, you may wish to rename the \fn{.tfm} files for the intermediate sizes---6, 8, and 9 point for the math fonts and all sizes but 10 point for the cyrillic---so that \TeX{} won't find them. This will insure that the bitmaps aren't used inadvertently, or created on demand by systems that use the MakeTeXPk facility. %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% \appendix{C}{For further information} The AMSFonts collection was implemented and packaged by the Society's Publications Technical Group. Questions or suggestions for improvements should be directed to that group at the following address: \begingroup \smallskip \parskip=0pt \TextAddr Publications Technical Group \AMS{} \POBox 6248 Providence, RI 02940 \smallskip Phone: 800-321-4AMS (4267)\quad or\quad 401-455-4080 Internet: {\tt tech-support@ams.org}< \endgroup \smallskip \noindent Questions or comments concerning \Textures{} can be directed to: \begingroup \smallskip\parskip0pt \TextAddr Blue Sky Research 516 Southeast Morrison Portland, OR 97204 \smallskip Phone: 800-622-8398 \quad or \quad 503-222-9571 Internet: {\tt help@bluesky.com}< \endgroup \smallskip %\noindent %The \TUG{} is a good source of general information about fonts for use %with \TeX. Inquiries can be directed to: %\begingroup %\smallskip %\parskip=0pt %\TextAddr \TUG{} % 1850 Union Street, \#1637 % San Francisco, CA 94123 USA % \smallskip Phone: 415-982-8449 % Internet: {\tt tug@tug.org}< %\endgroup \noindent The Internet newsgroup {\tt comp.text.tex} is an excellent source of general information about anything related to \TeX, and fonts are no exception. The newsgroup and its archives can be accessed at {\tt http://groups.google.com/}. The \TeX{} Resources pages at the AMS web site ({\tt http://www.ams.org/tex/}) contain pointers to additional sources of \TeX{}-related information, including answers to Frequently Asked Questions (FAQ). \bye