% Y&Y TeX Manual --- plain TeX format release 2.1 % Copyright 2007 TeX Users Group. % You may freely use, modify and/or distribute this file. % Run with kerned Lucida fonts \immediate\write16{Format: \fmtname\space Version: \fmtversion} % \overfullrule=5pt % show justification problem areas \overfullrule=0pt % avoid ugliness in final output % \tolerance=800 % to avoid overfull box blocks ? \catcode`\@11 % make @ act as if it was a letter \newdimen\pc@ % define a new dimension for `pica' for efficiency \pc@12\p@ % a pica is 12 pt (\p@ is predefined in plain TeX) \hsize26\pc@ % horizontal size is 26 picas \vsize12\p@ % vertical page size \vsize41\vsize % is 41 picas (another way of doing this sort of thing) \advance\vsize\topskip % plus topskip amount % \voffset-2.5\pc@ % take out, vertical shift not needed with TWOUP % \hoffset-3\pc@ % take out, horizontal shift not needed with TWOUP \parskip\z@ % set paragraph skip to 0pt \parindent\pc@ % set paragraph indent to one pica % % Define fonts. % Originally: Minion for text, Syntax for heading, Memphis light for typewriter % Now: LucidaBright for text, LucidaSans for heading, and LucidaSansTypewriter % \font\tenrm=lbr at9.5\p@ % \font\tenrm=morg at10\p@ \font\sixrm=lbr at6.1\p@ % \font\sixrm=morg at6\p@ \font\sixbf=lbd at6.1\p@ % \font\sixrm=morg at6\p@ \font\sevenrm=lbr at6.9\p@ % \font\sevenrm=morg at7\p@ \scriptfont\z@\sevenrm \font\tenit=lbi at9.5\p@ % \font\tenit=moi at10\p@ \font\tenbf=lbd at9.5\p@ % \font\tenbf=mob at10\p@ \font\tensc=lbrsc at9.5\p@ % \font\tensc=mosc at10\p@ \font\tendsc=lbdsc at9.5\p@ % \font\tensc=mosc at10\p@ \font\tensl=lbsl at9.5\p@ \font\eightsl=lbsl at7\p@ % fir slanted LaTeX \font\titlef=lsd at16\p@ % \font\titlef=sxb at16\p@ \font\eighttitle=lsd at9.0\p@ % \font\eighttitle=sxb at9.6\p@ \font\sectfnt=lsd at10.6\p@ % \font\sectfnt=sxb at11\p@ \font\subsectfnt=lsd at9.5\p@ % \font\subsectfnt=sxb at10\p@ \font\sixsubsectfnt=lsd at6.1\p@ % \font\sixsubsectfnt=sxb at6\p@ \font\rhfnt=lsr at8.6\p@ % \font\rhfnt=sxr at9\p@ \font\rhfol=lsb at8.6\p@ % \font\rhfol=sxubl at9\p@ % \font\tentt=lbtnr at9.5\p@ % \font\tentt=meml at10\p@ \font\tentt=lstnr at9.5\p@ % \font\tentt=meml at10\p@ % \font\secttt=lbtnr at10.6\p@ % \font\secttt=meml at11\p@ % \font\secttt=lstnr at10.6\p@ % \font\secttt=meml at11\p@ \font\secttt=lstnb at10.6\p@ % \font\secttt=meml at11\p@ \font\cmsy=cmsy10 at 10\p@ % for AMS TeX and AMS LaTeX logos only \font\lbms=lbms at 9.5\p@ % for < and > in -b= etc \font\lbmi=lbmi at 9.5\p@ % for \varepsilon in LaTeX 2e, x, y \font\lbr=lbr at 9.5\p@ % for > % \font\lstr=lstr at 9.5\p@ % for > % \let\sc\tensc % short hand for smallcaps font \let\dsc\tendsc % short hand for bold smallcaps font \let\tt\tentt % short hand for typewriter fixed width font \tenrm % switch to ten point roman text font \baselineskip12\p@ % baseline skip is 12pt % \newwrite\toc % allocate new output stream called TOC \immediate\openout\toc\jobname.toc % open output stream file .toc \def\noindex#1{} \def\tocwrite#1{{\let\index\noindex\xdef\toctext{#1}}\xdef\writeit{\write\toc {\toctext\string{\noexpand\number\pageno\string}}}\writeit} \newcount\sectcnt % allocate new counter for sections \def\section#1{\removelastskip26\p@ plus3.9\p@ minus1.95\p@ \global\advance\sectcnt\@ne{\sectfnt\let\tt\secttt\setbox8\hbox{\the \sectcnt.\kern6\p@}\hangindent\wd8\noindent\box8#1\par}\afterheadtrue \everypar{\afterhead}\global\subsectcnt\z@\nobreak\markbothsame{\the \sectcnt.\ #1}\tocwrite{\string\tocsect{\the\sectcnt}{#1}}\nobreak \vskip13\p@ plus2.6\p@ minus1.3\p@} \def\markbothsame#1{\xdef\chapmark{{#1}}\mark{{#1}{#1}}} \def\chapmark{{}} \newcount\subsectcnt % allocate new counter for subsections \def\subsect#1{\removelastskip19.5\p@ plus3.25\p@ minus1.625\p@\global\advance \subsectcnt\@ne\global\subsubsectcnt\z@{\subsectfnt\let\sixrm\sixsubsectfnt \setbox8\hbox{\the\sectcnt.\the\subsectcnt\kern6\p@}\hangindent\wd8\noindent \box8#1\par}\afterheadtrue\everypar{\afterhead}\nobreak\markright{\the \sectcnt.\the\subsectcnt\ #1}\tocwrite{\string\tocsub{\the\sectcnt.\the \subsectcnt}{#1}}\nobreak\vskip6.5\p@ plus1.95\p@ minus.975\p@} \newcount\subsubsectcnt % allocate new counter for subsubsections \def\subsub#1{\removelastskip13\p@ plus2.6\p@ minus1.3\p@\global\advance \subsubsectcnt\@ne{\subsectfnt\let\sixrm\sixsubsectfnt\noindent\the \sectcnt.\the\subsectcnt.\the\subsubsectcnt\kern6\p@#1}\tocwrite{\string \tocsubsub{\the\sectcnt.\the\subsectcnt.\the\subsubsectcnt}{#1}}\quad \ignorespaces} % \def\markright#1{\expandafter\makerightmark\chapmark{#1}} \def\makerightmark#1#2{\mark{{#1}{#2}}} \def\rhhead{\ifodd\pageno\rightheadline\else\leftheadline\fi} \def\rightheadline{\line{\rhfnt\getrecto\botmark\hfil\rhfol\folio}} \def\getrecto{\expandafter\dogetrecto} \def\dogetrecto#1#2{#2} \def\getverso{\expandafter\dogetverso} \def\dogetverso#1#2{#1} \def\leftheadline{\line{\rhfol\folio\hfil\rhfnt\getverso\botmark}} % \headline{\ifnum\pageno>1\rhhead\else\hfil\fi} \headline{\ifnum\pageno>1\rhhead\else\hfil\fi} % \footline{\ifnum\pageno=\@ne\hfil{\rhfol\folio}\fi\hfil} \footline{\ifnum\pageno=\z@\hfil{\rhfol\folio}\fi\hfil} %% no footer % \newif\ifafterhead \def\afterhead{\doafterhead\global\everypar{}} \def\doafterhead{{\setbox\z@\lastbox}\global\afterheadfalse} \newskip\nextskip \def\simpleremove{\par\ifdim\lastskip=\z@\else\vskip-\lastskip\fi} \def\removelastskip{\par\afterassignment\rem@vel@stskip\nextskip=} \def\rem@vel@stskip{\ifdim\lastskip=\z@\else\doremoveskip\fi\vskip\nextskip} \def\doremoveskip{\ifdim\lastskip>\nextskip\nextskip\z@\else\vskip-\lastskip \fi} \newskip\egskip \def\afterendgroupskip{\par \global\egskip\lastskip\endgroup\afterassignment\removeegskip\nextskip=} \def\removeegskip{\ifdim\egskip=\z@\else\doremoveegskip\fi\vskip\nextskip} \def\doremoveegskip{\ifdim\egskip>\nextskip\nextskip\z@\else\vskip-\egskip\fi} % \newif\iffirstitem \newif\ifinnerlist \def\makelistdisplay{\whang\wd8\advance\whang\leftskip\leftskip\whang} \let\item\zxvqj \def\regbeginlist{\removelastskip6.5\p@ plus1.95\p@ minus.975\p@ \begingroup\firstitemtrue\let\beginlist\innerbeginlist} \def\innerbeginlist{\begingroup\let\itemskip\relax\let\Itemskip\relax\let \endlist\endinnerlist\innerlisttrue} \newcount\itemcount % allocate new counter for items \newskip\qrtrskip \qrtrskip\thr@@\p@ plus1.6\p@ minus.8\p@ \def\itemskip{\iffirstitem\global\firstitemfalse\else\removelastskip\qrtrskip \fi} \def\Itemskip{\iffirstitem\global\firstitemfalse\else\removelastskip\h@lfskip \fi} \def\@tem{\itemskip\advance\itemcount\@ne% \noindent\llap{\hbox to\whang{\hfil\hbox to\pc@{\eqthing\itemcount.\hfil}}}} % \def\bull{$\bullet$} % \chardef\bull=149 % bullet % \def\bull{{\lbms\char15}} % bullet \def\bull{{\lbms\char14}} % openbullet \def\b@tem{\itemskip\noindent\llap{\hbox to\whang{\hfil\raise\p@\hbox to\pc@ {\bull\hfil}}}} \newdimen\whang \def\llist{\beginlist\itemcount96\let\item\@tem\let\eqthing\char \setbox8\hbox{\kern\tw@\pc@}\makelistdisplay} \def\nlist{\beginlist\itemcount\z@\let\item\@tem\let\eqthing\number \setbox8\hbox{\kern\tw@\pc@}\makelistdisplay} \def\blist{\beginlist\let\item\b@tem\setbox8\hbox{\kern\tw@\pc@}% \makelistdisplay} \def\ulist{\beginlist\let\item\u@tem\setbox8\hbox{\kern\tw@\pc@}% \makelistdisplay} \def\u@tem{\noindent\kern-\tw@\pc@} \def\endlist{\simpleremove\global\let\beginlist\regbeginlist \afterendgroupskip6.5\p@ plus1.95\p@ minus.975\p@} \def\endinnerlist{\endgraf\nextskip\lastskip\ifdim\nextskip=\z@\else\vskip- \nextskip\aftergroup\vskip\aftergroup\nextskip\fi\global\let\beginlist \regbeginlist\endgroup} \let\beginlist\regbeginlist % \chardef\other12 % \other will be used for \catcode 12 \def\ttverbatim{\begingroup\ttv \obeyspaces \obeylines} \def\ttv{% % make `less', `greater', and `backslash' active to translate char code \catcode`\<\active \catcode`\>\active % maybe just make these act like \other instead ? % make {, }, $, &, #, %, ~, _, ^ act like \other, not their normal meaning \catcode`\{=\other \catcode`\}=\other \catcode`\$=\other \catcode`\&=\other \catcode`\#=\other \catcode`\%=\other \catcode`\~=\other \catcode`\_=\other \catcode`\^ \other \tt \catcode`\\=\active} % \def\oddcharbackslash{\char"9D\relax} % char 157 for `backslash' \def\oddcharbackslash{\char92\relax} % char 92 for `backslash' % \def\oddchargreat{\char"9C\relax} % char 156 for `greater' \def\oddchargreat{\char62\relax} % char 62 for `greater' % \def\oddcharless{\char"98\relax} % char 60 for `less' \def\oddcharless{\char60\relax} % char 152 for `less' % need to play a game to do the following, since \ is redefined by \ttv % let char 219 act as escape (ala \) in place of \ % also set up active definitions for <, >, \ \bgroup \catcode`\Û\z@ \ttv ÛglobalÛlet\Ûoddcharbackslash ÛglobalÛlet>Ûoddchargreat ÛglobalÛlet<Ûoddcharless Ûegroup {\obeyspaces\gdef {\ }} \outer\def\begintt{$$\let\par=\endgraf \ttverbatim \parskip=\z@pt \catcode`\Û=\z@ \ttfinish} {\catcode`\Û\z@\catcode`Û\\otherÛobeylinesÛgdefÛttfinish#1^^M#2\endtt{#1Ûvbox% {#2}Ûendgroup$$}} \catcode`\Û\active {\obeylines\gdefÛ{\ttverbatim\let^^M=\ \letÛ=\endgroup}} \def\beginlines{\par\goodbreak\vskip6.5\p@ plus1.95\p@ minus.975\p@\nobreak \begingroup\parskip\z@\everypar{\vrule height9.20833\p@ depth3.79167\p@ width\z@}\rightskip\z@ plus\thr@@ em\leftskip\pc@\parindent\z@\obeylines} \def\endlines{\par\endgroup\vskip6.5\p@ plus1.95\p@ minus.975\p@} % % define various logos % \def\yandy{Y\hbox to.35\p@{\hss\sixrm\&\hss}Y} \def\yandyBold{Y\hbox to.35\p@{\hss\sixbf\&\hss}Y} \def\LaTeX{{L\kern-.36em\raise.3ex\hbox{\sc a}\kern-.15emT\kern-.1667em\lower .7ex\hbox{E}\kern-.125emX}} \def\LaTeXSlanted{{L\kern-.26em\raise.3ex\hbox{\eightsl A}\kern-.15emT\kern-.1667em\lower .7ex\hbox{E}\kern-.125emX}} \def\LaTeXBold{{L\kern-.3em\raise.3ex\hbox{\dsc a}\kern-.15emT\kern-.1667em\lower .7ex\hbox{E}\kern-.125emX}} % \def\LaTeXe{\LaTeX\kern.15em2${}_{\textstyle\varepsilon}$} % \def\LaTeXe{\LaTeX\kern.15em2{\lbmi \char34}} \def\LaTeXe{\LaTeX} % \def\LaTeXeBold{\LaTeXBold\kern.15em2{\lbmi \char34}} \def\LaTeXeBold{\LaTeXBold} \def\SliTeX{S{\sc li}{\TeX}} \def\AMS{{\cmsy A\kern-.1667em\lower.5ex\hbox{M}\kern-.125emS}} % \def\AmSTeX{{\the\textfont\cmsyfam A\kern-.1667em\lower.5ex\hbox{M}\kern-.125 \def\AmSTeX{{\cmsy A\kern-.1667em\lower.5ex\hbox{M}\kern-.125 emS}-\TeX} \def\SLiTeX{{S\kern-.06em{\sc l\kern-.035emi}\kern-.06emT\kern-.1667em\lower .7ex\hbox{E}\kern-.125emX}} % \def\AmSLaTeX{{\the\textfont\cmsyfam A\kern-.1667em\lower.5ex\hbox{M}\kern \def\AmSLaTeX{{\cmsy A\kern-.1667em\lower.5ex\hbox{M}\kern -.125emS}-\LaTeX} \font\tii=tii at 10.5pt \font\tibi=tibi at 10.5pt \def\MathTime{{\tii Math\-T\kern-2pt\i me}} \def\MathTimeBold{{\tibi Math\-T\kern-2pt\i me}} % % \def\ang#1{$\langle${#1}$\rangle$} \def\ang#1{{\lbms\char104}{#1}{\lbms\char105}} \def\angi#1{{\lbms\char104}{\it #1\/}{\lbms\char105}} \def\breakpar{{\parfillskip\z@\par}} \def\dottedline{\leaders\hbox to1em{\hss.\hss}\hfill} \def\tocsect#1#2#3{\vskip6.5\p@\noindent{\bf#1.\kern.5em#2\dottedline#3}\breakpar\vskip3.25\p@} \def\tocsub#1#2#3{\noindent\phantom{\bf0.\kern.5em}#1\kern.5em#2\dottedline #3\breakpar} \def\tocsubsub#1#2#3{\noindent\phantom{\bf0.\kern.5em0.0\kern.5em}#1\kern.5em #2\dottedline#3\breakpar} % % \def\vbar{$|$} % \chardef\vbar=`\| % vertical bar separating menu | submenu | subsubmenu % \def\vbar{\,`\|\,} % vertical bar separating menu | submenu | subsubmenu % \def\vbar{$\,|\,$} % vertical bar separating menu | submenu | subsubmenu % \def\vbar{$\,${\lbms\char106}$\,$} % vertical bar separating menu | submenu | subsubmenu % \def\vbar{$\,${\lbms\char105}$\,$} % vertical bar separating menu | submenu | subsubmenu \def\down{$\,${\lbr\char62}$\,$} % > separating menu > submenu > subsubmenu % \def\trademark{$^{\rm TM}$} \chardef\trademark=153 % TM - trademark (not registered) % \chardef\registered=174 % (R) - registered trademark % \chardef\copyright=169 % (C) - copyright % \chardef\paragragh=182 % pillcrow % \chardef\section=167 % section \chardef\onehalf=189 % {1\over2} % \chardef\multiply=215 % \times \chardef\times=215 % \times \chardef\ellipsis=133 % \dots % \def\tip{Advanced Feature: \enspace} \def\tip{{\bf Tip: \enspace}} \def\decreasepageno{\global\advance\pageno-1} \def\newpage{\vfill\eject} \def\blankpage{ \topglue 2in \hbox{ } % to get blank page \newpage % \decreasepageno } % \font\bigggsize=lsr at 18pt \font\bigggsize=lsr at 20pt % \font\biggsize=lsr at 12pt \font\biggsize=lsr at 16pt % \font\bigsize=lbr at 12pt % \font\bigsize=lbr at 11pt \font\bigsize=lbr at 10pt \def\coverpage{ % \nopagenumbers % \topglue 2in \hbox{ } % \vskip 2in \vskip 1in \centerline{{\bigggsize Y\kern-3pt{\biggsize\&}\kern-3ptY TeX System --- release 2.1}} %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% Define some useful acronyms %%%%%%%%%%%%%%% \def\DOS{{\sc dos}} % \def\DVIWindo{{\sc dviwindo}} \def\DVIWindo{{\sc dvi\-w}indo} \def\DVIPSONE{{\sc dvi\-ps\-one}} \def\DVIPS{{\sc dvips}} \def\PFE{{\sc pfe}} \def\CTAN{{\sc ctan}} \def\CD{{\sc cd}} \def\PS{{\sc ps}} \def\FTP{{\sc ftp}} \def\CTM{{\sc ctm}} \def\PDF{{\sc pdf}} \def\ATM{{\sc atm}} \def\AFM{{\sc afm}} \def\TFM{{\sc tfm}} \def\TIFF{{\sc tiff}} \def\BMP{{\sc bmp}} \def\TIFFTAGS{{\sc tifftags}} \def\WMFSPY{{\sc wmfspy}} \def\TSR{{\sc tsr}} \def\FMP{{\sc fmp}} \def\ANSI{{\sc ansi}} \def\ASCII{{\sc ascii}} \def\EPS{{\sc eps}} \def\EPSI{{\sc epsi}} \def\WMF{{\sc wmf}} \def\WWW{{\sc www}} \def\DSC{{\sc dsc}} \def\PIF{{\sc pif}} \def\AFMtoTFM{{\sc afm}to{\sc tfm}} \def\AFMtoPFM{{\sc afm}to{\sc pfm}} \def\TFMtoAFM{{\sc tfm}to{\sc afm}} \def\PFMtoAFM{{\sc pfm}to{\sc afm}} \def\PFAtoAFM{{\sc pfa}to{\sc afm}} \def\PFBtoPFA{{\sc pfb}to{\sc pfa}} \def\MODEX{{\sc modex}} \def\TWOUP{{\sc twoup}} % \def\DECODE{{\sc decode}} % \def\CLEANUP{{\sc cleanup}} % \def\SERIAL{{\sc serial}} \def\PKtoPS{{\sc pktops}} \def\TUG{{\sc tug}} \def\RAM{{\sc ram}} \def\FMP{{\sc fmp}} \def\WMF{{\sc wmf}} \def\PSNFSS{{\sc psnfss}} % follow may need some tweaking ... \def\TEXNANSI{TeX 'n {\sc ansi}} % \def\yandytex{\yandy\TeX} \def\yandytex{\yandy\ TeX} \def\yandytexBold{\yandyBold\ TeX} %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% Deal with encoding %%%%%%%%%%%%%%%%%%%%%%%% \input texnansi % in Windows 3.1 with ENCODING=texnansi % \input ansiacce % in Windows NT with TEXANSI=1 \catcode219=\active % \catcode`\Û\active % override ansiacce \catcode ... \coverpage \newpage \decreasepageno \topglue 2in \hbox{ } % to get blank page \newpage \decreasepageno %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% Document itself starts here %%%%%%%%%%%%%%% \section{Introduction} % % Need a more general introduction --- provide more context? % Why has user bought the package --- what does (s)he expect? % \TeX\ --- invented by Donald E. Knuth of Stanford University --- is the premiere tool for typesetting % of technical material. \TeX\ excels at displaying mathematic formulae and also features an outstanding paragraph % hyphenation-justification line-breaking algorithm. \TeX\ is a `code based' system, that is, the source file you create is marked up using `control sequences,' and has to be processed by the {\TeX} `compiler' % processor before it is possible to view the typeset result on screen or on the printed page. Since \TeX\ is not {\sc wysiwyg} (or {\sc wysiayg} --- What You See Is All You Get), \TeX\ depends on % \yandytex\ system uses an edit--\TeX--preview cycle to produce the desired results. First, you create or edit a % plain {\ASCII} text source file in a text editor or word processor. Second, you `run \TeX' on the file, % with \yandytex. which creates a compact binary file with extension Û.dviÛ (for `DeVice Independent'). Third, you view the resulting Û.dviÛ file using the previewer. % {\DVIWindo}. If the results are not satisfactory, you go back to step one. Once you are satisfied with the results, you go to a fourth step: Printing your masterpiece of fine typography. %% emphasize speed ? The \yandytex\ System release~2.1 is an implementation of {\TeX} for IBM PC compatibles % running Windows~3.1, Windows NT~3.51, Windows~95, or OS~2/2.1. running Windows~95/98 or Windows~NT 4.0 (or later). It provides many advanced features such as on the fly font reencoding, dynamic memory allocation, partial font downloading, hypertext linkage, % added 1996/July/23 and multiple master font support. % added 1999/July/26 The \yandytex\ System comes with commercial grade fonts in industry standard {\ATM} compatible Adobe Type~1 format (a.k.a. `Post\-Script' fonts), but can also work with TrueType fonts. The \yandytex\ System is, like Gaul, divided into three main parts: \nlist \item {\DVIWindo}: a previewer and printer driver for \TeX\ {\tt.dvi} files. This is the heart of the system --- everything % else is controlled from here. \item {\DVIPSONE}: a device driver that converts \TeX\ {\tt.dvi} files to resolution independent, DSC-compliant, page-independent Post\-Script (PS) files suitable for printing on any Adobe Post\-Script % PS device. \item \yandytex\ itself: a 32-bit implementation of \TeX\ that can run as a `console application' in Windows~95/98 and Windows~NT. % 95/Sep/27 % for {\DOS}, {\DOS} boxes under Windows, and as a % `console application' in Windows NT. % and in a {\DOS} box under Windows 3.1. % rephrased 96/July/23 \endlist \noindent The \yandytex\ System includes Adobe Type Manager (\ATM) 4.0 for rasterizing fonts in Adobe Type~1 format, % the Programmer's File Editor, {\PFE}, the WinEdt editor, and some handy utilities. % programs % shareware ? CTAN ? In addition, the \yandytex\ System CD holds many useful {\LaTeXe} packages from CTAN (Comprehensive TeX Archive Network), extra documentation, as well as handy shareware programs. This manual explains how to install the system, % programs, gives brief instructions on how to use it, and gives hints on how to trouble-shoot the most common % Windows-related problems. This manual does {\it not\/} explain how to use \TeX\ or Post\-Script --- or how to program in \TeX\ or Post\-Script. The standard references for the two languages are {\sl The \TeX book}, % {\it The \TeX book}, by Donald E. Knuth (ISBN 0-201-13448-9), % (Reading, Mass.: Addison-Wesley, 1984) and {\sl Post\-Script Language Reference Manual}, % {\it Post\-Script Language Reference Manual}, 2nd ed., by Adobe Systems Inc. % Incorporated. % (Reading, Mass.: Addison-Wesley, 1990). (ISBN 0-201-18127-4). For {\LaTeX} (a dialect built on top of `plain' \TeX), refer to {\sl {\LaTeXSlanted} --- A Document Preparation System}, 2nd edit. by Leslie Lamport (ISBN 0-201-52983-1), % (Reading, Mass.: Addison-Wesley, 1994) and {\sl The {\LaTeXSlanted} Companion}, by Michel Goosens, Frank Mittelbach, Alexander Samarin % --- (0-201-54199-8). % For information on graphics inclusions see {\sl The LaTeX Graphics Companion}, by Michel Goosens, Sebastian Rahtz, Frank Mittelbach (0-201-85469-4) All of the above-mentioned books are % were published by Addison-Wesley (Reading, Massachusetts, USA). % (Reading, Mass.: Addison-Wesley, 1994) % give ISBN numbers also ? % It is assumed here that the reader has some familiarity with % Windows\registered\ and {\DOS}. % Familiarity with Windows\registered\ and {\DOS}\registered\ is also assumed. \subsect{Necessary Legal Stuff} % % Too flip ? % \yandy, Inc. will, of course, replace defective CDs. % and diskettes. \yandy, Inc. is not responsible for anything bad that happens while you use this software. \yandy, Inc. will, however, gladly take the credit for whatever good things happen. % say more about warranty or lack thereof ? The \yandytex\ System and the fonts supplied with it are copyrighted material and each copy is customized to a particular end user. Do not copy % or distribute. --- except for archival backup purposes. % Always install from the original diskettes. Refer to the end user license agreement printed on the software and font envelopes for exact statement of licensing terms. Please contact \yandy\ for generous site license terms, % information. second platform discounts, % As well as electronic publishing licensing terms for Adobe Acrobat PDF files. as well as information on publishing Adobe Acrobat PDF files with embedded fonts. Use of trademarks in this manual should not be construed as infringements of said trademarks. % those %% say something about fonts in PS or PDF files ? \subsect{Conventions} % Familiarity with % Microsoft Windows\registered\ is assumed. % and {\DOS}\registered\ is % also is assumed. Things you enter into fields in dialog boxes --- or type at the command prompt --- appear in a typewriter font, like so: Ûa:setupÛ. % a:install The same font will be used for folders, % disk directories, file names and so on. % maybe > is better than | ? % A vertical bar (\down) % will be used to A `greater than' sign (\down) % will be used to separates menu items selected from the names of the menus themselves. % submenu selections. % and so on. % separates the names of menu from items selected from % these menus. % submenu selections. % and so on. So, for example, `File{\down}Run' means select `Run' from the `File' menu (when reading constructions of this sort one might say `File {\it down\/} Run' to emphasize % the subsidiary relationship). that `Run' is subsidiary to `File'). More than one level of menu selection may be denoted in this fashion, e.g. `Preferences{\down}Ruler Units{\down}mm.' Another obvious extension of this notation is that `Start{\down}Run' denotes selecting `Run' from the menu reached by clicking on the `Start' button. The notation Ctrl+A denotes typing `A' while holding down the `Ctrl' key. Similarly, the manual refers to the `Shift' and `Alt' keys. %% Also explain \ang{Enter} and \ang{Alt-Tab} etc ? %% And why not use \ang also for other keys, like Esc, Ins, Del ? Console applications and utilities supplied give a command line summary when invoked with Û-?Û on the command line. This is useful, for example, when checking whether a utility has capabilities beyond the basic ones discussed in this manual. % The utilities that come with the system are in the Û\utilÛ subfolder % subdirectory (typically Ûc:\yandy\utilÛ). % Windows NT~4.0 has the `new shell,' that is, % the same look and feel as Windows 95 (while % Windows NT~3.51 still has the look and feel of Windows~3.1). % We'll use the term `new shell' when we want to refer % collectively to Windows NT~4.0 and Windows~95. % % (as distinguished from Windows NT~3.51). % We use the term `folder' in preference to `directory' % since this is common usage with the `new shell.' Adobe Type Manager ({\ATM}~4.0) comes % is available in two forms --- one for Windows~95/98 and one for Windows NT~4.0. ATM consists of two functional parts: (i) a font rasterizer (for on screen display and for printing to non-PS printers), and (ii) a font manager (facilitating font installation and removal). %% distinction between ATM rasterizer and ATM font manager In Windows~2000, the {\ATM} rasterizer is built in, and you do not install {\ATM}. % In this case You install fonts simply by dragging them % (to be specific: the Û.pfmÛ files) to the font folder (a sub-folder of the Windows NT folder --- typically Ûc:\winnt\fontsÛ). % However, in future a version of {\ATM} for Windows~2000 may add the benefits of a font management interface. % (the old ATM~3.02 will run on Windows~95/98, but not on Windows~NT). % (there are no plans to retrofit {\ATM} to Windows NT~3.51). % We'll refer to systems for which {\ATM} is available as % `{\ATM} compatible' systems. % Font installation instructions differ depending % on whether {\ATM} has been installed or not. % We assume here for concreteness that your diskette drive is Ûa:Û. % If it is Ûb:Û, then please replace Ûa:Û with Ûb:Û % Similarly, we assume that your CD driver is Ûd:Û. We assume here for concreteness that your CD drive is Ûd:Û. If it is not, then please replace Ûd:Û with the appropriate drive letter in the instructions that follow. In some of the examples, explicit reference will also be made to subfolders of the \yandytex\ System installation folder. If you install in other than the default Ûc:\yandyÛ folder you will need to make adjustments to these examples. % By the way, do {\it not\/} try to install the system into a folder that has a space in its name (such as ``Program Files''). \subsect{Requirements} % The \yandytex\ System~2.1 requires: \beginlines (i)~IBM PC compatible 486 (Pentium recommended); (ii)~CD ROM drive; % (iii)~3\onehalf" diskette drive (for ATM~3.02); (iii)~16 Meg of {\RAM} (32 Meg when using NT); (iv)~20--30 Meg of free hard disk space; (v)~VGA display (higher resolution recommended); (vi)~Windows~95, 98 or Windows NT~4.0 (or later). % (vii)~PostScript printer if you have PostScript inclusions. \endlines % (vi)~DOS 5.0 or later; % (vi)~Windows 3.1, Windows for Workgroups 3.11, Windows NT 3.51, % Windows~95, or OS/2 release 2.1. % will not run on Windows 3.1 or OS 2/2.1 % CD-ROM :-) % Tech support info ? tech-help@YandY.com, fax number % ask them to give serial & machine configuration ? \section{Installation} There are two parts to the installation: (i) installing {\ATM} and the fonts (do this first), and (ii) installing the {\yandy} TeX System itself. % We'll discuss {\ATM} installation first, since {\ATM} should be installed % first --- except on Windows~2000. % it is best to install the fonts before the \yandytex\ System itself. % %% systems with {\ATM}. % % On `{\ATM} compatible' systems % (i.e. systems for which {\ATM} is currently available), On Windows~95/98 and Windows~NT 4.0, you must install Adobe Type Manager ({\ATM}). {\ATM} rasterizes the fonts for on screen display as well as when printing to non-PS devices. On Windows~2000, the Type~1 font rasterizer is built in, and Type~1 fonts can be installed by dragging them to the ÛfontsÛ folder. % but has some advantages. % % You may, however, still wish to install {\ATM} for its font management functions. % % Install ATM~4.0 for NT if you have it. % --- unless you are using a version of Windows~NT % for which no {\ATM} is yet available. % Then To install {\ATM}, right click on the {\CD} icon and select from the menu % that appears the version of {\ATM} appropriate to your operating system. % If you elect to install {\ATM} {\it without\/} fonts, then you will later need to install the fonts supplied with your \yandytex\ system from the {\ATM} control panel (see section~2.1). % converting them to TrueType format. % during installation. % install the fonts instead from the `Fonts' icon in the Windows control panel % --- this will automatically convert them to TrueType format % (see section on conversion to TrueType format). % give number ??? % While this font conversion is automatic, exactly how it is invoked % depends on the version of Windows~NT being used (see section~2.2). % See section~2.2. % for details. % Give more details? OK! % If you have received the \MathTime\ fonts, first % $run the Ûprepare.batÛ batch file in a temporary folder % directory % on your hard drive % (and Ûtexttune.batÛ) % {\it before\/} installing the fonts % (Either using {\ATM} or by converting them to TrueType format in Windows~NT). % Consult the documentation that comes with the \MathTime\ fonts % for additional details, if necessary. % Note that with large font sets (such as Computer Modern or % Lucida Bright + Lucida New Math), the last diskette typically % often % contains {\it only\/} Û.afmÛ metric % files, Û.texÛ source files, and other ancillary files --- {\it not\/} % installable Û.pfbÛ and Û.pfmÛ files. % So don't be surprised if no fonts are found on the last diskette % of a set! \subsect{Installing Fonts with ATM} % On Windows~95/98 start by installing {\ATM}. % On Windows~NT install {\ATM} if you have {\ATM}~4.0 for NT. Start by installing {\ATM} from the CD. Choose the version appropriate to your version of Windows. % In either case, insert the {\ATM} diskette or CD, % and type Ûa:installÛ from the `Start{\down}Run' dialog. % {\ATM} only exists for new shell... % (or `File{\down}Run' dialog in the Program Manager in Windows~NT). NO % Refer to `Installing {\ATM}' in the {\ATM} manual if necessary. This step normally {\it also\/} installs the fonts that came with your system. % Adobe currently supplies us with {\ATM} version~3.01 for use with Windows~95 % You need at {\it least\/} {\ATM} version~3.02 % for everything to work as advertised in Windows~95/98. % and ATM~4.0 for NT when using Windows~NT. % If you use {\sc pcl} printers in Windows~95, % you need the latest printer drivers, % since the original Windows {\sc pcl} drivers are buggy. % (An upgrade from {\ATM}~3.0 and {\ATM}~3.01 to version 3.02 % is included in the Û\utilÛ subfolder --- % unzip the file Ûatm302up.zipÛ using Ûpkunzip.exeÛ). % (Free upgrades from {\ATM}~3.0 and {\ATM}~3.01 to version 3.02 % are available at Ûhttp://www.adobe.comÛ). % For Windows~NT 4.0 you can use {\ATM}~4.0 for NT if you have it --- % For Windows~NT 4.0 you can use {\ATM}~4.0 for NT (recommended) === % or you can use the automatic conversion to TrueType format % described in the next section. % section~2.2 If you installed {\ATM} {\it without\/} installing fonts, you can selectively install fonts later. % Once you have {\ATM} installed, Start up the {\ATM} control panel --- from the `Start' button select % `Programs{\down}Main{\down}ATM' (ATM~3.02) or `Programs{\down}Adobe{\down}Adobe Type Manager.' % (ATM~4.0). Click on `Add' or `Add Fonts.' Then choose the drive with the CD % (in {\ATM} 3.02, look for a list of drives --- Û[-a-]Û etc. % --- near the bottom of the list of folders), Select each of the folders with the fonts in turn. The names of these folders are: \beginlines (i) CM, AMS, LatxFont, TeX Pi (Computer Modern TeX System); (ii) MathTime, MathPlus (MathTime TeX System); (iii) Lucidabr, LucidExp (Lucida Bright TeX System); and (iv) EM, TeX Pi (European Modern TeX System). \endlines \noindent You may also have additional font folders, such as `XY' (fonts for use with XY-Pic). In each folder, highlight all the font names shown, and click on `Add' % again (A quick way to highlight all font names is to type Ctrl-A). Make sure to \beginlines (1) check `Autodownload for Post\-Script driver,' and (2) do {\it not\/} check `Install without copying files'. \endlines % \noindent Repeat for the other font diskettes. % (note, though, that with some font sets, the last diskette % contains {\it only\/} % Û.afmÛ metric files, Û.texÛ source files, and other ancillary files, % {\it not\/} installable Û.pfbÛ and Û.pfmÛ files). % \subsect{Systems without ATM --- Conversion to TrueType} % \subsect{Systems without ATM --- Windows~2000} \subsect{Installing fonts without ATM} % --- Windows 2000 % Until there is a version of {\ATM} for Windows~NT, In Windows~2000 you can use Type~1 fonts % by converting them to TrueType format using the built-in {\ATM} rasterizer. % built into Windows NT~4.0. % But first replace the Ût1install.dllÛ that came % with your system with the improved version on the CD % in the Ût1installÛ folder. Please refer to Ût1install.txtÛ % for details. % % To convert the fonts, drag the Û.pfmÛ files --- % `fonts' (the To install the fonts, drag the Û.pfmÛ files --- % `fonts' (the the ones with the red `a' icon --- from the folder on the CD to the `Û\fontsÛ' folder --- subfolder of your `ÛwinntÛ' folder. Whenever a font is dropped into the ÛfontsÛ folder, it is automatically registered.% converted and % This can be done conveniently starting from `My Computer.' Open the `Ûc:\winnt\fontsÛ' folder in one window and the folder with the fonts on the {\CD} in another (perhaps by starting again at `My Computer'). Alternatively, you may prefer to use Windows Explorer. Explorer can be reached from `Start{\down}Programs.' Note that you can select the fonts in one folder by holding down the `Ctrl' key and clicking on each Û.pfmÛ file listed. % Then drag the selection to the Û\fontsÛ sub-folder of the % ÛwindowsÛ folder. A convenient alternative is to select {\it everything\/} in a folder by clicking on an item in the folder and then typing `Ctrl'-A. In this case files other than Û.pfmÛ files will {\it also\/} be selected --- and the system will complain about that --- but you can ignore these benign complaints --- nothing bad will happen! % Alternatively you can open the `Û\fontsÛ' subfolder % subdirectory % of your ÛwindowsÛ folder % directory % from Explorer and select `File{\down}Install New Font'. % On Windows NT {\it without\/} the new shell % (i.e. Windows NT~3.51) % double click on the `Control Panel' icon in the `Main' program group. % Then double click on the colorful `Fonts' icon. % Click `Add' and navigate to the diskette with the fonts. % Select all of the fonts listed and click on `Add' again. % On Windows NT with the new shell you can get to the control panel % from `Start{\down}Settings{\down}Control Panel'. % When you install fonts, elect to have the Type~1 fonts made available % to the Post\-Script printer driver % (so the converted TrueType versions % will be used {\it only\/} for on screen display). % In summary, check all three boxes in the dialog box: % \beginlines % (1) `Convert Type 1 Font to TrueType,' % (2) `Install Type 1 Font Files for use on a Post\-Script Printer,' and % (3) `Copy Type 1 Font Files to Fonts Folder.' % \endlines % \noindent If you experience problems resulting from `font name mangling' by the automatic installation in Windows~NT run the ÛsetupttfÛ utility % after installing fonts. after installing all fonts. The `Ûsetupttf.exeÛ' utility % comes with the \yandy\ TeX System % In release~2.1 of {\yandy} TeX System this application is in the may be found in the `Û\utilÛ' subfolder. % (typically Ûc:\yandy\util\setupttf.exeÛ). You can run this utility from `Start{\down}Run' by typing Ûc:\yandy\util\setupttfÛ. % % Flush following alternative ? % Alternatively, start from the command prompt. The command prompt can be reached from `Start{\down}Programs.' At the prompt, type \beginlines Ûc:\yandy\util\setupttfÛ \endlines \noindent then type ÛexitÛ to dismiss the command prompt again. \vskip .05in \subsect{Fonts supplied with the System} With your \yandytex\ System, you will have received % several a CD with folders % diskettes containing fonts in {\ATM} compatible Adobe Type~1 format: \nlist \item {\yandy} CM TeX system includes (i) the Computer Modern fonts, (ii) the AMS font set, as well as (iii) the extra {\LaTeX} + {\SliTeX} font set; \item {\yandy} LB TeX system includes (i) the Lucida Bright + Lucida New Math fonts, as well as (ii) the Lucida Bright Expert font set; % and \item {\yandy} MT Complete TeX system includes (i) the \MathTime~1.1 fonts, as well as (ii) the \MathTime\ Plus fonts. \item {\yandy} EM Complete TeX system includes (i) the EM fonts, as well as (ii) the TeX Pi fonts. \endlist \noindent The text fonts used with \MathTime\ are the Times-Roman, Helvetica, and Courier font families. These are automatically installed with the special version of {\ATM} that we supply. % On Windows~2000 systems when {\ATM} is not used, install these 13 fonts separately from the ÛpsfontsÛ folder in the {\ATM} folder on the CD --- as described above. % in the previous section. % section~2.2 % As mentioned above, % The \MathTime\ % math % fonts themselves % should {\it not\/} be installed straight off the diskette. % Prepare an empty temporary directory, make that the current directory % be installed from a temporary directory in which % and run the Ûprepare.batÛ batch found on the diskette. % All other fonts are installed straight off their respective diskettes. %% forward reference to section describing how to use LB+LNM, MT See sections~3.7.4 and 3.7.5 % for LB+LNM & MathTime % See later % explicit section ? for instruction on how to use fonts other than Computer Modern with plain {\TeX}, {\LaTeX}~2.09, and {\LaTeXe}. \subsect{Installing the Y\&Y TeX System Itself} %% This section is rather long % The \yandytex\ system itself is installed simply by using % Ûd:setupÛ from the `Start{\down}Run' dialog box % where Ûd:Û is your CD ROM drive. % Or double click on Ûsetup.exeÛ on the CD reached from `My Computer.' To install the \yandytex\ system itself, right click on the {\CD} icon and select % installation of the \yandytex\ system. the system installation. % in systems with the new shell (i.e. Windows~95 and Windows NT~4.0). % (assuming that Ûa:Û is your diskette drive). % In Windows NT~3.51, install instead using the `File{\down}Run' % dialog box in Program Manager. % Similarly, we'll assume you are installing the system on Windows~95 and hence % using the `Start' button. % On other operating systems please adjust the instructions as described above. % The ÛsetupÛ installation program first The program first % calls for the three `{\yandy} TeX System' diskettes. installs the basic {\yandy} TeX System with the plain {\TeX} and {\AMS}-{\TeX} formats. At the end of this operation you are given the option to also install {\LaTeXe} and/or {\LaTeX} 2.09. You can install {\LaTeX} at this point or do this latter % These two formats can alternatively be installed later by % running Ûsetup1.exeÛ on the CD (note the digit 1). by right clicking on the {\CD} icon and selecting installation of \LaTeX from the menu. % then it will also refer to the three `{\LaTeX} Support' diskettes. % The `{\LaTeX} Support' diskettes can be installed % separately at a later time, by the way. You can choose which system components to install. % You may, for example, wish to omit {\DVIPSONE}, the Post\-Script printer driver, % if you will never need Post\-Script output. We recommend that you accept the defaults. By the way, do {\it not\/} attempt to install into a folder that has spaces in its path name --- {\TeX} itself does not like file names with spaces! If you like your current text editor or word processor then you can link it into the `TeX' menu in {\DVIWindo}, as explained in section~3.4.2. % explicit section ? % But the \yandytex\ System does include a full featured Windows editor of its own --- % developed by Alan Phillips --- called {\PFE}. WinEdt --- developed by Aleksander Simonic. The editor will be installed in the ÛWinEdtÛ subfolder of the main Û\yandyÛ folder. % The {\PFE} editor The editor comes with its own `help' file explaining its operation --- just hit the F1 function key to access it while in the editor. % while in {\PFE}. % We also include {\PFE} Note that you can always add system components later. Also, most choices made during installation can be modified from the `Preferences' menu in the {\DVIWindo} previewer (or by editing the \yandytex\ configuration file Ûdviwindo.iniÛ in the ÛwindowsÛ or ÛwinntÛ folder % directory using a plain ASCII text editor --- such as `Notepad,' `WordPad,' `WinEdt' or {\PFE}). % (in `Start{\down}Programs{\down}Accessories') We'll discuss next the questions that you will be asked % come up during installation. We recommend that you normally accept the default choices, unless there is some good reason not to do so. \subsub{Questions and Answers during Installation.} % TeX System Customization % You can chose between `Custom' and `Express' installation. If you chose `Express' installation, you will not be asked a lot of questions and the defaults will be used. Otherwise read on. When asked what font encoding (character layout) to use for text fonts, accept the default {\TEXNANSI} (ÛtexnansiÛ, also referred to as LY1 in {\LaTeX}) --- unless you are % both a \TeX pert and a `fontspert' and want to experiment. The chosen encoding will be used for all {\it text\/} fonts. % or you do not have {\ATM} installed. % If you are running on Windows ~NT {\it without\/} {\ATM}, % select `Windows ANSI' encoding instead. % This is required because TrueType fonts {\it cannot\/} be reencoded % `on the fly' --- the way {\DVIWindo} reencodes Type~1 fonts --- % and Windows insists on encoding text fonts as Windows ANSI. You will be asked where {\TeX} source files may be found. Now, you can, of course, run {\TeX} on files in {\it any\/} folder, by giving their full path, but it can be % is often convenient to give just a file name {\it without\/} the path in Û\inputÛ and Û\usepackageÛ macros. The installation already adds folders % the folders % directories with the {\LaTeXe} class files, and {\LaTeX} 2.09 style files, so you need not be concerned about those. During installation you are given % This just gives you an opportunity to enter {\it additional\/} folders. % directories. Give the full path of each folder % directory that you plan to use for % {\TeX} style files --- % and source files --- hit \ang{Enter} after each one. When you are done, click `No' when asked: `Specify another directory?'. Note that you can easily change this list of folders % directory list later by modifying the ÛTEXINPUTSÛ environment variable from {\DVIWindo}'s `Preferences{\down}Environment Variables' menu (or by editing the Ûdviwindo.iniÛ file). Actually, unless you are running {\TeX} {\it without\/} a format preloaded, you should modify the `format specific' variables ÛPLAINÛ for plain {\TeX}, ÛAMSTEXÛ for {\AMS}-{\TeX}, ÛLPLAINÛ for {\LaTeX} 2.09, or ÛLATEXÛ for {\LaTeXe} --- see section~3.2.1). Similarly, you will be asked where your graphics and image files ({\EPS}, {\TIFF}, {\BMP} and {\WMF}) % (if any) are to be searched for. Navigate to or type in the full path of each folder. % directory. When you are done, click `No' when asked: `Specify another directory?'. This list can be changed easily later by modifying the ÛPSPATHÛ environment variable from the {\DVIWindo}'s `Preferences{\down}Environment Variables' menu. % (or by editing the Ûdviwindo.iniÛ file) % Note that if you want {\TeX} to be able to read the `bounding box' in your EPS files then the folders % directories with those files need to be on the list searched by {\TeX} or {\LaTeX} {\it also\/}. % The installation program automatically takes care of this. % % If you add additional folders later you will have to do this manually. You will be asked whether you have {\TeX} font metric (Û.tfmÛ) files in another folder % directory that you would like to use with the system. Typically the answer is `No.' This list can be changed later by modifying the ÛTEXFONTSÛ environment variable % in Ûdviwindo.iniÛ from {\DVIWindo}'s `Preferences{\down}Environment Variables' menu. % (or by editing the Ûdviwindo.iniÛ file) (Actually % unless you are running {\TeX} without a format preloaded, --- as explained above --- you should modify the `format specific' variables for the dialect of {\TeX} being used). % ÛTEXNANSIÛ for TeX 'n ANSI encoding, % ÛANSINEWÛ for Windows ANSI encoding, and so on). %%% Does it ask about which ports have PS printers??? % Graphics File Formats, David C. Jay & John R. Levine % Windcrest/McGrawHill ISBN 0-8306-3059-7 You will also be asked whether \yandytex\ should write Û.dviÛ files in the same folder as the \TeX\ source file, or instead into a {\it common\/} working folder. % directory. {\TeX} users seem to be divided % about equally as to which of the two modes of operation they prefer. %% Send in your vote! Win a free vacation to Hawaii! If you can't decide, chose {\it not\/} to use a common working folder (so that the output files will be written back into the same place the source files came from). Here is the difference: If you run \TeX\ on Ûc:\books\chapter1.texÛ and chose the former (i.e. {\it no\/} common working folder) then the Û.dviÛ file will be Ûc:\books\chapter1.dviÛ. If you chose instead to have a common working folder % directory called, let's say, Ûc:\workingÛ, then the Û.dviÛ file corresponding to Ûc:\books\chapter1.texÛ will % instead be Ûc:\working\chapter1.dviÛ. An advantage of a common folder % directory is that it is easy to clean up and delete old Û.dviÛ files. % later. % optional ? A disadvantage is that files for different jobs will be mixed up in one place. The common working folder can be a folder on your hard drive (which is created by the installation program if it doesn't already exist), or it can be on a {\RAM} drive % (well, at least in Windows~95/98). (Windows~95/98). % % Is it impossible to have RAM drive in NT % % Files on a {\RAM} drive disappear when you power down your machine. % (use {\sc dos help} to find out what parameters to use when % you load Ûramdrive.sysÛ in your Ûconfig.sysÛ file). %% No RAM drives in Windows NT ??? %% No DOS Help in Windows 95 ??? If you forget which mode you chose, you can easily get frustrated, because you won't know where your Û.dviÛ files are going to! One side effect of this may be that your preview will not be updated when you re-{\TeX} a file --- since you may be looking at a ``stale'' version in the wrong folder, rather than the fresh version just created. In this case just see whether % or not % `Fonts{\down}Working Directory' is checked in {\DVIWindo}. `Special{\down}Working Directory' is checked in {\DVIWindo}. % You can temporarily change this selection by checking or unchecking % this menu item. You can change the selection permanently % later by changing the ÛWorkingDirectoryÛ entry in the Û[Window]Û section of Ûdviwindo.iniÛ --- or temporarily by toggling the check mark on % `Fonts{\down}Working Directory.' `Special{\down}Working Directory.' %%%%% Maybe explain the directory structure here ??? \subsect{Quick Tutorial} This section walks you through creation of a simple {\TeX} source file in the text editor, `compilation' of that file using {\TeX}, and finally viewing the typeset result on screen. % in {\DVIWindo}. If you did not already do so during installation, this may be a good time to create a folder % directory for `random' {\TeX} source files. % such as the one to be typed in and edited in this exercise. {\TeX} can, of course, read source files from any folder, % directory, but a common folder % directory for `miscellaneous' {\TeX} source files can make it easier for you to find them again later. % You can create a new folder % directory using the Windows Explorer, % (in systems with the new shell), or from `My Computer' using `File{\down}New{\down}Folder.' % or the File Manager (in systems without). % --- or even from the {\DOS} prompt using ÛmkdirÛ. For concreteness, let us suppose this new folder is called Ûc:\texinputÛ. %%% is this name used again later ??? % Now we are ready for a simple \TeX exercise. Now we are ready for a simple \TeX ercise. Launch {\DVIWindo} by double-clicking on the {\DVIWindo} icon on the desktop (or by selecting it from `Start{\down}Programs{\down}YandY21'). % => installation program YANDY20 ??? % from the % `Y and Y' % `{\sc YANDY2x}' % ??? % `{\sc YANDY2}' % ??? % program group reached via % from % `Start{\down}Programs.' % Start > Programs > YandY2x > DVIWINDO_2x You might want to resize {\DVIWindo}'s window at this point by dragging the right window frame to the left a bit. This will make it easier to switch between different windows just by clicking on an exposed part of a window. % Select `TeX{\down}PFE Editor' to call the {\PFE} editor. Select `TeX{\down}WinEdt' to call the editor. You will be presented with a File Open dialog box. The first time you do this, enter an exclamation mark (!) for `File Name' to tell the system that you do {\it not\/} wish to open an existing file. % --- instead asking it to create a new file. Click `OK.' The editor comes up. % The {\PFE} editor comes up. If it covers the full screen, change it to windowed mode by clicking on the double rectangle icon in the top right corner. Select `File{\down}New.' A new window % labelled `Untitled1' appears. %%%%%%%%%%%% editor changed !!! At this point, you may want to resize the overall % {\PFE} editor window to cover less of the screen. % (drag the right and bottom edges closer to the edges % of the `Untitled1' window). Then click on the editor window % labelled `Untitled1' and type something like `ÛHello World!Û,' followed by `Û\endÛ'. That is all you need if you are using Computer Modern fonts. If you are using Lucida Bright fonts % or \MathTime\ fonts, insert `Û\input lcdplainÛ' at the beginning of the file. % respectively If you are using \MathTime\ fonts insert instead `Û\input mtplainÛ. % (or `Û\input mtplainxÛ' if you also have the \MathTime\ Plus fonts). % Next, if you are using {\TEXNANSI} (LY1) encoding with non-CM fonts % then add `Û\input texnansiÛ' % after the above. (If you are using Windows {\ANSI} encoding % then add `Û\input ansiacceÛ' instead). Finally, select `File{\down}Save.' You will be presented with a `File Save' dialog. % box. Navigate to the folder % directory that you wish to use for {\TeX} input files (perhaps Ûc:\texinputÛ), enter {\tt hello.tex} for the File Name, and click `OK'. Now that the file has been saved, click on {\DVIWindo}'s window to give it the input focus again. Select `TeX{\down}plain TeX'. Use the File Open dialog box that appears to select the file that you have just saved. \yandytex\ will run in a window that disappears when it finishes (unless there was an error). Now select `TeX{\down}Preview' to see the typeset result. (If you don't see it right away, try `File{\down}Default Scale'). You can also open the DVI file directly from `File{\down}Open.' At this point click on the % {\PFE} editor window to get its attention again, and add Û$z=\sqrt{x^2+y^2}$Û just before the Û\endÛ. This time type Ctrl+S to save the modified file. Then type \ang{Alt-Tab} to return input focus to {\DVIWindo}'s window, % click on {\DVIWindo}'s window again (or and use the F5 function key to call plain {\TeX}. The preview will be automatically refreshed when {\TeX} has finished producing Ûhello.dviÛ from Ûhello.texÛ. You will notice how once you get going, there is little need to interact with % File Open dialog boxes. Also, most things in the editor can be accomplished using the tool bar instead of the pull down menus. And judicious use of `hot keys' % in {\DVIWindo} can speed up the edit-{\TeX}-preview cycle. % In the above, it took just three key strokes (Ctrl+S, \ang{Alt-Tab}, F5), to refresh the preview after making changes in the {\TeX} source file. % \yandytex\ is so fast that you can get almost instantaneous screen updates on short source files. % (such as this manual). There are some sample `Hello World' test files already set up for you to look at in the `texinput' subfolder of your `yandy' folder. Look for `ÛHello_CMÛ,' `ÛHello_LBÛ,' `ÛHello_MTÛ,' or `ÛHello_EMÛ' --- the last two letters in the name denote the font set for which the file is designed. You will find both `source' files (extension Û.texÛ) and corresponding Û.dviÛ files. These sample files are set up for {\LaTeXe}. You can open the Û.dviÛ files from `File{\down}Open'. The corresponding source files can be opened with the editor from the `TeX Menu' as described in the next section. % \section{Using the \yandytex\ System} \section{Using the \yandytexBold\ System} % % This section focuses on the `edit--{\TeX}--preview' cycle alluded to % in the introduction. % earlier. The heart of the system is {\DVIWindo}, the previewer. Your editor, {\TeX} itself, the printer drivers, and other programs are all called from here. % the previewer. % 's `TeX' menu. You call {\TeX} or {\LaTeX} from {\DVIWindo}'s `TeX' menu. Installation sets up `hot keys' that make this particularly easy --- just press F5 for plain {\TeX}, F6 for {\AMS} {\TeX}, F7 for {\LaTeX}~2.09, and F8 for {\LaTeXe}. The hot keys are listed in the menu itself for easy reference --- and of course, you can customize them --- as explained later. Note that you do not need to close the preview when you call {\TeX}. The preview is automatically refreshed when {\DVIWindo} notices that the Û.dviÛ file has been `re-compiled.' The editor is also called from {\DVIWindo}'s `TeX' menu. Installation sets up convenient hot keys. % for the {\PFE} editor --- Just press F9, and % {\PFE} the editor will pop up with the {\TeX} source file corresponding to the Û.dviÛ file % currently currently being viewed (see section~3.3.2 % customizing the `TeX' menu on how to link in your own editor instead). %% section? Of course, when you start, you may not be viewing a Û.dviÛ file. In this case you will be presented instead with a `File Open' dialog box so that you can select a {\TeX} source file for the editor to open. % Initially, you may not have a source file to open. If you want to start on a fresh file, just enter % ! (exclamation mark) an exclamation mark (!) instead of a file name. % some repetition of material in Tutorial ? % or `nul' If you are viewing a Û.dviÛ file and want to edit a file {\it other\/} than the corresponding source file, % If you want instead to select a different file, then hold down the `Shift' key while calling the editor --- the `File Open' dialog will pop up. % After editing the file and running {\TeX}, use `Tex{\down}Preview' to view the corresponding Û.dviÛ file. You won't need to use `Tex{\down}Preview' % once you get going, later on, since the previewer will already be `connected' to the appropriate Û.dviÛ file. % You may print either from the `File{\down}Print' dialog box or directly % from the {\DOS} command line. You print from the `File{\down}Print' dialog box in {\DVIWindo}. % If you have installed {\DVIPSONE}, then you can check the For Post\-Script output devices check the `Use DVIPSONE' box % for Post\-Script output devices (You {\it can\/} use Microsoft's or Adobe's Post\-Script printer drivers, but they do {\it not\/} have any of the advanced features of {\DVIPSONE} --- such as partial font downloading and on-the-fly font reencoding). For non-PS devices % Otherwise the standard Windows printer drivers will be used. % are used. Note that you can {\it also\/} use \yandytex\ and {\DVIPSONE} as `console applications' % or directly from the {\DOS} command line. from the command prompt. This may be useful in some cases % rare % were you may want if you want to process several files in batch mode, or gain direct control over processing options using command line flags. % and command line arguments. % For each application You can get a list of commonly used command line options by invoking either application with Û-?Û on the command line. For additional information refer to the Technical Addendum or the Ûreadme.txtÛ file in the corresponding application folder (i.e. the Û\yandytexÛ and Û\dvipsoneÛ subfolders) --- % directory --- these each give a list of command line options. You can add command line option passed to these programs when they are called from {\DVIWindo} using `Preferences{\down}Command Line.' \subsect{The Edit--\TeX--Preview Cycle} % % The following sections expand on the elements of this process. % The following expands on the edit--\TeX--preview cycle in \yandytex. This section focuses on the `edit--{\TeX}--preview' cycle alluded to earlier. % introduction. % If your monitor has enough screen resolution, you % most likely will find that the most efficient way to operate is to use overlapping --- or side-by-side --- windows. % (as opposed to running every application full screen). If both {\DVIWindo} and the editor window are visible, then you can switch between them simply by clicking on a visible part % corner of the window that you would like next to receive the input focus. % (By the way, for high quality display, it is a good idea to use as high a screen resolution as your video board supports. You can control the screen resolution from `Start > Settings > Control Panel > Display.') If your monitor has limited screen resolution, then you may instead wish to run {\DVIWindo} and the editor full screen. To switch between them in this case % simply use Windows' standard method: hold down the `Alt' key and press % `Tab' \ang{Tab} until you get to the desired window % (to step in reverse order, hold down the `Shift' key as well). Alternatively, you can use the `TeX' menu to transfer control to the editor. Installation creates entries that {\it switch\/} to a window (rather than {\it launching\/} a new copy of an application). % the editor). By convention such entries are marked with an initial `Û->Û' in the `TeX' menu. Like all other entries in the `TeX' menu, these may be associated with hot keys. % also. For example, to switch to the % {\PFE} editor window, hold down the `Ctrl' key and hit F9 (denoted C-F9 in the `TeX' menu). % \subsect{The {\tt dviwindo.ini} File} \subsect{The {\secttt dviwindo.ini} File} % Preferences and user customizations % for the system are saved in Ûdviwindo.iniÛ in your `windows' or `winnt' folder. % The Ûdviwindo.iniÛ file has several sections, including: \nlist \item Û[Window] Û\quad{\DVIWindo}'s preferences (`Preferences' menu); % in {\DVIWindo} % reversed order of the two following 95/Sep/27 \item Û[Environment] Û\quad The `environment variables;' \item Û[Applications]Û\quad Plain {\ASCII} representation of the `TeX' menu. % \item Û[Documents] Û\quad Names of the most recently used Û.dviÛ files; % \item Û[Registration]Û \endlist \noindent The environment variables tell various components of the \yandytex\ System where files are located, as well as general preferences you have expressed during installation. % The environment variables can be edited from {\DVIWindo}'s `Preferences{\down}Environment Variables' menu. % The Û[Environment]Û section is typically the only part of Ûdviwindo.iniÛ that you may want to make adjustments to. % Actually, if you have installed the \yandytex\ System as described in % section~2, then you may well never have to even % look at the [Environment] section. % of % at the Ûdviwindo.iniÛ. % file. % If you did not install it the standard way, then you may. % The gory details of the menu implementation are in the Ûreadme.txtÛ and % Ûnews.txtÛ files in the Û\dviwindoÛ directory. % Here, we will discuss the environment variables. % % Next, we will discuss the environment variables. % Anyway, Here follows a sample Û[Environment]Û section: % \hskip12bpÛc:\yandytex\latex2e;c:\yandytex\ams\amstexÛ \beginlines Û[Environment]Û ÛYANDYPATH=c:\yandyÛ ÛTEXFORMATS=c:\yandy\yandytex\fmtÛ ÛTEXPOOL=c:\yandy\yandytex\fmtÛ ÛPSFONTS=c:\psfonts;c:\winnt\fontsÛ ÛPSPATH=c:\eps;c:\tiff;c:\wmfÛ ÛVECPATH=c:\yandy\fonts\encodingÛ ÛPREPATH=c:\yandy\dvipsoneÛ ÛSUBPATH=c:\yandy\dvipsone\subÛ ÛTEXINPUTS=c:\yandy\texinput;c:\yandy\tex\base\\Û ÛAMSTEX=c:\yandy\texinput;c:\yandy\tex\base\\Û ÛLPLAIN=c:\yandy\texinput;c:\yandy\tex\latex209\\;c:\yandy\tex\base\\Û ÛLATEX=c:\yandy\texinput;c:\yandy\tex\latex\\;c:\yandy\tex\base\\Û ÛENCODING=texnansiÛ ÛTEXFONTS=c:\yandy\fonts\tfm;c:\yandy\fonts\Û ÛTEXNANSI=c:\yandy\fonts\tfm\texnansi\tfm\\;c:\yandy\fonts\tfm\nontext\Û ÛANSINEW=c:\yandy\fonts\tfm\ansinew\tfm\\;d:\yandy\fonts\tfm\nontext\Û \endlines % ÛTEXANSI=0Û % ÛDUMMY=1Û \noindent % These environment variables can also be changed % by editing Ûdviwindo.iniÛ using any plain {\ASCII} text editor % such as `Notepad,' `WordPad,' `WinEdt' or {\PFE}. % If you want to edit Ûdviwindo.iniÛ simply open it in some plain text editor like Notepad, Wordpad, WinEdt or {\PFE}. A `{\DVIWindo} {\sc ini}' icon is already set up ({\it not\/} the `{\DVIWindo}' icon itself) for this purpose. This launches `Notepad' and reads Ûdviwindo.iniÛ from the Windows folder. % % The environment variables are listed in the % Û[Environment]Û section. After making changes, select `File{\down}Save' and then `File{\down}Exit.' \tip % Advanced Feature: If a folder in a list of folders ends with a backslash (Û\Û), then {\TeX} will {\it also\/} search first level subfolders % subdirectories of that folder. % directory. If it ends with a {\it double\/} backslash (Û\\Û) then {\TeX} will search {\it all\/} subfolders % subdirectories recursively (Use these capabilities sparingly --- it takes extra time to search complex trees of folders). %% the above is repeated later If your Ûdviwindo.iniÛ file is missing entries for some of the environment variables, then the \yandytex\ System may not find all of the files it needs ({\it unless\/} you happen to have installed all system components in the standard folders). % directories). If a problem does arise, then we recommend that you edit your Ûdviwindo.iniÛ file. You'll know there's a problem if \TeX\ complains: \beginlines ÛSorry, I can't find that format; will try the default.Û, or perhaps Û! I can't find file Û `\angi{file\-name}.' \endlines \noindent If the corresponding files {\it do\/} exist, then the problem most likely is with the environment variables. % The same may be true when {\TeX} can't find font metric (Û.tfmÛ) files. % By the way, older versions of \yandytex\ % (as well as many other {\TeX} systems) % (as well as most of our competitors) % used {\DOS} environment variables instead of % an `ini' file for this purpose. % the Û[Environment]Û section of Ûdviwindo.iniÛ. % give forward reference to: % Sometimes it is convenient to change environment variables when working on % hmm, is this really a good idea ??? %%% autoexec.nt and config.nt are the defaults used %%% can set a command prompt up to use some other files... %% use bulleted list for following? \subsub{What the Environment Variables Mean} % \ulist \item ÛTEXINPUTSÛ\quad Where \TeX\ style- and source files may be found -- {\it unless\/} a `format specific' environment variables overrides this --- see below. % reference to same section This is {\it one\/} environment variable you may actually find yourself modifying as you add more folders % directories with {\TeX} style files. Installation sets this to a semicolon-separated list, e.g., \beginlines ÛTEXINPUTS=c:\texinput;c:\yandy\texinput;c:\yandy\tex\base\\Û \endlines % ÛTEXINPUTS=c:\texinput;c:\letters;c:\books;c:\yandytex\latexÛ \noindent The installation program puts folders with plain {\TeX} files and miscellaneous other useful files supplied with the system on this list and asks for additional folders during installation. % Note the Û\\Û at the end of the entry for the Û\tex\baseÛ subfolders. % subdirectory. This invokes recursive subfolder search. That is, files in this folder % directory and {\it all\/} subfolders below it are included. % (typically Ûc:\yandytex\latexÛ). %% used when ini-TeX is run \endlist %%% what about format specific `TEXINPUTS' ??? \noindent By the way, \yandytex\ always searches the current directory % folder first when looking for input files, so there is no need to add `Û.;Û' to the list of folders % directories in ÛTEXINPUTSÛ. % \endlist \tip % Advanced Feature: If you have an environment variable with the {\it same\/} name as the current `format' % being used % you are using, then {\it its\/} value will be used by {\TeX} {\it instead} of the value of ÛTEXINPUTSÛ. % Hence variables named % ÛPLAINÛ, ÛLPLAINÛ, ÛLATEXÛ, and ÛAMSTEXÛ % are used instead of ÛTEXINPUTSÛ when you use % plain {\TeX}, {\LaTeX} 2.09, {\LaTeXe}, and {\AMS} {\TeX} respectively. % This is particularly convenient when two `formats' (such as {\LaTeX}~2.09 and {\LaTeXe}) use different style files with the same name % but quite different content. (which otherwise could be quite confusing!). You can, for example, have `format specific' environment variables named: \ulist \item \quad ÛPLAIN Û\quad folders with \TeX\ source files for plain {\TeX}; \item \quad ÛAMSTEXÛ\quad folders with \TeX\ source files for {\AMS} {\TeX}; \item \quad ÛLPLAINÛ\quad folders with \TeX\ source files for {\LaTeX} 2.09; \item \quad ÛLATEX Û\quad folders with \TeX\ source files for {\LaTeXe}. \endlist \noindent The names derive from the names % is because of the corresponding format files: % are called Ûplain.fmtÛ, Ûamstex.fmtÛ, Ûlplain.fmtÛ, and Ûlatex.fmtÛ. % respectively. Note that these `format specific' environment variables must {\it also\/} list the folders % directories containing your own \TeX\ source files --- as in ÛTEXINPUTSÛ --- since the list is used {\it instead\/} of the default % list provided by ÛTEXINPUTSÛ, rather than being appended to that list. Also note that ini-{\TeX} {\it does\/} refer to ÛTEXINPUTSÛ, since no formats are pre\-loaded when it runs. So should you ever have to use ini-{\TeX}, make sure that all the folders you will be referring to are listed in ÛTEXINPUTSÛ (or alternatively that all files needed are in the current directory where you run ini-{\TeX}). %% ini TeX refers to TEXINPUTS ... \ulist \item ÛTEXFONTSÛ\quad Where \TeX\ Û.tfmÛ metric files may be found (actually, typically an `encoding specific' variable will be used in stead of ÛTEXFONTSÛ --- see below). % The installation adds references to the appropriate directories. % the Û\fontsÛ subfolder % subdirectory % to this list. % The Û\Û after ÛfontsÛ invokes one-level down subfolder % subdirectory % search. % (see below). % TEXFONTS=c:\yandy\fonts\tfm;c:\yandy\fonts\Û % not needed if all Û.tfmÛ files are in subdirectories % of the default ÛfontsÛ subdirectory. \endlist \noindent The first folder in the ÛTEXFONTSÛ list is where new Û.tfmÛ files created by `WriteTFM\ellipsis' and {\AFMtoTFM} are deposited --- see section~3.7.2. It may also be where the Ûtexfonts.mapÛ font name aliasing file is found --- see section~3.7.3. \tip % Advanced Feature: If you have an environment variable with the {\it same\/} name as the current text font encoding, then its value will be used % by {\TeX} {\it instead} of the value of ÛTEXFONTSÛ. % This makes it easy to switch font encoding from `Fonts{\down}Encoding' in {\DVIWindo}. The default installation, for example, sets up % You can, for example, have `encoding specific' environment variables named: \ulist \item \quad ÛTEXNANSI Û\quad folders with {\TFM} files for {\TEXNANSI} (LY1); \item \quad ÛANSINEWÛ\quad folders with {\TFM} files for Windows ANSI; \item \quad ÛTEX256Û\quad folders with {\TFM} files for Cork (T1); \item \quad ÛTEXTEXTÛ\quad folders with {\TFM} files for TeX Text (OT1). \item \quad ÛSTANDARDÛ\quad folders with {\TFM} files for Adobe Standard Encoding. \endlist \noindent The following optional environment variables are {\it only\/} needed if files do not end up in the default places: \ulist \item ÛTEXFORMATSÛ\quad Where \TeX\ format files may be found; not needed if all Û.fmtÛ files are in the default Û\fmtÛ subfolder. % subdirectory. \vskip .05in \item ÛTEXPOOLÛ\quad Where \TeX's `string pool' file may be found; not needed if the file Ûtex.poolÛ (used only by ini-\TeX) is in the Û\fmtÛ subfolder. % subdirectory. % or tex.pool ... \vskip .05in \item ÛYANDYPATHÛ\quad Where the \yandytex\ System is installed. Some system components use this to find other system files. \endlist \noindent {\DVIPSONE} needs the following environment variable: % needs to know where the Type~1 outline font files (Û.pfbÛ) are kept: \ulist \item ÛPSFONTSÛ\quad Where Post\-Script Type~1 outline font files (i.e. Û.pfbÛ files) may be found. % It is Set to a semicolon-separated list of folders. % directories. The installation procedure normally figures out (from Ûatm.iniÛ, Ûatmreg.atmÛ, the registry, or the `font' folder) where Û.pfbÛ files are kept --- typically it is Ûc:\psfontsÛ or Ûc:\winnt\fontsÛ. % or Ûc:\winnt\fontsÛ. %% what if it is NT does it set it up for c:\windows\fonts ??? % In systems without {\ATM} this may instead be the Û\fontsÛ % subfolder of the ÛwindowsÛ or ÛwinntÛ folder. % This environment variable may not be set correctly if, by mistake, you install the system {\it before\/} installing any of the fonts. \endlist \noindent The following is needed only if you want to call an editor directly from {\TeX} when it hits an error % (that is, when (and you respond % with the choice ÛeÛ to {\TeX}'s error prompt). by typing `ÛeÛ' at {\TeX}'s error prompt). This is not used much, since it is % typically usually more convenient to just go back to the editor window that is already open. \ulist \item ÛTEXEDITÛ\quad A command-line string used when calling an editor from {\TeX}. % when it hits an error. This string may contain: Û%dÛ (replaced with the line number), Û%sÛ (replaced with the \TeX\ source file name), and Û%lÛ (replaced with the \TeX\ Û.logÛ file name), e.g., \beginlines ÛTEXEDIT=c:\yandy\WinEdt\WinEdt.exe [Open('%s');SelLine(%d,8)]Û, or ÛTEXEDIT=c:\yandy\pfe\pfe32.exe /g %d %sÛ, or ÛTEXEDIT="c:\Program Files\eps90\bin\epsilon.exe" +%d %sÛ \endlines \endlist % NOT: ÛTEXEDIT=c:\epsilon\bin\epsilon.exe %s +%dÛ % TEXEDIT=c:\tools\cmds\vi +%d %s % You need to use Û%%Û in place of Û%Û in a {\DOS} batch file... \noindent You can call for graphics inclusions (Û.epsÛ, Û.tiffÛ, Û.bmpÛ, or Û.wmfÛ files) using their fully qualified names --- as long as you replace Û\Û with Û/Û in the file name so as to avoid confusing {\TeX}. You can give just the file names --- without path --- if you set up the following environment variable: \ulist \item ÛPSPATHÛ\quad Semicolon-separated list of folders % directories in which inserted {\EPS} (Û.epsÛ) files, Post\-Script headers, {\TIFF} (Û.tifÛ) files, {\BMP} (Û.bmpÛ) files, and Windows Meta\-Files (Û.wmfÛ) are searched for. The installation program asks for the folders in this list. % and adds to TEXINPUTS directories... \endlist \noindent Note that if your figure inclusion macros also make {\TeX} read the {\EPS} files to extract bounding box information, then the directory with {\EPS} should {\it also\/} be appended to your ÛTEXINPUTSÛ environment variable --- or rather the corresponding `format specific' environment variable. %% move following to technical addendum ??? % \TeX\ normally writes its output files in the current directory. If you % want to redirect them, then set the following environment variables: % \ulist % \item ÛTEXDVIÛ\quad Set only if you want \yandytex\ to redirect % Û.dviÛ file output. If defined, {\DVIWindo} looks for Û.dviÛ files % to `Preview' in this directory rather than in the `TeX' menu default. % \item ÛTEXLOGÛ\quad A directory for Û.logÛ files. % \item ÛTEXAUXÛ\quad A directory for Û.auxÛ files. % \endlist % advanced stuff ? %% flush following ? banish to Technical Addendum ??? % Sometimes it is convenient to redirect specific types of files % produced by {\TeX}. % % You can use the environment variables % ÛTEXDVIÛ, ÛTEXAUXÛ, and ÛTEXLOGÛ to redirect % Û.dviÛ, Û.auxÛ, and Û.logÛ files respectively % (If ÛTEXDVIÛ is set, {\DVIWindo} will look for Û.dviÛ % files in the specified directory). % following is somewhat optional - also maybe in an odd place. % advanced stuff ? Discussed earlier % Different {\TeX} `formats' typically work with different style files. % This may lead to conflicts between style files % that have the same % with the same names % but are % designed for different formats. % In this case, it is convenient to have a different list of directories % when different \TeX\ formats are used. % \tip % Advanced Feature: % If \yandytex\ finds an environment variable with a name equal to that of the % format selected on the command line, then it will use the value of % {\it that\/} variable instead of the default ÛTEXINPUTSÛ. % So you could, for example, have environment variables named: % moved earlier % \noindent % which list directories with style files for % plain {\TeX} (Ûplain.fmtÛ), \LaTeX\ 2.09 (Ûlplain.fmtÛ) and \LaTeXe\ % (Ûlatex.fmtÛ), respectively. % This is because % the corresponding format files are called % Ûplain.fmtÛ, Ûlplain.fmtÛ, and Ûlatex.fmtÛ, respectively. The variable ÛENCODINGÛ specifies the font encoding (character layout) for non-CM text fonts. This is initially set during installation and can be changed using `Fonts{\down}Encoding' in {\DVIWindo}. the default % on systems with {\ATM} is `ÛtexnansiÛ' --- for {\TEXNANSI} (LY1) encoding (see section~6 for detailed character layout): %% section? \beginlines ÛENCODING=texnansiÛ \endlines % \noindent % In a Windows NT system running without {\ATM} % the ÛENCODINGÛ environment variable should {\it not\/} be set % since % (i) TrueType fonts cannot be reencoded and (ii) TrueType text fonts are % set up for `Windows ANSI' encoding. % $In this case ÛTEXANSIÛ should be set to 1 as described % $next. % in the following. % The above refers to an encoding vector file Ûtexnansi.vecÛ in the % directory specified by ÛVECPATHÛ (see below). %% section? % % If you do use `texnansi' encoding, then you should also add a line % of the form Û\input texnansiÛ to your {\TeX} source file. % Do the above in more detail somewhere else? % The following will be set to Û1Û if you % {\it instead\/} % indicated during installation that you want % to use Windows {\ANSI} (ÛansinewÛ) encoding --- % as is appropriate for a Windows NT system without {\ATM}: % \beginlines % ÛTEXANSI=1Û % \endlines % \noindent % The above is required if you use plain text fonts with Windows {\ANSI} % encoding in {\DVIWindo}. % and other Windows applications. % Windows {\ANSI} (Ûansinew.vecÛ) is the default character layout used by % Windows applications. % Windows and % most % % If you do use `ansinew' encoding, then you should also add a line % of the form Û\input ansiacceÛ to your {\TeX} source file. % The environment variables ÛENCODINGÛ and ÛTEXANSIÛ are mutually % exclusive --- use one {\it or\/} the other, not both. % % Also note that the environment variable ÛTEXANSIÛ % has nothing to do with `texnansi' encoding --- % it's an unfortunate historical accident that the names are so similar. % Sorry about that! % of near coincidence in spelling\ellipsis % \ldots % % For additional details please refer to section~6, % `Font Encoding and Character Layout.' %% What to do if you change encoding ??? \noindent Note that if you change the ÛENCODINGÛ environment variable, TFM metric files will be taken from a different place as dictated by `encoding specific' environment variables. Installation sets up parallel trees of folders with TFM files for this purpose. % you must {\it also\/} change the Û.tfmÛ {\TeX} metric files to the ones % appropriate for that encoding (see section~3.7.1). % ??? The following optional environment variables are {\it only\/} needed if files do not end up in the standard places: \ulist \item ÛVECPATHÛ\quad Where encoding vector files may be found. The default is the Û\fonts\encodingÛ subfolder. % subdirectory. % {\DVIWindo} uses the ÛVECPATHÛ variable to find encoding vector files % when you select `Write TFM\ellipsis' or `Write AFM\ellipsis' in the `Fonts' % menu. % (See section on `Font Encoding' for additional details). %% section? % \endlist \endlist % What about Write All TFMs... ??? \noindent {\DVIWindo} uses the ÛVECPATHÛ variable to find the encoding vector specified by the ÛENCODINGÛ environment variable, % well isn't that just the same ??? we can no longer choose ... as well as encoding vector files needed when you select `Write TFM\ellipsis' or `Write AFM\ellipsis' in the `Fonts' menu. % and `Write All AFMs\ellipsis' and `Write All TFMs\ellipsis' ... % (See section on `Font Encoding' for additional details). %% section? % % {\DVIWindo} also uses ÛVECPATHÛ when it looks for the encoding vector % specified by the ÛENCODINGÛ environment variable. % \noindent % An encoding vector file is a plain {\ASCII} file that gives the mapping % from character codes (in the range 0--255) to glyph names. % % We recommend the `texnansi' encoding vector since it provides access to % all 228 glyphs in plain text fonts, yet matches most of the hard-wired % assumptions that {\TeX} makes about where accents and various special % characters appears in the character layout. \ulist \item ÛSUBPATHÛ\quad Where font substitution files may be found. The default is the Û\dvipsone\subÛ subfolder. % subdirectory. % (or its ÛsubÛ subdirectory) \endlist \noindent A font substitution file can, for example, be used to let {\DVIPSONE} know which fonts are printer resident (so it won't include them in the Post\-Script output). The standard substitution file (read when you do not explicitly specify a font substitution file on the command line) is called Ûstandard.subÛ and lists Times-Roman, Helvetica, Courier, % and Symbol, and Zapf Dingbats as printer resident. Refer to the Technical Addendum for more esoteric uses of font substitution files. % (see later for details). %% section? technical addendum ? % refer them to DVIPSONE manual ? \ulist \item ÛPREPATHÛ\quad Where {\DVIPSONE} % (and ÛPKtoPSÛ) preamble files may be found. The default is the Û\dvipsoneÛ subfolder. % subdirectory. \endlist % also for PKtoPS %%% dvipsone.bat ??? \noindent {\DVIWindo} adds the `Use DVIPSONE' checkbox to the `Print' dialog box only if it can find {\DVIPSONE}. % Ûdvipsone.exeÛ. % {\DVIPSONE}. {\DVIWindo} looks for {\DVIPSONE} along the % {\DOS} ÛPATHÛ (set in Ûautoexec.batÛ in Windows~95/98 and from `Control Panel{\down}System{\down}Environment' in Windows~NT). % Ûautoexec.ntÛ) % ??? and in the default folder. If this fails, it tries to find {\DVIPSONE} in the folder specified in ÛPREPATHÛ. % (as well as ÛVECPATHÛ). So if the `Use DVIPSONE' check box is missing, try setting ÛPREPATHÛ % (or ÛVECPATHÛ) to the folder % directory where {\DVIPSONE} may be found. % See below for a description of these environment variables. %% section? % {\DVIWindo} also uses ÛVECPATHÛ when it looks for the encoding vector % specified in the {\sc encoding} environment. % following is somewhat optional ? % Note that it is possible with some software to write ``scripts'' that can % edit Ûdviwindo.iniÛ; this may be more convenient than using % {\DOS} environment variables and Û.batÛ files. \subsub{The [Window] section of dviwindo.ini} % The other part of Ûdviwindo.iniÛ that may be of occasional interest is the Û[Window]Û section, which stores preferences and state information. % other useful information. % \noindent \TeX\ normally writes all of its output files in the `current directory.' When called from {\DVIWindo}, the current directory will be {\it either\/} % that {\TeX} has been asked to process \beginlines (i) the directory of the {\TeX} source file, {\it or\/} (ii) the common working directory, \endlines \noindent all depending on whether you elected to specify a working % common directory during installation (see installation instructions % for {\DVIWindo} --- section~2.4). %% check section ??? % % The working directory % folder % selected during installation is recorded % in the ÛWorkingDirectoryÛ entry in the Û[Window]Û % section of Ûdviwindo.iniÛ. % Note that this is % ({\it not\/} the Û[Environment]Û section). % and can be changed there. The working directory selected during installation is recorded in the ÛWorkingDirectoryÛ entry in the Û[Window]Û section. If you do not want to use a common working directory remove this line or comment it out using a semicolon (;). Conversely, to use e.g. Ûc:\workingÛ as a common working directory add \beginlines ÛWorkingDirectory=c:\workingÛ \endlines \noindent to the Û[Window]Û section. % You can also temporarily toggle the `Working Directory' option using % `Fonts{\down}Working Directory' `Special{\down}Working Directory' in {\DVIWindo}. If applications called from the `TeX Menu' cannot handle file names with backslash (\char92) then add \beginlines ÛDeslash=1Û \endlines \noindent to the Û[Window]Û section. This requests that {\DVIWindo} convert Û\Û to Û/Û on the command line before % when calling other applications. You can control command line arguments passed to {\yandytex}, {\DVIPSONE}, and {\AFMtoTFM} using `Preferences{\down}Command Line' in {\DVIWindo}. This information is recorded in the ÛWindowÛ section of Ûdviwindo.iniÛ. % also makes it possible to pass command line arguments to {\DVIPSONE}, % {\yandytex}, and {\AFMtoTFM} when called from {\DVIWindo}. The values associated with the keys ÛDVIPSONEÛ, ÛTeXÛ, and ÛAFMtoTFMÛ defined in the Û[Window]Û section record this information. For example: \beginlines ÛTeX=-w -jÛ % -j \endlines \noindent % tells {\yandytex} to truncate long file names to {\DOS} 8+3 % file name convention. tells {\yandytex} to show accented characters on screen and in the log file instead of coverting them to hexadecimal notation. % You can also use this line to change exactly {\it what\/} is called. For example, to call Ûdvipsone.batÛ, with command line argument Û-vÛ, instead of Ûdvipsone.exeÛ when printing use \beginlines % ÛDVIPSONE=dvipsone.bat -vÛ ÛDVIPSONE=c:\yandy\dvipsone\dvipsone.bat -vÛ \endlines % \noindent (this assumes % assuming % that Ûdvipsone.batÛ is somewhere on your path). % The Û[Applications]Û section of Ûdviwindo.iniÛ % contains the `TeX' menu and is discussed in the section % on {\DVIWindo} below. % section~3.3 % \subsect{\yandytexBold} \subsect{DVIWindo} % If you're viewing a Û.dviÛ file, and use the `TeX' menu (or a hot key) to `re-{\TeX}' the corresponding source file, you will find that the preview is automatically refreshed as soon as {\TeX} finishes running. The page number, zoom factor, and viewing position are all preserved (unless, of course, you happen to be looking at a page that disappeared because of changes in the source file). % If another window has the focus at this point, simply click on a visible part % corner of the {\DVIWindo} window to get its attention. Alternatively hit \ang{Alt-Tab} repeatedly. % until {\DVIWindo} has the focus again. % (if the number of pages has changed, this may not be true). % Alternatively, click on a visible corner of the {\DVIWindo} window, % or hit \ang{Alt-Tab} until you are there. % once or twice and 'll be % While {\DVIWindo} does not come with a traditional Windows Help file, % it does have Ûdvi_help.dviÛ --- a Û.dviÛ file with hypertext links % created by Dr. Donald P. Story. Installation sets up an icon for this file. % You can also call it from the `TeX' menu. {\DVIWindo} comes with a help file % (written in \TeX) that exploits {\DVIWindo}'s support for color and hypertext links. This file --- Ûdvi_help.dviÛ --- was kindly provided by Dr. Donald P. Story of the University of Akron. % {\DVIWindo} installation sets up an icon for this file. % Just double-click on this icon Just hit the F1 function key % (or select `TeX{\down}Help') (or select `Help{\down}Help') while in {\DVIWindo} to see the first page, which has an explanation of how to use the help file. %%% Or from the `Help' menu ??? \subsub{Mouse Tricks and Accelerator Keys} % Most operations in {\DVIWindo} are easily discovered % assimilated % discovered as you work with it, since they are listed as menu items. % accessed via menu items. There are, however, `mouse tricks' % and several accelerator keys (hot keys) % worth noting here, that may not be immediately apparent, since they do not appear in the menus, as well as accelerator keys (hot keys) that you may have missed. Three of the `mouse tricks' depend on defining a rectangular area. In each case, the top left corner is fixed when you first press the left mouse button. You extend the rectangle by dragging the mouse while holding the left mouse button --- the mouse controls the right bottom corner. The rectangle can be moved --- instead of resized --- if you {\it also\/} hold down the {\it right\/} mouse button. % you can reposition the whole rectangle without changing its shape. The final shape and position of the rectangle is the one in effect when you release the left mouse button. The % actual action taken when you define the rectangle depends on which combination of `Shift' and `Ctrl' keys are held down when you first press the left mouse button. \blist \item You can create a `Zoom In' rectangle by holding down the `Ctrl' key and using the mouse to define a rectangle as explained above. The aspect ratio of the rectangle in this case is constrained to be the same as that of {\DVIWindo}'s window. % that The rectangle % region shown % is what will be blown up to fit into the window when you finally release the left mouse button. % to zoom in Later, you can click the {\it right\/} mouse button to undo the `Zoom.' \item You can create a `Ruler' rectangle % in a similar fashion by holding down the `Shift' key instead. This is useful for measuring % horizontal and vertical distances. You may want to zoom in first if you want to make accurate % fine measurements. Go to `Preferences\ellipsis{\down}Ruler Units' to select the ruler units. (Note that this feature is disabled when the `Fonts Used' list is showing.) \item You can also create a `Copy' rectangle defining a rectangular region to be copied to the Windows clipboard by holding down {\it both\/} the `Shift' and `Ctrl' keys. % while defining a rectangle using the mouse. The material copied may be pasted into other Windows applications, and positioned, sized and clipped there. This is a convenient way to insert mathematics typeset using {\TeX} into typical {\sc wysiwyg}-type applications. % (Note that this feature is disabled when the `Fonts Used' list is showing.) \item You can reposition the page in the window simply by holding down the `Alt' key and the left mouse button. % and moving the mouse allows you to position the page on the screen. Just drag the page around by moving the mouse. \item You can refresh the display --- should it ever become corrupted --- % by double clicking on the window. by hitting the `Enter' key. % changed \item Space and Backspace move forward and backward a % one page, keeping the current zoom factor and position on the page. \item `PgDn' goes to the top of the next page. `PgUp' goes to the bottom of the previous. % page. \item The `Home' and `End' keys take you to the beginning and the end of the current page respectively. \item The `Ctrl-Home' and `Ctrl-End' keys take you to the beginning and the end of the file respectively % or use |<- and ->| (or use Û|<-Û and Û->|Û). \item You can move to a new page by typing in a page number --- using the top row of the keyboard --- and then hitting the \ang{Enter} key. % return. % \item The numeric keypad's Û+Û and Û-Û zoom in and out one step. % \item The numeric keypad's + and - zoom in and out one step. % respectively. \item Ctrl+R opens the `Find' dialog box; % Ctrl+S repeats the previous search. % You can close the `Find' dialog box after the first search, you can check a box to close the `Find' dialog box after the first search, yet continue using Ctrl+S, which repeats the previous search. % we don't say much about search in DVI files ... should we? \item \ang{Ins} % `Ins' (from the numerical keypad) closes the current file (if any) and opens the `File Open' dialog box. Note that % when you start, you can quickly go back to the file you last viewed, % when you last exited {\DVIWindo} last, by double clicking on the {\DVIWindo} icon, hitting \ang{Ins} and then \ang{Enter}. \item \ang{Del} % `Del' closes the view of the current Û.dviÛ file. \item \ang{Esc} % `Esc' pops you out of {\DVIWindo} --- unless some % modeless --- remove or explain dialog boxes are being shown, in which case these are removed instead. % first. \endlist %%%% Should we discuss here color fonts, DVI Fonts List etc ? %%%% Ctrl+F goes to `Show Fonts' %%%% Ctrl+X toggles `color font' %%%% Shift click on character while `DVI Fonts Used' shows %%%% look in dvi_help for more `mouse tricks' ??? \noindent These commands cover the bulk of day-to-day use of {\DVIWindo}. % For the other features of the program (such as controlling color and viewing % {\TIFF}s and {\EPS} previews), please see the Technical Addendum. %% Does the following eliminate the need for the `TeX Menu Manual' ? \subsub{Customizing the `TeX' Menu} % The `TeX' menu is the `control center' or `shell' from which {\TeX} and other applications are called. The installation of the \yandytex\ System sets up a useful % initial `TeX' menu, but you may want to add entries, or modify existing entries. % To do this, hold down the `Ctrl' key before selecting an item from the menu. You can then \ulist \item (i) edit and replace an existing entry (select `Replace'), \vskip .05in \item (ii) add a new entry {\it after\/} the item selected (select `Add'), \vskip .05in \item (iii) add a separator line after the item selected (select `Separator'), \vskip .05in \item (iv) delete the item selected (select `Delete'), or % or \vskip .05in \item (v) delete the item {\it after\/} the item selected (select `Delete Next'). \endlist \noindent The last mentioned capability is useful for removing menu separator lines, since separators themselves cannot be selected. % directly The menu is organized as a series of `key=value' pairs. The key is the `Menu Item Name' that appears in the `TeX' menu, while the value is the `Application Call Pattern' that will be executed in response to selection of that key from the menu. % The first menu item is hard-wired to `Preview' the Û.dviÛ file corresponding to the last file {\TeX} source file selected. % for editing or processing using {\TeX}. As indicated before, this menu item is rarely used, since in most cases that Û.dviÛ file is already being displayed. % Usage with Borde & Rokicki's TeX Help ... Each menu item may be associated with a `hot key.' Hot keys can be function keys (written F1--F12), or function keys with the `Ctrl' key also held down (written C-F1--C-F12). The hot key designation follows the menu item name, with a vertical bar ($\,$|$\,$) used as a separator. Note that F1 is hard-wired for `Help,' C-F1 for `Preview.' and Windows reserves F10 --- which is equivalent to `Alt,' and in some versions of Windows --- and some laptops --- F11 and F12 are % also not available. % % The default hot key for `Preview' is C-F1. % The `value' associated with a `key' The `Application Call Pattern' can be any command line that calls % a {\DOS} or Windows program. a Windows program, console application or batch file. % (or {\DOS} program). Obviously, such a facility would be of limited utility if only a {\it fixed\/} string could be used, but simple string replacements on the `value' part provide added power: % added flexibility: % First of all, Reference can be made to any environment variable using the notation Û%Û\angi{env var name}Û%Û. % Second, an Û*Û (asterisk) is replaced with the name of the currently open Û.dviÛ file --- {\it sans\/} extension, or path. Third, % a semicolon-separated list of directories followed by the pattern \angi{list of dirs}Û#Û\angi{file name} % a Û#Û (number sign) and a file name triggers a search. % for the file in the listed directories. If a file with name \angi{file name} is found in one of the folders % directories in the semicolon separated list, then the full path name of that file replaces the pattern. % The resulting full path then replaces the % list of directories, the Û#Û, and the original filename. This is handy, since it makes it easy, for example, to insert the full path name of the {\TeX} % is not always trivial to locate the {\TeX} source file corresponding to the currently open Û.dviÛ file. This is no mean task, since it can be in any one of the folders % directories listed in ÛTEXINPUTSÛ. % Following the above rules, it is clear that {\DVIWindo} will search for that file in the list of source folders if the notation Û%TEXINPUTS%#*.texÛ is used. % Since this is such a common construction, Û@.texÛ is accepted as a shorthand notation for Û%TEXINPUTS%#*.texÛ. %% big question: is TEXINPUTS replaced with format specific ??? The pattern Û"Û\angi{arg name}\char124\angi{default value}Û"Û is replaced by text you are prompted to supply when the pattern is activated. The string \angi{arg name} appears in the title bar of a dialog box to indicate what information is requested, and \angi{default value} (if present) is offered as the default value. % also \angi{dir}Û?Û\angi{.ext} Now let us suppose that you would like to use the `xyz' editor, which lives in the Ûc:\xyzdirÛ folder; % directory; you want it attached to hot key Ctrl+F5, and this editor takes Û-vÛ and the file name as arguments on the command line. If you want the new entry to appear % in the `TeX' menu after the one for `Notepad,' hold down the `Ctrl' key and click on `Notepad' in the `TeX' menu. Then enter ÛXYZ|C-F5Û for the `Menu Item Name' (key), and Ûc:\xyzdir\xyz.exe -v @.texÛ for the `Application Call Pattern' (value). Then click `Add.' %% redundant ??? A file name inserted in the application call pattern normally uses Û\Û (backslash) as separator. Some applications cannot handle file names with backslashes. Add `ÛDeslash=1Û' to the Û[Window]Û section of Ûdviwindo.iniÛ to force {\DVIWindo} to convert % backslash to slash on the command line. Û\Û to Û/Û on the command line. Typically {\TeX} `formats' are listed last in the `TeX' menu. This makes it easy % for ini-{\TeX} to append a new format when you create it. % Assuming Û[Applications]Û section is last in dviwindo.ini Of course, you can insert new formats anywhere in the menu simply using an application call pattern of the form: \beginlines Ûc:\yandy\yandytex\tex.bat +Û\angi{format file name}Û @.texÛ \endlines % Ûtex.bat +Û\angi{format file name}Û @.texÛ \noindent Note the use of `+' as an alternative to `\&' before the format name --- this prevents problems in Windows~NT where ampersand on the command line is interpreted by the system as a command separator. The above refers to the batch file Ûtex.batÛ created during installation. % of \yandytex. Calling a batch file from the `TeX' menu rather than calling an application directly offers the opportunity to control what happens before the application is run, and what happens after it terminates. Also note that {\PIF} files can control execution of % {\DOS} programs in Windows. % console applications batch files (and {\DOS} programs). {\PIF} files can be used, for example, to specify whether the application will run full screen or windowed. The installation procedure copies convenient {\PIF} files for {\DVIPSONE} and \yandytex. You can edit these, or create new {\PIF} files for other applications by right-clicking on the batch file and selecting `Properties.' % ??? Altogether then there are three ways to control execution of an application called from the `TeX' menu: \beginlines (i) in the `Application Call Pattern' itself, (ii) in a batch file called from the `TeX' menu, and (iii) by using a {\PIF} file with the same name as the batch file. \endlines \noindent % (or the batch file). % % flush reference to DOS box ??? % Finally, note that you can even select the fonts used in a windowed {\DOS} box by clicking on the `System Menu' of the box, and selecting `Fonts...'. Windows remembers the selection you have made for use in future {\DOS} boxes with the same title. If details of the `TeX' menu still appear a bit % seems mysterious, check out the entries created by the installation program to see how these work. % in practice. Just hold down the `Ctrl' key, click on a menu item, and after inspecting it, click `Cancel' (unless you actually want to change it!). \subsub{The [Applications] section of dviwindo.ini} % Note that while the `TeX' menu can be edited directly from {\DVIWindo}, it is also possible to alter it by editing the Û[Applications]Û section of the file `Ûdviwindo.iniÛ. This may be useful should the `TeX' menu ever get seriously corrupted. Each line in the Û[Applications]Û section is of the form `Ûkey=valueÛ.' A typical entry might be \beginlines ÛLaTeX 2e|F8=tex.bat +latex @.texÛ \endlines \noindent Note that `TeX' menu entries can % also be used to transfer focus to another window --- as opposed to launching a new Windows or console application. Use Û$Window(Û\angi{window title}Û)Û for this. To transfer to the `Notepad' window, for example, % you may use a key-value pair of the form % Û-> Notepad|C-F2=$Window(Notepad...)Û \beginlines Û-> Notepad|C-F2=$Window(...Notepad)Û \endlines \noindent The ellipses (Û...Û) indicate that the window title need not match the the given text in its entirety, but may have additional characters before `Notepad.' % initial part of the window title, which may contain additional characters. Conversely, if the ellipsis appears {\it after\/} the word `Notepad', then the given text need only match the initial part of the window title. This is handy because title bars often contain not only the application name, but also the name of an open file. % opened by that application. Of course, you get an error message when there is no such window. Here we have chosen to use Û->Û as the initial characters in the `key.' This is {\it not\/} in any way interpreted by {\DVIWindo}, but {\it is\/} a useful mnemonic device to mark entries in the `TeX' menu that merely transfer focus to an existing window --- as opposed to launching a new copy of the application. % additional features of `TeX' menu ??? % compare with TeX Menu manual ??? Can we flush that one now ??? \subsect{\yandytexBold} % You can run \TeX\ (or \LaTeX, or what you will) from the `TeX' menu in {\DVIWindo} by choosing the appropriate menu item using the mouse, % option. or by pressing the associated `hot key.' % function key You will also have batch files Ûtex.batÛ, Ûlatex209.batÛ, and Ûlatex.batÛ in the Û\yandytexÛ % or Û\utilÛ subfolder. % subdirectories. %%% check with final installation decision ??? As a test, type Ûc:\yandy\yandytex\tex -?Û at the command prompt (you would need to adjust this command if you installed in a different directory than the default Ûc:\yandyÛ). You should get a short command line summary from \yandytex. % If instead you get a `Bad command or file name' complaint, % from {\DOS}, % then copy Ûtex.batÛ and Ûlatex.batÛ % from your Û\yandytexÛ subdirectory %%%% where ??? %%%% and does it install the correct file ??? % to a directory that {\it is\/} on your ÛPATHÛ. % (if necessary, create a directory called Ûc:\batÛ, % and add that to the ÛPATHÛ statement in Ûautoexec.batÛ). To make it more convenient to use these batch files, you may want to add the folder % directory % they are in to your ÛPATHÛ --- as defined in Ûautoexec.batÛ in Windows~95/98, and from `Control Panel{\down}System{\down}Environment' in Windows~NT. Alternatively, copy the batch files to a folder % directory that is already on your ÛPATHÛ. % (such as the Windows folder). % directory). % but do not delete the original versions since these are called from menu... %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% Note that \yandytex\ is {\it exactly\/} the same as the standard \TeX\ described in {\sl The \TeX book} when it comes to the {\it language\/} implemented (except that it is version 3.14159, while the book describes version 3.0). \yandytex, however, does have quite a few added capabilities such as dynamic memory allocations, more detailed log file output, % in certain situations, capabilities for dealing with `foreign' language keyboards, and other extensions controlled by command line flags. Use Û-?Û on the command line to list commonly used command line options. Please refer to the Technical Addendum (or Ûreadme.txtÛ in Û\yandytexÛ subfolder and Ûcommflag.txtÛ in Û\doc-miscÛ subfolder) % subdirectory) %%% is there such a file ??? for additional extensions and optional command line arguments. %%% discuss keyboard.txt ??? If {\TeX} hits an error while processing your source file, it will stop and ask you for a response. Type `Û?Û' % at this point to see a list of options available to you at that point. Typically it's easiest just to hit \ang{Enter} and let {\TeX} continue. If you start to see too many errors (sometimes a single mistake triggers an avalanche of error messages), type `ÛxÛ' instead in order to escape. If you have set up the environment variable ÛTEXEDITÛ you also have the option of using `ÛeÛ' to call your editor. %% refer to previous section? %% section? % `Please type another file name' When {\TeX} is looking for a file that it can't find, it will ask you to `ÛPlease type another file nameÛ.' % ask you for a new file name. If the file does not exist and there is no appropriate substitute, then one option you have is to type ÛnulÛ. {\TeX} will then read an empty file --- which in some cases may be appropriate (or at least keep it going a bit longer). % If you want to stop processing instead, type Ctrl+Z. This will cause {\TeX} to perform an `Emergency Exit.' This is a handy trick to know, since otherwise you may find yourself at some time stuck in an annoying --- seemingly endless --- loop with {\TeX} asking you again and again for a file name\ellipsis The window in which {\TeX} is running when {\TeX} is called from {\DVIWindo} will persist if an error occurs. %%% check tex.bat as installed %% once we have the batch file fixed up ??? This is so that you can read the error information at your leisure. To dismiss the Window % when you are through looking at it, type any character while that window has the focus. % to make it disappear. % to make the window disappear. In rare cases the {\TeX} window disappears before one can tell what the problem is. In this case temporarily check % `Fonts{\down}Pause WinExe' `Special{\down}Pause WinExe' in {\DVIWindo} before calling {\TeX}. You may find % `Fonts{\down}Show WinExe' `Special{\down}Show WinExe' useful as well --- it shows you exactly how {\DVIWindo} is calling {\TeX}. You may also wish to look at the Û.logÛ file for more detailed error output. The Û.logÛ file is a plain {\ASCII} text file with the same name as the output Û.dviÛ file, but extension Û.logÛ. {\TeX} writes the Û.logÛ file in the same place as the Û.dviÛ file. % unless you redirected output... % (or in the location specified by the ÛTEXLOGÛ environment variable). %% see section 2.7 ???? If you would like to use certain command-line options every time {\TeX} % }\yandytex\ is called from {\DVIWindo}, use `Preferences{\down}Command Line.' % then add a line to the % an entry % Û[Window]Û section of Ûdviwindo.iniÛ of the form % ÛTeX=Û\angi{command line options}. Curiously, % Confusingly, {\TeX} itself interprets the command line, and to {\TeX} anything starting with Û\Û (backslash) is considered to be a {\TeX} `control sequence.' To avoid problems with % {\DOS} file names that have backslashes, \yandytex\ % automatically converts backslashes to slashes in file names % (and format names) and format names. % on the command line. % (unless you use the command line flag Û-dÛ). % You can also ask {\DVIWindo} to do the translation. % Deslash=1 [Window] section In Windows~95/98, files with long names also have short names constructed by omitting parts of the name and replacing it with \char158. One can use either the long or the abbreviated name to access a file. These `tilde' characters in short file names could, however, % potentially create havoc when interpreted by {\TeX}, so \yandytex\ transparently replaces them with something benign. % else. Note that {\TeX} itself {\it cannot\/} deal with file names that contain spaces. If you do need to use such file names, enclose them in double quotes (Û"Û). However, we do {\it not\/} recommend using names --- or paths --- that contain spaces. For additional details please refer to Technical Addendum (or the Ûreadme.txtÛ file Û\yandytexÛ folder and Ûcommflag.txtÛ in Û\doc-miscÛ subfolder) % subdirectory) % directory). % following redundant ??? You can also use \yandytex\ from the % {\DOS} command prompt by typing % ÛtexÛ \angi{filename} Ûc:\yandy\yandytex\texÛ \angi{filename} and pressing \ang{Enter}. % (You may need to enter the full path, e.g. Ûc:\yandy\yandytex\texÛ % if the batch file is not on your ÛPATHÛ). Use Û-?Û instead of a filename to see a usage summary of the most common command line options that \yandytex\ accepts. %%%%%%%%%%%%%%%%%%%%%%%%%%%%%% % Uncheck Working Directory when running ini-TeX ???? %%%%%%%%%%%%%%%%%%%%%%%%%%%%%% \subsub{Making new {\TeX} formats --- running ini-{\TeX}} % A `format' file (like Ûplain.fmtÛ) is a kind of dump of {\TeX}'s state of mind after reading the definition for a particular dialect of {\TeX} (such as plain {\TeX}). It is typically faster to load such a format file than to read the {\TeX} source code defining the format (although, these days, the time taken to load these files is quite short). \yandytex\ comes with ready made `format' files for plain {\TeX}, {\AMS}-{\TeX}, {\LaTeX} 2.09 and {\LaTeXe}. Consequently, you do not normally have to create new `formats' However, should you ever need to create new formats, run `ini-{\TeX}.' The preferred way % Probably the easiest way to create a new format is to run {\yandytex} using Û-iÛ on the command line from the command prompt (see below). You can also create formats directly from the `TeX' menu by selecting the `ini TeX' menu item. For example, to create the \LaTeX\ 2.09 format file, you could select `ini TeX' % ÛiniTeXÛ from the `TeX' menu and type ÛLaTeX 2.09Û for the `TeX' menu name (adding any hot key desired following a vertical bar as separator). Click `OK.' Then type ÛlplainÛ\ang{Enter} for the source file name in the field that pops up. Click `OK.' The required files Ûlplain.texÛ, Ûlfonts.texÛ, and Ûlatex.texÛ are in the Û\tex\latex209Û subfolder. % The required {\TeX} source files defining this format % are in the Û\latexÛ subfolder % subdirectory % of the Û\texÛ subfolder, % subdirectory, % and this folder either should be the current folder, % or it should be be on the list of folders % directories Clearly that folder should be listed in the ÛTEXINPUTSÛ environment variable so that {\TeX} can find the files if this approach is used, since ini-{\TeX} ignores `format specific' environment variables, and always refers to ÛTEXINPUTSÛ. % One convenient approach is to temporarily redefine the % `Working Directory' to be the directory with the source files, % by {\it unchecking\/} `Fonts{\down}Working Directory' % if it happens to be currently checked. %%% Mention change of Working Directory check mark here ??? Note that with some formats you need to explicitly type Û\dumpÛ when {\TeX} returns to the '*' prompt, while other formats may already include that command in the source code. In some cases (like {\LaTeXe}) creation of new format files may be more involved --- e.g. requiring two runs of {\TeX}. % You may find it easier to handle this from the command prompt. This is easier from the command prompt. % Note that `ini-{\TeX}' is nothing more than `{\TeX}' with the command line flag Û-iÛ. To create a new format for \LaTeXe, using this approach, switch to the folder that has all of the {\LaTeXe} base files % (typically Ûc:\yandy\tex\latexÛ). % (typically Ûc:\yandy\tex\latex\baseÛ). (typically Ûc:\yandy\tex\latex\unpackedÛ). These files may be the latest versions downloaded from {\CTAN} ({\LaTeXe} is presently updated every 6 months). % First run {\TeX} ({\it not\/} ini-{\TeX}) % or \LaTeXe) on the file Ûunpack.insÛ (which in turn reads Ûunpack.dtxÛ and other files). For example: %% need for recent version of docstrip.tex ??? \beginlines Ûcd c:\yandy\tex\latexÛ % Ûtex -v unpack.insÛ Ûc:\yandy\yandytex\tex -v unpack.insÛ \endlines % \noindent % If Ûtex.batÛ is not on your ÛPATHÛ you need to give the % fully qualified name Ûc:\yandy\yandytex\texÛ instead. % You will also need to adjust the folders if you installed % in other than the standard Û\yandyÛ folder. % \noindent After a minute or so, two or three hundred files will have been created. % At that point, run ini-{\TeX} on the file Ûlatex.ltxÛ. Then move the resulting Ûlatex.fmtÛ format file to the folder % directory specified in the environment variable ÛTEXFORMATSÛ. For example: \beginlines % Ûtex -v -i latex.ltxÛ Ûc:\yandy\yandytex\tex -v -i latex.ltxÛ Ûmove latex.fmt c:\yandy\yandytex\fmtÛ \endlines \noindent Also make sure that the other new files created by the `unpacking' process reside in a folder listed in % ÛTEXINPUTSÛ --- or rather the `format specific' environment variable ÛLATEXÛ. This happens automatically if you `unpack' the packed distribution % from CTAN % in Ûc:\yandy\tex\latexÛ. % in Ûc:\yandy\tex\latex\baseÛ. in Ûc:\yandy\tex\latex\unpackedÛ. % the following should really be more general and appear elsewhere ??? Finally, to add a {\it new\/} format file to the `TeX' menu, select the menu, hold down the `Ctrl' key and click on an entry in the bottom portion of the menu (for example, the one for % ÛLaTeXÛ). %% ? {\LaTeX} 2.09. A dialog box will pop up. Make the changes necessary to make your new format file work (e.g. replace Û+lplainÛ with Û+latexÛ), being sure to give the `key' a unique name, and to associate it with a unique function key (if you wish to use that handy shortcut), and then click on `Add.' Refer to section~3.3.2 on customizing the `TeX' menu for additional details. Equivalently, you can edit the Û[Applications]Û section of Ûdviwindo.iniÛ directly using `Notepad,' `WordPad,' `WinEdt' or {\PFE}. %%% give section number ??? % not needed for existing formats. \subsub{`Foreign' Language Keyboards --- Accented Characters} % If you are a typical mono-glottal English speaker you can ignore this! % spelling ??? Many languages use accented characters, composite characters, or special characters. There is, of course, a standard notation in {\TeX} to access such characters. For example, Û\"aÛ yields `\"a', Û\c cÛ yields `\c c', and Û\aeÛ yields `\ae.' But it is more convenient to represent these characters using a {\it single\/} character code in the file, as we do for `ordinary' alphabetic characters. With {\yandytex} you {\it can\/} type these characters directly from the keyboard and use the resulting {\TeX} source file as is. % There are three cases to consider: \nlist \item Normal text fonts (i.e. {\it not\/} Computer Modern) --- font encoding matches keyboard character codes; \item Normal text fonts (i.e. {\it not\/} Computer Modern) --- font encoding does {\it not\/} match keyboard character codes; \item Computer Modern fonts. \endlist \noindent In case (1) all that needs to be done is to tell {\TeX} about the font encoding. This is the case e.g. if you use a Windows editor to create the source file, and set up the fonts for {\TEXNANSI} (LY1) or Windows {\ANSI} encoding. For plain {\TeX} and {\LaTeX}~2.09, add Û\input texnansiÛ, when using TeX 'n {\ANSI} encoding. For Windows {\ANSI} encoding, use Û\input ansiacceÛ instead. % With {\LaTeXe} instead use Û\usepackage[LY1]{fontenc}Û (for {\TEXNANSI}) or Û\usepackage[ansinew]{texnasni}Û (for Windows ANSI). Conveniently, alphabetic characters and the 58 `standard' accented characters have the {\it same\/} character codes in {\TEXNANSI}, Windows ANSI, ISO Latin~1, and even Cork (T1) encoding! In case (2) character codes need to be translated from those generated by the keyboard to those used in the font. This is the case e.g. if you use a {\DOS} editor (which may e.g. use {\DOS} code page 850) % , or perhaps {\DOS} code page 437 and set up the fonts for TeX 'n {\ANSI} or Windows {\ANSI} encoding. The translation can be accomplished by {\yandytex} itself by specifying a translation table using \beginlines Û-x=Û \endlines % where does it look ??? need full path ??? \noindent on the command line. % argument with \yandytex. % The translation table is read into {\TeX}'s Ûxchr[]Û table. % The inverse of this --- the Ûxord[]Û table --- is used to % translate incoming characters before {\TeX} starts to analyze them. It is then as if the file had been entered using the encoding of the font, not that of the keyboard. Use Ûdos850wn.mapÛ to translate from {\DOS} code page 850 to Windows {\ANSI} % Use Ûdos437wn.mapÛ to translate from {\DOS} code page 437. (Additional sample Û.mapÛ files are provided in the Û\yandytex\keyboardÛ subfolder). In case (3) character codes need to be {\it expanded\/} into standard {\TeX} notation, since Computer Modern text fonts do {\it not\/} have ready-made accented characters. If you are using {\LaTeXe} then this can be taken care of using Û\usepackage[dos850]{inputenc}Û. This can also be done by {\yandytex} by specifying a keyboard character expansion table using \beginlines Û-k=Û \endlines % where does it look ??? need full path ??? \noindent on the command line. % argument with \yandytex. Use Ûdos1252.keyÛ for an editor set up for Windows {\ANSI} % Use Ûdos850.keyÛ for {\DOS} code page 850. (Additional sample Û.keyÛ files are provided in the Û\yandytex\keyboardÛ subfolder). For additional details please refer to the file Ûkeyboard.txtÛ in the Û\yandytex\keyboardÛ subfolder. % ??? right place % Sample translation tables Û*.mapÛ and % sample keyboard expansion tables Û*.keyÛ % are provided in this subfolder as well. % Avoiding hexadecimal notation in output from TeX: When TeX outputs information on screen or in the log file, it uses hexadecimal notation (e.g. Û^^cfÛ) for character codes above 126 and below 32. This can make it hard to read text containing accented, composite, or special characters in error messages. Use the Û-wÛ command line flag to instead have these characters printed `as is' (i.e. without conversion to hexadecimal). This by itself works well if your source file was made using a {\DOS} editor. If your source file was made using a Windows editor, then use in addition the command line flag Û-jÛ to translate from Windows {\ANSI} back to {\DOS} code page 850. The ability to use full `8 bit' character encoding makes it possible to set up proper hyphenation tables for languages using accented characters. Hyphenation tables for many languages are available from {\CTAN} and national {\TeX} user's groups (see the `language' subfolder of the `{\CTAN}' folder on the CD). New formats must be created using ini-{\TeX} (see section~3.4.1) when new hyphenation patterns are to be used. In {\LaTeXe} you may find that the `babel' package provides a good mechanism for supporting multiple languages in the same document. %%% but is beyond the scope of this introductory manual ??? %%% see Technical Addendum ??? %%% hyphenation issues ??? %%% say more ??? give detailed example ??? \subsect{DVIPSONE} % {\DVIPSONE} is the special Post\-Script printer driver. It is simple to use: Just open the `File{\down}Print' menu in {\DVIWindo}, make sure the `Use DVIPSONE' check box is checked, click on `OK' % and press \ang{Enter} (Of course, you can change the entries in the dialog box if you wish). You can control what `port' you are printing to by first using `File{\down}Print Setup.' {\DVIPSONE} assumes that all of the fonts (the actual Û.pfbÛ font files) that your \TeX\ job uses may be found % are in the folder pointed to by ÛPSFONTSÛ. % This is typically Ûc:\psfontsÛ when using {\ATM}. In Windows~NT without {\ATM} it may be the Û\fontsÛ subfolder of the ÛwinntÛ folder. % or the Û\systemÛ subfolder. % normally set up during installation... %% This may be Ûc:\windows\fontsÛ or Ûc:\windows\systemÛ ??? If you have a set of command-line flags and arguments for {\DVIPSONE} that you use all the time, then you may want to set these up using `Preferences{\down}Command Line' in {\DVIWindo}. % then you can add an entry to the Û[Window]Û section of % Ûdviwindo.iniÛ of the form % ÛDVIPSONE=Û\angi{command line options}, % which specifies command line options to be passed to {\DVIPSONE} when % called from {\DVIWindo}. % % (Alternatively, you can create a Ûdvipsone.cmdÛ file in your % ÛDVIPSONEÛ directory containing the command line options --- % please refer to the Ûreadme.txtÛ file for details). % If you want to produce a Post\-Script file instead of sending output directly % to a printer, then select a printer connected to the port {\sc file:} % If you don't yet have a printer connected to {\sc file:}, double click % on `Printers' in the Windows control panel to `Install' a new printer % driver on that port, or to `Connect' an existing on to {\sc file:}. % (of course, you won't use that actual printer driver, but... You can also tell {\DVIWindo} which printer ports have % are attached to Post\-Script devices attached. For the ports listed, the `Use DVIPSONE' check box will be automatically checked as default (and it will {\it not\/} be checked for other ports). % (like ÛCOM2:Û say). To enable this feature, in the Û[Window]Û section of Ûdviwindo.iniÛ, add e.g. a line of the form % ÛUseDVIPSONEÛ line in reflect your printer port. % If you have problems printing (i.e., no output), you may need to edit the % ÛUseDVIPSONEÛ line in Ûdviwindo.iniÛ to reflect your printer port. % While \beginlines ÛUseDVIPSONE=LPT1:;FILE:Û \endlines \noindent which means that you normally want to use {\DVIPSONE} for a printer on ÛLPT1:Û, as well as when `printing to file' (but not when printing to other ports --- like ÛCOM2:Û say). If you {\it never\/} want the `Use DVIPSONE' box checked, then use instead ÛUseDVIPSONE=BOGUS:Û (or uninstall \DVIPSONE). The window in which {\DVIPSONE} is running when it is called from {\DVIWindo} will persist if an error occurs. %% once we have the batch file fixed up ??? This is so that you can read the error information at your leisure. To dismiss the Window type any character while that window has the focus. % to make it disappear. In rare cases the {\DVIPSONE} window disappears before one can tell what the problem is. In this case temporarily check % `Fonts{\down}Pause WinExe' `Special{\down}Pause WinExe' in {\DVIWindo} before calling {\DVIPSONE}. You may also find % `Fonts{\down}Show WinExe' `Special{\down}Show WinExe' useful --- it shows you exactly how {\DVIWindo} is calling {\DVIPSONE}. % By the way, {\DVIPSONE} will not be able to print % if you have something like a `print monitor' % permanently connected to your printer port. % move to problem section ??? % \noindent will work for systems with parallel-port connections, ÛLPT1Û % will need to be changed to ÛCOM1Û \ellipsis\ ÛCOM4Û if you have a % serial-port connection. % page size setting ??? % duplex mode setting ??? \subsub{Printing to File} % {\DVIPSONE} normally is used to print directly to some printer port. To create a Post\-Script file instead --- to send to a service bureau, say --- click the `Print to File' check box in the printer dialog (or choose a printer connected to the `port' {\sc file:}). Then, when you print, you will be asked for a file name to use. % for the output. % This can be a handy way of feeding {\PS} files to Acrobat Distiller's ``watched folder.'' % Is the following still needed ??? % If you don't yet have a printer connected to {\sc file:}, double click % on `Printers' in the Windows Control Panel to `Install' a new printer % driver on that `port,' or to `Connect' an existing one to {\sc file:}. % % (of course, you won't use that actual printer driver, but... % You may need to `Install' a printer from the Windows Control Panel % (in the `Main' program group) and `Connect' it to the `virtual port' % called ÛFILE:Û. % following somewhat optional If you then decide to {\it print\/} the Post\-Script file locally after all (perhaps to check that everything is {\sc ok}) you can just use the % {\DOS} {\sc copy} command. {\sc copy} command from the command prompt. But you must then take into account the fact that Post\-Script printers (on serial ports and parallel ports at least) expect to receive a Ctrl+D (character code 4) % ({\ASCII} 4) at the end of each job. % (to reset their virtual memory). The Ctrl+D is an `end of job' signal and resets the printer's virtual memory. % in the printer. {\DVIPSONE} automatically adds this character when it sends its output {\it directly\/} to a printer, but control characters designed for controlling a % serial communications link are not valid % strictly in a Post\-Script file, so the Ctrl+D is omitted when `printing to file.' % does not contain this character. % whether from {\DVIWindo} or from {\DOS}.) % You can add the Ctrl+D back in again as follows: You can re-append the dropped Ctrl+D again as follows: \beginlines Ûcopy book.ps+c:\yandy\ps\controld.ps lpt1:Û \endlines % Ûcopy book.ps+c:\yandy\dvipsone\controld.txt lpt1:Û % Ûcopy book.ps+c:\dvipsone\controld.txt lpt1:Û \noindent The file Ûcontrold.psÛ contains nothing but a Ctrl+D character. % For convenience you may wish to create a simple one-line batch file, Ûsend.batÛ say, which contains the following: % above line, but where the filename \angi{book} % ? % is replaced with Û%1Û, referring to the argument % given to the batch file. % The batch file takes one argument, \beginlines Ûcopy %1+c:\yandy\ps\controld.ps lpt1:Û \endlines % Ûcopy %1.ps+c:\yandy\dvipsone\controld.txt lpt1:Û \noindent The single argument is the name of the PS file. % {\it sans\/} extension --- % but with a path specification, if the file is not in the current directory. %% flush following ??? UGH SERIAL PORTS ! potential problems 98/Apr/15 % If you (still) have a serial connection to the printer, % use the {\sc print} command. % In that case you may also want to use the utility {\MODEX}, % to set the baud rate of your serial port to a higher value % then the maximum 19,200 baud rate provided for by {\DOS}; % this can greatly reduce print times % ({\MODEX} will not work in Windows~NT because it accesses % serial port hardware directly). % Just make sure to change the baud rate on the printer {\it first\/} % (using front panel controls or specific Post\-Script commands for your % type of printer). % Finally, if you have a serial line that (still) does not support hardware % flow control, use the utility {\SERIAL} % supplied with {\DVIPSONE} % ({\SERIAL} will not work in Windows~NT because it accesses hardware directly). Note that you can also use {\DVIPSONE} directly from % {\DOS} the command line by typing e.g. \beginlines % Ûdvipsone -v -d=lpt1Û \angi{filename} Ûc:\yandy\dvipsone\dvipsone -v -d=lpt1Û \angi{filename} \endlines \noindent and pressing \ang{Enter}. % If the Û\dvipsoneÛ subfolder is not on your ÛPATHÛ % you will need to use a fully qualified file name: % such as % Ûc:\yandy\dvipsone\dvipsoneÛ. % Use Û-?Û on the command line to get a brief usage summary. Please refer to the Technical Addendum (or Ûreadme.txtÛ in the Û\dvipsoneÛ subfolder and Ûcommflag.txtÛ in the Û\doc-miscÛ subfolder) % subdirectory) % subdirectory %%% or in ÛdocÛ subdirectory of that for additional details. % omit % eliminate % the Û-dÛ command-line option which specifies the destination. %%% flushed the font substitution nonsense from here... % Besides font management, the only other tricks you're likely to need % on a daily basis are figure location and page selection. % \subsub{Figure-file location} % % Has this now been covered better elsewhere ??? installation % % just add the command-line parameter Û-i=c:\tex\figs\psÛ % (or put it in Ûdvipsone.cmdÛ). \subsect{Graphics, EPS, TIFF, BMP, WMF, Color, and Hypertext} % % \subsub{Inserting Encapsulated Post\-Script (EPS) Files} % The \yandytex\ System is compatible with figure insertion methods % scheme used by the `graphicx' (and `graphics') packages in {\LaTeXe}. % Just check that there are files in the graphics There should be files called Ûgraphics.cfgÛ and Ûcolor.cfgÛ in the graphics package folder (typically Ûc:\yandy\tex\latex\graphicsÛ) containing the single line \beginlines Û\ExecuteOptions{dvipsone}Û \endlines \noindent This is to tell the graphics package what `driver' you are using. To invoke the graphicx package in {\LaTeXe}, use \beginlines Û\usepackage{graphicx}Û \endlines \noindent % to load the package, Then, to insert the {\EPS} file Ûmyart.epsÛ use \beginlines Û\includegraphics{myart.eps}Û \endlines \noindent If you specify a full path for the file, use Û/Û instead of Û\Û to prevent {\TeX} % from trying to from interpreting parts of the file name as control sequences. The figure can also be scaled using, for example, \beginlines Û\includegraphics[scale=0.5]{myart.eps}Û \endlines \noindent Additional options are available. For details % please refer to Ûgrfguide.texÛ in the `graphics' package folder % directory (a printed version can be obtained by copying the Post\-Script file Ûgrfguide.psÛ to a PS printer port). % We now supply unpacked files % As with most {\LaTeXe} `packages' you first have to % `unpack' the graphics package. You can do this by running {\TeX} % on the file Ûgraphics.insÛ in the Û\tex\latex\graphicsÛ % subfolder. Temporarily uncheck the `Fonts{\down}Working Directory' % --- if it is checked --- so as to force {\TeX} to write the % files created back into the same directory. %% above may now not be relevant anymore ??? The \yandytex\ System is also compatible with the two most common % higher-level Post\-Script figure inclusion macro files used in % {\LaTeX} 2.09 and plain {\TeX}, namely plain {\TeX} and {\LaTeX} 2.09, namely Ûepsf.texÛ and Ûpsfig.styÛ % (as well as several others, see below). %% section? (actually, for reasons explained below, use Ûepsfsafe.texÛ and Ûpsfigfx.styÛ instead). We'll briefly describe Ûepsf.texÛ here. Given a file named, for example, Ûmyart.epsÛ, to include it in a \LaTeX\ 2.09 file, type: % Û% Û this line must appear after the Û\documentclassÛ line and before \beginlines Û\documentstyle[epsf]{Û\angi{main documentstyle}Û}Û % (for \LaTeX\ 2.09) % or \endlines \noindent While the `epsf' style was % originally designed for {\LaTeX} 2.09, for backward compatibility it is {\it also\/} available in the {\LaTeXe} graphics package, e.g. \beginlines Û\documentclass{Û\angi{main document class}Û}Û Û\usepackage{epsfig}Û % %Û (for \LaTeXe); \endlines % don't need the [dvipsone] option right ??? % Û\usepackage[dvipsone]{epsfig}Û % %Û (for \LaTeXe); % was Û\usepackage[dvipsone]{graphics,epsfig}Û % %Û (for \LaTeXe); % don't need {graphics}, since invoked by epsfig (David Carlisle) \noindent In either case, follow this with \beginlines Û\begin{document}Û \ellipsis Û\begin{figure}Û Û\epsfig{file=myart.eps}Û Û\caption{My Caption Goes Here}Û Û\end{figure}Û \ellipsis Û\end{document}Û \endlines % Û\epsfig{myart.eps}Û % Û\epsf{myart.eps}Û % \noindent For other uses of Post\-Script with \TeX, please consult your % local \TeX\ Wizard. % \noindent % If you specify a full path for the file, use / instead of \char92\ to % prevent {\TeX} % from trying to % from interpreting the file name as a control sequence. \noindent Note that {\DVIWindo} will display a preview in (i) {\TIFF}, (ii) Windows Meta\-File ({\WMF}), or (iii) {\EPSI} form associated with an {\EPS} file. If you do not obtain a preview, check the application that created the {\EPS} file; you may have disabled the generation of previews. % it may have an option that disables generation of a preview. % in the {\EPS} file. % it probably did not follow the specifications correctly. % You can also add a preview to an {\EPS} file that does not have one using a PS % Post\-Script interpreter such as Transverter Pro\registered\ from TechPool Software, or GhostScript. But the details are beyond this introductory manual. \tip % Advanced Feature: If you do not use the extension Û.epsÛ in the call to insert the file, {\DVIWindo} will look for a file with extension Û.epsÛ for printing, but try and find a corresponding file with extension Û.tifÛ for preview. This is another way to `add a preview' to an {\EPS} file that does not have one. % You should know that Ûepsf.texÛ reads the {\EPS} file to find the Post\-Script comment that defines the bounding box for the figure in order to figure out how much space to allocate on the page. This may not work as expected if the {\EPS} file contains a preview in {\TIFF} or {\WMF} format --- yet, previews are obviously useful. % because {\DVIWindo} shows previews on screen. For this reason, use % Please use % refer to the file Ûepsfsafe.texÛ {\it instead\/} of Ûepsf.texÛ. It contains a simple fix to the bounding box reading code to deal properly with previews. % Other style files provide alternative high level interfaces for figure inclusion. One popular one is Ûpsfig.styÛ. It has a similar problem with previews in {\EPS} files. Use Ûpsfigfx.styÛ instead. % Please refer to the Technical Addendum % or the file Ûpsfigfix.txtÛ % until Technical Addendum is finished % for information on how to modify % the official % Ûpsfig.styÛ. % so it works properly. Note that at the lowest level, {\DVIWindo} and {\DVIPSONE} support twelve % more than ten different schemes for figure inclusion (see Technical Addendum). This is necessary because there is no standardization --- every printer driver and previewer uses a different scheme! We recommend using high level interfaces like the \LaTeXe\ graphics package, Ûepsf.texÛ or Ûpsfig.styÛ whenever possible to avoid running into problems. % at the low level. % If your Post\-Script art files are in Ûc:\epsÛ, % % Ûc:\tex\figs\psÛ, % make sure that the environment variable ÛPSPATHÛ is % set accordingly: ÛPSPATH=c:\epsÛ. % ÛPSPATH=c:\tex\figs\psÛ. % The same goes for inserted {\TIFF} and Windows Meta\-File images. % \subsub{Including {\dsc TIFF} and Windows Meta\-File Images} \subsub{Including {\dsc TIFF}, {\dsc BMP} and {\dsc WMF} Images} % In addition to inclusion of images in {\EPS} form, {\DVIWindo} and {\DVIPSONE} provide support for insertion of images in {\TIFF} format. For images (rectangular arrays of gray levels or color tones), {\TIFF} provides a natural format --- typically much more compact than the equivalent {\EPS} file. Also, there is no need in this case for a separate `preview,' since {\DVIWindo} can show the {\TIFF} file directly . % (although this can be a bit slow for {\it very\/} large {\TIFF} images --- % so you may want to disable this feature by unchecking % `Pref