~ubuntu-branches/ubuntu/lucid/auctex/lucid

« back to all changes in this revision

Viewing changes to doc/preview-latex.info

  • Committer: Bazaar Package Importer
  • Author(s): Reinhard Tartler
  • Date: 2008-03-21 14:54:04 UTC
  • mfrom: (1.2.3 upstream)
  • Revision ID: james.westby@ubuntu.com-20080321145404-p1yrn1rfiyculi0n
Tags: 11.84-0ubuntu1
Upload to hardy. Freeze exception granted in LP: #103631

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
 
This is preview-latex.info, produced by makeinfo version 4.6.90 from
 
1
This is preview-latex.info, produced by makeinfo version 4.8 from
2
2
preview-latex.texi.
3
3
 
 
4
   This manual is for preview-latex, a LaTeX preview mode for AUCTeX
 
5
(version 11.84 from 2007-01-12).
 
6
 
 
7
   Copyright (C) 2001, 2002, 2003, 2004, 2005, 2006 Free Software
 
8
Foundation, Inc.
 
9
 
 
10
     Permission is granted to copy, distribute and/or modify this
 
11
     document under the terms of the GNU Free Documentation License,
 
12
     Version 1.2 or any later version published by the Free Software
 
13
     Foundation; with no Invariant Sections, no Front-Cover Texts and
 
14
     no Back-Cover Texts.  A copy of the license is included in the
 
15
     section entitled "GNU Free Documentation License."
 
16
 
 
17
INFO-DIR-SECTION Emacs
4
18
INFO-DIR-SECTION TeX
5
 
INFO-DIR-SECTION Emacs
6
19
START-INFO-DIR-ENTRY
7
20
* preview-latex: (preview-latex).       Preview LaTeX fragments in Emacs
8
21
END-INFO-DIR-ENTRY
9
22
 
10
23
 
11
 
File: preview-latex.info,  Node: Top,  Next: Introduction,  Prev: (dir),  Up: (dir)
 
24
File: preview-latex.info,  Node: Top,  Prev: (dir),  Up: (dir)
12
25
 
13
26
preview-latex
14
27
*************
15
28
 
16
 
preview-latex is a package embedding preview fragments into Emacs
 
29
This manual may be copied under the conditions spelled out in *Note
 
30
Copying this Manual::.
 
31
 
 
32
   preview-latex is a package embedding preview fragments into Emacs
17
33
source buffers under the AUCTeX editing environment for LaTeX.  It uses
18
34
`preview.sty' for the extraction of certain environments (most notably
19
35
displayed formulas).  Other applications of this style file are
23
39
letters, with a hyphen.  If you typeset it, you can use a sans-serif
24
40
font to visually offset it.
25
41
 
26
 
   This file documents preview-latex version 11.83.
27
 
 
28
 
   This documentation should cover most important points.  However,
29
 
corrections or perhaps rewrites of sections are _very welcome_.
30
 
 
31
 
   David Kastrup, Alan Shutko, Jan-AAke Larsson and Nick Alcock.
32
 
 
33
42
* Menu:
34
43
 
 
44
* Copying::                     Copying
35
45
* Introduction::                Getting started.
36
46
* Installation::                Make Install.
37
47
* Keys and lisp::               Key bindings and user-level lisp functions.
40
50
* For advanced users::          Internals and more customizations.
41
51
* ToDo::                        Future development.
42
52
* Frequently Asked Questions::  All about preview-latex
43
 
* License::                     GPL.
 
53
* Copying this Manual::         GNU Free Documentation License
44
54
* Index::                       A menu of many topics.
45
55
 
46
56
 
47
 
File: preview-latex.info,  Node: Introduction,  Next: Installation,  Prev: Top,  Up: Top
 
57
File: preview-latex.info,  Node: Copying,  Next: Introduction,  Prev: Top,  Up: Top
 
58
 
 
59
Copying
 
60
*******
 
61
 
 
62
For the conditions for copying parts of preview-latex, see the General
 
63
Public Licenses referres to in the copyright notices of the files, the
 
64
General Public Licenses accompanying them and the explanatory section in
 
65
*Note Copying: (auctex)Copying.
 
66
 
 
67
   This manual specifically is covered by the GNU Free Documentation
 
68
License (*note Copying this Manual::).
 
69
 
 
70
 
 
71
File: preview-latex.info,  Node: Introduction,  Next: Installation,  Prev: Copying,  Up: Top
48
72
 
49
73
1 Introduction
50
74
**************
1109
1133
          indicates an optional `*' modifier, as in `\includegraphics*'.
1110
1134
 
1111
1135
    `['
1112
 
          indicates an optional argument in brackets.  This syntax is
1113
 
          somewhat baroque, but brief.
 
1136
          ^^A] indicates an optional argument in brackets.  This syntax
 
1137
          is somewhat baroque, but brief.
1114
1138
 
1115
1139
    `[]'
1116
1140
          also indicates an optional argument in brackets.  Be sure to
1653
1677
 
1654
1678
 
1655
1679
 
1656
 
File: preview-latex.info,  Node: Frequently Asked Questions,  Next: License,  Prev: ToDo,  Up: Top
 
1680
File: preview-latex.info,  Node: Frequently Asked Questions,  Next: Copying this Manual,  Prev: ToDo,  Up: Top
1657
1681
 
1658
1682
Appendix B Frequently Asked Questions
1659
1683
*************************************
1708
1732
We recommend to use GNU or AFPL Ghostscript with a version of at least
1709
1733
7.07.
1710
1734
 
1711
 
   Proper PDFLaTeX support will require AUCTeX version 11.50 or later.
1712
 
