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