From 39c56b63e4d93f0689cc3af8bad4b22af835f58d Mon Sep 17 00:00:00 2001
From: Björn Persson
Users and distributions can build and install the software with the -traditional commands "make" and -"make install".
All aspects of the build are fully configurable through directory variables, program-name variables and options variables. These configuration @@ -133,7 +133,7 @@ modified is included with the above copyright notice.
INSTALL to your source tree.Write a GNAT project file to control the build. Import -"comfignat.gpr" (without ".gp") and use the variables +“comfignat.gpr” (without “.gp”) and use the variables that the project Comfignat defines.
Use Comfignat.Objdir for Object_Dir.
If your project is a library, then write a project file for other projects to import to use the library. Give it a filename that ends with -".gpr.gp". It will be run through Gnatprep to generate the actual -project file without the ".gp" suffix. Make it import the project +“.gpr.gp”. It will be run through Gnatprep to generate the actual +project file without the “.gp” suffix. Make it import the project file that the preprocessor symbol Directories_GPR specifies, but only if Directories_GPR is defined. Do not import comfignat.gpr. Use the symbol Includedir in the value of @@ -229,9 +229,9 @@ write them there.
Comfignat defines several directory variables to allow distributions and installing users to control where in the filesystem different kinds of files get installed and where applications write their files at run time. Variables -whose names begin with "stage_" point to the directories under the +whose names begin with “stage_” point to the directories under the staging directory where the files shall be written during the build. Variables -without the "stage_" prefix tell where the files will be in the +without the “stage_” prefix tell where the files will be in the target system after installation, and are suitable for embedding in programs where the directory names are needed at run time, and in usage project files.
@@ -240,7 +240,7 @@ files. include comfignat.mk, as GNAT project variables to build project files that import comfignat.gpr, and as preprocessor symbols to usage project files that are preprocessed with Gnatprep. If the Make variable -relocatable_package is set to "true" on the command +relocatable_package is set to “true” on the command line, then the variables for embedding will be relative to bindir in build project files, and relative to gprdir in usage project files, except that bindir will instead be relative to @@ -419,7 +419,7 @@ and the right library will be used in every build.Your software may have optional features or properties that can be enabled or disabled at build time. Comfignat can help you define options for those. Each option is represented as a Make variable whose value can be -"true" or "false", which installing users and +“true” or “false”, which installing users and distributions are expected to override on the command line. The names of these variables should be listed in the variable options. Each option should also be assigned a default value, unless it shall be mandatory to always @@ -440,12 +440,12 @@ files.
There are several options variables that let installing users and distributions control which arguments the build tools are invoked with. They -have names that end with "FLAGS", and are documented in +have names that end with “FLAGS”, and are documented in INSTALL. The value of GNATFLAGS is a combination of the other options variables and must not be modified in a way that disregards the other variables. Apart from that restriction you can assign default values to optional arguments in these variables, but be sure to do the assignments with -"?=" so that environment variables can override your defaults.
+“?=” so that environment variables can override your defaults.The value of Gnatprep_arguments will be passed to Gnatprep when a file is preprocessed, and builder_arguments will be passed to @@ -458,15 +458,15 @@ options variables instead.
The program-name variables GNATPREP and GNAT_BUILDER allow installing users and distributions to control the commands that invoke the build tools, for example to use a specific version or a wrapper. You can -set GNAT_BUILDER to "gnatmake" if you want to build +set GNAT_BUILDER to “gnatmake” if you want to build with Gnatmake instead of GPRbuild by default, but again be sure to do the -assignment with "?=" so that environment variables can override +assignment with “?=” so that environment variables can override your default.
Those Make variables that installing users are expected to change can be -configured persistently. Run "make configure" with some variables +configured persistently. Run “make configure” with some variables set on the command line or in the environment. Those variables will then be saved in a file named comfignat_configuration.mk, which will be loaded in all subsequent Make invocations. Additional variables can be @@ -476,15 +476,15 @@ that can only be overridden on the command line can only be configured from the command line. In subsequent Make invocations environment variables override values that were configured from the environment, and variables set on the command line override all configured values. The configuration can be -erased with "make unconfigure" or as a part of -"make distclean".
+erased with “make unconfigure” or as a part of +“make distclean”. -The command "make show_configuration" may be used to view the +
The command “make show_configuration” may be used to view the current configuration. It outputs the configured variables in Make assignment syntax, but easier to read than the actual configuration file. Variables that were configured from the command line are shown as ordinary assignments with -"=", and those that were configured from the environment are shown -as conditional assignments with "?=".
+“=”, and those that were configured from the environment are shown +as conditional assignments with “?=”.The variables that can be configured are listed in the variable configuration_variables. The variables listed in options @@ -497,7 +497,7 @@ names to configuration_variables.
directory. All generated files will then be written under the build directory and the source tree will not be modified. You can have several build directories with different configuration files in them. To set up a new build -directory, run "make configure builddir=/some/pathname". The +directory, run “make configure builddir=/some/pathname”. The variable builddir will not be saved in the configuration; instead a configuration file will be written in the specified directory. A makefile will also be written in the build directory unless there is one already. This -- cgit v1.2.3