Re: Bug#571776: document symbols

2012-01-13 Thread Russ Allbery
Cyril Brulebois writes: > Russ Allbery (13/01/2012): >> Yes, but there was some discussion in the Policy bug asking why shlibs >> files were required when they're not used if a symbols file is present, >> and while I originally argued that keeping them both made sense, I came >> around to that p

Re: Bug#571776: document symbols

2012-01-13 Thread Cyril Brulebois
Russ Allbery (13/01/2012): > Yes, but there was some discussion in the Policy bug asking why shlibs > files were required when they're not used if a symbols file is present, > and while I originally argued that keeping them both made sense, I came > around to that position after reviewing the bug

Re: Bug#571776: document symbols

2012-01-13 Thread Russ Allbery
Charles Plessy writes: > here are some comments about the current patch. I agree with the other > changes made subsequently in that thread. >> + If a package contains a binary or library which links to a >> + shared library, we must ensure that, when the package is >> + installed

Re: Bug#571776: document symbols

2012-01-13 Thread Charles Plessy
Dear Russ and Raphaƫl, here are some comments about the current patch. I agree with the other changes made subsequently in that thread. > + If a package contains a binary or library which links to a > + shared library, we must ensure that, when the package is > + installed on

Re: Bug#571776: document symbols

2012-01-13 Thread Russ Allbery
Raphael Hertzog writes: > 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

Re: Bug#571776: document symbols

2012-01-13 Thread Russ Allbery
Raphael Hertzog writes: > There is no leading space before the "*". Just like "|" it must be on > the first column to differentiate with symbol definitions which do have > a leading space on their lines. Oh, then deb-symbols(5) is wrong for both * and |... oh, I see, I was misreading how the syn

Re: Bug#571776: document symbols

2012-01-13 Thread Raphael Hertzog
On Fri, 13 Jan 2012, Russ Allbery wrote: > + > + > +library-soname main-dependency-template > +[ | alternative-dependency-template ] > +[ ... ] > +[ * field-name: field-value ] > +[ ... ] > + symbol minimal-version[ > id-of-dependency-template ] > + I think this descripti

Re: Bug#571776: document symbols

2012-01-13 Thread Raphael Hertzog
On Fri, 13 Jan 2012, Russ Allbery wrote: > >>For our example, the zlib1g symbols file > >>would contain: > >> > >> * Build-Depends-Package: zlib1g-dev > >> > >>(Don't forget the leading space.) > > > What leading space are you referring to ? > > I now have

Re: Bug#571776: document symbols

2012-01-13 Thread Russ Allbery
Russ Allbery writes: > I tried sending a unified diff, but the new sections are largely > unreadable since they're intermixed with the old sections being removed. > Hence, for review purposes, here are the symbols and shlibs sections in > their entirety, followed by a diff for the changes elsewhe

Re: Bug#571776: document symbols

2012-01-13 Thread Russ Allbery
Raphael Hertzog writes: > On Mon, 02 Jan 2012, Russ Allbery wrote: > [...] >> >>shlibs files were the original mechanism for >>handling library dependencies. They are documented >>in . symbols files, >>documented in this section, are recommended for most pa