# $Id: README,v 1.30 1996/12/02 01:38:45 ohl Exp $
########################################################################
This is feynmf, a combined LaTeX/Metafont package for easy drawing
of professional quality Feynman diagrams. feynmf lays out most
diagrams satisfactorily from the structure of the graph without
any need for manual intervention. Nevertheless all the power of
Metafont is available for more obscure cases. See the
documentation for appetizers, examples and more details.
A preformatted manual (`manual.ps.gz') is provided to wet your
appetite with numerous examples.
Anyway, you are invited to share, use, abuse, and improve it, see
the file COPYING for details.
Enjoy,
-Thorsten
########################################################################
Installation:
You need a recent LaTeX (LaTeX2e, as of December 1994 is
sufficient) to use feynmf, docstrip.tex to install it and doc.sty
to typeset the documentation. If it is not already on your system,
you can get all this (and much more) from your nearest CTAN host.
To install, either use the Makefile or use the installation file
feynmf.ins:
$ latex feynmf.ins
then you can typeset the documentation by
$ latex fmfman.drv
$ mf '\mode:=laserjet; input fmfsamp1'
$ mf '\mode:=laserjet; input fmfsamp2'
$ mf '\mode:=laserjet; input fmfsamp3'
$ mf '\mode:=laserjet; input fmfsamp4'
$ latex fmfman.drv
$ makeindex -s gind.ist -o fmfman.ind fmfman.idx
$ makeindex -s gglo.ist -o fmfman.gls fmfman.glo
$ latex fmfman.drv
or by using the Makefile (`make man'). That's it.
There is also a simple example `template.tex' that you can use as
a template for your own creations. To typeset, either use the
feynmf script
$ feynmf template
or run Metafont manually
$ latex template
$ mf '\mode:=localfont; input fmftempl'
$ latex template
Finally, there is another installation file for LaTeX 2.09 compatible
versions: feynmf209.ins. This file has to be processed _in addition_
to feynmf.ins!
########################################################################
WARNING:
If LaTeX fails with `Unknown graphics extension: 3', you have a
slightly out-of-date graphics.sty file (LaTeX will have issued a
warning in this case). There has been a change to the user
interface, which makes it very hard to support both versions.
Sorry. I have chosen to support the current one, which will
hopefully be stable.
You can work around this by either getting a more recent graphics
package from CTAN (macros/latex/packages/graphics) or by using
epsf.sty instead (`\let\includegraphics\epsffile\input epsf.sty').
[You can also ignore it and get the preformatted manual. But you
will not be able to use the MetaPost version in this case.]
########################################################################
Comments, bug reports and improvements are welcome at:
Thorsten.Ohl@Physik.TH-Darmstadt.de
(aka: ohl@crunch.ikp.physik.th-darmstadt.de)
New versions can be found in:
crunch.ikp.physik.th-darmstadt.de:/pub/ohl/feynmf
or at CTAN:
{ftp.shsu.edu,ftp.tex.ac.uk,ftp.dante.de}:
... macros/latex/contrib/supported/feynmf
There are two mailing lists
feynmf-announce@crunch.ikp.physik.th-darmstadt.de
feynmf-bugs@crunch.ikp.physik.th-darmstadt.de
both are open for subscription. The former should be very low
volume and carry only important announcements. The latter can
serve as a more general discussion forum.
To subscribe, send mail to
majordomo@crunch.ikp.physik.th-darmstadt.de
and NOT to the lists itself. The following commands (on a line in
the body of the mail, not in the subject) are useful: `subscribe
feynmf-announce', `unsubscribe feynmf-bugs', `help', etc.
########################################################################
NEWS for Version 1.08
* Improved very short gluon and photon propagators by relaxing
overly aggressive rounding.
* New (still experimental) `feynmf' script automating the
invocation of Metafont (requires perl(1)).
NEWS for Version 1.07
* Switch off I/O during the first pass in AMS-LaTeX equation
environments. This avoids a nasty race condition (thanks to Axel
Thimm for reporting this bug). A beneficial side effect is that
it saves us 50% processing time in these cases.
NEWS for Version 1.06
* New abstraction: polygons. Useful for complex vertices in
non-perturbative diagrams.
* New commands: \fmfpoly, \fmfpolyn and \fmfrpolyn, implementing
polygons.
* New option `rubout' for crossing propagators.
* Some common typos are detected are appropriate warning messages
are issued.
* New options `errorstop', `scroll', `nonstop' and `batch' for
specifying the desired interactionmode.
* Work around an obscure babel/german/feynmf three way
destructive interference.
NEWS for Version 1.05
* FeynMF now coexists with french.sty and other packages that
change the \catcode of ``:''.
* Fixed a bug introduced in version 1.03, which could cause
problems with font loading. Unfortunately, the fix has to give up
some compatibility with earlier versions. Sources for version
1.02 and earlier which used \noexpand in labels have to upgraded
or the option `pre-1.03' has to be used. Sorry.
NEWS for Version 1.04
* Finally, \fmffixed{(dx,whatever)}{v1,v2} and
\fmffixed{(whatever,dy)}{v1,v2} do what you would expect them
to. \fmffixedx and \fmffixedy are new synonyms for those.
NEWS for Version 1.03
* It is no longer necessary to protect TeX command sequences with
\noexpand. Old files using \noexpand will continue to work.
NEWS for Version 1.02
* Read the .tfm file before writing the .mf file destructively.
This should allow a transparent two pass processing if MakeTeXTFM
is enabled. Thanks to Thomas Esser
for the suggestion.
NEWS for Version 1.01
* new decoration shapes for vertices by popular demand: `cross'
(also `triacross', `pentacross' and `hexacross').
* fixed a rounding bug in cut-off ends (noticeable as a spurious
thin diagonal line at the left end of double lines).
* The maximum size for shaded and hatched areas has been doubled
by removing an obsolete speedup hack that was not used anymore.
* In an unrelated move, shading and hatching has been
reimplemented in a much more general fashion. Now arbitray
tilings can be specified as argument to `decoration.filled='. The
old style numerical arguments continue to work, but should be
replaced by `empty', `full', `shaded', and `hatched' in new
documents.
########################################################################
# Local Variables:
# mode:indented-text
# End: