Debian Codegraph @

texmf-dist/doc/generic/mfpic/README

raw
1 % File: README
2 % A part of mfpic 1.10 2012/11/13
3 %
4
5 MFpic defines a command group \mfpic...\endmfpic (optionally in LaTeX
6 an environment, mfpic) and drawing commands to be used inside this group.
7 When TeX (or LaTeX) is run on a file containing those commands, a
8 MetaPost (or Metafont) source file is created. When that file is correctly
9 processed by MetaPost (or Metafont), and LaTeX or TeX is run again, the
10 result is a figure in the TeX document at the location of each
11 environment.
12
13 See install.txt for installation instructions. See mfpguide.pdf for a
14 short tutorial. See below for a summary of features added since the
15 previous major release (1.0). See the manual mfpic-doc.pdf for more
16 detailed instructions and descriptions of features.
17
18 This is mfpic version 1.10
19
20 LICENSE
21 -------
22 All files of the core mfpic distribution (listed below) may be
23 distributed and/or modified under the conditions of the LaTeX Project
24 Public License, either version 1.3c of this license or (at your option)
25 any later version. The latest version of this license is
26
27 http://www.latex-project.org/lppl.txt
28
29 and version 1.3c or later is part of all distributions of LaTeX version
30 2008/12/01 or later.
31
32 DISCLAIMER
33 ----------
34 While every effort has been made to make mfpic useful, it comes with no
35 warranty, expressed or implied.
36
37 MANIFEST
38 --------
39 Here is a list, plus explanation of purpose, of all files in the mfpic
40 distribution. Read it *before* trying to process any of the example
41 files. These files constitute the mfpic distribution to which the LPPL
42 applies.
43
44 The six files marked with "+" below are the only ones essential to using
45 all the facilities of mfpic. The three files marked with "*" below are
46 sufficient to generate those essential files.
47
48 All the *.tex files in the doc directory (except the plain TeX file
49 mfpcard.tex) require the LaTeX style file mfpdoc.sty. The mfpic manual
50 is mfpic-doc.pdf. A tutorial is available in mfpguide.pdf.
51
52 The directory names given below are subdirectories of graphics/mfpic/ in
53 your nearest CTAN mirror (go to http://mirror.ctan.org/)
54
55 Source files (in source/):
56 ------------
57 *mfpic.dtx Contains mfpic.sty and mfpic.tex
58 *grafbase.dtx Contains grafbase.mf, grafbase.mp and dvipsnam.mp
59 *mfpic.ins The unpacking script: run tex or latex on it. It reads
60 in mfpic.dtx and grafbase.dtx and produces the six
61 required run-time files (marked "+" below)
62
63 TeX/LaTeX code (in tex/):
64 --------------
65 +mfpic.tex Basic TeX/LaTeX code
66 +mfpic.sty LaTeX2e wrapper for mfpic.tex
67 +mfpicdef.tex Input file used by metapost for TeX labels
68
69 MetaPost/Metafont code (in metapost/ and metafont/):
70 ----------------------
71 +grafbase.mp MetaPost macros supporting mfpic
72 +dvipsnam.mp Color definitions for MetaPost, needed by grafbase.mp
73 +grafbase.mf Metafont macos supporting mfpic
74
75 Documentation (in doc/):
76 -------------
77 changes.txt Summary of 20+ years of changes
78 install.txt Basic information on installation
79 README This file.
80 mfpguide.pdf Tutorial (usletter paper size)
81 mfpic-doc.pdf Manual (usletter paper size)
82 mfpcard.pdf Reference card (two sides of usletter, landscape).
83 mfpdoc.sty LaTeX style used by the next two
84 mfpguide.tex LaTeX source for mfpguide.pdf, requires mfpdoc.sty and
85 the mfpic package.
86 mfpic-doc.tex LaTeX source for mfpic-doc.pdf, requires mfpdoc.sty.
87 coil.mps Figure included in mfpic-doc.tex
88 mfpcard.tex reference card source, should fit on two sides of
89 either USletter or A4, rotated. Plain TeX.
90 lcheaders.ist makeindex style file for mfpic-doc.tex
91
92 Examples (in doc/examples/):
93 --------
94 pictures.tex Example pictures. Produces pics.mp. Plain TeX
95 lapictures.tex Same examples. Produces same pics.mp. LaTeX
96 data.dat Sample data file used by above two
97 forfun.tex Examples of \mfsrc. Produces fun.mp. Plain TeX
98
99
100 This distribution, any new updates, and some past versions, should also be
101 available at my web site:
102
103 http://comp.uark.edu/~luecking/tex/mfpic.html
104
105
106 NEW FEATURES since Version 1.0
107 -------------------------------
108
109 -- bugfix in \vectorfield. (1.01)
110
111 -- Work-around for some not-so-nice behavior of verbatimtex in some
112 versions of MetaPost. (1.02)
113
114 -- Bugfix in grafbase handling of color. (1.03)
115
116 -- Bugfix in \mfresolution and \mfmode. (1.04)
117
118 -- Changes to avoid namespace clashes in some internal macros. (1.05)
119
120 -- Differential equation plotters \DEgraph and \DEtrajectory added. (1.06)
121
122 -- Remove mfppatch.tex (which has never been used). (1.06)
123
124 -- Added file mfpicdef.tex for metapost labels. (1.07)
125
126 -- Added \quarterellipse, \halfellipse and \fullellipse. (1.07)
127
128 -- Added \gbrace for large braces in pictures. (1.07)
129
130 -- Added \hypergeodesic for certain (technical) circular arcs. (1.07)
131
132 -- Added \browniangraph and \randomwalk (1.07)
133
134 -- Added \gradient, \radialgradient and \areagradient (1.08)
135
136 -- Added \interpolatepath. Added \reversepath (= \reverse) (1.10)
137
138 \sig
139 Dan Luecking (luecking at uark dot edu)
140 Department of Mathematical Sciences
141 University of Arkansas
142 Fayetteville, Arkansas 72701-1201
143 U.S.A.