% File: README
% A part of mfpic 1.06 2011/03/08
%

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
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 major release (1.00). See the manual
mfpic-doc.pdf for more detailed instructions and descriptions of
features.

This is mfpic version 1.06.

LICENSE
-------
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.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.3c or later is part of all distributions of LaTeX version
2008/12/01 or later.

DISCLAIMER
----------
While every effort has been made to make mfpic useful, it comes with no
warranty, expressed or implied.

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 running tex on mfpic.ins,
constitute the mfpic distribution to which the LPPL applies.

The five files marked with + below are the only ones essential to using
all the facilities of mfpic. The three files marked with * below are
sufficient to generate those essential files.

The mfpic reference manual is mfpic-doc.pdf. A tutorial is available in
mfpguide.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
                  required run-time files mfpic.sty, mfpic.tex,
                  grafbase.mf, grafbase.mp, and dvipsnam.mp

TeX/LaTeX code:
--------------
 + mfpic.tex      Basic TeX/LaTeX code
 + mfpic.sty      LaTeX2e \usepackage wrapper for mfpic.tex

MetaPost/Metafont code:
----------------------
 + grafbase.mp    MetaPost macros supporting mfpic
 + dvipsnam.mp    Color definitions for MetaPost, input by grafbase.mp
 + grafbase.mf    Metafont macros supporting mfpic

Documentation:
-------------
 changes.txt    Summary of 19 years of changes
 install.txt    Basic information on installation
 README         This file.
 mfpcard.pdf    Precompiled reference card (usletter, landscape).
 mfpguide.pdf   Precompiled tutorial (usletter paper size)
 mfpic-doc.pdf  Precompiled manual   (usletter paper size)
 mfpcard.tex    plain TeX source for mfpcard.pdf, should fit on two
                sides of either USletter or A4, rotated.
 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,
                lcheaders.ist amd coil.mps.
 mfpdoc.sty     LaTeX style used by the above two
 lcheaders.ist  makeindex style file for mfpic-doc.tex
 coil.mps       Figure included in mfpic-doc.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


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


NEW FEATURES since Version 1.0
-------------------------------

 -- bugfix in \vectorfield. (1.01)

 -- Work-around for some not-so-nice behavior of verbatimtex in some
    versions of MetaPost. (1.02)

 -- Bugfix in grafbase handling of color. (1.03)

 -- Bugfix in \mfresolution and \mfmode. (1.04)

 -- Changes to avoid namespace clashes in some internal macros. (1.05)

 -- Differential equation plotters \DEgraph and \DEtrajectory added. (1.06)

 -- Some internal macros changed, some documentation changes made.
    (1.01-1.06)

 -- Remove mfppatch.tex (which has never been used). (1.06)

\sig
Dan Luecking  (luecking at uark dot edu)
Department of Mathematical Sciences
University of Arkansas
Fayetteville, Arkansas 72701-1201
U.S.A.
