Christian,

Danek Duvall pointed out in a recent mail on a different
ARC case:

 > Another thing we need to know is the full SONAME for the libraries
 > involved.  For anyone looking to submit arc cases, please note:
 > the *.so
 > form of a library is *not* sufficient.  Nor is the realpath()ed
 > name of the
 > link correct.  We need to know what the SONAME is, as specified on
 > the ld
 > commandline with the -h flag.  We've been seeing this mistake a lot
 > recently.

In this case, it seems to be:
        % elfdump /usr/lib/libid3.so | grep SONAME
        libid3-3.8.so.3

Someone else might want to chip in here (Brian?),
but I think the SONAME should be the shorter-form
name (libid3.so), and also that you should list
the symlinks as interfaces.
(Some more discussion on SONAMEs in ARCs here:
http://sac.sfbay/Archives/CaseLog/arc/PSARC/2008/071/mail )


There is some repetition/confusion in the last 2
paragraphs of the Tech description ("For these
reasons...").


Also, some typos:
 >          The ID3 tagging standard is independant of the media format
        independent
 >          compared to ID3v2 - i.e. fixed lenth fields of thirty
        length
 >          compatability breaks in the API.
        compatibility
 >          the standard allows for adding tag fields in a backwarrds
        backwards
 >          compatability breaksin the API.
        compatibility breaks in


- Dermot



Christian Kelly wrote:
> Looking for feedback.
> 
> Thanks
> -Christian
> 
> 
> 
> 1. Introduction
>    1.1. Project/Component Working Name:
>         id3lib
> 
>    1.2. Name of Document Author/Supplier:
>         Christian Kelly
> 
>    1.3. Date of This Document:
>         02/04/08
> 
>    1.4. Name of Major Document Customer(s)/Consumer(s):
>         1.4.1. The Community you expect to review your project:
>         1.4.2. The ARC(s) you expect to review your project:
>         1.4.3. The Director/VP who is "Sponsoring" this project:
>                robert.odea at sun.com
>         1.4.4. The name of your business unit:
>                OPG/OpenSource
> 
>    1.5. Email Aliases:
>         1.5.1. Responsible Manager:
>                Tom.Garland at Sun.Com
>         1.5.2. Responsible Engineer:
>                Christian.Kelly at Sun.Com
>         1.5.4. Interest List:
>                jds-dev at sun.com
> 
> 4. Technical Description:
>     4.1. Details:
>          id3lib is a library for handling ID3v1 and ID3v2 tags added
>          to digital media files. While the format allows for tagging
>          any media format, it is used exclusively with MP3s. The tags
>          hold information about the file such as artist, title, year
>          of production, etc..
> 
>          The ID3 tagging standard is independant of the media format
>          of the file that they are applied to, they are merely appended
>          or pre-pended to the file.
> 
>          This proposal adds version 3.4.3, the latest stable release.
> 
>          The use of the ID3v1 standard has dwindled due to the fact
>          that it is now twelve years old and the obvious limitations
>          compared to ID3v2 - i.e. fixed lenth fields of thirty characters.
>          For these reasons it is extremely unlikely that we will see
>          compatability breaks in the API.
> 
>          The last revision of the ID3v2 standard was eight years ago. Also,
>          the standard allows for adding tag fields in a backwarrds
>          compatible way. For these reasons, it is unlikely we will see
>          compatability breaksin the API.
> 
>     4.2. Bug/RFE Number(s):
>          None
> 
>     4.3. In Scope:
>          See Above
> 
>     4.4. Out of Scope:
>          See Above
> 
>     4.5. Interfaces:
>          
> --------------------------------------------------------------------
>          Exported                               Stability         Comments
>          
> --------------------------------------------------------------------
>          SUNWid3lib                             Uncommitted       
> Package name
>            libid3.so                            Uncommitted       C library
>            /usr/bin/id3info                     Uncommitted       CLI
>            /usr/bin/id3convert                  Uncommitted       CLI
>            /usr/bin/id3tag                      Uncommitted       CLI
>            /usr/bin/id3cp                       Uncommitted       CLI
>            /usr/include/id3                     Not an Interface  *NEW* 
> Folder
>            /usr/include/id3.h                   Uncommitted
> 
> 
>     4.9. I18N/L10N Impact:
>          The JDS team and the G11N are working together to evaluation and
>          provide I18N/L10N support.
> 
> 
>     4.10. Packaging & Delivery:
>           Adds new package: SUNWid3lib
> 
> 
> 5. Reference Documents:
>    id3lib website : http://id3lib.sf.net
>    ID3v1, brief description of format : 
> http://id3lib.sourceforge.net/id3/id3v1.html
>    ID3v2.4.0 Informal Standard : 
> http://id3lib.sourceforge.net/id3/id3v2.4.0-structure.txt
> _______________________________________________
> desktop-discuss mailing list
> desktop-discuss at opensolaris.org

Reply via email to