summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/generic/mfpic/install.txt
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/doc/generic/mfpic/install.txt')
-rw-r--r--Master/texmf-dist/doc/generic/mfpic/install.txt97
1 files changed, 59 insertions, 38 deletions
diff --git a/Master/texmf-dist/doc/generic/mfpic/install.txt b/Master/texmf-dist/doc/generic/mfpic/install.txt
index 9e881942298..c20b18c76e2 100644
--- a/Master/texmf-dist/doc/generic/mfpic/install.txt
+++ b/Master/texmf-dist/doc/generic/mfpic/install.txt
@@ -1,9 +1,9 @@
-%%% File: instruct.txt
-%%% A part of mfpic 0.7a beta 2004/04/16
+%%% File: install.txt
+%%% A part of mfpic 0.9 2006/05/26
%%%
-This is an alpha-test version of mfpic. See README.txt for a list of
-files and a brief description of each.
+This is version 0.9 of mfpic. See README.txt for a list of files and a
+brief description of each.
Generating and installing the files
-----------------------------------
@@ -20,13 +20,14 @@ Generating and installing the files
-- If you have an older version of mfpic, remove the old files with the
same names as the above five from your TeX directories, or ensure
that the following procedure overwrites them (back them up somewhere
- else first if you wish).
+ else first if you wish). Do the same for mfppatch.tex.
--- Copy mfpic.tex (and mfppatch.tex, if it exists) where TeX or LaTeX
- will find it, and mfpic.sty where LaTeX will find it. On any TDS
- compliant system (such as teTeX, fpTeX, TeXLive, or MiKTeX) they can
- both be put in $TEXMF/tex/generic/mfpic/ (where $TEXMF indicates a
- directory serving as a root of a texmf tree).
+-- Copy mfpic.tex and mfppatch.tex where TeX and LaTeX will find it, and
+ mfpic.sty where LaTeX will find it. On any TDS compliant system (such
+ as teTeX, fpTeX, TeXLive, or MiKTeX) they can all be put in
+ $TEXMF/tex/generic/mfpic/
+ (where $TEXMF indicates a directory serving as a root of a texmf
+ tree).
-- Copy grafbase.mp and dvipsnam.mp where MetaPost will find them, for
example $TEXMF/metapost/mfpic/ .
@@ -34,13 +35,24 @@ Generating and installing the files
-- Copy grafbase.mf where Metafont will find it. For example,
$TEXMF/metafont/mfpic/ .
--- Copy mfpguide.pdf and mfpman.pdf where documentation is kept. For
- example, $TEXMF/doc/generic/mfpic/ . Optionally, copy src/*.* to the
- LaTeX input path, and examples/*.* to either the same place or the
- documentation area.
+-- Copy mfpguide.pdf, mfpman.pdf. mfpcard.pdf where documentation is
+ kept. For example, $TEXMF/doc/generic/mfpic/ . Optionally, copy
+ src/*.* and examples/*.* either to the documentation area or to
+ the same place as mfpic.tex. Also optional: copy the two .dtx files
+ and mfpic.ins to the source area ($TEXMF/source/generic/mfpic/).
--- If required by your TeX system (MiKTeX, teTeX, fpTeX, TeXLive
- DO require it): UPDATE THE TeX FILENAME DATABASE !
+-- Some distributions might have a copy of the file grafbase.mf in the
+ directory $TEXMF/fonts/public/mfpic. If so, delete it or replace it
+ with a copy of the new one. If some package needs that particular
+ version, put it someplace where mf and mpost will _not_ find it and
+ arrange for that package to find it when necessary.
+
+-- If required by your TeX system (MiKTeX, teTeX, fpTeX, XemTeX, and
+ TeXLive all DO require it):
+
+ *************************************
+ * UPDATE THE TeX FILENAME DATABASE! *
+ *************************************
There is one optional step that may be useful (if you only wish to use
mfpic to produce MetaPost pictures, you may skip this): find the file
@@ -56,60 +68,69 @@ change, regenerate the mf.base file (fmtutil on teTeX, fpTeX or TeXLive;
MiKTeX Options in MiKTeX). On some systems this may be named plain.base.
Read mfpguide.pdf before trying anything further. If you are already
-familiar with mfpic, version 0.2.10.9 or later, you can probably get
+familiar with mfpic (version 0.2.10.9 or later) you can probably get
going right away.
If you want to read the documented source code for mfpic, run latex on
mfpic.dtx and grafbase.dtx (Peter Wilson's docmfp.sty is required
for grafbase.dtx) 2 or 3 times each. Then run makeindex for each:
- makeindex -s gind.ist -o mfpic.ind mfpic.idx
+ makeindex -s gind.ist -o mfpic.ind mfpic.idx
makeindex -s gind.ist -o grafbase.ind grafbase.idx
and then latex again (once each). The docmfp package can be found at
your favorite CTAN mirror. A copy of docmfp.sty is also on my web page
-(see README.txt).
+(see README). (Some TeX distributions (e.g., TeXLive) contain a rogue
+copy of ltxdoc.cfg in the TeX input path (e.g., tex/latex/subfig), which
+can mess up the indexes of these documents. Move it from the texinputs
+area to the documentation area of your system.
------------------------------------------------------------------------
If you desire to remake the mfpic manual (and why in the world would you
be wanting to do a daft thing like that?), make sure mfpman.tex and
mfpdoc.sty are in the current directory or where LaTeX can find them.
-Edit, if you like, the paper size option in the \documentclass command
-in mfpman.tex. Make sure mfpdoc.sty is where LaTeX will find it. Then
-run pdflatex two (2) times:
+Make sure that coil.mps is also where LaTeX can find it. Edit, if you
+like, the paper size option in the \documentclass command in mfpman.tex.
+Make sure mfpdoc.sty is where LaTeX will find it. (The document uses
+Times for the main font family, LuxiMono for a typewriter font, and CMSS
+for a sans serif font. Packages mathptmx amd luximono are required.)
+Then run pdflatex three times:
- pdflatex mfpman
- pdflatex mfpman
+ pdflatex mfpman (Hundreds of undefined labels messages)
+ pdflatex mfpman (Labels have changed message)
+ pdflatex mfpman (All resolved)
-then run makeindex:
+Now page numbers should be correct in the index, so run makeindex:
- makeindex mfpman
+ makeindex -o mfpman.ind mfpman.idx
-then run latex two (2) more times
+(or just "makeindex mfpman" on many systems) then run latex two more
+times:
- pdflatex mfpman
- pdflatex mfpman
+ pdflatex mfpman (mfpman.toc now has index added)
+ pdflatex mfpman (Document toc now correct)
-The last run is required to get the index into the table of contents.
You can use latex instead of pdflatex, but you won't get clickable links
-in the result. (I was too lazy to work out the kinks.)
+in the result. (I was too lazy to make that work.)
You could do something similar for mfpguide.tex (but that, too, would be
daft):
- pdflatex mfpguide
- mpost guide.mp
- pdflatex mfpguide
- pdflatex mfpguide
+
+ pdflatex mfpguide (produces guide.mp)
+ mpost guide.mp (creates guide.1, guide.2, etc.)
+ pdflatex mfpguide (includes figures, which changes pagination)
+ pdflatex mfpguide (All resolved)
This relies on mfpic so you should probably wait to do that until after
you are accustomed to that process. (And then take a cold shower until
this compulsion passes.)
And finally, if you forgot:
- ****************************************
- * ! UPDATE THE TeX FILENAME DATABASE ! *
- ****************************************
+
+ !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+ !! UPDATE THE TeX FILENAME DATABASE !!
+ !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
--
Dan Luecking (luecking at uark dot edu)