doc/emacs/emacs-xtra.texi

   1 \input texinfo    @c -*-texinfo-*-
   2 @comment %**start of header
   3 @setfilename ../../info/emacs-xtra
   4 @settitle Specialized Emacs Features
   5 @c Merge all functions, variables, and keys into the concept index.
   6 @syncodeindex fn cp
   7 @syncodeindex vr cp
   8 @syncodeindex ky cp
   9 @comment %**end of header
  10
  11 @copying
  12 This manual describes specialized features of Emacs.
  13
  14 Copyright @copyright{} 2004-2012
  15 Free Software Foundation, Inc.
  16
  17 @quotation
  18 Permission is granted to copy, distribute and/or modify this document
  19 under the terms of the GNU Free Documentation License, Version 1.3 or
  20 any later version published by the Free Software Foundation; with no
  21 Invariant Sections, with the Front-Cover texts being ``A GNU
  22 Manual,'' and with the Back-Cover Texts as in (a) below.  A copy of the
  23 license is included in the section entitled ``GNU Free Documentation
  24 License'' in the Emacs manual.
  25
  26 (a) The FSF's Back-Cover Text is: ``You have the freedom to copy and
  27 modify this GNU manual.  Buying copies from the FSF supports it in
  28 developing GNU and promoting software freedom.''
  29
  30 This document is part of a collection distributed under the GNU Free
  31 Documentation License.  If you want to distribute this document
  32 separately from the collection, you can do so by adding a copy of the
  33 license to the document, as described in section 6 of the license.
  34 @end quotation
  35 @end copying
  36
  37 @dircategory Emacs
  38 @direntry
  39 * Emacs-Xtra: (emacs-xtra).    Specialized Emacs features.
  40 @end direntry
  41
  42 @titlepage
  43 @title Specialized Emacs Features
  44 @page
  45 @vskip 0pt plus 1filll
  46 @insertcopying
  47 @end titlepage
  48
  49 @contents
  50
  51 @ifnottex
  52 @node Top
  53 @top Specialized Emacs Features
  54
  55 @insertcopying
  56
  57 @end ifnottex
  58
  59 @menu
  60 * Introduction::        What documentation belongs here?
  61 @iftex
  62 * Picture Mode::        Editing pictures made up of characters using
  63                          the quarter-plane screen model.
  64
  65 * Autorevert::          Auto Reverting non-file buffers.
  66 * Subdir Switches::     Subdirectory switches in Dired.
  67 * Advanced Calendar/Diary Usage:: Advanced Calendar/Diary customization.
  68 * Emerge::              A convenient way of merging two versions of a program.
  69 * Advanced VC Usage::   Advanced VC (version control) features.
  70 * Fortran::             Fortran mode and its special features.
  71 * MS-DOS::              Using Emacs on MS-DOS (otherwise known as @dfn{MS-DOG}).
  72 @end iftex
  73 * Index::
  74 @end menu
  75
  76 @node Introduction
  77 @unnumbered Introduction
  78
  79 This manual contains detailed information about various features that
  80 are too specialized to be included in the printed Emacs manual.  It is
  81 intended to be readable by anyone having a basic knowledge of Emacs.
  82 However, certain sections may be intended for a more specialized
  83 audience, such as Elisp authors.  This should be clearly pointed out
  84 at the beginning of these sections.
  85
  86 @c Note to authors - you need to be careful about cross-references to
  87 @c topics in the Emacs manual.  As a printed document, the xtra files
  88 @c are separate from the Emacs manual; but as an info document, they
  89 @c are part of the Emacs manual.  Hence you need to use something like:
  90 @c @iftex
  91 @c @ref{Comparing Files,,, emacs, the Emacs Manual},
  92 @c @end iftex
  93 @c @ifnottex
  94 @c @ref{Comparing Files},
  95 @c @end ifnottex
  96
  97 Certain packages (or collections of related features) have their own
  98 manuals, separate from the main Emacs manual.  This manual is
  99 intended as a complement, rather than an alternative, to reading those
 100 additional manuals.  In a nutshell, it is a collection of smaller
 101 specialized features (or extra detail about standard features), too
 102 small or too obscure to justify their own manual, or inclusion in the
 103 printed Emacs manual.  The chapters in this manual are, however,
 104 included (at the relevant places) in the main Emacs manual when it is
 105 formatted as an Info document.
 106
 107 Sections intended specifically for Elisp programmers can follow the
 108 style of the Elisp manual.  Other sections should follow the style of
 109 the Emacs manual.
 110
 111 @iftex
 112 @c ``Picture Mode'' is a chapter, not a section, so it's outside @raisesections.
 113 @include picture-xtra.texi
 114
 115 @raisesections
 116 @include arevert-xtra.texi
 117
 118 @include dired-xtra.texi
 119
 120 @include cal-xtra.texi
 121
 122 @include emerge-xtra.texi
 123
 124 @include vc-xtra.texi
 125
 126 @include fortran-xtra.texi
 127
 128 @include msdog-xtra.texi
 129
 130 @lowersections
 131 @end iftex
 132
 133 @node Index
 134 @unnumbered Index
 135
 136 @printindex cp
 137
 138 @bye