Debian Codegraph @

texmf-dist/doc/generic/mfpic/install.txt

raw
1 % File: install.txt
2 % A part of mfpic 1.10 2012/12/03
3 %
4
5 This is version 1.10 of mfpic. See README for a list of files and a
6 brief description of each.
7
8 Generating and installing the files
9 -----------------------------------
10
11 This sections is unnecessary if you get
12 http://mirror.ctan.org/install/graphics/mfpic.tds.zip
13 when it becomes available. Just unzip it in a texmf directory.
14 Alternatively, you can get the entire graphics/mfpic/ directory from
15 http://mirror.ctan.org/ and move those files as described below
16
17 -- If you have acquired only mfpic.ins, mfpic.dtx and grafbase.dtx, put
18 the three in the same temporary directory and change to that
19 directory. Run latex (or tex) on mfpic.ins, which should produce
20 these six files:
21 mfpic.tex grafbase.mf
22 mfpic.sty grafbase.mp
23 mfpicdef.tex dvipsnam.mp
24
25 -- If you have an older version of mfpic, remove any old files with the
26 same names as the above from your TeX directories, or ensure that the
27 following procedure overwrites them (back them up first, if you wish).
28
29 -- Copy mfpic.tex and mfpicdef.tex where TeX and LaTeX will find them,
30 and mfpic.sty where LaTeX will find it. On any TDS compliant system
31 (such as TeXLive, MacTeX and MiKTeX) they can all be put in
32 $TEXMF/tex/generic/mfpic/ (where $TEXMF indicates a directory serving
33 as a root of a texmf tree).
34
35 -- Copy grafbase.mp and dvipsnam.mp where MetaPost will find them, for
36 example $TEXMF/metapost/mfpic/ .
37
38 -- Copy grafbase.mf where Metafont will find it. For example,
39 $TEXMF/metafont/mfpic/ .
40
41 -- Copy mfpguide.pdf, mfpic-doc.pdf. mfpcard.pdf where documentation is
42 kept. For example, $TEXMF/doc/generic/mfpic/ . Optionally, copy the
43 *.tex versions of these, plus mfpdoc.sty, lcheadings.ist and
44 coil.mps, as well as examples/*.* either to the documentation area or
45 to the same place as mfpic.tex. Also optional: copy the two .dtx
46 files and mfpic.ins to the source area
47 ($TEXMF/source/generic/mfpic/).
48
49 -- If required by your TeX system (most do): update the tex filename
50 database.
51
52 There is one optional step that may be useful if you plan to make use of
53 mfpic's support for Metafont (you may skip this if you only wish to use
54 its MetaPost support): find the file modes.mf on your system. Typically
55 this will be in $TEXMF/metafont/misc/ . Find, near the end of that file,
56 a line similar to
57
58 localfont := ljfour;
59
60 Replace, if necessary, the string "ljfour" by one of the modes defined
61 in that file. At minimum, select one whose resolution (DPI) matches both
62 your printer and the configuration of your dvi viewer. If you make such
63 a change, regenerate the mf.base file (fmtutil on MacTeX or TeXLive;
64 MiKTeX Options in MiKTeX). On some systems this may be named plain.base.
65
66 Read mfpguide.pdf before trying anything further. If you are already
67 familiar with mfpic (version 0.2.10.9 or later) you can probably get
68 going right away.
69
70 If you want to read the documented source code for mfpic, run pdflatex
71 on mfpic.dtx and grafbase.dtx three times each. Then run makeindex for
72 each:
73 makeindex -s gind.ist -o mfpic.ind mfpic.idx
74 makeindex -s gind.ist -o grafbase.ind grafbase.idx
75 and then pdflatex again.
76
77 ------------------------------------------------------------------------
78
79 If you desire to remake mfpic-doc.pdf, make sure mfpic-doc.tex and
80 mfpdoc.sty are in the current directory or where LaTeX can find them.
81 Make sure that coil.mps is also where LaTeX can find it. Edit, if you
82 like, the paper size option in the \documentclass command in
83 mfpic-doc.tex. (The document uses Times for the main font family,
84 LuxiMono for a typewriter font, and CMSS for a sans serif font. Packages
85 mathptmx amd luximono are required.) Then run
86 pdflatex mfpic-doc
87 three times. Make sure lcheadings.ist is where makeindex can find it
88 and run
89 makeindex -s lcheadings.ist -o mfpic-doc.ind mfpic-doc.idx
90 Then
91 pdflatex mfpic-doc
92 at least 2 more times.
93
94 You could do something similar for mfpguide.tex:
95 pdflatex mfpguide
96 mpost guide.mp
97 pdflatex mfpguide
98 pdflatex mfpguide
99 This relies on the mfpic package itself.
100
101 \sig
102 Dan Luecking (luecking at uark dot edu)
103 Department of Mathematical Sciences
104 University of Arkansas
105 Fayetteville, Arkansas 72701-1201
106 U.S.A