Index of /afs/athena.mit.edu/contrib/tex-contrib/XYPic

      Name                    Last modified       Size  Description


[DIR] Parent Directory        06-Apr-2007 09:14      -  
[   ] CATALOG                 17-Jan-1996 20:50     1k  
[   ] COPYING                 17-Jan-1996 20:50    18k  
[   ] INSTALL                 17-Jan-1996 20:50    12k  
[   ] MANIFEST                12-Oct-1995 09:50     8k  
[   ] TRAILER                 19-Sep-1995 10:58     4k  
[   ] VERSIONS                12-Oct-1995 09:45     4k  
[DIR] doc/                    17-Jan-1996 21:21      -  
[DIR] fixes/                  17-Jan-1996 21:08      -  
[DIR] mfinputs/               17-Jan-1996 21:06      -  
[DIR] papers/                 17-Jan-1996 20:43      -  
[DIR] pkfonts/                17-Jan-1996 21:03      -  
[DIR] ps/                     17-Jan-1996 21:00      -  
[DIR] psfonts/                17-Jan-1996 20:59      -  
[DIR] samples/                17-Jan-1996 20:43      -  
[DIR] src/                    17-Jan-1996 20:43      -  
[DIR] texfonts/               17-Jan-1996 20:58      -  
[DIR] texinputs/              17-Jan-1996 20:57      -  

-*-text-*- $Id: README,v 3.1 1995/09/05 20:31:32 kris Exp $

	======================================================
	THE Xy-pic PACKAGE FOR TYPESETTING GRAPHS AND DIAGRAMS
	======================================================

Xy-pic is a package for typesetting graphs and diagrams with TeX.

It works with most formats, including LaTeX, AMS-LaTeX, AMS-TeX, and
plain TeX.

It has been used to typeset complicated diagrams from many application
areas including category theory, automata theory, algebra, neural
networks, and database theory.

				 - o -

Xy-pic is structured as a `kernel' and several orthogonal modules called
`options', each defining a custom notation for a particular kind of
graphical object or structure.

These (combinable) structures are available:

* A graph combinator mode where diagrams are specified the way they are
  composed as graphs.

* A matrix-like mode where the dimensions of the drawing are computed by
  aligning diagram entries in rows and columns (this is the `diagram'
  mode Xy-pic version 2 users are used to).

* A polygon mode where diagrams shaped as regular polygons are entered
  in a simple way.

* A mode for typesetting beautiful knots and links.

* A general object-oriented `turtle graphic' drawing language for
  specifying graphs with objects and connections between them in a
  manner independent of orientation.

The following objects may be used:

+ 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.

+ Objects may be circular, elliptic, or rectangular (more shapes can be
  added) and adjusted in several ways.

+ Large library of objects with mnemonic names.

+ Objects that orient themself along a connection when placed relative
  to it, e.g., `\dir{|-}' is like \vdash but thus oriented; new such
  objects can be defined in a convenient way.

+ TeX `boxes', i.e., text and mathematical formulae.

+ Includes circle segments and optionally arbitrary elliptical,
  quadratic, and cubic arcs.

+ Connections are aligned between the reference points of objects but
  start and end on the edges.

+ Any object can be used to build a connection (using `diagonal
  filling'); library objects provide common line types.

+ 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 `go by' other entries, paired
  arrows (including support for 2-cells), curved arrows, and arrows with
  bends.

+ Library of frames and braces.

+ Special notation for rotation, scaling, colour, and line thickness.
  The correct typesetting of these features requires a backend that
  supports it (i.e., PostScript) 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).

+ Output can use PostScript for drawing (several \special formats are
  supported: dvips, Textures, and OzTeX -- more are being added
  continuously: contact Ross Moore <ross@mpce.mq.edu.au> for the current
  list).  Notation for inclusion of literal PostScript is available.

* Other graphics can be imported and then `decorated' using Xy-pic.

All object forms may be used with all structures.

				 - o -

See CATALOG for up to date version information!
See TRAILER for author and accessibility information!
See COPYING for the conditions for redistribution and modification!
See MANIFEST for a complete file list!
See VERSIONS for the exact list of the versions of all source files!
See the various INSTALL files for how to install Xy-pic on your system!
See the W3 <URL: http://www.diku.dk/~kris/Xy-pic.html> for news!

And finally, enjoy Xy-pic!

Sincerely,
		Kristoffer H. Rose	<kris@diku.dk>
		Ross Moore		<ross@mpce.mq.edu.au>