auctex / texi / intro.texi

  1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 @chapter Introduction to AUC TeX This section of the AUC @TeX{} manual gives a brief overview of what AUC @TeX{} is, and the section is also available as a @file{README} file. It is @strong{not} an attempt to document AUC @TeX{}. Real documentation for AUC @TeX{} is available in the rest of the manual, which you can find in the @file{doc} directory. Read the @file{INSTALLATION} file for information about how to install AUC @TeX{}. It is identical to the Installation chapter in the AUC @TeX{} manual. If you are upgrading from the previous version of AUC @TeX{}, the latest changes can be found in the @file{CHANGES} file. If you are upgrading from an older version, read the History chapter in the AUC @TeX{} manual. AUC @TeX{} is a comprehensive customizable integrated environment for writing input files for La@TeX{} using GNU Emacs. AUC @TeX{} lets you run @TeX{}/La@TeX{} and other La@TeX{}-related tools, such as a output filters or post processor from inside Emacs. Especially running La@TeX{}' is interesting, as AUC @TeX{} lets you browse through the errors @TeX{} reported, while it moves the cursor directly to the reported error, and displays some documentation for that particular error. This will even work when the document is spread over several files. AUC @TeX{} automatically indents your La@TeX{}-source', not only as you write it --- you can also let it indent and format an entire document. It has a special outline feature, which can greatly help you getting an overview' of a document. Apart from these special features, AUC @TeX{} provides a large range of handy Emacs macros, which in several different ways can help you write your La@TeX{} documents fast and painlessly. All features of AUC @TeX{} are documented using the GNU Emacs online documentation system. That is, documentation for any command is just a key click away! AUC @TeX{} is written entirely in Emacs-Lisp, and hence you can easily add new features for your own needs. It was not made as part of any particular employment or project (apart from the AUC @TeX{} project itself). AUC @TeX{} is distributed under the GNU Emacs General Public License' and may therefore almost freely be copied and redistributed. The next sections are a short introduction to some actual' features. For further information, refer to the built-in online documentation of AUC @TeX{}. @section Indentation and formatting AUC @TeX{} may automatically indent your document as you write it. By pressing @key{lfd} instead of @key{ret} at the end of a line, the current line is indented by two spaces according to the current environment level, and the cursor is moved down one line. By pressing @key{tab}, the current line is indented, and the cursor stays where it is. The well-known Emacs feature @code{format-paragraph} (@kbd{M-q}) is reimplemented especially for AUC @TeX{} to follow the indentation. A special command @code{LaTeX-fill-buffer} lets you indent an entire document like the well-known C utility indent (this time, only according to the La@TeX{} structure @t{:-)}. @section Completion By studying your @samp{\documentclass} command (in the top of your document), and consulting a precompiled list of (La)@TeX{} symbols from a large number of @TeX{} and La@TeX{} files, AUC @TeX{} is aware of the La@TeX{} commands you should be able to use in this particular document. This knowledge' of AUC @TeX{} is used for two purposes. @enumerate @item To make you able to complete' partly written La@TeX{} commands. You may e.g. write @kbd{\renew} and press @kbd{M-@key{tab}} (@code{TeX-complete-symbol}), and then AUC @TeX{} will complete the word @samp{\renewcommand} for you. In case of ambiguity it will display a list of possible completions. @item To aid you inserting environments, that is \begin - \end pairs. This is done by pressing C-c C-e (La@TeX{}-environment), and you will be prompted for which environment' to insert. @end enumerate @section Editing your document A number of more or less intelligent keyboard macros have been defined to aid you editing your document. The most important are listed below. @table @code @item LaTeX-environment (@kbd{C-c C-e}) Insert a @samp{\begin@{@}} --- @samp{\end@{@}} pair as described above. @item LaTeX-section (@kbd{C-c C-s}) Insert one of @samp{\chapter}, @samp{\section}, etc. @item TeX-font (@kbd{C-c C-f C-r}, @kbd{C-c C-f C-i}, @kbd{C-c C-f C-b}) Insert one of @samp{\textrm@{ @}}), @samp{\textit@{ \/@}} @samp{\textbf@{ @}} etc. @end table A number of additional functions are available. But it would be far too much to write about here. Refer to the rest of the AUC @TeX{} documentation for further information. @section Running La@TeX{} When invoking one of the commands @code{TeX-command-master} (@kbd{C-c C-c}) or @code{TeX-command-region} (@kbd{C-c C-r}) La@TeX{} is run on either the entire current document or a given region of it. The Emacs view is split in two, and the output of @TeX{} is printed in the second half of the screen, as you may simultaneously continue editing your document. In case @TeX{} find any errors when processing your input you can call the function @code{TeX-next-error} (@kbd{C-c }) which will move the cursor to the first given error, and display a short explanatory text along with the message @TeX{} gave. This procedure may be repeated until all errors have been displayed. By pressing @kbd{C-c C-w} (@code{TeX-toggle-debug-boxes}) you can toggle whether the browser also should notify over-full/under-full boxes or not. Once you've successfully formatted your document, you may preview or print it by invoking @code{TeX-command-master} again. @section Outlines Along with AUC @TeX{} comes support for outline mode for Emacs, which lets you browse the sectioning structure of your document, while you will still be able to use the full power of the rest of the AUC @TeX{} functionality. @section Availability The most recent version is always available by ftp at @flushright @samp{ftp://ftp.iesd.auc.dk/pub/emacs-lisp/auctex.tar.gz} @end flushright In case you don't have access anonymous ftp, you can get it by email requests to @samp{}. WWW users may want to check out the AUC @TeX{} page at @flushright @samp{http://www.iesd.auc.dk/~amanda/auctex/} @end flushright @section Contacts There has been established a mailing list for help, bug reports, feature requests and general discussion about AUC @TeX{}. You're very welcome to join. Traffic average at an article by day, but they come in bursts. If you are only interested in information on updates, you could refer to the newsgroups @samp{comp.text.tex} and @samp{gnu.emacs.sources}. If you want to contact the AUC @TeX{} mailing list, send mail to @samp{} in order to join. Articles should be sent to @samp{}. To contact the current maintainers of AUC @TeX{} directly, email @samp{}. @example AUC @TeX{} development c/o Kresten Krab Thorup Mathematics and Computer Science University of Aalborg DK 9000 Aalborg Denmark @end example `