Versions before that are not supported.
 
1735
   preview-latex has been distributed as part of AUCTeX since version
 
1736
11.80.  If your version of AUCTeX is older than that, or if it does not
 
1737
contain a working copy of preview-latex, complain to wherever you got
 
1738
it from.
1713
1739
 
1714
1740
B.2.3 I have trouble with the display format...
1715
1741
-----------------------------------------------
1720
1746
 
1721
1747
   All other formats are known to have inconveniences, either in file
1722
1748
size or quality.  There are some Emacs versions around not supporting
1723
 
PNG, the proper idea to deal with that is to complain to your Emacs
1724
 
providers.  Short of that, checking out PNM or JPEG formats might be a
 
1749
PNG; the proper way to deal with that is to complain to your Emacs
 
1750
provider.  Short of that, checking out PNM or JPEG formats might be a
1725
1751
good way to find out whether the lack of PNG format support might be
1726
1752
the only problem with your Emacs.
1727
1753
 
1731
1757
It is known to work under the X Window System for Linux and for several
1732
1758
flavors of Unix: we have reports for HP and Solaris.
1733
1759
 
1734
 
   Under Windows, you should try the most recent versions of
1735
 
preview-latex since a lot of typical Windows problems have been ironed
1736
 
out lately.  Under XEmacs, both Cygwin and native ports should work.
1737
 
Image support for GNU Emacs under Windows is expected with Emacs 22
1738
 
which has not yet been released at the time of this writing.  CVS
1739
 
versions of it already work, however.
1740
 
 
1741
 
   The entry "X11/Unix" currently means Linux, Solaris or HP/UX, as well
1742
 
as the X-specific version for Mac/OSX.
 
1760
   There are several development versions of Emacs around for native
 
1761
MacOS Carbon, and preview-latex is working with them, too.
 
1762
 
 
1763
   With Windows, Cygwin and native ports of XEmacs should work.
 
1764
preview-latex will not work with any native version 21 of Emacs under
 
1765
Windows: you need to get a hold of Emacs 22 which is at the time of
 
1766
this writing not released but available as a developer snapshot.
 
1767
 
 
1768
   The entry "X11/Unix" currently means Linux, Solaris or HP/UX, as
 
1769
well as the X-specific version for Mac/OSX.
1743
1770
 
1744
1771
OS             Emacs version   XEmacs version
1745
1772
X11/Unix       21.1            21.4.9
1746
 
Win9x cygwin   21.4?           21.4.8
1747
 
Win9x native   21.4?           21.4.8
1748
 
 
1749
 
   With display errors, XEmacs versions as early as 21.1.14 might also
1750
 
work.
 
1773
Win9x cygwin   21.3.50?        21.4.8
 
1774
Win9x native   22.1            21.4.8
 
1775
MacOSX native  22.1            -
1751
1776
 
1752
1777
 
1753
1778
File: preview-latex.info,  Node: Installation Trouble,  Next: Customization,  Prev: Requirements,  Up: Frequently Asked Questions
1755
1780
B.3 Installation Trouble
1756
1781
========================
1757
1782
 
1758
 
B.3.1 I could not install the precompiled RPM binaries
1759
 
------------------------------------------------------
1760
 
 
1761
 
Note that the binaries require RPM version 3.
1762
 
 
1763
 
B.3.2 I just get `LaTeX found no preview images'.
 
1783
B.3.1 I just get `LaTeX found no preview images'.
1764
1784
-------------------------------------------------
1765
1785
 
1766
1786
The reason for this is that LaTeX found no preview images in the
1774
1794
write permissions).  If the symptom persists, you have a problem, and
1775
1795
the problem is most likely a LaTeX problem.  Here are possible reasons:
1776
1796
 
1777
 
Incompatible RPM installation
1778
 
     The RPM packages are intended to run on a Redhat system. So the
1779
 
     TeX files, provided by package `preview-latex-common' go into
1780
 
     `/usr/share/texmf/tex/latex/preview' and
1781
 
     `/usr/share/texmf/doc/latex/styles/preview'. If for your system the
1782
 
     TeX files are in different places you have to set appropriate
1783
 
     links.
1784
 
 
1785
 
     Another possibility is to get the tar archive, edit the
1786
 
     `preview-latex.spec' accordingly, repack and then use the
1787
 
     appropriate `rpm' command for building RPMs from a tar archive.
1788
 
     If this works, please don't forget to send us the spec file, so
1789
 
     that we may be able to help others with your platform.
1790
 
 
1791
1797
Filename database not updated
1792
1798
     Various TeX distributions have their own ways of knowing where the
1793
1799
     files are without actually searching directories.  The normal
1815
1821
     default tree.  Make sure that the first version of those files
1816
1822
     that gets found is the correct one.
1817
1823
 
1818
 
B.3.3 I have problems with the XEmacs installation
 
1824
B.3.2 I have problems with the XEmacs installation
1819
1825
--------------------------------------------------
1820
1826
 
1821
1827
Please note that the XEmacs installation is different, since XEmacs has
1822
1828
a package system that gets used here.  Please make sure that you read
1823
1829
and follow the installation instructions for XEmacs.
1824
1830
 
1825
 
   The XEmacs Lisp files provided by the `preview-latex-xemacs' RPM
1826
 
package are in XEmacs package format and will be installed right into
1827
 
the XEmacs package tree.  The location is detected when the RPM file is
1828
 
built.  If it is wrong for your system, doing an
1829
 
       rpmbuild --rebuild preview-latex-0.9.1-1.fedora.src.rpm
