summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/mathspic/README.txt
blob: e84f830431cf444fe01cbf525b631da0a93d776b (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
%% readme.txt
%% for mathsPIC (version 1.00)

Name:-         mathsPIC (Perl version)
Authors:-      A. Syropoulos and R.W.D. Nickalls
Affiliation:-  see manual
Date:-         February 2005

(1) INTRODUCTION
-----------------
MathsPIC is an open-source `filter' program for the PiCTeX graphics package, which enables complicated drawings/diagrams to be constructed very easily (allows the flexible use of LaTeX commands, relative addressing, macros, libraries, and perl programs).

MathsPIC is a Perl program which processes an input script file (containing mathsPIC, TeX, LaTeX, and PiCTeX commands) into  a .tex file which can be processed in the usual way (by TeX or LaTeX) to  generate the final graphic. Please read the comprehensive manual for details of commands, usage, examples, installation etc.

MathsPIC will run on any platform having a working Perl and TeX/LaTeX installation. However, there may of course be minor differences regarding installation and usage between platforms.

MathsPIC has been well tested using a Solaris x86 box and GNU/Linux which the authors are familiar with. Feedback regarding installation and usage on other platforms will be greatly appreciated, and included in future manuals.

For details see the manual (mp1manual*.pdf).

(2) HISTORY
-----------
MathsPIC was originally an MS-DOS program (September 1999). mathsPIC was implemented in Perl in order to (a) greatly improve its utility, and (b) to make it available to the wide range of platforms which run Perl. An early version of the Perl mathsPIC was presented at the TUG2000 conference (Oxford, UK).

(3) REQUIRED SYSTEMS
--------------------
-perl (an interpreter for the perl language, see http://www.perl.com)


(4) PACKAGE FILES
------------------
The following files are included in the mathsPIC package.

readme.txt            % this file
mathspic.pl           % mathsPIC program (perl)
mathspic.sty          % style option
mathspic.1            % unix/Linux manpage file
HELP.TXT              % text version of the Unix manpage
mathspic.sh           % an example BASH file for running the program
MATHSPIC.BAT          % an example batch file (MS-Windows)
mathsPICa4.pdf        % manual (PDF) in A4 size
mathsPICa4.ps         % manual (PostScript) in A4 size
mathsPICa5.pdf        % manual (PDF) in A5 size
mathsPICa5.ps         % manual (PostScript) in A5 size
drawcube.pl           % perl program described in the manual
drawcurvedarrow.pl    % perl program described in the manual
grabtexdata.tex       % tex file (see manual) for accessing texfile data
mathspic.lib          % example library file of macros
sourcecode.pdf/.html  % perl source code
sourcecode.nw         % perl source code (noweb)
figures.tgz           % compressed file of all figure files in manual


(5) INSTALLATION (Unix/Linux)
-----------------------------
Four files need to be placed in specific locations as follows
(see also USAGE regarding the BASH script file)

(a) mathsPIC program (mathspic.pl)
This needs to be placed where your shell can find it
(typically: /usr/local/bin)

(b) mathsPIC BASH script (mathspic.sh)
This needs to be placed where your shell can find it
(typically: /usr/local/bin)

(c) LaTeX package (mathspic.sty)
This needs to be  placed with the other style options
(typically:  /usr/share/texmf/tex/latex/base/).

(d) manpage (mathspic.1)
place this file in the /man1/ directory
(typically:  /usr/share/man/man1/)

Actually, there is no need to install the shell script. Instead one
can just copy the file mathspic.pl to a directory where his/her shell
can find it and to rename it mathspic. Then one just need to make 
executable the file mathspic (e.g., by issuing the command 
chmod 755 mathspic).

(6) USAGE  (see manual for full details)
----------------------------------------
In Unix/Linux one way of running mathsPIC is to type the following at the command-line (options are shown in square brackets). Note this requires both the perl program (mathspic.pl) and the input file to be in the same directory.

Syntax:
   perl mathspic.pl [-b] [-c] [-h]  infile  [-o outfile]

Options:
 -b       enables bell/sound if errors are detected
 -c       disables writing of comments to output file
 -o       to be followed by the <outfile>
 -h       displays help info

However, it is generally much more convenient to run mathsPIC via a batch file, since we can then run mathsPIC from any directory.

For example (Unix/Linux) rename the example BASH file <mathspic.sh> to <mathspic>. Now change the user permissions to make it a read/write/executable  file. Finally, copy the file to a place where your shell will find it, typically the directory  /usr/local/bin/.  Now you will be able to run mathsPIC from the command-line in any directory using the command:-

mathspic  [-b] [-c] [-h]  infile  [-o outfile]

MS-Windows users can use the example MATHSPIC.BAT file similarly.

(7) LICENSE (LPPL):
-------------
 This program is free software; you can redistribute it and/or modify it under the terms of the LaTeX Project Public License.

  This program 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.
-----------------
End of README.txt
-----------------



=========================