| 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. |