diff options
author | Björn Persson <bjorn@rombobjörn.se> | 2013-10-14 03:29:05 +0200 |
---|---|---|
committer | Björn Persson <bjorn@rombobjörn.se> | 2013-10-14 03:29:05 +0200 |
commit | bd7bdf0be2279a1e224a4a1703ca0c313088cdad (patch) | |
tree | 961ccb0855eeefb2eec614ccfd336a173167cf1b | |
parent | d4d770302fe20fc7aefa4083ff3fd0a4a31ed7c8 (diff) |
Additions to the manual.
· Explained more about configuration with environment variables.
· Documented show_configuration.
· Added a news section.
-rwxr-xr-x | manual.en.html | 36 |
1 files changed, 35 insertions, 1 deletions
diff --git a/manual.en.html b/manual.en.html index 14184bd..b601f57 100755 --- a/manual.en.html +++ b/manual.en.html @@ -470,12 +470,22 @@ configured persistently. Run "<samp>make configure</samp>" with some variables set on the command line or in the environment. Those variables will then be saved in a file named <var>comfignat_configuration.mk</var>, which will be loaded in all subsequent Make invocations. Additional variables can be -configured incrementally. In subsequent Make invocations environment variables +configured incrementally. Make variables that can be overridden by environment +variables can also be configured from the environment, whereas those variables +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 "<samp>make unconfigure</samp>" or as a part of "<samp>make distclean</samp>".</p> +<p>The command "<samp>make show_configuration</samp>" 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 "?=".</p> + <p>The variables that can be configured are listed in the variable <var>configuration_variables</var>. The variables listed in <var>options</var> are included. You can make additional variables configurable by appending their @@ -518,6 +528,30 @@ be useful to users as-is, but it will be more helpful if you edit it. Put the title of your project in the heading, add information about optional features and testing, and delete parts that don't apply to your project.</p> +<h2 id="news">News</h2> + +<h3 id="news_1.2">Noteworthy changes in version 1.2</h3> + +<ul> +<li><p>The directory variables <var>alidir</var> and <var>archincludedir</var> +were added.</p></li> + +<li><p>The directory variable <var>runtimedir</var> was renamed to +<var>runstatedir</var> to keep Comfignat compatible with the GNU Coding +Standards.</p></li> + +<li><p>Comfignat.Bindir was made relative to Comfignat.Libexecdir when +relocatable_package is true.</p></li> + +<li><p>Comfignat's behaviour in sub-Makes was fixed so that subprocesses +working in subdirectories use the right build and staging directories.</p></li> + +<li><p>The ability to save environment variables in the persistent +configuration was added.</p></li> + +<li><p>The Make target <var>show_configuration</var> was added.</p></li> +</ul> + <!--#include virtual="/SSIfragment/giltig.shtml" --> </body> |