1830
 
   should do the trick and should generate RPMs for your system (even if
1831
 
that System happens to be SuSE rather than Fedora).
1832
 
 
1833
 
   Alternatively you could install preview-latex manually in your home
1834
 
directory either in `~/.xemacs' (for XEmacs version below 21.4.x) or in
1835
 
`~/.xemacs/xemacs-packages' (for versions starting with 21.4).
1836
 
 
1837
 
B.3.4 After installation of the XEmacs RPM package, AUCTeX does not work
1838
 
------------------------------------------------------------------------
1839
 
 
1840
 
Most likely you installed the RPM files and you have an XEmacs version
1841
 
which uses a different architecture of directories, (SuSE is known to
1842
 
have a no standard architecture, besides it changes it from SuSE
1843
 
version to SuSE version).  Your init file will contain an invocation of
1844
 
preview-latex according to the installation instructions in *Note
1845
 
Installation::.
1846
 
 
1847
 
   In consequence, the attempt to load preview-latex when entering
1848
 
AUCTeX mode fails because of preview-latex being in a different
1849
 
directory, and this AUCTeX's actication is aborted.  Please notice that
1850
 
the installation instructions for Emacs and XEmacs differ.
1851
 
 
1852
1831
 
1853
1832
File: preview-latex.info,  Node: Customization,  Prev: Installation Trouble,  Up: Frequently Asked Questions
1854
1833
 
1974
1953
B.6.1 Does preview-latex work with  PDFLaTeX?
1975
1954
---------------------------------------------
1976
1955
 
1977
 
Yes.  PDFLaTeX works fine with AUCTeX version 11.50 or later.  For
1978
 
earlier versions, you need to have `LaTeX-command-style' configured
1979
 
manually to call PDFLaTeX.
 
1956
Yes, as long as you use AUCTeX's own PDFLaTeX mode and have not messed
 
1957
with `TeX-command-list'.
1980
1958
 
1981
1959
B.6.2 Does preview-latex work with `elatex'?
1982
1960
--------------------------------------------
1983
1961
 
1984
1962
No problem here.  If you configure your AUCTeX to use `elatex', or
1985
 
simply have `latex' point to `elatex', this will work fine.
 
1963
simply have `latex' point to `elatex', this will work fine.  Modern TeX
 
1964
distributions use eTeX for LaTeX, anyway.
1986
1965
 
1987
1966
B.6.3 Does preview-latex work with ConTeXt?
1988
1967
-------------------------------------------
2008
1987
     \end{document}
2009
1988
 
2010
1989
 
2011
 
File: preview-latex.info,  Node: License,  Next: Index,  Prev: Frequently Asked Questions,  Up: Top
2012
 
 
2013
 
Appendix C License
2014
 
******************
2015
 
 
2016
 
(This text is stolen from the Texinfo manual, Edition 4.0).
2017
 
 
2018
 
   The programs currently being distributed that relate to preview-latex
2019
 
include lisp files for Emacs and style files for LaTeX.  These programs
2020
 
are "free"; this means that everyone is free to use them and free to
2021
 
redistribute them on a free basis.  The preview-latex related programs
2022
 
are not in the public domain; they are copyrighted and there are
2023
 
restrictions on their distribution, but these restrictions are designed
2024
 
to permit everything that a good cooperating citizen would want to do.
2025
 
What is not allowed is to try to prevent others from further sharing
2026
 
any version of these programs that they might get from you.
2027
 
 
2028
 
   Specifically, we want to make sure that you have the right to give
2029
 
away copies of the programs that relate to preview-latex, that you
2030
 
receive source code or else can get it if you want it, that you can
2031
 
change these programs or use pieces of them in new free programs, and
2032
 
that you know you can do these things.
2033
 
 
2034
 
   To make sure that everyone has such rights, we have to forbid you to
2035
 
deprive anyone else of these rights.  For example, if you distribute
2036
 
copies of the preview-latex related programs, you must give the
2037
 
recipients all the rights that you have.  You must make sure that they,
2038
 
too, receive or can get the source code.  And you must tell them their
2039
 
rights.
2040
 
 
2041
 
   Also, for our own protection, we must make certain that everyone
2042
 
finds out that there is no warranty for the programs that relate to
2043
 
preview-latex.  If these programs are modified by someone else and
2044
 
passed on, we want their recipients to know that what they have is not
2045
 
what we distributed, so that any problems introduced by others will not
2046
 
reflect on our reputation.
2047
 
 
2048
 
   The precise conditions of the licenses for the programs currently
2049
 
being distributed that relate to preview-latex are found in the General
2050
 
Public Licenses that accompany them.
2051
 
 
2052
 
 
2053
 
File: preview-latex.info,  Node: Index,  Prev: License,  Up: Top
 
1990
File: preview-latex.info,  Node: Copying this Manual,  Next: Index,  Prev: Frequently Asked Questions,  Up: Top
 
1991
 
 
1992
Appendix C Copying this Manual
 
1993
******************************
 
1994
 
 
1995
The copyright notice for this manual is:
 
1996
 
 
1997
   This manual is for preview-latex, a LaTeX preview mode for AUCTeX
 
1998
(version 11.84 from 2007-01-12).
 
1999
 
 
2000
   Copyright (C) 2001, 2002, 2003, 2004, 2005, 2006 Free Software
 
2001
Foundation, Inc.
 
2002
 
 
2003
     Permission is granted to copy, distribute and/or modify this
 
2004
     document under the terms of the GNU Free Documentation License,
 
2005
     Version 1.2 or any later version published by the Free Software
 
2006
     Foundation; with no Invariant Sections, no Front-Cover Texts and
 
2007
     no Back-Cover Texts.  A copy of the license is included in the
 
