summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/source/generic/xypic/xyxdvi.doc
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/source/generic/xypic/xyxdvi.doc')
-rw-r--r--Master/texmf-dist/source/generic/xypic/xyxdvi.doc335
1 files changed, 0 insertions, 335 deletions
diff --git a/Master/texmf-dist/source/generic/xypic/xyxdvi.doc b/Master/texmf-dist/source/generic/xypic/xyxdvi.doc
deleted file mode 100644
index 0a33c52cf24..00000000000
--- a/Master/texmf-dist/source/generic/xypic/xyxdvi.doc
+++ /dev/null
@@ -1,335 +0,0 @@
-%% $Id: xyxdvi.doc,v 3.3 1996/12/18 09:53:22 ross Exp $
-%%
-%% Xy-pic ``xdvi-driver'' option.
-%% Copyright (c) 1995-1996 Ross Moore <ross@mpce.mq.edu.au>
-%%
-%% This file is part of the Xy-pic package for graphs and diagrams in TeX.
-%% See the companion README and INSTALL files for further information.
-%% Copyright (c) 1991-1996 Kristoffer H. Rose <krisrose@brics.dk>
-%%
-%% The Xy-pic package is free software; you can redistribute it and/or modify
-%% it under the terms of the GNU General Public License as published by the
-%% Free Software Foundation; either version 2 of the License, or (at your
-%% option) any later version.
-%%
-%% The Xy-pic package is distributed in the hope that it will be useful, but
-%% WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
-%% or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
-%% for more details.
-%%
-%% You should have received a copy of the GNU General Public License along
-%% with this package; if not, write to the Free Software Foundation, Inc.,
-%% 675 Mass Ave, Cambridge, MA 02139, USA.
-%%
-\ifx\xyloaded\undefined \input xy \fi
-
-\xyprovide{xdvi}{XDVI driver}{\stripRCS$Revision: 3.3 $}%
- {Ross Moore}{ross@mpce.mq.edu.au}%
- {Mathematics Department, Macquarie University, NSW~2109, Australia}
-
-\DOCMODE3%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
-
-This driver provides support for extensions when using variants of the
-|xdvi| driver, by Eric Cooper, Bob Scheifler, Mark Eichin and others.
-It has been used successfully with |xdvi| patchlevel 20, by Paul Vojta,
-and |xdvik| version~18f, by Karl Berry.
-
-\DOCMODE3%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
-
-Some of the supported features assume that the implementation of |xdvi| is
-linked to a \PS\ renderer; e.g. {\it Ghostscript} or {\sc Display \PS}.
-If such support is not available, then invoking |xdvi| using the command
-|xdvi -hushspecials| will suppress warning messages that might otherwise
-be produced.
-One drawback of such a setup is that much of the \PS\ is not
-rendered until after all of the font characters, etc. have been placed on
-the page. Thus text that was meant to be placed on top of a filled or
-patterned region may appear to be obscured by it. However when printed,
-using a \PS\ printer, the correct placement is obtained.
-
-\DOCMODE2%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
-\paragraph*{Header:}\leavevmode
-\DOCHEADER
-
-\paragraph*{Driver installation}
-\DOCMODE(
-\xydef@\xdvi@@#1{\dvimessage@{xdvi}{#1}}
-
-\newdriver{%
- \xyaddsupport{color}\xdviColor@@
- \xyaddsupport{crayon}\xdviCrayola@@
- \xyaddsupport{ps}\xdviPS@@
- \xyaddsupport{rotate}\xdviRotate@@
- \xyaddsupport{line}\xdviLine@@
- \xyaddsupport{frame}\xdviFrames@@
- \xyaddsupport{tile}\xdviTiles@@
- \xyaddsupport{tpic}\xdviTPIC@
-}
-\DOCMODE)
-
-\DOCMODE3%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
-
-Supported |\special| effects are...
-%
-\begin{itemize}
-
-\item colour, using \PS.
-
-Not all versions of |xdvi| support color |\special|s, so there is no direct
-support for colour. However parts of pictures rendered using \PS\ may
-appear coloured, due to interpretation of colour commands within the \PS.
-
-\DOCMODE2%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
-
-Disable the |\xylocalColor@| but enable the |\xycolor@| for use by \PS.
-
-\DOCMODE(
-\xydef@\xdvi@Color@{\xdviPStypes@
- \let\xylocalColor@=\xyNoColor@@
-% \let\xylocalColor@=\xystackcolor@
-% \let\xycolor@push\xycolor@push@@
- \def\xycolor@{\xycolor@@}\let\xycolorwarning@=\relax
- \expandafter\ifx\csname xyps-psloaded\endcsname\empty\DN@{%
- \xyinputorelse@{xyps-c}{\xydrivernoload@{ps-c}}\installPScolor@ }%
- \else\DN@{}\fi \next@
- \ifx\xycolor@@\xyNoColor@ \let\xycolor@@=\xycolor@raw@@\fi
- \ifx\xycrayolaloaded\empty \DN@{\xystandardcolors@\xdviCrayola@{}}%
- \else \DN@{\xystandardcolors@}\fi \next@
- \let\xdviColor@@=\relax
- \let\UnloadColor@@=\NoXDVIcolor@
- }%
-
-\xydef@\xdviColor@@{\xdvi@Color@}
-
-\xydef@\NoXDVIcolor@{%
- \def\xycolor@{\xycolor@@}%
- \let\xycolor@@=\xyNoColor@
- \let\xylocalColor@=\xyNoColor@@
- \let\xycolorwarning@=\xycolorwarning@@
- \let\xdviColor@@=\xdvi@Color@
- \let\UnloadColor@@=\UnloadColor@
- }
-\DOCMODE)
-
-If neither support file |colordvi.tex| nor |colordvi.sty| can be found,
-then the normal colour support will not be available. However the colour
-support for the \PS\ back-end can still be used.
-
-\DOCMODE(
-\xydef@\NoXDVIcolordvi@{\xywarning@{%
- Neither colordvi.tex nor colordvi.sty could be found.}%
- \xyBEcolorcheck@}%
-\DOCMODE)
-
-\DOCMODE3%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
-
-\item crayon colours.
-
-\DOCMODE2%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
-
-The 68 colours that |xdvi| recognizes by name are not loaded unless the
-|crayon| option has been requested.
-
-\DOCMODE(
-\xydef@\xdviCrayola@@{\xdviColor@@\xdviCrayola@}
-
-\xydef@\xdviCrayola@{%
- \let\prevxycolor@=\newxycolor@
- \def\newxyXDVIcolor@##1##2##3{\prevxycolor@{##1}{}{##1}}%
- \let\newxycolor@=\newxyXDVIcolor@
- \installCrayolaColors@
- \let\newxycolor@=\prevxycolor@ }%
-\DOCMODE)
-
-Although any order of loading options: |ps|, |xdvi|, |color| and |crayon|
-produces the desired result visually, the \PS\ code can be different
-with different loading order. The most easily readable is obtained when
-|crayon| is requested last.
-
-\DOCMODE3%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
-
-\item \PS\ back-end.
-\DOCMODE(
-\xydef@\xdviPS@@{\xdviPS@}
-
-\xydef@\xdviPS@unload{\UnloadPS@
- \let\UnloadPS@@=\UnloadPS@
- \let\xdviPS@@=\xdviPS@ }
-\DOCMODE)
-
-\DOCMODE2%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
-
-The latest versions of |xdvi| recognise most forms of |\special| command
-that are recognised by |dvips|; these are used to support \PS\ effects.
-
-\DOCMODE(
-\xydef@\xdviPStypes@{%
- \xyinputorelse@{xyps-ps}{\xydrivernoload@{ps-ps}}%
- \ifx\PSspecial@@\xdviSpecial@\else
- \let\PSspecial@@=\xdviSpecial@
- \let\PSmacro@@=\xdviMacro@
- \let\PSdict@@=\xdviDict@
- \let\PSspecialdict@@=\xdviDict@
- \let\PSraw@@=\xdviRaw@
- \let\PSinclude@@=\xdviInclude@
- \let\xyPSobeylines@@=\obeyXDVIlines@
- \let\xyPScurrpt@@=\xdviCurrpt@@
- \xdvi@@{PostScript}%
- \fi \XYpredict@ }
-
-\xywarnifdefined\xdviSpecial@
-\xywarnifdefined\xdviMacro@
-\xywarnifdefined\xdviDict@
-\xywarnifdefined\xdviInclude@
-\xywarnifdefined\xdviRaw@
-{\catcode`\"=11 \catcode`\!=11 \catcode`\:=11
- \gdef\xdviSpecial@#1{\special{ps:: SDict begin #1 end}}
- \gdef\xdviMacro@#1{\firstPS@@\special{" {#1}xy}}
-% \gdef\xdviDict@#1{\special{! mark{#1}stopped cleartomark}}
- \gdef\xdviDict@#1{\special{! #1}}
- \gdef\xdviInclude@#1{\special{header=#1}}
- \gdef\xdviRaw@#1{\special{ps: SDict begin #1 end}}
-
-\catcode`\^^M=\active %
- \gdef\next{\catcode`\^^M=\active \let^^M=\space }}%
-\xylet@\obeyXDVIlines@=\next
-\DOCMODE)
-
-All the \PS\ definitions passed to |xdvi| by reading the
-dictionary file are stored in a \PS\ dictionary which it defines,
-called |SDict|. This must be the current dictionary whenever an \Xy-ps
-command is to be executed.
-This will be the case whenever the |\special{" |{\it commands}|}| or
-|\special{! |{\it commands}|}| forms are used, but not when the
-|\special{ps:: |{\it commands}|}| form is used.
-Thus the |\xdviSpecial@| macro includes code to open |SDict| and
-close it when finished; so also does the |\xdviRaw@| type, since this
-is used with \Xy-pic\ \PS\ operators whose definitions have been placed
-within |SDict|.
-
-The |currentpoint| is defined for the ``raw'' specials.
-
-\DOCMODE(
-\xydef@\xdviCurrpt@{\let\xyPScurrpt@@=\xdviCurrpt@@}%
-\xydef@\xdviCurrpt@@{\PSraw@@{xyp}}
-\DOCMODE)
-
-The \PS\ operator called |xyp| is defined in |xyps-ps| for storing the
-location read from |currentpoint|.
-
-\medskip
-
-This installs the \PS\ backend.
-
-\DOCMODE(
-\xydef@\xdviPS@{\xdviPStypes@
- \let\xdviPS@@=\PSspecials@true
- \let\UnloadPS@@=\xdviPS@unload
- \let\installxyps@@=\relax \installxyps@ }
-\DOCMODE)
-
-\DOCMODE3%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
-
-\item rotated/scaled diagrams and text, using \PS.
-\DOCMODE(
-\xydef@\xdviRotate@@{\xdviRotate@}
-
-\xydef@\xdviRotate@{\xdviPStypes@
- \expandafter\ifx\csname xyps-psloaded\endcsname\empty\DN@{%
- \xyinputorelse@{xyps-r}{\xydrivernoload@{ps-r}}%
- \xdviCurrpt@ \xdviRotScale@ \installPSrotscale@ }%
- \else\DN@{\xydriverfail@{rotations are}UnloadRotate@\relax}\fi
- \next@ }
-
-\xydef@\xdviRotScale@{%
- \def\xyrot@start(##1){{xyct ##1\space xyrs }}%
- \def\xyrot@end{}%
- \def\xyscale@start(##1,##2){{xyct ##1\space##2\space xyss }}%
- \def\xyscale@end{}}
-\DOCMODE)
-
-\DOCMODE3%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
-
-\item variable line-widths and poly-lines, using \PS.
-\DOCMODE(
-\xydef@\xdviLine@@{\xdviLine@}
-
-\xydef@\xdviLine@{\xdviPStypes@
- \expandafter\ifx\csname xyps-psloaded\endcsname\empty\DN@{%
- \xyinputorelse@{xyps-l}{\xydrivernoload@{ps-l}}\installPSline@ }%
- \else\DN@{\xydriverfail@{line-widths are}\UnloadLine@\relax}\fi
- \next@ }
-\DOCMODE)
-
-\DOCMODE3%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
-
-\item extra frames and fills, using \PS.
-\DOCMODE(
-\xydef@\xdviFrames@@{\xdviFrames@}
-
-\xydef@\xdviFrames@{\xdviPStypes@
- \expandafter\ifx\csname xyps-psloaded\endcsname\empty\DN@{%
- \xyinputorelse@{xyps-f}{\xydrivernoload@{ps-f}}\installPSframes@ }%
- \else\DN@{\xydriverfail@{frames are}\UnloadFrames@\relax}\fi
- \next@ }
-\DOCMODE)
-
-\DOCMODE3%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
-
-\item patterns and tiles, using \PS.
-\DOCMODE(
-\xydef@\xdviTiles@@{\xdviTiles@}
-
-\xydef@\xdviTiles@{\xdviPStypes@
- \expandafter\ifx\csname xyps-psloaded\endcsname\empty\DN@{%
- \xyinputorelse@{xyps-t}{\xydrivernoload@{ps-t}}\installPSpatterns@ }%
- \else\DN@{\xydriverfail@{Patterns are}\UnloadPSpatterns@\relax}\fi
- \next@ }
-\DOCMODE)
-
-\DOCMODE3%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
-
-\item \TPIC\ drawing commands.
-\DOCMODE(
-\xydef@\xdviTPIC@@{\xdviTPIC@}
-
-\xydef@\xdviTPIC@{\setupxyTPIC@}
-\DOCMODE)
-
-\DOCMODE3%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
-
-\end{itemize}
-
-\DOCMODE2%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
-
-\paragraph*{The end \& Log}\leavevmode
-
-\DOCMODE(
-\xyendinput
-
-% $Log: xyxdvi.doc,v $
-% Revision 3.3 1996/12/18 09:53:22 ross
-% minor improvements to file-loading commands
-%
-% Revision 3.2 1995/09/19 18:21:41 ross
-% Bug fix release.
-%
-% Revision 3.1 1995/09/05 20:28:57 ross
-% Releasing version 3.1!
-%
-% Revision 3.0 1995/07/07 20:13:19 ross
-% Major release w/new User's Guide!
-%
-% Revision 2.13 1995/07/04 15:04:51 ross
-% Ready for release of v3.
-%
-% NEW for version 3.
-\DOCMODE)
-
-\DOCMODE3%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
-
-% Tell Emacs that this is a LaTeX document and how it is formatted:
-% Local Variables:
-% mode:latex
-% fill-column:77
-% End: