This is an automated email from the git hooks/post-receive script. guillem pushed a commit to branch main in repository dpkg.
View the commit online: https://git.dpkg.org/cgit/dpkg/dpkg.git/commit/?id=fc80b4b44ff687ccce761b6aefe8e47d5c73012f commit fc80b4b44ff687ccce761b6aefe8e47d5c73012f Author: Guillem Jover <[email protected]> AuthorDate: Tue Sep 30 04:14:11 2025 +0200 man: Itemize deb-substvars operators This should make the syntax a bit more clear. --- man/deb-substvars.pod | 38 ++++++++++++++++++++++++++++++-------- 1 file changed, 30 insertions(+), 8 deletions(-) diff --git a/man/deb-substvars.pod b/man/deb-substvars.pod index 3a0cc2826..c107c3c88 100644 --- a/man/deb-substvars.pod +++ b/man/deb-substvars.pod @@ -54,17 +54,39 @@ is rescanned to look for more substitutions. =head2 File Syntax Substitution variables can be specified in a file. -These files consist of lines of the form I<name>B<=>I<value>, -I<name>B<?=>I<value>, or -I<name>B<!=>I<value>. -The B<=> operator assigns a normal substitution variable, -the B<?=> operator (since dpkg 1.21.8) assigns an optional substitution -variable which will emit no warnings even if unused, -and the B<!=> operator (since dpkg 1.22.7) assigns a required substitution -variable which will error out if unused. +These files consist of lines with variable assignments, +that start with the variable name, +immediately followed by an assignment operator, +and then the value. +Each operator gives the variable specific attributes. Trailing whitespace on each line, blank lines, and lines starting with a B<#> symbol (comments) are ignored. +The following operators are supported: + +=over + +=item B<=> + +Assigns a normal substitution variable. + +=item B<?=> + +Assigns an optional substitution variable which will emit no warnings +even if unused. + +Supported since dpkg 1.21.8. + +=item B<!=> + +Assigns a required substitution variable which will error out if unused. + +Supported since dpkg 1.22.7. + +=back + +For example C<some-package:Depends?=other-package (= 1.0), the-package>. + =head2 Substitution Variables can be set using the B<-V> common option. -- Dpkg.Org's dpkg
