Commit 54df6fd9 by Vincent Celier Committed by Arnaud Charlet

gnat_ugn.texi: Add documentation for switches --version and --help for the GNAT tools gnatbind...

2007-10-15  Vincent Celier  <celier@adacore.com>
	    Robert Dewar  <dewar@adacore.com>

	* gnat_ugn.texi: Add documentation for switches --version and --help
	for the GNAT tools gnatbind, gnatlink, gnatmake, gnatchop, gnatname,
	gnatxref, gnatfind, gnatls, and gnatclean.
	Document -gnatw.o.
	Mention attribute Excluded_Source_Dirs
	Replace obsolescent attribute Locally_Removed_Files with attribute
	Excluded_Source_Files.
	Improve documentation of -u (gnatbind)
	Document how to do reliable stack checking for the environmental task
	on iVMS.

	* gnat_rm.texi: Rewrite section about No_Implicit_Dynamic_Code.
	Document attribute Excluded_Source_Files and indicate that attribute
	Locally_Removed_Files is obsolescent.

From-SVN: r129341
parent e0aacc92
...@@ -7780,11 +7780,13 @@ of composite objects and the Max/Min attributes. ...@@ -7780,11 +7780,13 @@ of composite objects and the Max/Min attributes.
@findex No_Implicit_Dynamic_Code @findex No_Implicit_Dynamic_Code
This restriction prevents the compiler from building ``trampolines''. This restriction prevents the compiler from building ``trampolines''.
This is a structure that is built on the stack and contains dynamic This is a structure that is built on the stack and contains dynamic
code to be executed at run time. A trampoline is needed to indirectly code to be executed at run time. On some targets, a trampoline is
address a nested subprogram (that is a subprogram that is not at the built for the following features: @code{Access},
library level). The restriction prevents the use of any of the @code{Unrestricted_Access}, or @code{Address} of a nested subprogram;
attributes @code{Address}, @code{Access} or @code{Unrestricted_Access} nested task bodies; primitive operations of nested tagged types.
being applied to a subprogram that is not at the library level. Trampolines do not work on machines that prevent execution of stack
data. For example, on windows systems, enabling DEP (data execution
protection) will cause trampolines to raise an exception.
@item No_Implicit_Loops @item No_Implicit_Loops
@findex No_Implicit_Loops @findex No_Implicit_Loops
...@@ -15044,6 +15046,15 @@ If not specified, executables are placed in the object directory. ...@@ -15044,6 +15046,15 @@ If not specified, executables are placed in the object directory.
Expression must be a list of path names. The attribute Expression must be a list of path names. The attribute
defines the directories in which the source files for the project are to be defines the directories in which the source files for the project are to be
found. If not specified, source files are found in the project directory. found. If not specified, source files are found in the project directory.
If a string in the list ends with "/**", then the directory that precedes
"/**" and all of its subdirectories (recursively) are included in the list
of source directories.
@item Excluded_Source_Dirs
Expression must be a list of strings. Each entry designates a directory that
is not to be included in the list of source directories of the project.
This is normally used when there are strings ending with "/**" in the value
of attribute Source_Dirs.
@item Source_Files @item Source_Files
Expression must be a list of file names. The attribute Expression must be a list of file names. The attribute
...@@ -15052,6 +15063,16 @@ as sources for the project. File names are path_names that contain no directory ...@@ -15052,6 +15063,16 @@ as sources for the project. File names are path_names that contain no directory
information. If the project has no sources the attribute must be declared information. If the project has no sources the attribute must be declared
explicitly with an empty list. explicitly with an empty list.
@item Excluded_Source_Files (Locally_Removed_Files)
Expression must be a list of strings that are legal file names.
Each file name must designate a source that would normally be a source file
in the source directories of the project or, if the project file is an
extending project file, inherited by the current project file. It cannot
designate an immediate source that is not inherited. Each of the source files
in the list are not considered to be sources of the project file: they are not
inherited. Attribute Locally_Removed_Files is obsolescent, attribute
Excluded_Source_Files is preferred.
@item Source_List_File @item Source_List_File
Expression must a single path name. The attribute Expression must a single path name. The attribute
defines a text file that contains a list of source file names to be used defines a text file that contains a list of source file names to be used
...@@ -15186,13 +15207,6 @@ language of the main program. ...@@ -15186,13 +15207,6 @@ language of the main program.
Expression must be a string list. Each string designates Expression must be a string list. Each string designates
a programming language that is known to GNAT. The strings are case-insensitive. a programming language that is known to GNAT. The strings are case-insensitive.
@item Locally_Removed_Files
This attribute is legal only in a project file that extends another.
Expression must be a list of strings that are legal file names.
Each file name must designate a source that would normally be inherited
by the current project file. It cannot designate an immediate source that is
not inherited. Each of the source files in the list are not considered to
be sources of the project file: they are not inherited.
@end table @end table
@node Attribute References @node Attribute References
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment