X-Git-Url: https://code.delx.au/gnu-emacs/blobdiff_plain/28665d46c3222733ba0e024f21d39be2d88087d4..27f70a64389dbf769cf75fb672a50ea313495e3f:/man/ada-mode.texi diff --git a/man/ada-mode.texi b/man/ada-mode.texi index b67b08348a..aebb66be12 100644 --- a/man/ada-mode.texi +++ b/man/ada-mode.texi @@ -1,21 +1,19 @@ \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 @@ -31,11 +29,13 @@ 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. -@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 @@ -44,28 +44,9 @@ license to the document, as described in section 6 of the license. @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 @@ -181,7 +162,7 @@ not use these extensions and if you want Emacs to automatically start the 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 @@ -302,7 +283,7 @@ debugging can be performed within Emacs in a convenient and natural way. 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 @@ -348,7 +329,7 @@ This is done through the variable @code{ada-xref-default-prj-file}. @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 @@ -357,7 +338,7 @@ choice is to use this variable settings, and otherwise @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 @@ -620,7 +601,7 @@ they will also contain additional cross-referencing information. 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 @@ -642,7 +623,7 @@ Pressing @key{M-/} once more will bring you back to @samp{my_identifier}. 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. @@ -858,7 +839,7 @@ All letters, except the first one of the word and every letter after the 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 @@ -913,7 +894,8 @@ above, the new exception will be added to the first file in the list 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 @@ -1127,7 +1109,7 @@ You can set up in the project file a command to use to debug your 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 @@ -1144,7 +1126,7 @@ also set a breakpoint simply by right-clicking on a line. 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{} @@ -1191,7 +1173,7 @@ need to add the following to your @file{.emacs} file: (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 @@ -1214,7 +1196,7 @@ for an 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. @@ -1299,3 +1281,7 @@ However, this would not work on vxworks, for instance, where @contents @bye + +@ignore + arch-tag: 68cf0d8a-55cc-4190-a28d-4984fa56ed1e +@end ignore