X-Git-Url: https://code.delx.au/gnu-emacs-elpa/blobdiff_plain/d3c440073abf6a43548b8618cd1937cbfed79a1e..b2e9186ca29c6f9ffb5d2e511b25b65e00e30c7d:/packages/ada-mode/ada-mode.info diff --git a/packages/ada-mode/ada-mode.info b/packages/ada-mode/ada-mode.info index 78b9799c4..e2c10f95b 100644 --- a/packages/ada-mode/ada-mode.info +++ b/packages/ada-mode/ada-mode.info @@ -119,12 +119,11 @@ ada-mode-version'. * Menu: * Ada Reference Manual:: -* gnatinspect:: * gpr_query:: * Upgrading::  -File: ada-mode.info, Node: Ada Reference Manual, Next: gnatinspect, Up: Installation +File: ada-mode.info, Node: Ada Reference Manual, Next: gpr_query, Prev: Installation, Up: Installation 2.1 Ada Reference Manual ======================== @@ -133,51 +132,40 @@ The ELPA package ada-ref-man includes the Ada Reference Manual and Annotated Ada Reference Manual in info format.  -File: ada-mode.info, Node: gnatinspect, Next: gpr_query, Prev: Installation, Up: Installation +File: ada-mode.info, Node: gpr_query, Next: Upgrading, Prev: Ada Reference Manual, Up: Installation -2.2 gnatinspect -=============== +2.2 gpr_query +============= -Ada mode has experimental support for the new AdaCore cross reference -tool 'gnatinspect', which supports Ada, C, C++, and any other language -for which gcc provices the '-fdump-xref'. +Ada mode has support for an external cross reference tool 'gpr_query', +which supports Ada, C, C++, and any other language for which AdaCore gcc +provices the '-fdump-xref' ('-fdump-xref' is an AdaCore extension). - 'gnatinspect' is distributed as part of 'gnatcoll'. Ada mode -requires the very latest version, in 'gnatcoll 1.7w' distributed with + 'gpr_query' requires the 'gnatcoll' library provided by AdaCore. Ada +mode requires the very latest version 'gnatcoll 1.7w' distributed with GNAT GPL 2014. - To build 'gnatinspect', assuming GNAT GPL 2014 is installed in + To build 'gpr_query', assuming GNAT GPL 2014 is installed in '/usr/gnat-gpl-2014', and '/usr/gnat-gpl-2014/bin' is in PATH: tar xf ~/Downloads/gnatcoll-1.7x-src.tgz cd gnatcoll-1.7w-src ./configure --prefix=/usr/gnat-gpl-2014 - make Gnatcoll_Build=Debug - sudo make Gnatcoll_Build=Debug install + make + sudo make install + cd ~/.emacs.d/elpa/ada-mode-5.xx/build + make install-gpr_query To build an sqlite3 executable that is compatible with the database -created by gnatinspect: +created by 'gpr_query': cd gnatcoll-1.7w-src/src/sqlite/amalgamation/ gcc -O2 -o sqlite3 shell.c sqlite3.c -ldl -lpthread - -File: ada-mode.info, Node: gpr_query, Next: Upgrading, Prev: gnatinspect, Up: Installation - -2.3 gpr_query -============= - -'gpr_query' is similar to 'gnatinspect', but customized for Emacs -ada-mode use. To install it, install 'gnatinspect' as above (*note -gnatinspect::), then: - - cd ~/.emacs.d/elpa/ada-mode-5.xx/build - make install-gpr_query -  File: ada-mode.info, Node: Upgrading, Prev: gpr_query, Up: Installation -2.4 Upgrading from previous versions +2.3 Upgrading from previous versions ==================================== See the file NEWS for more details; here we summarize only important @@ -286,10 +274,9 @@ cross-reference-tool-specific functions for corresponding Ada mode operations. The default cross-reference tool is 'gnatxref', provided by the file -'ada-gnat-xref.el'. Two other tools are supported: 'gnat_inspect' and -'gpr_query'. To use these, add one of the following to '~/.emacs': +'ada-gnat-xref.el'. One other tool is supported: 'gpr_query'. To use +it, add the following to '~/.emacs': - (require 'gnat-inspect) (require 'gpr-query) To use 'gpr_query', the Ada code 'gpr_query.adb' must be compiled; @@ -299,8 +286,7 @@ see *note Installation::. Emacs lisp code that provides the interface to the compiler, and set 'ada-xref-tool' and the indirection variables. - See 'ada-gnat-xref.el', 'gnat-inspect.el', 'gpr-query.el' for -examples. + See 'ada-gnat-xref.el' and 'gpr-query.el' for examples.  File: ada-mode.info, Node: Other customization, Prev: Other cross-reference, Up: Customization @@ -341,18 +327,21 @@ the syntax to set a variable is the following: defaults to 'ada-skel-expand', is bound to (*note Statement skeletons::). 'imenu' + Navigate to subprograms and types by name, from a minibuffer menu. +'speedbar' + Navigate to subprograms and types by name, from a list in a + dedicated window. 'which-func' The above can all be set by the following code in your '~/.emacs'. Note that some are functions are added to 'before-save-hook'; they run just before a buffer is written to disk. Also, the order is important; -ada-mode does not set up the Ada-specific features of imenu and -which-func unless they are loaded first. +ada-mode does not set up the Ada-specific features of imenu and speedbar +unless imenu is loaded first. (setq-default indent-tabs-mode nil) (electric-pair-mode 1) - (require 'imenu) - (require 'which-func) + (require 'imenu) ;; also enables speedbar (require 'ada-mode) (add-to-list 'hippie-expand-try-functions-list 'ada-skel-hippie-try) (define-key ada-mode-map "\C-e" 'hippie-expand) @@ -1855,19 +1844,17 @@ File: ada-mode.info, Node: GNAT core, Next: Wisi, Prev: gpr mode, Up: Packag 'gnat-core.el' is a start at a language-agnostic interface to the GNAT tools. It was first factored out from 'ada-gnat.el' and - 'ada-mode.el' to support the multi-language 'gnat-inspect.el', - which is still experimental. + 'ada-mode.el' to support the multi-language 'gpr_query.el'. More code currently in 'ada-mode.el' could be migrated to 'gnat-core.el', in particular the project file support. -'gnat-inspect.el' - Provides an experimental interface to the experimental - multi-language cross-reference tool 'gnatinspect' from AdaCore, - which will supercede 'gnatxref'. +'gpr-query.el' + Provides an interface to the external multi-language + cross-reference tool 'gpr_query'. Implements the Ada mode cross-reference functions for the - 'gnatinspect' backend, and a minor mode providing similar functions + 'gpr_query' backend, and a minor mode providing similar functions for C++.  @@ -2452,46 +2439,45 @@ Tag Table: Node: Top945 Node: Overview2576 Node: Installation3787 -Node: Ada Reference Manual4769 -Node: gnatinspect5026 -Node: gpr_query6023 -Node: Upgrading6380 -Node: Customization6952 -Node: Non-standard file names7434 -Node: Other compiler9275 -Node: Other cross-reference9854 -Node: Other customization10865 -Node: Compiling Executing13335 -Node: Compile commands14070 -Node: Compiling Examples16808 -Node: No project files17640 -Node: Set compiler options23006 -Node: Set source search path24968 -Node: Use GNAT project file27421 -Node: Use multiple GNAT project files30195 -Node: Use a Makefile32915 -Node: Compiler errors34230 -Node: Project files35047 -Node: Project file overview36074 -Node: Project file variables37602 -Node: Moving Through Ada Code41232 -Node: Identifier completion43931 -Node: Indentation44893 -Node: Statement skeletons48945 -Node: Aligning code50730 -Node: Automatic casing51675 -Node: Comment Handling54379 -Node: Key summary54898 -Node: Developer overview57525 -Node: Directory structure57865 -Node: Package organization61351 -Node: Ada mode61586 -Node: gpr mode63782 -Node: GNAT core64065 -Node: Wisi65011 -Node: OpenToken65978 -Node: ELPA66580 -Node: GNU Free Documentation License67190 -Node: Index92351 +Node: Ada Reference Manual4753 +Node: gpr_query5029 +Node: Upgrading6094 +Node: Customization6666 +Node: Non-standard file names7148 +Node: Other compiler8989 +Node: Other cross-reference9568 +Node: Other customization10503 +Node: Compiling Executing13140 +Node: Compile commands13875 +Node: Compiling Examples16613 +Node: No project files17445 +Node: Set compiler options22811 +Node: Set source search path24773 +Node: Use GNAT project file27226 +Node: Use multiple GNAT project files30000 +Node: Use a Makefile32720 +Node: Compiler errors34035 +Node: Project files34852 +Node: Project file overview35879 +Node: Project file variables37407 +Node: Moving Through Ada Code41037 +Node: Identifier completion43736 +Node: Indentation44698 +Node: Statement skeletons48750 +Node: Aligning code50535 +Node: Automatic casing51480 +Node: Comment Handling54184 +Node: Key summary54703 +Node: Developer overview57330 +Node: Directory structure57670 +Node: Package organization61156 +Node: Ada mode61391 +Node: gpr mode63587 +Node: GNAT core63870 +Node: Wisi64704 +Node: OpenToken65671 +Node: ELPA66273 +Node: GNU Free Documentation License66883 +Node: Index92044  End Tag Table