Re: Bug#571776: document symbols
On Fri, 13 Jan 2012, Russ Allbery wrote:
> + <p>
> + <example>
> +<var>library-soname</var> <var>main-dependency-template</var>
> +[ | <var>alternative-dependency-template</var> ]
> +[ ... ]
> +[ * <var>field-name</var>: <var>field-value</var> ]
> +[ ... ]
> + <var>symbol</var> <var>minimal-version</var>[ <var>id-of-dependency-template</var> ]
> + </example>
I think this description adapted from the deb-symbols(5) manual page
mislead you into thinking that there were leading spaces before | or *
when in fact there are none.
I have updated the manual page to make it look like this now:
library-soname main-dependency-template
[| alternative-dependency-template]
[...]
[* field-name: field-value]
[...]
symbol minimal-version [id-of-dependency-template]
> + <example>
> +libGL.so.1 libgl1
> + | libgl1-mesa-glx #MINVER#
Drop the leading space on that last line.
> + publicGlSymbol@Base 6.3-1
> + [...]
> + implementationSpecificSymbol@Base 6.5.2-7 1
> + [...]
> + For our example, the <tt>zlib1g</tt> <file>symbols</file> file
> + would contain:
> + <example compact="compact">
> + * Build-Depends-Package: zlib1g-dev
And here too.
> + </example>
> + (Don't forget the space before the <tt>*</tt> so that it will
> + be parsed as part of the entry for that library.)
And that sentence is then useless (or needs to be reworded).
Cheers,
--
Raphaël Hertzog ◈ Debian Developer
Pre-order a copy of the Debian Administrator's Handbook and help
liberate it: http://debian-handbook.info/liberation/
Reply to: