aboutsummaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorBoris Kolpackov <boris@codesynthesis.com>2024-03-19 08:10:46 +0200
committerBoris Kolpackov <boris@codesynthesis.com>2024-03-19 08:10:46 +0200
commit380cb54ab94a502d2d7ff5d47f21839ee9e4f1e1 (patch)
tree3ffef2e85f918ceafcc13a48c9fff0bf224af4ac /doc
parent82794b4c64d500b8fb364f341bdb815d37e07ccb (diff)
Minor tweak to manual
Diffstat (limited to 'doc')
-rw-r--r--doc/manual.cli21
1 files changed, 11 insertions, 10 deletions
diff --git a/doc/manual.cli b/doc/manual.cli
index 4f057f9..e7e61c0 100644
--- a/doc/manual.cli
+++ b/doc/manual.cli
@@ -2388,7 +2388,8 @@ values can be used to specify auxiliary configurations that provide additional
components which are required for building or testing a package and that are
impossible or impractical to provide as part of the build configuration
itself. For example, a package may need access to a suitably configured
-database, such as PostgreSQL, in order to run its tests.
+database, such as PostgreSQL, in order to run its tests. Currently no more
+than \c{9} auxiliary configurations can be specified.
The \i{config} value is a filesystem wildcard patterns which is matched
against the auxiliary configuration names (which are in turn derived from
@@ -2438,24 +2439,24 @@ DATABASE_NAME=test
\
If the auxiliary configuration is specified as \c{build-auxiliary-<name>},
-then capitalized \i{name}_ is used as a prefix in the environment variables
-corresponding to the machine. For example, for the auxiliary configurations
-specified as:
+then capitalized and sanitized \i{name}_ is used as a prefix in the
+environment variables corresponding to the machine. For example, for the
+auxiliary configurations specified as:
\
-build-auxiliary-pgsql: *-postgresql_*
-build-auxiliary-mysql: *-mysql_*
+build-auxiliary-pg-sql: *-postgresql_*
+build-auxiliary-my-sql: *-mysql_*
\
The environment variables could be:
\
-PGSQL_DATABASE_HOST=192.168.0.1
-PGSQL_DATABASE_PORT=5432
+PG_SQL_DATABASE_HOST=192.168.0.1
+PG_SQL_DATABASE_PORT=5432
...
-MYSQL_DATABASE_HOST=192.168.0.2
-MYSQL_DATABASE_PORT=3306
+MY_SQL_DATABASE_HOST=192.168.0.2
+MY_SQL_DATABASE_PORT=3306
...
\