summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/generic/mfpic/README
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/doc/generic/mfpic/README')
-rw-r--r--Master/texmf-dist/doc/generic/mfpic/README183
1 files changed, 73 insertions, 110 deletions
diff --git a/Master/texmf-dist/doc/generic/mfpic/README b/Master/texmf-dist/doc/generic/mfpic/README
index ff9292a13ce..42a2aa57bb0 100644
--- a/Master/texmf-dist/doc/generic/mfpic/README
+++ b/Master/texmf-dist/doc/generic/mfpic/README
@@ -1,34 +1,34 @@
%%% File: README
-%%% A part of mfpic 0.9 2006/05/26
+%%% A part of mfpic 1.00 2009/09/22
%%%
MFpic defines a command group \mfpic...\endmfpic (optionally in LaTeX
an environment, mfpic) and drawing commands to be used inside this group.
When TeX (or LaTeX) is run on a file containing those commands, a
-Metafont (or MetaPost) source file is created. When that file is correctly
-processed by Metafont (or MetaPost), and LaTeX or TeX is run again, the
+MetaPost (or Metafont) source file is created. When that file is correctly
+processed by MetaPost (or Metafont), and LaTeX or TeX is run again, the
result is a figure in the TeX document at the location of each
environment.
See install.txt for initial setup and brief installation instructions.
See mfpguide.pdf for a short tutorial. See below for a summary of
-features added since the previous official release (0.8a beta). See the
-manual mfpman.pdf for more detailed instructions and descriptions
+features added since the previous official release (0.9). See the
+manual mfpic-doc.pdf for more detailed instructions and descriptions
of features.
-This is mfpic version 0.9.
+This is mfpic version 1.00.
LEGALITIES
----------
All files of the core mfpic distribution (listed below) may be
distributed and/or modified under the conditions of the LaTeX Project
-Public License, either version 1.3b of this license or (at your option)
+Public License, either version 1.3c of this license or (at your option)
any later version. The latest version of this license is in
http://www.latex-project.org/lppl.txt
-and version 1.3b or later is part of all distributions of LaTeX version
-2006/12/01 or later.
+and version 1.3c or later is part of all distributions of LaTeX version
+2008/12/01 or later.
While every effort has been made to make mfpic useful, it comes with no
warranty, expressed or implied.
@@ -37,139 +37,102 @@ MANIFEST
--------
Here is a list, plus explanation of purpose, of all files in the mfpic
distribution. Read it *before* trying to process any of the example
-files. These, and the files generated by TeXing mfpic.ins, constitute
-the mfpic distribution to which the LPPL applies.
+files. These, and the files generated by running tex on mfpic.ins,
+constitute the mfpic distribution to which the LPPL applies.
The four files marked with * below are the only ones essential
for using all the facilities of mfpic.
-All the *.tex files in the src directory (except the plainTeX file
+All the *.tex files in the doc directory (except the plainTeX file
mfpcard.tex) require the LaTeX style file mfpdoc.sty. The mfpic manual
-is mfpman.pdf.
+is mfpic-doc.pdf.
+
+Source files:
+------------
+*mfpic.dtx Contains mfpic.sty and mfpic.tex
+*grafbase.dtx Contains grafbase.mf, grafbase.mp and dvipsnam.mp
+*mfpic.ins The unpacking script: run tex or latex on it. It reads
+ in mfpic.dtx and grafbase.dtx and produces the only
+ required run-time files: mfpic.sty, mfpic.tex,
+ grafbase.mf, grafbase.mp, and dvipsnam.mp
TeX/LaTeX code:
--------------
-*mfpic.dtx Contains mfpic.sty and mfpic.tex
-*mfpic.ins The unpacking script, run tex or latex on it. It
- reads in mfpic.dtx and grafbase.dtx and produces
- the only required files: mfpic.sty, mfpic.tex,
- grafbase.mf, grafbase.mp, and dvipsnam.mp
-*mfppatch.tex patches and bugfixes. Not required unless there are
- some
+*mfpic.tex Basic TeX/LaTeX code
+*mfpic.sty LaTeX2e \usepackage wrapper for mfpic.tex
+*mfppatch.tex patches and bugfixes. (Not actually required unless
+ there are some patches.)
MetaPost/Metafont code:
----------------------
-*grafbase.dtx Contains grafbase.mf, grafbase.mp and dvipsnam.mp
+*grafbase.mp MetaPost macros supporting mfpic
+*dvipsnam.mp Color definitions for MetaPost, input by grafbase.mp
+*grafbase.mf Metafont macos supporting mfpic
Documentation:
-------------
+ changes.txt Summary of 17 years of changes
+ install.txt Basic information on installation
+ README This file.
+ mfpguide.pdf Precompiled tutorial (usletter paper size)
+ mfpic-doc.pdf Precompiled manual (usletter paper size)
+ mfpcard.pdf Precompiled reference card (usletter, landscape).
+ mfpdoc.sty LaTeX style used by the next two
+ mfpguide.tex LaTeX source for mfpguide.pdf, requires mfpdoc.sty and
+ the mfpic package.
+ mfpic-doc.tex LaTeX source for mfpic-doc.pdf, requires mfpdoc.sty.
+ coil.mps Figure included in mfpic-doc.tex
+ mfpcard.tex reference card source, should fit on two sides of
+ either USletter or A4, rotated. Plain TeX.
+
+Examples:
+--------
+ pictures.tex Running tex on it produces pics.mp
+ lapictures.tex Running latex on it produces same pics.mp
+ data.dat Sample data file needed for above two
+ forfun.tex Example of \mfsrc: running tex on it produces fun.mp
- changes.txt Summary of changes
- install.txt Basic information on installation
- README This file.
- mfpguide.pdf Precompiled tutorial (usletter)
- mfpman.pdf Precompiled manual (usletter)
- mfpcard.pdf Precompiled reference card (usletter landscape).
- src/mfpcard.tex reference card source, should fit on two sides
- of either USletter or A4, rotated. Plain TeX.
- src/mfpdoc.sty LaTeX style used by the next two
- src/mfpguide.tex LaTeX source for mfpguide.pdf, requires mfpdoc.sty and mfpic
- src/mfpman.tex LaTeX source for mfpman.pdf, requires mfpdoc.sty
- src/coil.mps Figure included in mfpman.tex
-
- examples/pictures.tex Run tex, produce pics.mf file
- examples/lapictures.tex Run latex, produce pics.mf file (same)
- examples/data.dat Sample data file needed for above two
- examples/forfun.tex Example of \mfsrc: Run tex, produce forfun.mp
This distribution, the latest updates, and some past versions, should also be
available at my web site:
- <http://comp.uark.edu/~luecking/tex/mfpic.html>.
-
-IMPORTANT NOTE
---------------
-A minor (I hope) backward incompatibility has been introduced:
-
-By historical accident, the MetaPost macros of mfpic (grafbase.mp) have
-overwritten the primitive MetaPost commands "dashed" and "clipped".
-With this version, these commands are no longer overwritten. The files
-written by mfpic have not contained "dashed" for over 6 years, and have
-never (I believe) contained "clipped".
+http://comp.uark.edu/~luecking/tex/mfpic.html
-However, if you learned enough about grafbase macros to use these
-commands, or if you try to run mpost on old files created by mfpic, you
-may need to change occurences of "clipped" to "Clipped" and change
-occurences of "dashed" to "Dashed". If you run mpost on files created
-for Metafont, there may be occurances of "clip" that need to be changed
-to "Clipped".
-Also, if you have been delving into mfpic internals, almost all internal
-commands have been renamed.
-
-NEW FEATURES since Version 0.8a
+NEW FEATURES since Version 0.9
-------------------------------
- -- \arrowhead{<shape>} adds <shape> to head of a path.
- -- \arrowtail{<shape>} adds <shape> to tail of a path.
- -- \arrowmid {<shape>} adds <shape> to middle of a path.
-
- -- \zigzag, \sinewave, \coil: three new ways to render a path.
-
- -- \tlabel now allows a list of points even without mplabels.
-
- -- \border: a closed rectangle tracing the lines of the border axes.
-
- -- \startbacktext, \stopbacktext: Between these, labels are added in
- the background; all other elements of the figure are on top of them.
-
- -- \axisline{<letter>}: the line (without arrowhead) that
- \axis{<letter>} would draw.
-
- -- \griddotsize: a length command, the default size for dots in \grid.
-
- -- \vectorfield, a field of arrows determined by a formula in x and y.
- -- \plrvectorfield: vector formula is in polar variable r and t.
-
- -- \globalassignmfvalue: a global version of \assignmfvalue
- (\global\assignmfvalue didn't work with mplabels).
-
- -- \globalsetmfvariable, a global version of \setmfvariable.
-
- -- \norender: a prefix macro that cancels automatic rendering.
-
- -- \everymfpic, \everyendmfpic: commands to add to the start/end of
- every mfpic environment.
- -- \closedcurve = \cyclic (a possibly more easily remembered name).
- -- \closedconvexcurve = \convexcyclic
- -- \closedpolyline = \polygon
+ -- Color functions cmyk() and gray() produce colors in the cmyk and
+ grayscale color models, if the MetaPost version is at least 1.000.
+ Extensive changes needed in grafbase, almost none in mfpic itself.
+ Also cyan, magenta and yellow now predefined to be cmykcolor.
- -- \randomizepath: random changes to the nodes and controls of a path.
- -- \randomlines: connects randomly changed nodes with straight lines.
+ -- Color functions makecmyk, makergb and makegray force the conversion
+ of their argument to the indicated color model.
- -- \arc has a *-form that produces the complement of the arc that
- would have been formed otherwise.
- -- \arccomplement, used in front of any arc, produces the
- complementary arc. Arc need not be one produced by \arc.
+ -- Command \setfilenametemplate to set the file names for the graphics
+ output by MetaPost. Does not support putting the system time/date
+ in the name, even though MetaPost does.
- -- Loops (\mfploop, \mfpwhile and \mfpfor) are allowed outside mfpic
- environments as long as no drawing commands are used in them.
+ -- Commands \mfmode and \mfresolution to set the Metafont printer mode
+ and resolution, if pictures are to be created by Metafont.
- -- \mfpbarchart, \mfppiechart: versions of \barchart, \piechart for use
- outside \mfpic..\endmfpic. (Actual drawing must still be inside.)
+ -- Commands \cbeziers and \closedcbeziers. The cubic equivalents of
+ the quadratic \qbeziers and \closedqbeziers.
- -- Somewhat better cooperation with babel. Also better handling of
- filenames with special characters.
+ -- Command \pshcircle produces a circle in the hyperbolic geometry of
+ the unit disk or (star form) the upper half-plane. If you don't
+ know what that means, don't worry, it's for complex function
+ theorists (like me).
- -- \useraggedcaptions (option raggedcaptions) sets multiline captions
- (from \tcaption) raggedright. With centeredcaptions both sides are
- ragged. \noraggedcaptions restores the default justified captions.
+ -- Command \brownianmotion simulates Brownian motion.
- -- centeredcaptions option corrected in LaTeX.
+ -- \mfpverbtex is now cumulative when used prior to \opengraphsfile.
+ -- Better(?) handling of the filename argument of \opengraphsfile.
---
-Dan Luecking <luecking at uark dot edu>
+\sig
+Dan Luecking (luecking at uark dot edu)
Department of Mathematical Sciences
University of Arkansas
Fayetteville, Arkansas 72701-1201