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=de456fb055d3de4c0bee2369406b2931e1c6b001 commit de456fb055d3de4c0bee2369406b2931e1c6b001 Author: Guillem Jover <[email protected]> AuthorDate: Sat Dec 20 20:09:13 2025 +0100 man: Refactor explanation about deb-symbols metavariables Explain the general metavariable mechanics, then use a section for each specific metavariable (currently only #PACKAGE#), which should make adding new metavariables easier. --- man/deb-src-symbols.pod | 20 ++++++++++++++------ 1 file changed, 14 insertions(+), 6 deletions(-) diff --git a/man/deb-src-symbols.pod b/man/deb-src-symbols.pod index f8a2af8bd..3e76b7337 100644 --- a/man/deb-src-symbols.pod +++ b/man/deb-src-symbols.pod @@ -45,16 +45,24 @@ the first character is a comment except if it starts with ‘#include’ Lines starting with ‘#MISSING:’ are special comments documenting symbols that have disappeared. -=head2 Using #PACKAGE# substitution +=head2 Using metavariable substitutions + +In some cases instead of hardcoding some variable text, +we can use metavariables that will be replaced either +when generating the symbols file shipped in the binary package, +or during dependency generation. + +Contrary to the I<#MINVER#> metavariable, +the following metavariables will never appear in a symbols file inside +a binary package. + +=head3 Using the #PACKAGE# metavariable In some rare cases, the name of the library varies between architectures. -To avoid hardcoding the name of the package in the symbols file, you can -use the marker I<#PACKAGE#>. +To avoid hardcoding the name of the package in the symbols file, +you can use the I<#PACKAGE#> metavariable. It will be replaced by the real package name during installation of the symbols files. -Contrary to the -I<#MINVER#> marker, I<#PACKAGE#> will never appear in a symbols file -inside a binary package. =head2 Using symbol tags -- Dpkg.Org's dpkg