2008
     section entitled "GNU Free Documentation License."
 
2009
 
 
2010
The full license text can be read here:
 
2011
 
 
2012
* Menu:
 
2013
 
 
2014
* GNU Free Documentation License:: License for copying this manual.
 
2015
 
 
2016
 
 
2017
File: preview-latex.info,  Node: GNU Free Documentation License,  Up: Copying this Manual
 
2018
 
 
2019
C.1 GNU Free Documentation License
 
2020
==================================
 
2021
 
 
2022
                      Version 1.2, November 2002
 
2023
 
 
2024
     Copyright (C) 2000,2001,2002 Free Software Foundation, Inc.
 
2025
     51 Franklin St, Fifth Floor, Boston, MA  02110-1301, USA
 
2026
 
 
2027
     Everyone is permitted to copy and distribute verbatim copies
 
2028
     of this license document, but changing it is not allowed.
 
2029
 
 
2030
  0. PREAMBLE
 
2031
 
 
2032
     The purpose of this License is to make a manual, textbook, or other
 
2033
     functional and useful document "free" in the sense of freedom: to
 
2034
     assure everyone the effective freedom to copy and redistribute it,
 
2035
     with or without modifying it, either commercially or
 
2036
     noncommercially.  Secondarily, this License preserves for the
 
2037
     author and publisher a way to get credit for their work, while not
 
2038
     being considered responsible for modifications made by others.
 
2039
 
 
2040
     This License is a kind of "copyleft", which means that derivative
 
2041
     works of the document must themselves be free in the same sense.
 
2042
     It complements the GNU General Public License, which is a copyleft
 
2043
     license designed for free software.
 
2044
 
 
2045
     We have designed this License in order to use it for manuals for
 
2046
     free software, because free software needs free documentation: a
 
2047
     free program should come with manuals providing the same freedoms
 
2048
     that the software does.  But this License is not limited to
 
2049
     software manuals; it can be used for any textual work, regardless
 
2050
     of subject matter or whether it is published as a printed book.
 
2051
     We recommend this License principally for works whose purpose is
 
2052
     instruction or reference.
 
2053
 
 
2054
  1. APPLICABILITY AND DEFINITIONS
 
2055
 
 
2056
     This License applies to any manual or other work, in any medium,
 
2057
     that contains a notice placed by the copyright holder saying it
 
2058
     can be distributed under the terms of this License.  Such a notice
 
2059
     grants a world-wide, royalty-free license, unlimited in duration,
 
2060
     to use that work under the conditions stated herein.  The
 
2061
     "Document", below, refers to any such manual or work.  Any member
 
2062
     of the public is a licensee, and is addressed as "you".  You
 
2063
     accept the license if you copy, modify or distribute the work in a
 
2064
     way requiring permission under copyright law.
 
2065
 
 
2066
     A "Modified Version" of the Document means any work containing the
 
2067
     Document or a portion of it, either copied verbatim, or with
 
2068
     modifications and/or translated into another language.
 
2069
 
 
2070
     A "Secondary Section" is a named appendix or a front-matter section
 
2071
     of the Document that deals exclusively with the relationship of the
 
2072
     publishers or authors of the Document to the Document's overall
 
2073
     subject (or to related matters) and contains nothing that could
 
2074
     fall directly within that overall subject.  (Thus, if the Document
 
2075
     is in part a textbook of mathematics, a Secondary Section may not
 
2076
     explain any mathematics.)  The relationship could be a matter of
 
2077
     historical connection with the subject or with related matters, or
 
2078
     of legal, commercial, philosophical, ethical or political position
 
2079
     regarding them.
 
2080
 
 
2081
     The "Invariant Sections" are certain Secondary Sections whose
 
2082
     titles are designated, as being those of Invariant Sections, in
 
2083
     the notice that says that the Document is released under this
 
2084
     License.  If a section does not fit the above definition of
 
2085
     Secondary then it is not allowed to be designated as Invariant.
 
2086
     The Document may contain zero Invariant Sections.  If the Document
 
2087
     does not identify any Invariant Sections then there are none.
 
2088
 
 
2089
     The "Cover Texts" are certain short passages of text that are
 
2090
     listed, as Front-Cover Texts or Back-Cover Texts, in the notice
 
2091
     that says that the Document is released under this License.  A
 
2092
     Front-Cover Text may be at most 5 words, and a Back-Cover Text may
 
2093
     be at most 25 words.
 
2094
 
 
2095
     A "Transparent" copy of the Document means a machine-readable copy,
 
2096
     represented in a format whose specification is available to the
 
2097
     general public, that is suitable for revising the document
 
2098
     straightforwardly with generic text editors or (for images
 
2099
     composed of pixels) generic paint programs or (for drawings) some
 
2100
     widely available drawing editor, and that is suitable for input to
 
2101
     text formatters or for automatic translation to a variety of
 
2102
     formats suitable for input to text formatters.  A copy made in an
 
2103
     otherwise Transparent file format whose markup, or absence of
 
2104
     markup, has been arranged to thwart or discourage subsequent
 
2105
     modification by readers is not Transparent.  An image format is
 
2106
     not Transparent if used for any substantial amount of text.  A
 
2107
     copy that is not "Transparent" is called "Opaque".
 
2108
 
 
2109
     Examples of suitable formats for Transparent copies include plain
 
2110
     ASCII without markup, Texinfo input format, LaTeX input format,
 
2111
     SGML or XML using a publicly available DTD, and
 
2112
     standard-conforming simple HTML, PostScript or PDF designed for
 
2113
     human modification.  Examples of transparent image formats include
 
2114
     PNG, XCF and JPG.  Opaque formats include proprietary formats that
 
