Debian Codegraph @

texmf-dist/doc/latex/mflogo/README

raw
1 mflogo --- LaTeX support for Metafont and MetaPost logos.
2
3 Copyright (C) 1994-99 Ulrik Vieth
4
5 This software is free software; you can redistribute it and/or
6 modify it under the terms of the LaTeX Project Public License
7 as described in lppl.txt in the base LaTeX distribution; either
8 version 1 of the License, or (at your option) any later version.
9
10 This software is distributed in the hope that it will be useful,
11 but WITHOUT ANY WARRANTY; without even the implied warranty of
12 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
13
14
15 DESCRIPTION:
16
17 This directory contains the documented sources of the `mflogo'
18 package for LaTeX(2e) and the corresponding font definition files
19 that provide access to the METAFONT and METAPOST `logo' fonts.
20
21 The `mflogo' package defines the font commands |\logofamily| and
22 |\textlogo| to access the `logo' fonts directly. It also defines
23 the macros |\MF| and |\MP| for the METAFONT and METAPOST logos in
24 terms of these font commands, which ensures that the logos will
25 follow font changes just as the |\TeX| logo does and always did.
26
27 To use this package, you'll need the complete and up-to-date set
28 of `logo' fonts, located in the directory CTAN:fonts/mflogo.
29
30 To facilitate the installation, the directory containing the
31 `logo' fonts is made available through a symbolic link `fonts',
32 so that the contents of CTAN:fonts/mflogo is automatically
33 included as a subdirectory if you download this directory as a
34 `.zip' or `.tar.gz' archive.
35
36
37 HISTORY:
38
39 The `mflogo' package was developed in early 1994 when LaTeX2e was
40 still in a beta-test phase. The first public release of `mflogo'
41 (v1.2 in May 1994) predated the release of the first production
42 version of LaTeX as of 1994/06/01.
43
44 The second release of `mflogo' (v1.5 in September 1995) cleaned up
45 some internals and fixed the space factor after the logos, just as
46 it is done for the |\TeX| and |\LaTeX| logos in the LaTeX kernel.
47
48 The present release of `mflogo' (v2.0 in March 1999) clarifies the
49 distribution conditions, adopting the LaTeX Project Public License.
50
51
52 OVERVIEW:
53
54 The `mflogo' distribution consists of the following files:
55
56 README - this file, i.e. the file you are reading
57 Makefile - Makefile to install the LaTeX package
58 mflogo.ins - LaTeX installation script
59 mflogo.dtx - documented source of the LaTeX package
60
61 Subdirectory `fonts':
62
63 README - some notes on the `logo' fonts
64 Makefile - Makefile to install the `logo' fonts
65
66 Subdirectory `fonts/source':
67
68 logo.mf - Metafont program to draw the logo charaters
69 logo*.mf - Metafont drivers for various sizes and shapes
70
71 Subdirectory `fonts/tfm':
72
73 logo*.tfm - TeX font metrics for various sizes and shapes
74
75
76 INSTALLATION:
77
78 (1) Before installing the `mflogo' LaTeX package and processing
79 the documentation, you should first make sure that you have a
80 complete and up-to-date set of the `logo' fonts. If you're
81 lucky, the `logo' fonts may have already been provided as part
82 of your TeX distribution. Otherwise, proceed by changing to the
83 `fonts' subdirectory and installing the fonts from there.
84
85 if you have a TDS-compatible TeX installation, you may try to use
86 the enclosed `Makefile' in the `fonts' subdirectory by calling
87
88 cd fonts ; make install TEXMF=/wherever/texmf
89
90 For manual installation of the font sources and font metric files,
91 please consult the file `fonts/README'.
92
93 (2) After the required fonts have been installed, return to this
94 distribution directory. To unpack the `mflogo' LaTeX package
95 and to typeset the documentation, proceed as follows:
96
97 If you have a TDS-compatible TeX installation, you may try to use
98 the enclosed `Makefile' by calling
99
100 make TEXMF=/wherever/texmf
101 make install TEXMF=/wherever/texmf
102
103 For manual installation, run
104
105 latex mflogo.ins
106
107 to unpack the package file `mflogo.sty' and the corresponding
108 font definition files `ulogo.fd' from the source file `mflogo.dtx'.
109
110 To typeset the documentation, run
111
112 (pdf)latex mflogo.dtx
113
114 to generate `mflogo.dvi' and/or `mflogo.pdf'. This requires
115 the `mflogo' and, of course, the `logo' fonts.
116
117 Finally, to install the `mflogo' package, copy the files
118 `mflogo.sty' and `ulogo.fd' to TEXMF/tex/latex/mflogo/ or
119 wherever else your installation keeps LaTeX `.sty' files.
120
121
122 TROUBLESHOOTING:
123
124 The `mflogo' package boldly assumes that your TeX distribution
125 provides a complete and up-to-date version of the `logo' fonts,
126 including some non-standard variants and some extra characters
127 that were absent from earlier (pre-1993) versions.
128
129 While it should no problem to regenerate PK-bitmap fonts from
130 the updated Metafont sources, if necessary, some problems may
131 arise when using PostScript Type 1 versions of the `logo' fonts.
132
133 Unless you happen to have access to some commercial versions of
134 the up-to-date `logo' fonts in Type 1 format as sold by Y&Y Inc.,
135 it is highly recommended to use the freely-distributable versions
136 by Taco Hoekwater, which are available from CTAN archives in:
137
138 CTAN:fonts/cm/utilityfonts/logo/ps-type1/hoekwater/logo*.pfb
139
140 It is no longer recommended to use the freely-distributable
141 versions of `logo' fonts provided by the American Mathematical
142 Society, which are available from CTAN archives in:
143
144 CTAN:fonts/cm/ps-type1/bluesky/logo*.pfb
145
146 Unfortunately, those fonts are out-of-date and do not provide a
147 complete set of sizes and shapes required by `mflogo' package.
148
149
150 Happy TeXing!