Thanks for the comments everyone. 

- Changed section 1.4.2 to LSARC
- Added 1.5.3 section, this isn't in the template on opensolaris.org, so I was 
not sure if it was supposed to be in there. I copied it in from another recent 
ARC case anyway.
- Re-arranged last paragraph of 4.1. Hopefully it makes more sense now and the 
spelling is correct - that'll teach me to put these through a spellchecker 
before I post!
- Added comment about the fact that it has been a long time since the last 
release of the library, hence, unlikely to be major changes.
- Corrected version number, was 3.4.3, now 3.8.3..
- Added sections 4.6 - 4.8. Not sure what the doc impact is. There doesn't seem 
to be any man page included with the lib. There is an id3lib-doc tarball which 
includes has some html documentation.

Amended proposal below:

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:
               LSARC
        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.3. Marketing Manager:
               dan.roberts 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 independent 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.8.3, the latest stable release.

         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 - e.g. fixed length fields of thirty characters. The 
         last revision of the ID3v2 standard was eight years ago and 
         the last release of id3lib itself is almost 5 years old. Also, 
         the ID3v2 standard allows for adding tag fields in a backwards 
         compatible way. For these reasons, it is unlikely we will see 
         compatibility breaks in 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.6 Doc Impact:
        

    4.7 Admin/Config Impact:
        None.

    4.8 HA Impact:
        None.


    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
 
 
This message posted from opensolaris.org

Reply via email to