2115
     can be read and edited only by proprietary word processors, SGML or
 
2116
     XML for which the DTD and/or processing tools are not generally
 
2117
     available, and the machine-generated HTML, PostScript or PDF
 
2118
     produced by some word processors for output purposes only.
 
2119
 
 
2120
     The "Title Page" means, for a printed book, the title page itself,
 
2121
     plus such following pages as are needed to hold, legibly, the
 
2122
     material this License requires to appear in the title page.  For
 
2123
     works in formats which do not have any title page as such, "Title
 
2124
     Page" means the text near the most prominent appearance of the
 
2125
     work's title, preceding the beginning of the body of the text.
 
2126
 
 
2127
     A section "Entitled XYZ" means a named subunit of the Document
 
2128
     whose title either is precisely XYZ or contains XYZ in parentheses
 
2129
     following text that translates XYZ in another language.  (Here XYZ
 
2130
     stands for a specific section name mentioned below, such as
 
2131
     "Acknowledgements", "Dedications", "Endorsements", or "History".)
 
2132
     To "Preserve the Title" of such a section when you modify the
 
2133
     Document means that it remains a section "Entitled XYZ" according
 
2134
     to this definition.
 
2135
 
 
2136
     The Document may include Warranty Disclaimers next to the notice
 
2137
     which states that this License applies to the Document.  These
 
2138
     Warranty Disclaimers are considered to be included by reference in
 
2139
     this License, but only as regards disclaiming warranties: any other
 
2140
     implication that these Warranty Disclaimers may have is void and
 
2141
     has no effect on the meaning of this License.
 
2142
 
 
2143
  2. VERBATIM COPYING
 
2144
 
 
2145
     You may copy and distribute the Document in any medium, either
 
2146
     commercially or noncommercially, provided that this License, the
 
2147
     copyright notices, and the license notice saying this License
 
2148
     applies to the Document are reproduced in all copies, and that you
 
2149
     add no other conditions whatsoever to those of this License.  You
 
2150
     may not use technical measures to obstruct or control the reading
 
2151
     or further copying of the copies you make or distribute.  However,
 
2152
     you may accept compensation in exchange for copies.  If you
 
2153
     distribute a large enough number of copies you must also follow
 
2154
     the conditions in section 3.
 
2155
 
 
2156
     You may also lend copies, under the same conditions stated above,
 
2157
     and you may publicly display copies.
 
2158
 
 
2159
  3. COPYING IN QUANTITY
 
2160
 
 
2161
     If you publish printed copies (or copies in media that commonly
 
2162
     have printed covers) of the Document, numbering more than 100, and
 
2163
     the Document's license notice requires Cover Texts, you must
 
2164
     enclose the copies in covers that carry, clearly and legibly, all
 
2165
     these Cover Texts: Front-Cover Texts on the front cover, and
 
2166
     Back-Cover Texts on the back cover.  Both covers must also clearly
 
2167
     and legibly identify you as the publisher of these copies.  The
 
2168
     front cover must present the full title with all words of the
 
2169
     title equally prominent and visible.  You may add other material
 
2170
     on the covers in addition.  Copying with changes limited to the
 
2171
     covers, as long as they preserve the title of the Document and
 
2172
     satisfy these conditions, can be treated as verbatim copying in
 
2173
     other respects.
 
2174
 
 
2175
     If the required texts for either cover are too voluminous to fit
 
2176
     legibly, you should put the first ones listed (as many as fit
 
2177
     reasonably) on the actual cover, and continue the rest onto
 
2178
     adjacent pages.
 
2179
 
 
2180
     If you publish or distribute Opaque copies of the Document
 
2181
     numbering more than 100, you must either include a
 
2182
     machine-readable Transparent copy along with each Opaque copy, or
 
2183
     state in or with each Opaque copy a computer-network location from
 
2184
     which the general network-using public has access to download
 
2185
     using public-standard network protocols a complete Transparent
 
2186
     copy of the Document, free of added material.  If you use the
 
2187
     latter option, you must take reasonably prudent steps, when you
 
2188
     begin distribution of Opaque copies in quantity, to ensure that
 
2189
     this Transparent copy will remain thus accessible at the stated
 
2190
     location until at least one year after the last time you
 
2191
     distribute an Opaque copy (directly or through your agents or
 
2192
     retailers) of that edition to the public.
 
2193
 
 
2194
     It is requested, but not required, that you contact the authors of
 
2195
     the Document well before redistributing any large number of
 
2196
     copies, to give them a chance to provide you with an updated
 
2197
     version of the Document.
 
2198
 
 
2199
  4. MODIFICATIONS
 
2200
 
 
2201
     You may copy and distribute a Modified Version of the Document
 
2202
     under the conditions of sections 2 and 3 above, provided that you
 
2203
     release the Modified Version under precisely this License, with
 
2204
     the Modified Version filling the role of the Document, thus
 
2205
     licensing distribution and modification of the Modified Version to
 
2206
     whoever possesses a copy of it.  In addition, you must do these
 
2207
     things in the Modified Version:
 
2208
 
 
2209
       A. Use in the Title Page (and on the covers, if any) a title
 
2210
          distinct from that of the Document, and from those of
 
2211
          previous versions (which should, if there were any, be listed
 
2212
          in the History section of the Document).  You may use the
 
2213
          same title as a previous version if the original publisher of
 
2214
          that version gives permission.
 
2215
 
 
2216
       B. List on the Title Page, as authors, one or more persons or
 
2217
          entities responsible for authorship of the modifications in
 
2218
          the Modified Version, together with at least five of the
 
