diff options
Diffstat (limited to 'Master/texmf-dist/doc/generic/xypic/Xy-pic.html')
-rw-r--r-- | Master/texmf-dist/doc/generic/xypic/Xy-pic.html | 365 |
1 files changed, 365 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/generic/xypic/Xy-pic.html b/Master/texmf-dist/doc/generic/xypic/Xy-pic.html new file mode 100644 index 00000000000..5b943902f69 --- /dev/null +++ b/Master/texmf-dist/doc/generic/xypic/Xy-pic.html @@ -0,0 +1,365 @@ +<html> <head> +<!--$Id: Xy-pic.html,v 3.34 2010/06/10 18:45:49 krisrose Exp $--> +<title>Xy-pic Home Page</title> +<!--``Xy-pic home page.'' +%% +%% 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-2010 Kristoffer H. Rose <krisrose@tug.org> +%% +%% 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, see http://www.gnu.org/licenses/. +--> +<meta name="description" + content="Xy-pic diagram drawing (La)TeX package home page."> +<meta name="keywords" + content="xypic, TeX, LaTeX, commutative diagram, planar graph, flow chart"> +</head> + +<body lang="EN" bgcolor="#FFFFFF"> +<center> +<h1> +<img src="Xy-logo.png" alt="Xy" width=95 height=111 align=center alt="Xy">-pic +— +Typesetting Graphs and Diagrams in TeX +</h1> +</center> + +<p> + Xy-pic is a package for typesetting graphs and diagrams using the + principle of <q>logical composition of visual components.</q> It is + structured as several modules, each defining a mnemonic plain text + notation for a particular kind of graphical object or structure. + Example objects are arrows, curves, frames, and colouring/rotation + on drivers that support it; these can be organised in matrix, + directed graph, path, polygon, knot, and 2-cell structure (a more + complete list of the features is given below). +<p> + Xy-pic works with most formats, including all variants of LaTeX, + AMS-TeX, and plain TeX, and has been used to typeset complicated + diagrams from many application areas including category theory, + automata theory, algebra, neural networks, topology (knots and + braids), database theory, and genealogy. +<p> + Xy-pic has been designed with great care to allow the style of + pictures to match well with the exquisite quality of the surrounding + TeX typeset material. +</p> + +<h2><a name="avail">Availability</a></h2> + +<p> + You can get Xy-pic from + <a href="http://ctan.org/tex-archive/macros/generic/diagrams/xypic/">CTAN</a> + or directly from the + <a href="http://sourceforge.net/projects/xy-pic/">SourceForge development project home</a>, + however, chances are that Xy-pic is already included with your TeX installation + (for <a href="http://www.tug.org/texlive/">TeX Live</a>, for example, + Xy-pic is part of the <q>pictures</q> bundle). +<p> + Xy-pic was conceived by + <a href="http://www.krisrose.net">Kristoffer Høgsbro Rose</a>, + the present version is the result of several years of collaboration with + <a href="http://www.maths.mq.edu.au/~ross/">Ross Moore</a> with + essential contributions from George Necula, Jeremy Gibbons, + <a href="http://www.math.uni-bonn.de/people/muellner">Daniel Müllner</a>, + and Alex Perlis<!--, <a href="http://www.tug.org/yandy/">Y&Y Inc.</a>-->, + and with many suggestions from more than two decades of users. +<p> + Xy-pic is © by its authors as + <a href="http://www.fsf.org/">free software</a>. +</p> + +<h2>Features</h2> + +<p> + Xy-pic is structured as a <q>kernel</q> and several orthogonal modules + called <q>options</q>, each defining a custom notation for a particular + kind of graphical object or structure. +<p> + +These (combinable) <q>logical composition</q> structures are available: + +<ul> + <li>A graph combinator mode where diagrams are specified the way they are + composed as graphs. + <li>A matrix-like mode where the dimensions of the drawing are computed by + aligning diagram entries in rows and columns (this is the <q>diagram</q> + mode Xy-pic version 2 users are used to). + <li>A polygon mode where diagrams shaped as regular polygons are entered + in a simple way. + <li>A mode for typesetting beautiful knots and links. + <li>A general object-oriented <q>turtle graphic</q> drawing language for + specifying graphs with objects and connections between them in a + manner independent of orientation. +</ul> + +The following <q>visual component</q> objects can be used: + +<ul> + <li>Positions can be given in variety of formats (extendable) including + user defined coordinates (x,y) and relative to previous positions, + objects, object edges, and points on connections. + <li>Objects may be circular, elliptic, or rectangular (more shapes can be + added) and adjusted in several ways. + <li>Large library of objects with mnemonic names. + <li>Objects that orient themself along a connection when placed relative + to it, e.g., <q><code>@{|-}</code></q> is like <q><code>\vdash</code></q> + but thus oriented; new such objects can be defined in a convenient way. + <li>TeX <q>boxes</q>, i.e., text and mathematical formulae. + <li>Includes circle segments and optionally arbitrary elliptical, + quadratic, and cubic arcs. + <li>Connections are aligned between the reference points of objects but + start and end on the edges. + <li>Any object can be used to build a connection (using <q>diagonal + filling</q>); library objects provide common line types. + <li>Flexible notation for drawing arrows and general paths with + tail, stem, and head built from any object(s). Special support + for arrows that cross each other, arrows that <q>go by</q> other + entries, paired arrows (including support for 2-cells), curved + arrows, and arrows with bends. The style of arrow tips can be + configured to match several styles of symbol arrows. + <li>Library of frames and braces. + <li>Special notation for rotation, scaling, colour, and line thickness. + The correct typesetting of these features requires a backend that + supports it but even when this is not available + Xy-pic tries to approximate what is requested such that at least the + picture size is stable (and thus page breaks). + <li>Output can use PostScript<a href="#PS">*</a> for drawing (several \special formats are + supported: dvips, Textures, and OzTeX - more are being added + continuously: contact Ross Moore <ross.moore@mq.edu.au> for the current + list). Notation for inclusion of literal PostScript<a href="#PS">*</a> is available. + <li>Support for Adobe PDF<a href="#PS">*</a> output is available + from version 3.8 (thanks to support by Daniel Müllner and + font conversion software by Scott Pakin).</a>). +</ul> + +<h2>Documentation</h2> + +The official Xy-pic documentation, updated with each release, consists of the following four documents. + +<ul> + + <li><em>Xy-pic User's Guide</em> + by <a href="http://www.krisrose.net/">Kristoffer H. Rose</a>. + Explains how to use the Xy-pic macro package to typeset + basic <q>matrix-like</q> diagrams with TeX + (<a href="http://ctan.org/tex-archive/macros/generic/diagrams/xypic/xy/doc/xyguide.pdf">pdf</a>).<p> + + <li><em>Xy-pic Reference Manual</em> + by <a href="http://www.krisrose.net/">Kristoffer H. Rose</a> & <a href="http://www.maths.mq.edu.au/~ross/">Ross Moore</a>. + Reference manual for Xy-pic summarising syntax and <q>drawing + semantics</q> of the capabilities in the kernel, all extensions and + features, and the PostScript<a href="#PS">*</a> backend + (<a href="http://ctan.org/tex-archive/macros/generic/diagrams/xypic/xy/doc/xyrefer.pdf">pdf</a>).<p> + + <li><em>Xy-pic Complete Sources with TeXnical Commentary</em> + by <a href="http://www.krisrose.net/">Kristoffer H. Rose</a> & <a href="http://www.maths.mq.edu.au/~ross/">Ross Moore</a>. + Just that (a large document, <a href="http://ctan.org/tex-archive/macros/generic/diagrams/xypic/xy/doc/xysource.pdf">pdf</a>).<p> + + <li><em>The xypdf package</em> + by <a href="http://www.math.uni-bonn.de/people/muellner">Daniel Müllner</a>. + Detailed user and TeXnical documentation of the PDF<a href="#PS">*</a> support for Xy-pic + (<a href="http://ctan.org/tex-archive/macros/generic/diagrams/xypic/xy/doc/xypdf.pdf">pdf</a>).<p> + +</ul> + +In addition there are several tutorials on Xy-pic. + +<ul> + + <li><em>An Introduction to Xy-pic</em> + by Cameron McLeman (<a href="http://math.arizona.edu/~swig/documentation/xypic/Xypic.pdf">pdf slides</a>).<p> + + <li><em>Commutative Diagrams with XY-pic---I.\ Kernel Functions and Arrows</em> + by Paul A. Blaga (<a href="http://tug.org/pracjourn/2006-4/blaga/blaga.pdf">pdf</a>).<p> + + <li><em>LaTeX/Creating Graphics/Xy-pic</em> + is a <a href="http://en.wikibooks.org/wiki/LaTeX/Creating_Graphics#XY-pic">WikiBook chapter</a>.<p> + + <li><em>The LaTeX Graphics Companion</em>, Second Edition + by <a href="http://goossens.web.cern.ch/goossens/">Michel Goossens</a>, <a href="http://users.ox.ac.uk/~rahtz/">Sebastian Rahtz</a>, Frank Mittelbach, Denis Roegel, and Herbert Voß, + <a href="http://aw.com">Addison-Wesley</a>, 2007. + Chapter 7 gives a concise introduction to some advanced uses of Xy-pic + (<a href="http://www.informit.com/store/product.aspx?isbn=0321508920">official page</a>; + in the <a href="http://books.google.com/books?id=hh6rdgZ9m3MC&printsec=frontcover&dq=The+LaTeX+Graphics+Companion&source=bl&ots=1rmNFdwt3O&sig=dQdy79YBDYQBq2r-CHfY3jL63ek&hl=en&ei=FrPXS_SkDpX49AS3tPiXBw&sa=X&oi=book_result&ct=result&resnum=1&ved=0CAsQ6AEwAA#v=onepage&q&f=false">first edition on Google books</a> chapter 5 is dedicated to Xy-pic).<p> + + <li><em>Examples on Typesetting Commutative Diagrams Using Xy-pic</em> + by M. Alsani (<a href="http://north.ecc.edu/alsani/xypicbyexample.ps">ps</a>).<p> + + <li><em>Using Xy-pic in LyX</em> + by H. Peter Gumm (<a href="http://wiki.lyx.org/uploads/Examples/XY-pic/xypic.pdf">pdf</a>).<p> + + <li><em>Drawing knot pictures using LaTeX with Xy-pic – An introduction and tutorial</em> + by Lars Fischer (<a href="http://lf.starlogik.de/drawing_knot_pictures.html">html</a>).<p> + + <li><em>Xy-pic tutorial with an archive of examples</em> + by Aaron Lauda (<a href="http://www.math.columbia.edu/~lauda/xy/">html</a>). + Uses low level Xy-pic directives for everything. + <p> + + <li><em>Tutorial de Xy-pic</em> + by Carlos A. P. Campani (<a href="http://ufpel.edu.br/~campani/xypictutorial.pdf">pdf</a>, in Portuguese).<p> + +</ul> + +Finally, we maintain a collection of +<a href="http://ctan.org/tex-archive/macros/generic/diagrams/xypic/xysamples/">examples</a> and +<a href="http://ctan.org/tex-archive/macros/generic/diagrams/xypic/xypapers/">papers</a> on CTAN. + +<p> + +If you know of other tutorials, interesting papers, or instructive examples, that can be shared, then please drop a note to the <a href="http://www.tug.org/mailman/listinfo/xy-pic">mailing list</a>! + +<h2>Help and Support</h2> + +Help and support on Xy-pic matters, as well as announcement of new versions, etc., is provided by the <a href="http://www.tug.org/mailman/listinfo/xy-pic">Xy-pic mailing list</a>, graciously hosted by <a href="http://tug.org">TUG</a>. + +<hr> +<p> +<a name="PS">*</a> PostScript and PDF are trademarks of <a href="http://www.adobe.com/">Adobe, Inc.</a> +<p> +<hr> +<address> +<a href="http://www.krisrose.net/">Kristoffer Høgsbro Rose</a> +— +$Id: Xy-pic.html,v 3.34 2010/06/10 18:45:49 krisrose Exp $ +— +Hits by +<A HREF="http://www.digits.com/thumbnail/"><IMG + ALT=WebCounter SRC="http://www.digits.com/thumbnail/wc-01.gif" + WIDTH=79 HEIGHT=22 BORDER=1 ALIGN=absmiddle></A>: +<IMG SRC="http://counter.digits.com/wc/-c/13/-d/5/-f/000000/-b/bebebe/Xy-pic" + ALIGN=absmiddle WIDTH=75 HEIGHT=20 BORDER=0 ALT=Count>. +</address> +</body></html> + +<!-- +-- $Log: Xy-pic.html,v $ +-- Revision 3.34 2010/06/10 18:45:49 krisrose +-- Reference to GPL by URL. +-- +-- Revision 3.33 2010/06/04 03:44:06 krisrose +-- More tutorials! +-- +-- Revision 3.32 2010/06/03 22:58:26 krisrose +-- Oops. +-- +-- Revision 3.31 2010/06/03 22:53:58 krisrose +-- Link documents on CTAN. +-- +-- Revision 3.30 2010/06/03 05:51:20 krisrose +-- Link to v3.8 documentation. +-- +-- Revision 3.29 2010/06/02 19:44:21 krisrose +-- Cleanup. +-- +-- Revision 3.28 2010/05/22 23:20:35 dmuellner +-- no message +-- +-- Revision 3.27 2010/05/21 04:36:29 krisrose +-- Experimental version with Alex's xymatrix adjustment modifiers as default. +-- +-- Revision 3.26 2010/05/17 23:29:21 krisrose +-- Experiment: generate all the Type1 fonts with METAPOST. +-- +-- Revision 3.25 2010/05/14 00:50:09 krisrose +-- Daniel's link included. +-- +-- Revision 3.24 2010/05/14 00:37:09 krisrose +-- Update documentation links to PDF and include Daniel's manual. +-- +-- Revision 3.23 2010/05/06 17:46:29 krisrose +-- Ross Moore's e-mail address updated. +-- Many obsolete files degraded to Historic. +-- +-- Revision 3.22 2010/04/28 20:17:28 krisrose +-- Link to (defunct) Y&Y Inc. +-- +-- Revision 3.21 2010/04/28 19:59:28 krisrose +-- Acknowledge properly. +-- +-- Revision 3.20 2010/04/28 19:31:55 krisrose +-- Boast about the style integration. +-- +-- Revision 3.19 2010/04/28 07:17:17 krisrose +-- PDF only in 3.8. +-- +-- Revision 3.18 2010/04/28 07:11:02 krisrose +-- Sic, again... +-- +-- Revision 3.17 2010/04/28 07:09:10 krisrose +-- CTAN samples and papers links... +-- +-- Revision 3.16 2010/04/28 07:05:39 krisrose +-- ß +-- +-- Revision 3.15 2010/04/28 07:01:24 krisrose +-- Users! +-- +-- Revision 3.14 2010/04/28 06:54:55 krisrose +-- Removed Latin1 specific characters. +-- +-- Revision 3.13 2010/04/28 06:50:42 krisrose +-- Removed dangling link. +-- +-- Revision 3.12 2010/04/28 06:43:27 krisrose +-- Sic. +-- +-- Revision 3.11 2010/04/28 05:39:25 krisrose +-- Checked and made version independent. +-- +-- Revision 3.10 2010/04/26 05:56:57 krisrose +-- Link fixes in progress... +-- +-- Revision 3.9 2010/04/21 18:41:02 krisrose +-- Adjustments preparing for xypdf.dtx and friends! +-- +-- Revision 3.8 2010/04/16 06:06:51 krisrose +-- Preparing for a new release... +-- +-- Revision 3.7 1999/02/16 15:01:59 krisrose +-- Updated for the interim 3.7. +-- +-- Revision 3.6 1998/03/06 01:28:05 krisrose +-- Releasing (with Y&Y fonts). +-- +-- Revision 3.5 1997/05/28 13:05:01 krisrose +-- Fixed missing breaks bug. +-- +-- Revision 3.4 1997/05/18 01:14:25 krisrose +-- Essential bugfixes. +-- +-- Revision 3.3 1996/12/19 17:03:13 krisrose +-- Maintenance release. +-- +-- Revision 3.2 1995/09/19 18:22:27 kris +-- Bug fix release. +-- +-- Revision 3.1 1995/09/05 20:31:32 kris +-- Releasing! +-- +-- Revision 3.0 1995/07/07 20:55:47 kris +-- Refers to v3! +-- +-- Revision 2.13 1995/07/04 15:11:17 kris +-- Ready to release v3? +-- +-- Revision 1.2 1994/10/06 16:43:38 kris +-- Cleaned up to be a proper Xy-pic home page. +-- +-- Revision 1.1 1994/08/29 12:24:13 kris +-- Initial revision +-- +-- Xy-pic `home page'. +--> |