\input texinfo @c -*-texinfo-*-
@setfilename ../info/ada-mode
@settitle Ada Mode
-@dircategory Emacs
-@direntry
-* Ada mode: (ada-mode). Emacs mode for editing Ada code.
-@end direntry
@comment !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
@comment The following lines inserts the copyright notice
@comment into the Info file.
@comment !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
-@ifnottex
-Copyright @copyright{} 1999, 2000, 2001 Free Software Foundation, Inc.
+@copying
+Copyright @copyright{} 1999, 2000, 2001, 2002, 2003, 2004,
+2005, 2006 Free Software Foundation, Inc.
+@quotation
Permission is granted to copy, distribute and/or modify this document
-under the terms of the GNU Free Documentation License, Version 1.1 or
+under the terms of the GNU Free Documentation License, Version 1.2 or
any later version published by the Free Software Foundation; with the
Invariant Sections being ``The GNU Manifesto'', ``Distribution'' and
``GNU GENERAL PUBLIC LICENSE'', with the Front-Cover texts being ``A GNU
Documentation License. If you want to distribute this document
separately from the collection, you can do so by adding a copy of the
license to the document, as described in section 6 of the license.
-@end ifnottex
+@end quotation
+@end copying
-@comment !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
-@comment TeX title page
-@comment !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+@dircategory Emacs
+@direntry
+* Ada mode: (ada-mode). Emacs mode for editing Ada code.
+@end direntry
@titlepage
@sp 10
@subtitle An Emacs major mode for programming Ada 95 with GNAT
@subtitle July 1998 for Ada Mode Version 3.0
@sp 2
-
@page
@vskip 0pt plus 1filll
-Copyright @copyright{} 1999, 2000, 2001 Free Software Foundation, Inc.
-@sp 1
-Permission is granted to copy, distribute and/or modify this document
-under the terms of the GNU Free Documentation License, Version 1.1 or
-any later version published by the Free Software Foundation; with the
-Invariant Sections being ``The GNU Manifesto'', ``Distribution'' and
-``GNU GENERAL PUBLIC LICENSE'', with the Front-Cover texts being ``A GNU
-Manual'', and with the Back-Cover Texts as in (a) below. A copy of the
-license is included in the section entitled ``GNU Free Documentation
-License'' in the Emacs manual.
-
-(a) The FSF's Back-Cover Text is: ``You have freedom to copy and modify
-this GNU Manual, like GNU software. Copies published by the Free
-Software Foundation raise funds for GNU development.''
-
-This document is part of a collection distributed under the GNU Free
-Documentation License. If you want to distribute this document
-separately from the collection, you can do so by adding a copy of the
-license to the document, as described in section 6 of the license.
+@insertcopying
@end titlepage
defined in your application
* File Browser:: Easy access to your files
* Automatic Smart Indentation:: Indenting your code automatically as you type
-* Formatting Parameter Lists:: Formating subprograms parameter lists
+* Formatting Parameter Lists:: Formatting subprograms' parameter lists
automatically
* Automatic Casing:: Adjusting the case of words automatically
* Statement Templates:: Inserting code templates
switching between spec and body files with eventually
auto-generation of body files,
@item
-automatic formating of subprograms parameter lists.
+automatic formatting of subprograms' parameter lists.
@item
automatic smart indentation according to Ada syntax,
@item
Ada mode every time you edit an Ada file.
Also, for general usage variables that you might want to set,
-see
+see
@iftex
@cite{The GNU Emacs Manual}.
@end iftex
To take full advantage of this features, it is possible to create a file
in the main directory of your application, with a @samp{.adp} extension.
-This file contain all needed information dealing with the way your
+This file contains all needed information dealing with the way your
application is organized between directories, the commands to compile,
run and debug it etc. Creating this file is not mandatory and convenient
defaults are automatically provided for simple setups. It only becomes
@end example
Note: This has a higher priority than the first variable, so the first
-choice is to use this variable settings, and otherwise
+choice is to use this variable's settings, and otherwise
@code{ada-prj-default-project-file}.
@end itemize
@item C-c u
@findex ada-customize
Create or edit the project file for the current buffer (@code{ada-customize}).
-@item C-c c
+@item C-c c
@findex ada-change-prj
Change the project file associated with the current Ada buffer (@code{ada-change-prj}).
@item C-c d
Emacs and Ada mode provide two general ways for the completion of
identifiers. This is an easy way to type faster: you just have to type
-the first few letters of an identifiers, and then loop through all the
+the first few letters of an identifier, and then loop through all the
possible completions.
The first method is general for Emacs. It will work both with Ada
This is a very fast way to do completion, and the casing of words will
also be respected.
-The second method is specific to Ada buffer, and even to users of the
+The second method is specific to Ada buffers, and even to users of the
Gnat compiler. Emacs will search the cross-information found in the
@samp{.ali} files generated by Gnat for possible completions.
place.
You can activate this mode by typing @key{M-x speedbar} in the editor.
-This will open a new frame. A better way might be to assicate the
+This will open a new frame. A better way might be to associate the
following key binding
@example
instance @code{My_vARIable} is converted to @code{My_Variable}.
@item ada-loose-case-word
-No letters is modified in the previous word, except the ones after the
+No letters are modified in the previous word, except the ones after the
@samp{_} character that are upper cased. For instance @code{My_vARIable} is
converted to @code{My_VARIable}.
@end table
only. You can not automatically add an exception to one of the other
files, although you can of course edit the files by hand at any time.
-Automatic casing can be performed on port or whole buffer using:
+Automatic casing can be performed on part of the buffer, or on the
+whole buffer, using:
@table @kbd
@item C-c C-b
application. Emacs is compatible with a lot of debuggers, and provide an
easy interface to them.
-This selection will focus on the gdb debugger, and two of the graphical
+This section will focus on the gdb debugger, and two of the graphical
interfaces that exist for it.
In all cases, the main window in Emacs will be split in two: in the
You can easily use Emacs as the source window when you are using a
graphical interface for the debugger. The interesting thing is that,
-whereas you still have the graphical nifties, you can also you the
+whereas you still have the graphical nifties, you can also use the
cross-references features that Ada mode provides to look at the
definition for the identifiers, @enddots{}
(ada-add-extensions "_s.ada" "_b.ada")
@end example
-Note that it is possible to redefine the extension, even if they already
+Note that it is possible to redefine the extensions, even if they already
exist, as in:
@example
@chapter Working Remotely
@c ---------------------------------------------------------------------
-When you work on project that involve a lot of programmers, it is
+When you work on a project that involves a lot of programmers, it is
generally the case that you will edit the files on your own machine, but
you want to compile, run and debug your application in another buffer.
@contents
@bye
+
+@ignore
+ arch-tag: 68cf0d8a-55cc-4190-a28d-4984fa56ed1e
+@end ignore
HCoop / bpt / emacs.git / blobdiff