2219
          principal authors of the Document (all of its principal
 
2220
          authors, if it has fewer than five), unless they release you
 
2221
          from this requirement.
 
2222
 
 
2223
       C. State on the Title page the name of the publisher of the
 
2224
          Modified Version, as the publisher.
 
2225
 
 
2226
       D. Preserve all the copyright notices of the Document.
 
2227
 
 
2228
       E. Add an appropriate copyright notice for your modifications
 
2229
          adjacent to the other copyright notices.
 
2230
 
 
2231
       F. Include, immediately after the copyright notices, a license
 
2232
          notice giving the public permission to use the Modified
 
2233
          Version under the terms of this License, in the form shown in
 
2234
          the Addendum below.
 
2235
 
 
2236
       G. Preserve in that license notice the full lists of Invariant
 
2237
          Sections and required Cover Texts given in the Document's
 
2238
          license notice.
 
2239
 
 
2240
       H. Include an unaltered copy of this License.
 
2241
 
 
2242
       I. Preserve the section Entitled "History", Preserve its Title,
 
2243
          and add to it an item stating at least the title, year, new
 
2244
          authors, and publisher of the Modified Version as given on
 
2245
          the Title Page.  If there is no section Entitled "History" in
 
2246
          the Document, create one stating the title, year, authors,
 
2247
          and publisher of the Document as given on its Title Page,
 
2248
          then add an item describing the Modified Version as stated in
 
2249
          the previous sentence.
 
2250
 
 
2251
       J. Preserve the network location, if any, given in the Document
 
2252
          for public access to a Transparent copy of the Document, and
 
2253
          likewise the network locations given in the Document for
 
2254
          previous versions it was based on.  These may be placed in
 
2255
          the "History" section.  You may omit a network location for a
 
2256
          work that was published at least four years before the
 
2257
          Document itself, or if the original publisher of the version
 
2258
          it refers to gives permission.
 
2259
 
 
2260
       K. For any section Entitled "Acknowledgements" or "Dedications",
 
2261
          Preserve the Title of the section, and preserve in the
 
2262
          section all the substance and tone of each of the contributor
 
2263
          acknowledgements and/or dedications given therein.
 
2264
 
 
2265
       L. Preserve all the Invariant Sections of the Document,
 
2266
          unaltered in their text and in their titles.  Section numbers
 
2267
          or the equivalent are not considered part of the section
 
2268
          titles.
 
2269
 
 
2270
       M. Delete any section Entitled "Endorsements".  Such a section
 
2271
          may not be included in the Modified Version.
 
2272
 
 
2273
       N. Do not retitle any existing section to be Entitled
 
2274
          "Endorsements" or to conflict in title with any Invariant
 
2275
          Section.
 
2276
 
 
2277
       O. Preserve any Warranty Disclaimers.
 
2278
 
 
2279
     If the Modified Version includes new front-matter sections or
 
2280
     appendices that qualify as Secondary Sections and contain no
 
2281
     material copied from the Document, you may at your option
 
2282
     designate some or all of these sections as invariant.  To do this,
 
2283
     add their titles to the list of Invariant Sections in the Modified
 
2284
     Version's license notice.  These titles must be distinct from any
 
2285
     other section titles.
 
2286
 
 
2287
     You may add a section Entitled "Endorsements", provided it contains
 
2288
     nothing but endorsements of your Modified Version by various
 
2289
     parties--for example, statements of peer review or that the text
 
2290
     has been approved by an organization as the authoritative
 
2291
     definition of a standard.
 
2292
 
 
2293
     You may add a passage of up to five words as a Front-Cover Text,
 
2294
     and a passage of up to 25 words as a Back-Cover Text, to the end
 
2295
     of the list of Cover Texts in the Modified Version.  Only one
 
2296
     passage of Front-Cover Text and one of Back-Cover Text may be
 
2297
     added by (or through arrangements made by) any one entity.  If the
 
2298
     Document already includes a cover text for the same cover,
 
2299
     previously added by you or by arrangement made by the same entity
 
2300
     you are acting on behalf of, you may not add another; but you may
 
2301
     replace the old one, on explicit permission from the previous
 
2302
     publisher that added the old one.
 
2303
 
 
2304
     The author(s) and publisher(s) of the Document do not by this
 
2305
     License give permission to use their names for publicity for or to
 
2306
     assert or imply endorsement of any Modified Version.
 
2307
 
 
2308
  5. COMBINING DOCUMENTS
 
2309
 
 
2310
     You may combine the Document with other documents released under
 
2311
     this License, under the terms defined in section 4 above for
 
2312
     modified versions, provided that you include in the combination
 
2313
     all of the Invariant Sections of all of the original documents,
 
2314
     unmodified, and list them all as Invariant Sections of your
 
2315
     combined work in its license notice, and that you preserve all
 
2316
     their Warranty Disclaimers.
 
2317
 
 
2318
     The combined work need only contain one copy of this License, and
 
2319
     multiple identical Invariant Sections may be replaced with a single
 
2320
     copy.  If there are multiple Invariant Sections with the same name
 
2321
     but different contents, make the title of each such section unique
 
2322
     by adding at the end of it, in parentheses, the name of the
 
2323
     original author or publisher of that section if known, or else a
 
2324
     unique number.  Make the same adjustment to the section titles in
 
2325
     the list of Invariant Sections in the license notice of the
 
2326
     combined work.
 
2327
 
 
2328
     In the combination, you must combine any sections Entitled
 
2329
     "History" in the various original documents, forming one section
 
2330
     Entitled "History"; likewise combine any sections Entitled
 
2331
     "Acknowledgements", and any sections Entitled "Dedications".  You
 
