summaryrefslogtreecommitdiff
path: root/Build/source/texk/dvipng/dvipng-1.12/README
diff options
context:
space:
mode:
Diffstat (limited to 'Build/source/texk/dvipng/dvipng-1.12/README')
-rw-r--r--Build/source/texk/dvipng/dvipng-1.12/README128
1 files changed, 128 insertions, 0 deletions
diff --git a/Build/source/texk/dvipng/dvipng-1.12/README b/Build/source/texk/dvipng/dvipng-1.12/README
new file mode 100644
index 00000000000..da9ba557f4c
--- /dev/null
+++ b/Build/source/texk/dvipng/dvipng-1.12/README
@@ -0,0 +1,128 @@
+dvipng
+******
+
+This program makes PNG and/or GIF graphics from DVI files as obtained
+from TeX and its relatives.
+
+ If GIF support is enabled, GIF output is chosen by using the
+`dvigif' binary or with the `--gif' option.
+
+ It is intended to produce anti-aliased screen-resolution images as
+fast as is possible. The target audience is people who need to generate
+and regenerate many images again and again. The primary target is the
+preview-latex (X)Emacs package, a package to preview formulas from
+within (X)Emacs. Yes, you get to see your formulas in the (X)Emacs
+buffer, see `http://www.gnu.org/software/auctex/preview-latex.html'.
+
+ Another example is WeBWorK, an internet-based method for delivering
+homework problems to students over the internet, giving students
+instant feedback as to whether or not their answers are correct, see
+`http://webwork.math.rochester.edu'.
+
+ A more recent addition to the dvipng-using applications out there is
+MediaWiki, the software behind Wikipedia and many other wikis out
+there. Dvipng is used to render mathematical formulae from version
+1.8.0 of MediaWiki, see `http://www.mediawiki.org'.
+
+ Other applications may also benefit, like web applications as
+latex2html and WYSIWYG editors like LyX.
+
+Benefits of dvipng
+==================
+
+ The benefits of `dvipng'/`dvigif' include
+
+ * Speed. It is a very fast bitmap-rendering code for DVI files, which
+ makes it suitable for generating large amounts of images
+ on-the-fly, as needed in preview-latex, WeBWorK and others.
+
+ * It does not read the postamble, so it can be started before TeX
+ finishes. There is a `--follow' switch that makes dvipng wait at
+ end-of-file for further output, unless it finds the POST marker
+ that indicates the end of the DVI.
+
+ * Interactive query of options. dvipng can read options interactively
+ through stdin, and all options are usable. It is even possible to
+ change the input file through this interface.
+
+ * Supports PK, VF, PostScript Type1, and TrueType fonts, subfonts
+ (i.e., as used in CJK-LaTeX), color specials, and inclusion of
+ PostScript, PNG, JPEG or GIF images.
+
+ * and more...
+
+
+Installation
+============
+
+Read `INSTALL', included in the distribution.
+
+Usage
+=====
+
+To use dvipng at its simplest, simply type
+
+ dvipng foo
+
+where `foo.dvi' is the output of TeX that you want to convert to PNG
+format. If there are four pages in `foo.dvi', those pages will be
+output as `foo1.png', `foo2.png', `foo3.png', and `foo4.png',
+respectively.
+
+ Many options are available (see the info manual). For a brief
+summary of available options, just type
+
+ dvipng --help
+
+Availability
+============
+
+The dvipng package is available at Savannah, the GNU project site. Since
+dvipng is not part of the GNU project, although released under the GNU
+GPL, the web address is `http://savannah.nongnu.org/projects/dvipng'.
+Instructions for anonymous CVS access can be found at
+`http://savannah.nongnu.org/cvs/?group=dvipng'.
+
+Contacts
+========
+
+Bug reports should be sent to <dvipng@nongnu.org>.
+
+ Questions, suggestions for new features, pleas for help, and/or
+praise should go to <dvipng@nongnu.org>. For more information on this
+mailing list, send a message with just the word `help' as subject or
+body to <dvipng-request@nongnu.org> or look at
+`http://lists.nongnu.org/mailman/listinfo/dvipng'.
+
+ Offers to support further development will be appreciated. For
+developer access, ask on <dvipng@nongnu.org>.
+
+Copying
+=======
+
+This program is released under the GNU Lesser General Public License
+version 3, see the COPYING file in the dvipng distribution or
+`http://www.gnu.org/licenses/'.
+
+ Copyright (C) 2002-2009 Jan-AAke Larsson
+
+Todo
+====
+
+ * Use gs interpreter library for speed and possibly for
+ functionality.
+
+ * Add more color models for xcolor compatibility
+
+ * Fix T1lib and PK rendering so it is on par with Freetype.
+
+ * Enable a named pipe as DVI
+
+ * Further speed improvements.
+
+ * Other output specials and source specials.
+
+ * Clean internal structures. Overhaul file handling.
+
+ * Fix the SELFAUTO stuff at runtime rather than at build time
+