summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/source/generic/xypic/INSTALL.Textures
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/source/generic/xypic/INSTALL.Textures')
-rw-r--r--Master/texmf-dist/source/generic/xypic/INSTALL.Textures393
1 files changed, 0 insertions, 393 deletions
diff --git a/Master/texmf-dist/source/generic/xypic/INSTALL.Textures b/Master/texmf-dist/source/generic/xypic/INSTALL.Textures
deleted file mode 100644
index 132fad86189..00000000000
--- a/Master/texmf-dist/source/generic/xypic/INSTALL.Textures
+++ /dev/null
@@ -1,393 +0,0 @@
--*-text-*- $Id: INSTALL.Textures,v 3.4 1997/05/18 01:13:24 ross Exp $
-
- ===============================================================
- INSTALLING THE Xy-pic DIAGRAM TYPESETTING MACROS ON A MACINTOSH
- ===============================================================
-
-This file assumes that you have downloaded the `xy34mac.sea.hqx'
-file and have decoded this and have expanded and extracted all files
-and folders from the resulting compressed archive.
-
-It also assumes that you have the TeX application called Textures(tm),
-from Blue Sky Research, Portland, Oregon (version 1.6 or later).
-
-Finally it assumes that you have read the file INSTALL.
-
-
-The main difference between Textures(tm) and other TeX implementations
-is the way in which fonts are handled. Here we deal with Macintosh
-font suitcases containing bitmap versions of the special fonts that
-Xy-pic uses, as well as a suitcase containing the font metrics.
-
-For users of OzTeX a folder called `for OzTeX only' contains .pk fonts,
-.tfm files and some configuration files. The file `INSTALL.OzTeX'
-explains how to install these.
-
-For any other implementations of TeX on the Macintosh, there may be
-sufficient files here to install Xy-pic. If not then obtain the full
-Xy-pic distribution from one of the usual ftp sites:
- ftp.mpce.mq.edu.au in the /pub/maths/TeX directory;
- ftp.brics.dk in the /Staff/krisrose/TeX directory;
- CTAN in the tex-archive/macros/generic/diagrams/xypic directory;
- e.g. at ftp.shsu.edu, ftp.tex.ac.uk and ftp.dante.de.
-
-(If this is still insufficient, then the author would like to know
-what other resources are required and why.
-Contact him by email at the address given below.)
-
-
-From version 2.10, the source files are NOT included with the
-Macintosh Distribution, as doing this would add almost 1 MByte
-to its overall size. Obtain them from the sites listed above.
-
-
-I'll also assume that you use a 300 dots per inch laser printer
-(like the Apple laserwriter or HP laserjet).
-
-Contents:
-
- -0- Simple Installation, for experienced users
- -1- Copyleft
- -2- Updating from version 2.6 (and earlier) or 2.7--2.12, 3.0--3.2
- -3- Overview of files and where they should be installed
- -4- Manuals and Sources
- -5- Memory Requirements
- -6- Bugs & comments
-
-----------------------------------------------------------------------
- -0- SIMPLE INSTALLATION, for EXPERIENCED USERS
-----------------------------------------------------------------------
-
-If you have never used Xy-pic before and are experienced as a user
-of Textures(tm), then the following instructions should be sufficient
-to get Xy-pic installed.
-
-You should have extracted two folders called `for TeX inputs folder'
-and `for TeX fonts folder' from the Stuffit archive.
-
-Simply copy the contents of these folders to the places indicated by
-their names; namely the font suitcases go into the `TeX Fonts` folder,
-while the `xy*.tex` source code files go into the `TeX inputs` folder.
-
-
-If these instructions do not make sense to you, or you get any warning
-messages when you try to carry out these steps, then...
-
- STOP immediately!
-
-... read the rest of this file, to learn more about Xy-pic, what all
-the files contain and how they should be installed on your Macintosh.
-
-If you had no trouble with this installation, then... enjoy Xy-pic!
-Please do us the courtesy of reading the rest of this file anyway.
-In particular please respect the following Copyright message, making
-sure that any copies that you may distribute are complete, so that
-others can equally enjoy Xy-pic (... and so that we do not get irate
-messages about missing features).
-
-----------------------------------------------------------------------
- -1- COPYLEFT
-----------------------------------------------------------------------
-
-This distribution of the Xy-pic package is distributed with copyleft:
-
- Copyright (c) 1991-1997 Kristoffer H. Rose <krisrose@brics.dk>
- Copyright (c) 1994-1997 Ross Moore <ross@mpce.mq.edu.au>
-
- 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.
-
-What this means is that if you install Xy-pic then you should (1) make
-sure that the file COPYING is accessible to the users, and (2) be
-prepared to provide Xy-pic (including sources) to any of your users
-that request it (you may charge a fee for this if you are so inclined).
-
-----------------------------------------------------------------------
- -2- UPDATING FROM VERSION 2.6 (AND EARLIER) OR 2.7--2.12, 3.0--3.2
-----------------------------------------------------------------------
-
-Xy-pic version 2.7 was almost a complete rewrite of Xy-pic. The update
-to version 2.8 fixed numerous small bugs and added PostScript \special
-commands that could be used instead of the Xy-pic fonts.
-In version 2.9 the PostScript functionality was extended to include
-effects such as rotation and scaling of diagrams and text, variable
-line thickness and colour support. There were also improvements in many
-other aspects of the way Xy-pic works.
-
-A Macintosh version of 2.9 was never released, as some of the claimed
-effects did not actually work. These bugs were fixed for version 2.10.
-
-Version 2.11 included the `Graph Combinator' feature which provides
-a simplified interface for many common classes of diagrams.
-Also some minor bugs were fixed, both in code and documentation.
-
-Version 2.12 is necessary to accommodate a change to AMS-LaTeX which
-otherwise seriously conflicts with internal structure of Xy-pic.
-A new `Polygon' feature has been added and many subtle bugs fixed.
-Also much of the `curve' code has been improved, especially for
-`curved arrows'.
-
-Also, versions 2.12+ provide for a new font for arrow-tips, in the style
-of those arrowheads that appear in the Computer Modern fonts.
-Fonts xycmat10 and xycmbt10 have always been included in the font
-suitcases (since version 2.6) but not used due to errors in the metrics.
-This has now been rectified --- this means that the font metric file
-`Xy-pic metrics' MUST BE REPLACED with the latest version --- having
-modification date: 20 August 1994 --- but the fonts are unchanged.
-
-Xy-pic version 3.0 was released in July 1995. New features included
-one for typesetting `crossing strings', in particular elegant
-representations of `knots', and one for `webs' or `lattices' of objects
-regularly spaced. There was no separate Macintosh distribution, but the
-macros would work with the earlier versions.
-With version 3.0 an improved option-loading mechanism was established
-for alternate dvi-drivers allowing extra effects using \special commands.
-
-To use such features place one of the following declarations in the
-document preamble:
-
- \xyoption{textures} % with version 1.7 or later
- \xyoption{16textures} % with version 1.6 of Textures
-
-If LaTeX is NOT being used then it is also necessary to specify
-
- \xyReloadDrivers
-
-after all Xy-pic options have been specified.
-With LaTeX, this command occurs automatically at the \begin{document}.
-
-This version 3.4 contains just a few fixes found to necessary after
-the extensive changes of the 3.3 release. Some PostScript effects
-were broken, but now patterned tilings work again and frames are
-better than ever, even for non-PostScript effects. The old v2 macros
-which stopped working are now properly enabled.
-
-The version 3.3 was very stable for most purposes. A few bugs from
-previous versions were fixed and some new features were
-added. In particular `breaks' in connections, whether straight or
-curved, now work correctly. There is a greater variety of arrow-tips.
-Intersections between a curved connection and a straight one can
-now be located, or the point of closest approach can be located.
-
-The previous Version 3.2, followed closely after Version 3.1, fixing
-several bugs found there. Some diagrams in the documentation were
-found to not print correctly on some PostScript printers due to
-internal errors in the PostScript interpreter; these diagrams have
-been altered slightly to avoid that problem. (A future release of
-Xy-pic will attempt to sidestep such problems completely.)
-
-Indeed the Version 3.1 release fixes bugs in earlier releases,
-improves the range of available `frames' and offers a wider range
-of curved objects.
-The number of different dvi-drivers has been extended, though this
-has little bearing for Macintosh-users.
-
-
-
-If you already have version 2.7 (or later) installed then:
-
-* Copy the file: `Xy-pic metrics' , to be found in the folder called
- `for TeX fonts folder', into your `TeX Fonts' folder.
-
-+ The file `Xy-pic fonts' contains no new fonts, so need not be updated.
-
-+ With version 7.1+ of the Macintosh operating system, you can place
- font suitcases in the Fonts subfolder of the system folder.
- However the `Xy-pic metrics' suitcase MUST be in the `TeX Fonts' folder.
-
-+ Extra font sizes are available in a separate archive called `xymacxf.sit',
- see below for more details. These can be installed locally, if desired.
- Alternatively the extra sizes may be installed on a file-server;
- then place an `alias' (requires system 7.0+) to them within the `TeX Fonts'
- folder --- the server will mount when Textures is launched.
-
-
-* Copy the contents of the `for TeX inputs folder' into the
- obvious place, i.e. the `TeX Inputs' folder, allowing these files to
- replace the existing ones of the same name.
-
-+ With the system-7 operating system, you can place the files/folders
- elsewhere, and place aliases to them within the `TeX Inputs' folder.
-
-
-
-If you already have version 2.6 (or some earlier version) installed then
-note the following:
-
-* All the fonts have been redone AND renamed. Thus installing the new
- version will not break any typeset files you already have that use
- the old fonts. However if you intend to keep the old version on your
- system then you should rename the font and metrics suitcases to
- `Xy-pic fonts.old' and `Xy-pic metrics.old'.
-
-* The distribution contains new versions of the files `xypic.tex' and
- `xypic.sty' that load Xy-pic 2.12 in a special compatibility mode.
- Thus re-TeX'ing your source documents will create typeset versions
- using the new fonts. If you wish to keep the old `xypic.tex' and
- `xypic.sty' then you should rename them before installation.
-
-* There are a few points where the backwards compatibility is not
- perfect -- these are noted in the documentation.
-
-
-----------------------------------------------------------------------
- -3- OVERVIEW OF FILES AND WHERE THEY SHOULD BE INSTALLED
-----------------------------------------------------------------------
-
-The installation instructions of INSTALL apply except that
-
-MACRO FILES: are placed in the `for TeX inputs folder' and should
-normally be duplicated to the `TeX Inputs' folder (after having
-appropriately dealt with any previous version, as described above).
-
-PostScript HEADER FILES: It is not necessary to use this header file;
-furthermore the reference manual describes how it can be generated if
-needed from `xyps.tex'.
-
-Xy-pic FONTs and METRICs: the two font suitcase files, called `Xy-pic
-fonts' and `Xy-pic metrics', are found in the folder called `for TeX
-fonts folder'. Simply move these into the Textures(tm) `TeX Fonts'
-folder (after having appropriately dealt with any previous version, as
-described above).
-
-When you next launch the Textures(tm) application the following fonts will
-then be available for use in typesetting with the Xy-pic macros.
-
- xydash10 straight line segments at 128 different angles
- xyatip10 top half of an arrow head at 128 different angles
- xybtip10 bottom half of arrow head at 128 different angles
- xybsql10 small quarter turns, for hooks, turns and wavy lines
- xycirc10 eighth-turns at 16 different radii, 8 per radius
-
- xycmat10 Computer Modern Tips --- upper barbs
- xycmbt10 Computer Modern Tips --- lower barbs
- xyeuat10 Euler Tips --- upper barbs
- xyeubt10 Euler Tips --- lower barbs
-
-These fonts are each provided in four screen sizes: 100% 120% 200% 240%
-and in one size for laser-printing at 300dpi: 417%.
-
-If more sizes are required then either:
-
- a) get the file `xymacxf.sit.hqx' from ftp.mpce.mq.edu.au.
- These expand to give suitcases containing the above sizes plus extra
- laserwriter sizes, corresponding to magsteps 0.5, 1, 2, 3, 4, 5.
- (The xycirc10 is separate since these fonts occupy more space than
- any of the others --- 2.2 MByte!! )
-
-or...
-
- b) generate extra sizes using Metafont.
- The appropriate xy*.mf source files are included in the sub-directory
- `mfinputs'. This can be obtained from the ftp sites listed above.
-
- xydash10.mf kernel font sources
- xyatip10.mf
- xybsql10.mf
- xybtip10.mf
- xycirc10.mf
-
-With the xy*.tex and xy*.sty input files installed in the `TeX Inputs'
-folder, and the font suitcases installed in the `TeX Fonts' folder,
-you should be ready to use Xy-pic to typeset some diagrams.
-
-DOCUMENTATION: The dvi-files are provided primarily for non-Textures
-users. Using the `DVI-Tool' application, they can be converted into
-the usual form for documents typeset using Textures(tm). However this is
-not necessary as it has been done already: the `Xy-pic User's Guide'
-and `Xy-pic Reference Manual' described below.
-
-
-----------------------------------------------------------------------
- -4- MANUALS and SOURCES
-----------------------------------------------------------------------
-
-The `Xy-pic User's Guide' and `Xy-pic Reference Manual' are provided
-with this distribution. They are in the form of pre-typeset Textures(tm)
-documents. These files are Finder-locked and should NOT be re-typeset.
-(Indeed it should not be possible to typeset this file without first
-removing the safe-guards which have been put in place.)
-
-It is a good idea to test your installation of Xy-pic by typesetting
-portions from the manuals. Of course you will first have to obtain
-these sources from one of the ftp sites listed above, or elsewhere.
-
-Alternatively you can try to typeset the complete manuals, using LaTeX,
-from the documents `xyguide.man' and `xyrefer.man' in the directory `src`
-where they are located along with all the input and non-standard style
-files that they need.
-You will need to obtain ALL the files in this directory.
-(There is a file named `xy*.doc' for each macro file `xy*.tex'
-placed in the `TeX Inputs' folder.)
-For this to be successful your Textures application will need a
-memory partition of at least 4.5 MBytes.
-
-The normal sequence should be followed: LaTeX, BibTeX, LaTeX, LaTeX
-to get all the references and the bibliography typesetting correctly.
-These manuals have been checked to work correctly with LaTeX 2.09 and
-LaTeX2e.
-
-An alternative way to get the manuals is to download the files called
-`xyguide.ps.Z' and `xyrefer.ps.Z' from one of the ftp-sites.
-These files were created using the `xyps' PostScript option, so should
-produce a higher quality printed output on a PostScript printer of
-resolution 300dpi (due to use of bitmapped Computer Modern fonts).
-
-
-----------------------------------------------------------------------
- -5- MEMORY REQUIREMENTS
-----------------------------------------------------------------------
-
-Although many efforts have been made to make Xy-pic work quickly and
-efficiently, the nature of the diagrams for which it is designed are
-sometimes necessarily quite large and consume a significant amount of
-TeX's available memory. Do not be surprised if it takes a long time
-to typeset a diagram having several rows and columns of entries.
-
-Usually I work with a memory partition set at 4 MBytes, on a Mac IIci
-or Macintosh PowerBook. For instance, when typesetting the User's Guide,
-using LaTeX-2e and Xy-pic, nearly all of this 4 MBytes is required.
-The Reference Guide requires even more than this: allowing 8 MByte was
-a luxury that I could afford, but I suspect that 4.5 MByte would have
-been sufficient. Mind you, although shorter the Users' Guide actually
-takes significantly longer to typeset than does the Reference Manual.
-
-
-----------------------------------------------------------------------
- -6- BUGS & COMMENTS
-----------------------------------------------------------------------
-
-Comments or reports related to the Macintosh distribution should be
-sent to Ross Moore at
-
- Electronic mail (Internet): ross@mpce.mq.edu.au [preferred]
-
- Paper mail: Ross Moore
- Mathematics Department,
- Macquarie University
- North Ryde, NSW 2109
- AUSTRALIA
-
- Fax +61 2 9850 8114 attn: R.Moore
-
-----------------------------------------------------------------------
-
-This is the end of `INSTALL.Textures'. We hope you'll enjoy Xy-pic !
-
---
-Ross MOORE Internet: ross@mpce.mq.edu.au
-Mathematics Dept, Macquarie University, Nth Ryde, NSW 2109, AUSTRALIA
-phone: +61 2 9850 8955 fax: +61 2 9850 8114
-WWW: http://www-math.mpce.mq.edu.au/~ross/
---