2332
     must delete all sections Entitled "Endorsements."
 
2333
 
 
2334
  6. COLLECTIONS OF DOCUMENTS
 
2335
 
 
2336
     You may make a collection consisting of the Document and other
 
2337
     documents released under this License, and replace the individual
 
2338
     copies of this License in the various documents with a single copy
 
2339
     that is included in the collection, provided that you follow the
 
2340
     rules of this License for verbatim copying of each of the
 
2341
     documents in all other respects.
 
2342
 
 
2343
     You may extract a single document from such a collection, and
 
2344
     distribute it individually under this License, provided you insert
 
2345
     a copy of this License into the extracted document, and follow
 
2346
     this License in all other respects regarding verbatim copying of
 
2347
     that document.
 
2348
 
 
2349
  7. AGGREGATION WITH INDEPENDENT WORKS
 
2350
 
 
2351
     A compilation of the Document or its derivatives with other
 
2352
     separate and independent documents or works, in or on a volume of
 
2353
     a storage or distribution medium, is called an "aggregate" if the
 
2354
     copyright resulting from the compilation is not used to limit the
 
2355
     legal rights of the compilation's users beyond what the individual
 
2356
     works permit.  When the Document is included in an aggregate, this
 
2357
     License does not apply to the other works in the aggregate which
 
2358
     are not themselves derivative works of the Document.
 
2359
 
 
2360
     If the Cover Text requirement of section 3 is applicable to these
 
2361
     copies of the Document, then if the Document is less than one half
 
2362
     of the entire aggregate, the Document's Cover Texts may be placed
 
2363
     on covers that bracket the Document within the aggregate, or the
 
2364
     electronic equivalent of covers if the Document is in electronic
 
2365
     form.  Otherwise they must appear on printed covers that bracket
 
2366
     the whole aggregate.
 
2367
 
 
2368
  8. TRANSLATION
 
2369
 
 
2370
     Translation is considered a kind of modification, so you may
 
2371
     distribute translations of the Document under the terms of section
 
2372
     4.  Replacing Invariant Sections with translations requires special
 
2373
     permission from their copyright holders, but you may include
 
2374
     translations of some or all Invariant Sections in addition to the
 
2375
     original versions of these Invariant Sections.  You may include a
 
2376
     translation of this License, and all the license notices in the
 
2377
     Document, and any Warranty Disclaimers, provided that you also
 
2378
     include the original English version of this License and the
 
2379
     original versions of those notices and disclaimers.  In case of a
 
2380
     disagreement between the translation and the original version of
 
2381
     this License or a notice or disclaimer, the original version will
 
2382
     prevail.
 
2383
 
 
2384
     If a section in the Document is Entitled "Acknowledgements",
 
2385
     "Dedications", or "History", the requirement (section 4) to
 
2386
     Preserve its Title (section 1) will typically require changing the
 
2387
     actual title.
 
2388
 
 
2389
  9. TERMINATION
 
2390
 
 
2391
     You may not copy, modify, sublicense, or distribute the Document
 
2392
     except as expressly provided for under this License.  Any other
 
2393
     attempt to copy, modify, sublicense or distribute the Document is
 
2394
     void, and will automatically terminate your rights under this
 
2395
     License.  However, parties who have received copies, or rights,
 
2396
     from you under this License will not have their licenses
 
2397
     terminated so long as such parties remain in full compliance.
 
2398
 
 
2399
 10. FUTURE REVISIONS OF THIS LICENSE
 
2400
 
 
2401
     The Free Software Foundation may publish new, revised versions of
 
2402
     the GNU Free Documentation License from time to time.  Such new
 
2403
     versions will be similar in spirit to the present version, but may
 
2404
     differ in detail to address new problems or concerns.  See
 
