In order to make it possible to use the new compila- tion features even on documents written with XY-pic v2, the following command was added in v2.12:
\diagramcompileto{ hnamei}. . . \enddiagram which is like the ordinary diagram command except the result is compiled (see note 5e). Note that com- pilation is not quite safe in all cases!
There is also the following command that switches on automatic compilation of all diagrams created with the v2\diagram. . . \enddiagramcommand:
\CompileAllDiagrams {hprefixi}
\NoCompileAllDiagrams
\ReCompileAllDiagrams
will apply\xycompileto{hprefixin}{. . .}to each di- agram withna sequence number starting from 1. Use
\CompileMatricesand\CompilePrefixinstead!
If for some reason a diagram does not work when compiled then replace the\diagram command with
\diagramnocompile (or in case you are using the LATEX form,\begin{diagramnocompile}).
C Common Errors
In this appendix we describe some common cases where small mistakes in XY-pictures result in TEX er- ror messages that may seem cryptic.
! Box expected.
! Ahboxi was supposed to be here. This mes- sage is common when an XY-pichobjectiis mistyped such that XY-pic expects but does not find a TEX hboxiconstruction.
! LaTeX Error: Bad math environment delim- iter.
! File ended while scanning use of\xycompiled.
! Argument of \codeof@has an extra}. These errors can happen while reading an incomplete com- piled picture (such a beast is created when XY-pic crashes during compilation due to a syntax error or other such problem).
! Missing}inserted. This happens when\endxy was left out.
To Do: Also include the more obscure ones. . .
References
[1] Adobe Systems Incorporated. PostScript Lan- guage Reference Manual, second edition, 1990.
[2] American Mathematical Society. AMS-LATEX Version 1.1 User’s Guide, 1.1 edition, 1991.
[3] Karl Berry.Expanded plain TEX, version 2.6 edi- tion, May 1994. Available from CTAN.
[4] Michel Goossens, Frank Mittelbach, and Alexan- der Samarin. The LATEX Companion. Addison- Wesley, 1994.
[5] Brian W. Kernighan. PIC—a language for type- setting graphics. Software Practice and Experi- ence, 12(1):1–21, 1982.
[6] Donald E. Knuth. The TEXbook. Addison- Wesley, 1984.
[7] Donald E. Knuth. Computer Modern Typefaces, volume A ofComputers & Typesetting. Addison- Wesley, 1986.
[8] Leslie Lamport. LATEX—A Document Prepara- tion System. Addison-Wesley, 1986.
[9] Leslie Lamport. LATEX—A Document Prepara- tion System. Addison-Wesley, 2nd edition, 1994.
[10] Daniel M¨ullner. The xypdf
package. Available from
http://ctan.org/tex-archive/macros/generic/diagrams/xypic/xy/doc/xyp May 2010.
[11] P. Naur et al. Report on the algorithmic lan- guage ALGOL 60.Communications of the ACM, 3:299–314, 1960.
[12] Alexander R. Perlis. Axis alignment in XY-pic diagrams. TUGboat, 22(4):330–334, 2001.
[13] Tomas Rokicki. DVIPS: A TEX Driver. Dis- tributed with the dvips program found on CTAN archives.
[14] Kristoffer H. Rose. How to typeset pretty dia- gram arrows with TEX—design decisions used in XY-pic. In Jiˇr´ı Zlatuˇska, editor, EuroTEX ’92—
Proceedings of the 7th European TEX Con- ference, pages 183–190, Prague, Czechoslo- vakia, September 1992. Czechoslovak TEX Users Group.
[15] Kristoffer H. Rose. Typesetting diagrams with XY-pic: User’s manual. In Jiˇr´ı Zlatuˇska, edi- tor, EuroTEX ’92—Proceedings of the 7th Eu- ropean TEX Conference, pages 273–292, Prague, Czechoslovakia, September 1992. Czechoslovak TEX Users Group.
[16] Kristoffer H. Rose. XY-pic User’s Guide.
DIKU, University of Copenhagen, Univer- sitetsparken 1, DK–2100 København Ø, 3.0 edi- tion, June 1995. Latest version is available from http://xy-pic.sourceforge.net/.
[17] Kristoffer H. Rose and Ross R. Moore. XY- pic complete sources with TEXnical commentary.
Available from http://xy-pic.sourceforge.net/, June 2010.
[18] Michael D. Spivak.The Joy of TEX—A Gourmet Guide to Typesetting with the AMS-TEX Macro Package. American Mathematical Society, sec- ond edition, 1990.
[19] TUG Working Group TWG-TDS. A directory structure for TEX files version 0.98. URL, May 1995. Available with URL ftp://jasper.ora.com/
pub/twg-tds/.
Index
!,8
&,48
’,39 (),8 (0),8 (0,0),72 (1),8
*,8,39,41,42,49,50,76
**,8,40,50 +,8
,,8,40 -,8,39 .,8 .xyd,15 /,38, 39,42 //,8 :,8,12 ::,8
;,8
<,8,38–40
<>,8
<>(.5),39
=,8,38–41
>,8,38–40
?,8,40
@,8,39,42,50
@!,42,50
@!0,50
@!=,50
@!C,50
@!R,50
@(,10,42,43
@),10
@*,42,50
@+,10
@-,10
@/,42,43
@1,51
@<,42,43
@=,10
@?,42,43
@@,10
@C,50
@H,50
@L,50
@M,50
@R,50
@W,50
@‘,42
@i,10 [.],13
[=,12,14,31, 33 [P:,37
[],13
[c],14 [d],13 [dvips],5 [l],13 [o],13 [r],13 [textures],5 [u],13
\\,48
^,39,40,42 _,39,40,42
‘,39,40
‘s,66
|,39,42
|<<,76
~,39 0,6,8, 42 1,42 2,42 3,42 10,27 11,27 12,27 A,8 a,8
active characters, 4 hadd opi,12
\aftergo ,76
\afterPATH ,38
\afterPOS ,15,16,40
\ahook ,77 allocation,5 AMS-LATEX,5,15 AMS-TEX,5
\apit , 76
\ar ,14,38,66 array,52 arrow head,41 arrow stem,41 arrow tail,41
\astop ,77
\aTip , 77
\atip , 77
\aturn ,77 banner,5
\bhook ,77 BNF,4
hbody of the optioni,19
\bpit , 76
\bstop ,77
\bTip , 77
\btip , 77
\bturn ,77
C,8,10 c,6 c,8
cartesian coordinate system, 6 category code,4
CD,8
\cD ,76
\cH ,76 hciri,19
\cir , 18,74
\Circled ,77
\circled ,77 circles,5 CL,8
\cL ,76 cm,27
\Col , 51
column spacing,50 hcommandi,16
\CompileFixPoint ,15
\CompilePrefix ,15 compiling, 15
hcompositei,12
\composite ,12,13,18 connect,6
\connect ,16 hcoordi,8,37 COPYING,4 copyright, 3 hcorneri,8 CR,8
\cR ,76 CU,8
current object style, 12,14 D,6
D,8,10 Dc,6 Dp,6
\Dashed ,76
\dashed ,76 dashes,5
\dashframed , 77
\Dc ,76
\Ddashed ,76
\Ddotted ,76 hdecori,16 decoration, 6 default entry,50
\define ,76
\definemorphism ,77 hdiagi,12
\diagram ,77 dimension registers,5
\dir , 16,18,41
hdirectioni,12
\documentclass ,5
\dotframed ,77
\Dotted ,76
\dotted ,76
\dottedwith ,76
\Dp ,76 hdriveri,20
\Drop ,76
\drop ,16
\dsize , 76
\dumpPSdict {<filename>},36 E,8,10
Edge,6 Edgec,6 Edgep,6
\enddiagram ,77
\endxy , 5,6,15
entry alignment used prior to ver- sion 3.8,51
entry height,50 entry margin,50 entry modifiers,50,51 entry width,50
\entrymodifiers ,51 Error,5
hescapei,52 eu,27
\everyentry ,51 extension,20 extents,6 e|,37 fixed grid,50 fonts,5
format dependencies,5 formats,4
\Framed ,77
\framed ,77 free software,3 french.sty,4
\frm ,10,24
\frm {**},26
\frm {*},26 german.sty,4
GNU General Public License,3
\go ,76 hgraphi,52
\grow ,77 h,12
\halfrootthree ,7
\halfroottwo , 7
\halign ,52
\hbox ,12
\hole ,41,77
hooks,5 i,12 idioms, 5
\input xy,4
\input xypic, 77
\jot ,9 L,6 L,8,10 Lc,6 Lp, 6
label separation,50
\labelbox ,41
\labelmargin ,40
\labelstyle ,41 LATEX,5
\LaTeXdiagrams ,77 LATEX 2ε,5
\Lc ,76 LD,8 license,3 line,37 hlisti,52 loading, 4,5 logo,5
\Lp ,76 LU,8 lu,27
\makeatletter ,4
\makeatother ,4
\MakeOutlines ,15 math mode, 6 hmatrixi,48 matrix,48
matrix orientation,50 matrix spacing,50
\merge ,76 messages, 5 hmodifieri,12,37
\morphism ,77 hmovei,52 movie,34
\MovieSetup ,35
\MultipleDrivers ,20
\newdir ,18,41
\newgraphescape ,53
\newxycolor ,31
\newxypattern ,32
\next , 4 hnodei,52
\NoisyDiagrams ,77
\none , 76
\NoOutlines ,15
\NoPSspecials ,35
\NoRules ,18
\notip ,77
\NoTips ,27 hobjecti,12 object, 6
\object ,12,16 hobjectboxi,12
\objectbox ,11,41
\objectheight ,13
\objectmargin ,13,40
\objectwidth ,13
\OnlyOutlines ,15 horienti,19
orientation,50 P,8,10 p,6 p,8 package,5
\partroottwo ,7
\PATH ,38
\PATHaction , 38
\PATHafterPOS ,40 Perlis, 51
\pit , 76 hplacei,8
placement state,6 plainTEX, 5 hposi,8
\POS , 16,38 positions,6 privacy,4 q,12 R,6 R,8,10 Rc,6 Rp, 6 hradiusi,19
\Rc ,76 RD,8
\redefine ,76 redefined,4
\relax ,4,16
\restore ,16
\rotate ,77
\rounddashframed ,77
\Row , 51 row spacing,50
\Rp ,76 RU,8 s,8
\save ,16
\scene ,34
\SelectTips , 27
\ShowOutlines ,15
\SilentMatrices ,49