Source

xemacsweb / Documentation / index.content

Full commit
%title%
Documentation
%author%
john s jacobs anderson, using old content with no listed author
stephen j turnbull, for ghostscript and problems with acrobat
%main%

  <h1>XEmacs Documentation</h1>

  <h2>XEmacs <a id="HTML" name="HTML">HTML</a> Manuals</h2>

  <a href="#PDF">PDF</a>

  <p>
    Following XEmacs Manuals are available for browsing on the XEmacs
    Website and all its mirrors worldwide:</p>

  <ul>
    <li>XEmacs <a href="21.5/html/">21.5</a> (<a href="https://bitbucket.org/xemacs/xemacs/src/tip/man">xemacs/man sources</a> in CVS)</li>
    <li>XEmacs <a href="packages/html/">Packages</a> (<a href="https://bitbucket.org/xemacs/xemacs-packages/src/">packages sources</a>, including texinfo sources, in CVS)</li>
  </ul>

  <hr />

  <h2>XEmacs Info Manuals in <a id="PDF" name="PDF">PDF</a> format</h2>

  <a href="#HTML">HTML</a>

  <p>
    The following documents are available in
    <a href="#Readers">PDF</a> format (with permuted indices) for both US
    Letter and A4 sized paper:</p>
            
  <table>
    <tbody>
      <tr>
        <td rowspan="1" colspan="1">Programming in Emacs Lisp, an
    Introduction (emacs-lisp-intro)</td> <td rowspan="1"
    colspan="1"><a
    href="http://ftp.xemacs.org/pub/xemacs/docs/letter/emacs-lisp-intro-letter.pdf.gz"
    >[Letter]</a></td> <td rowspan="1" colspan="1"><a
    href="http://ftp.xemacs.org/pub/xemacs/docs/a4/emacs-lisp-intro-a4.pdf.gz"
    >[A4]</a></td>
      </tr>
      <tr>
        <td rowspan="1" colspan="1">XEmacs Internals Manual (internals)</td>
        <td rowspan="1" colspan="1"><a href="http://ftp.xemacs.org/pub/xemacs/docs/letter/internals-letter.pdf.gz">[Letter]</a></td>
        <td rowspan="1" colspan="1"><a href="http://ftp.xemacs.org/pub/xemacs/docs/a4/internals-a4.pdf.gz">[A4]</a></td>
      </tr>
      <tr>
        <td rowspan="1" colspan="1">XEmacs Lisp Reference Manual (lispref)</td>
        <td rowspan="1" colspan="1"><a href="http://ftp.xemacs.org/pub/xemacs/docs/letter/lispref-letter.pdf.gz">[Letter]</a></td>
        <td rowspan="1" colspan="1"><a href="http://ftp.xemacs.org/pub/xemacs/docs/a4/lispref-a4.pdf.gz">[A4]</a></td>
      </tr>
      <tr>
        <td rowspan="1" colspan="1">Getting Started With XEmacs (new-users-guide)</td>
        <td rowspan="1" colspan="1"><a href="http://ftp.xemacs.org/pub/xemacs/docs/letter/new-users-guide-letter.pdf.gz">[Letter]</a></td>
        <td rowspan="1" colspan="1"><a href="http://ftp.xemacs.org/pub/xemacs/docs/a4/new-users-guide-a4.pdf.gz">[A4]</a></td>
      </tr>
      <tr>
        <td rowspan="1" colspan="1">XEmacs Users Manual (xemacs)</td>
        <td rowspan="1" colspan="1"><a href="http://ftp.xemacs.org/pub/xemacs/docs/letter/xemacs-letter.pdf.gz">[Letter]</a></td>
        <td rowspan="1" colspan="1"><a href="http://ftp.xemacs.org/pub/xemacs/docs/a4/xemacs-a4.pdf.gz">[A4]</a></td>
      </tr>
    </tbody>
  </table>
            
  <p>
    If you would like to download documents in Postscript or DVI
    format, please do so directly via FTP from <a
    href="http://ftp.xemacs.org/pub/xemacs/docs/"
    >&lt;http://ftp.xemacs.org/pub/xemacs/docs/&gt;</a> or,
    if you are behind a firewall, via HTTP from <a
    href="http://ftp.xemacs.org/docs/"
    >&lt;http://ftp.xemacs.org/docs/&gt;</a>.</p>

  <!-- #### Cross-link to the download page.... -->
  <p>
    The Texinfo source files are bundled with the <a
    href="../Download/">XEmacs source tarball</a>, and a
    wide variety of tools are available from the <a
    href="http://www.gnu.org/">GNU Project</a> and third party
    developers to format them in almost any way imaginable.</p>

  <h3><a id="Readers" name="Readers">Download a PDF Reader</a></h3>

  <p>
    There are several PDF readers which are freely available for
    download.</p>

  <ul>
    <!-- #### The wisc.edu URL is still better than ghostscript.com
    or sourceforge.net for this purpose. -->
    <li>
      We recommend <a href="http://www.cs.wisc.edu/~ghost/"
      >Aladdin or GNU Ghostscript</a>.  A user-friendly
      interface is provided by <em>gv</em> (for X11) or
      <em>Ghostview</em> (for Windows).  Ghostscript also provides the
      capability to create PDF files from Postscript sources, as well
      as a complete, robust Postscript interpreter.</li>
    <li>
      Another contender is
      <a href="http://www.foolabs.com/xpdf/">xpdf</a>,
      which is more user-friendly and compact,
      but has less overall capability.  (Not for Windows.)</li>
  </ul>

  <h3><a id="AcrobatBug" name="AcrobatBug">PDF Problems?</a></h3>

  <p>
    Older versions of Adobe Acrobat are known to be incapable of
    reading certain standard-conformant PDF files.</p>

  <p>
    Following versions of Adobe Acrobat have been reported to be able
    to read the PDF files provided here:</p>

  <ul>
    <li>Acrobat Reader 4.0 (4.05.1103 09:34) on Windows 2000 Professional (danish version)</li>
    <li>Acrobat Reader 4.0 (0408 05:21) on Windows 98 SE4.10.2222 A</li>
    <li>Acrobat Reader 4.0 0513 09:57 on Windows NT 4.0 (Build 1381: Service Pack 6)</li>
    <li>Acrobat Reader 5.0 5.0.127.03.01 on Windows 98 [Version 4.10.2222]</li>
    <li>Acrobat 5.0.5 on Windows XP</li>
    <li>Acrobat 5.0.5 on MacOS X (ver. 10.1.5)</li>
    <li>Acrobat 5.0.6 on GNU/Linux</li>
    <li>Acrobat 5.0.1 of 3/27/2001 on Windows XP Professional</li>
  </ul>

  <p>
    The standard <a href="#Readers">free PDF readers</a>
    (<em>Ghostscript</em>, <em>gv</em>, and <em>xpdf</em>) do not have
    these limitations.  <em>Ghostscript</em>, at least, is available
    for the Windows platform.</p>

  <!-- #### Raph sez "6.32 is last before 6.50 stable."
  Watch for better Ghostscript! -->

  <p>
    Unfortunately, both versions of <em>Ghostscript</em> prior to
    about 6.21 (ie, still in beta) and current versions of
    <em>pdflatex</em> emit such files (some of the problems were fixed
    in Aladdin Ghostscript's 6.0 release).  There's not much we can do
    about it until updated versions of PDF writing software that cater
    to Acrobat's idiosyncracies become generally available.  In
    particular, <em>pdflatex</em> (which we use for generating
    preformatted versions of Texinfo documents) still generates such
    files.</p>

  <h3>Additional documentation</h3>

  <p>
    More recent material can be found in the
    <a href="../FAQ/">FAQ</a> or the
    <a href="../Releases/">Releases</a> files. The following might also be
    useful:</p>

  <ul>
    <li><a href="http://www.gnu.org/software/emacs/emacs-faq.text">FSF/GNU Emacs FAQ</a></li>
    <li><a href="http://www.ccs.neu.edu/software/contrib/gnus/">Gnus FAQ</a></li>
    <li><a href="http://www.wonderworks.com/vm/FAQ.html">VM FAQ</a></li>
  </ul>

<!-- Keep this comment at the end of the file
Local variables:
mode: xml
sgml-omittag:nil
sgml-shorttag:nil
sgml-namecase-general:nil
sgml-general-insert-case:lower
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:2
sgml-indent-data:t
sgml-parent-document:("../template.html" "html" "body" "table" "tr" "td")
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
-->