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