summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/support/texdraw/README
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/doc/support/texdraw/README')
-rw-r--r--Master/texmf-dist/doc/support/texdraw/README84
1 files changed, 20 insertions, 64 deletions
diff --git a/Master/texmf-dist/doc/support/texdraw/README b/Master/texmf-dist/doc/support/texdraw/README
index 91cced49d63..370b91dea05 100644
--- a/Master/texmf-dist/doc/support/texdraw/README
+++ b/Master/texmf-dist/doc/support/texdraw/README
@@ -1,6 +1,6 @@
-This file describes the contents of the distribution for TeXdraw
+This file describes the contents of the distribution for TeXdraw.
-$Id: README,v 2.0 1995/12/18 texdraw-V2R0 $
+$Id: README,v 2.0a 2019/03/28 texdraw-V2R0a $
The TeXdraw package consists of a set of macro definitions for the TeX
typesetting program. These macros allow the user to produce PostScript
@@ -30,11 +30,17 @@ The extensibility features include,
(2) local segment scaling
(3) saving and restoring positions using symbolic positions
-The compressed file texdraw-V2R0.tar.Z is available for anonymous ftp on
-ftp.TSP.EE.McGill.CA in directory /pub/tsp/texdraw.
+Version 2.0a was rleased in March 2019; the only substantive
+modification was to change the license to CC-BY (any version).
+Also, an Info direntry is created by texdraw.texi, and
+minor changes were made to this README and other documentation files.
+For the distribution:
+- A PDF version of the manual was added.
+- the Texinfo source files (texindex.c, texi2dvi, etc.) were removed, as
+they are readily available elsewhere and cannot be kept up to date here.
=====
-Peter Kabal kabal@TSP.EE.McGill.CA
+Peter Kabal peter dot kabal at mcgill dot ca
Department of Electrical Engineering
McGill University
Montreal, Quebec
@@ -42,8 +48,7 @@ Montreal, Quebec
=====
The distribution consists of the TeXdraw macros themselves, files with
-auxiliary macros, and the TeXdraw manual (texinfo format, also as a
-PostScript file).
+auxiliary macros, and the TeXdraw manual (Texinfo format).
Distribution Contents:
----------------------
@@ -61,27 +66,10 @@ TeXdraw macros (main directory):
txdexamp.tex - plain TeX code for the examples in the manual
txdexamp.latex - LaTeX2e code for the examples in the manual
-compacted TeXdraw macros (directory compact/):
- texdraw.tex
- txdtools.tex
- txdps.tex
-
TeXdraw documentation (directory manual/):
+ texdraw.pdf - PDF version of the manual
texdraw.ps - PostScript version of the manual
texdraw.texi - Texinfo source file for the TeXdraw manual
- texdraw.aux - cross-references (generated by an earlier run, used
- as input when TeX'ing the manual)
- texdraw.cps - concept index (generated by an earlier run, used as
- input when TeX'ing the manual)
- texdraw.fns - sorted functon index (generated by an earlier run,
- used as input when TeX'ing the manual).
-
-GNU Texinfo utilities (directory manual/):
- texindex.c - Source for the texindex program
- getopt.h - Include file for texindex.c
- texinfo.tex - Texinfo macros used to make manuals and on-line
- documentation
- texi2dvi - Script to run TeX and texindex
===============================================
The following notes on setup are for Unix systems.
@@ -89,7 +77,7 @@ The following notes on setup are for Unix systems.
Initial Tests:
(1) Print the PostScript version of the manual ("texdraw.ps") to see the
- capabilities of TeXdraw.
+ capabilities of TeXdraw. (Or PDF.)
(2) Try TeX'ing the examples file. Assuming plain TeX is invoked with the
command "tex" and LaTeX2e is invoked with the command "latex"
% tex txdexamp
@@ -102,10 +90,6 @@ Initial Tests:
=====
Permanent Setup:
-Compact source files:
-In the subdirectory "compact", there are versions of the macro files
-with most comments and white space removed.
-
(1) Private copy of TeXdraw.
Move the TeXdraw sources files ("texdraw.sty", texdraw.tex",
"txdtools.tex" and "txdps.tex") to an appropriate directory. If you are
@@ -113,7 +97,7 @@ with most comments and white space removed.
~mylogin/tex . With many versions of TeX, including this directory in
the TeX input path variable (the environment variable TEXINPUTS) allows
you to refer to the files in TeX without specifying the full pathname.
- With the C-cshell, a line in the ".login" file sets the environment
+ With the C shell, a line in the ".login" file sets the environment
variable TEXINPUTS
% setenv TEXINPUTS ".:$HOME/tex:".
The last part of the path string should terminate with a colon to have
@@ -121,21 +105,8 @@ with most comments and white space removed.
(2) Public copy of TeXdraw.
Move the TeXdraw source files ("texdraw.sty", "texdraw.tex",
"txdtools.tex" and "txdps.tex") to a directory that TeX searches by
- default. This might be a directory such as "/usr/local/lib/tex/inputs".
- Newer versions of TeX allow subdirectory searching - in that case, use
- the directory "/usr/local/lib/tex/inputs/TeXdraw".
-
-=====
-The following instructions pertain to installing the ability to use the
-Texinfo system for any texinfo type manual.
-(1) The GNU program "texindex" should built using
- % cc texindex.c -o texindex
- Move the program to an appropriate place such as "/usr/local/bin".
-(2) The GNU script "texi2dvi" runs TeX and texindex for a texinfo file.
- Move this script to an appropriate place such as "/usr/local/bin".
-(3) The GNU "texinfo.tex" file should go into the public directories
- searched by TeX, for instance "/usr/local/lib/tex/inputs", or
- "/usr/local/lib/tex/inputs/texinfo".
+ default. If installed from a distribution, this should be
+ handled by the package manager.
=====
Creating a TeXdraw manual from the sources:
@@ -144,27 +115,12 @@ Creating a TeXdraw manual from the sources:
(2) To create the manual, you have to TeX the manual twice - the second
time to access the sorted indices and the cross-references. The
program "texindex" sorts the indices. (The distribution includes pre-
- sorted indices that can be used). The three steps can be replaced by
- an invokation of the script "texi2dvi".
+ sorted indices that can be used). Or the three steps can be replaced by
+ an invocation of the script "texi2dvi".
% tex texdraw.texinfo
% texindex texdraw
% tex texdraw.texinfo
(3) If you have the printer driver program dvips, a PostScript version of the
manual is created as follows.
% dvips texdraw -o texdraw.ps
-
-=====
-On-line info manual:
-
-Consider building an info version of the manual. For this you need the
-GNU program "makeinfo" (available by anonymous ftp from prep.ai.mit.edu
-as part of texinfo-XXX.tar.gz). After running "makeinfo texdraw", the top
-level info directory file "dir" in /usr/local/emacs/info needs to be
-updated to include a menu entry for TeXdraw. This entry is of the form
-* TeXdraw: (texdraw).
- TeXdraw is a collection of macros that allow drawings to be
- created from within TeX.
-Also the files produced by makeinfo (texdraw, texdraw-1, texdraw-2, and
-texdraw-3) need to be moved there. The info file can be read from within
-the emacs editor, or with the info reader program "info" (also part of the
-texinfo distribution).
+(4) The targets in manual/Makefile handle this.