summaryrefslogtreecommitdiffstats
path: root/doc/internal
diff options
context:
space:
mode:
authorRichard Levitte <levitte@openssl.org>2020-02-26 14:35:17 +0100
committerRichard Levitte <levitte@openssl.org>2020-03-02 03:34:30 +0100
commite42921790267d54054cde1596711219b72a184ad (patch)
tree4fde9afd10c5130bed9de1b579b1a5e1eae35b02 /doc/internal
parentad5be194c6b08e89f9a6e2a78b85ff19a3c40d40 (diff)
build.info: Implement simply substitutions in variable values
Use case: having a variable with multiple source files in its value, and wanting to refer to the corresponding object file. $SRCS=foo.c bar.c SOURCE[program]=$SRCS DEPEND[${SRCS/.c/.o}]=prog.h GENERATE[prog.h]=... Reviewed-by: Tomas Mraz <tmraz@fedoraproject.org> (Merged from https://github.com/openssl/openssl/pull/11185)
Diffstat (limited to 'doc/internal')
-rw-r--r--doc/internal/man7/build.info.pod16
1 files changed, 16 insertions, 0 deletions
diff --git a/doc/internal/man7/build.info.pod b/doc/internal/man7/build.info.pod
index c2020a432f..f6ca49067d 100644
--- a/doc/internal/man7/build.info.pod
+++ b/doc/internal/man7/build.info.pod
@@ -270,6 +270,22 @@ part of is tokenized>.
I<Variable assignment values are not tokenized.>
+Variable references can be one of:
+
+=over 4
+
+=item B<$>I<NAME> or B<${>I<NAME>B<}>
+
+Simple reference; the variable reference is replaced with its value,
+verbatim.
+
+=item B<${>I<NAME>B</>I<str>B</>I<subst>B<}>
+
+Substitution reference; the variable reference is replaced with its
+value, modified by replacing all occurences of I<str> with I<subst>.
+
+=back
+
=head2 Scope
Most of the statement values are accumulated globally from all the