2405
     `http://www.gnu.org/copyleft/'.
 
2406
 
 
2407
     Each version of the License is given a distinguishing version
 
2408
     number.  If the Document specifies that a particular numbered
 
2409
     version of this License "or any later version" applies to it, you
 
2410
     have the option of following the terms and conditions either of
 
2411
     that specified version or of any later version that has been
 
2412
     published (not as a draft) by the Free Software Foundation.  If
 
2413
     the Document does not specify a version number of this License,
 
2414
     you may choose any version ever published (not as a draft) by the
 
2415
     Free Software Foundation.
 
2416
 
 
2417
ADDENDUM: How to use this License for your documents
 
2418
====================================================
 
2419
 
 
2420
To use this License in a document you have written, include a copy of
 
2421
the License in the document and put the following copyright and license
 
2422
notices just after the title page:
 
2423
 
 
2424
       Copyright (C)  YEAR  YOUR NAME.
 
2425
       Permission is granted to copy, distribute and/or modify this document
 
2426
       under the terms of the GNU Free Documentation License, Version 1.2
 
2427
       or any later version published by the Free Software Foundation;
 
2428
       with no Invariant Sections, no Front-Cover Texts, and no Back-Cover
 
2429
       Texts.  A copy of the license is included in the section entitled ``GNU
 
2430
       Free Documentation License''.
 
2431
 
 
2432
   If you have Invariant Sections, Front-Cover Texts and Back-Cover
 
2433
Texts, replace the "with...Texts." line with this:
 
2434
 
 
2435
         with the Invariant Sections being LIST THEIR TITLES, with
 
2436
         the Front-Cover Texts being LIST, and with the Back-Cover Texts
 
2437
         being LIST.
 
2438
 
 
2439
   If you have Invariant Sections without Cover Texts, or some other
 
2440
combination of the three, merge those two alternatives to suit the
 
2441
situation.
 
2442
 
 
2443
   If your document contains nontrivial examples of program code, we
 
2444
recommend releasing these examples in parallel under your choice of
 
2445
free software license, such as the GNU General Public License, to
 
2446
permit their use in free software.
 
2447
 
 
2448
 
 
2449
File: preview-latex.info,  Node: Index,  Prev: Copying this Manual,  Up: Top
2054
2450
 
2055
2451
Index
2056
2452
*****
2082
2478
* Caching a preamble:                    Simple customization.
2083
2479
                                                              (line  59)
2084
2480
* Contacts:                              Contacts.            (line   6)
2085
 
* Copying:                               License.             (line   6)
2086
 
* Copyright:                             License.             (line   6)
 
2481
* Copying:                               Copying.             (line   6)
 
2482
* Copyright:                             Copying.             (line   6)
2087
2483
* CVS access:                            Availability.        (line   6)
 
2484
* Distribution:                          Copying.             (line   6)
2088
2485
* Download:                              Availability.        (line   6)
2089
 
* General Public License:                License.             (line   6)
2090
 
* GPL:                                   License.             (line   6)
 
2486
* FDL, GNU Free Documentation License:   GNU Free Documentation License.
 
2487
                                                              (line   6)
 
2488
* Free:                                  Copying.             (line   6)
 
2489
* Free software:                         Copying.             (line   6)
 
2490
* General Public License:                Copying.             (line   6)
 
2491
* GPL:                                   Copying.             (line   6)
2091
2492
* Inline math:                           Simple customization.
2092
2493
                                                              (line 110)
2093
2494
* Kill preview-generating process:       Keys and lisp.       (line 161)
2094
 
* License:                               License.             (line   6)
 
2495
* License:                               Copying.             (line   6)
2095
2496
* M-m P:                                 Keys and lisp.       (line  64)
2096
2497
* M-x preview-report-bug <RET>:          Keys and lisp.       (line 153)
2097
2498
* Mailing list:                          Contacts.            (line   6)
2158
2559
* preview-use-balloon-help:              The Emacs interface. (line 165)
2159
2560
* Readme:                                Introduction.        (line   6)
2160
2561
* Report a bug:                          Keys and lisp.       (line 153)
 
2562
* Right:                                 Copying.             (line   6)
2161
2563
* Showing \labels:                       Simple customization.
2162
2564
                                                              (line  23)
2163
2565
* Using dvipng:                          Basic modes of operation.
2164
2566
                                                              (line  18)
2165
 
* Warranty:                              License.             (line   6)
 
2567
* Warranty:                              Copying.             (line   6)
2166
2568
 
2167
2569
 
2168
2570
 
2169
2571
Tag Table:
2170
 
Node: Top248
2171
 
Node: Introduction1632
2172
 
Node: What use is it?2301
2173
 
Node: Activating preview-latex3693
2174
 
Node: Getting started4508
2175
 
Node: Basic modes of operation6595
2176
 
Node: More documentation7799
2177
 
Node: Availability8687
2178
 
Node: Contacts9292
2179
 
Node: Installation10564
2180
 
Node: Keys and lisp10777
2181
 
Node: Simple customization17445
2182
 
Node: Known problems23206
2183
 
Node: Problems with Ghostscript24027
2184
 
Node: Font problems with Dvips26220
2185
 
Node: Emacs problems27423
2186
 
Node: Too small bounding boxes29160
2187
 
Node: x-symbol interoperation30544
2188
 
Node: Middle-clicks paste instead of toggling31926
2189
 
Node: For advanced users32742
2190
 
Node: The LaTeX style file33201
2191
 
Node: Package options35761
2192
 
Node: Provided commands46571
2193
 
Node: The Emacs interface53921
2194
 
Node: The preview images63101
2195
 
Node: Misplaced previews66573
2196
 
Node: ToDo70016
2197
 
Node: Frequently Asked Questions74801
2198
 
Node: Introduction to FAQ75074
2199
 
Node: Requirements75413
2200
 
Node: Installation Trouble78291
2201
 
Node: Customization83125
2202
 
Node: License89313
2203
 
Node: Index91364
 
2572
Node: Top831
 
2573
Node: Copying2103
 
2574
Node: Introduction2564
 
2575
Node: What use is it?3237
 
2576
Node: Activating preview-latex4629
 
2577
Node: Getting started5444
 
2578
Node: Basic modes of operation7531
 
2579
Node: More documentation8735
 
2580
Node: Availability9623
 
2581
Node: Contacts10228
 
2582
Node: Installation11500
 
2583
Node: Keys and lisp11713
 
2584
Node: Simple customization18381
 
2585
Node: Known problems24142
 
2586
Node: Problems with Ghostscript24963
 
2587
Node: Font problems with Dvips27156
 
2588
Node: Emacs problems28359
 
2589
Node: Too small bounding boxes30096
 
2590
Node: x-symbol interoperation31480
 
2591
Node: Middle-clicks paste instead of toggling32862
 
2592
Node: For advanced users33678
 
2593
Node: The LaTeX style file34137
 
2594
Node: Package options36697
 
2595
Node: Provided commands47507
 
2596
Node: The Emacs interface54862
 
2597
Node: The preview images64042
 
2598
Node: Misplaced previews67514
 
2599
Node: ToDo70957
 
2600
Node: Frequently Asked Questions75742
 
2601
Node: Introduction to FAQ76027
 
2602
Node: Requirements76366
 
2603
Node: Installation Trouble79330
 
2604
Node: Customization81892
 
2605
Node: Copying this Manual88068
 
2606
Node: GNU Free Documentation License88993
 
2607
Node: Index111398
2204
2608
 
2205
2609
End Tag Table