doc/emacs/emacs-xtra.texi

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