Template Version: @(#)onepager.txt 1.35 07/11/07 SMI
Copyright 2007 Sun Microsystems


1. Introduction
   1.1. Project/Component Working Name:

        Python XDG Module

   1.2. Name of Document Author/Supplier:

        Darren Kenny

   1.3. Date of This Document:

        02/11/08
        
   1.3.1. Date this project was conceived:

        01/01/08

   1.4. Name of Major Document Customer(s)/Consumer(s):

        1.4.1. The PAC or CPT you expect to review your project:

                Solaris PAC

        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@sun.com

        1.4.4. The name of your business unit:

                OPG / OpenSource.

   1.5. Email Aliases:
        1.5.1. Responsible Manager:

                leo.binchy@sun.com

        1.5.2. Responsible Engineer:

                darren.kenny@sun.com

        1.5.3. Marketing Manager:

                dan.roberts@sun.com

        1.5.4. Interest List:

                desktop-discuss@opensolaris.org

4. Technical Description:
    4.1. Details:

        Python XDG (also known as PyXDG) is an open source python library to
        access freedesktop.org specifications. Currently supported are:

        - Base Directory Specification Version 0.6
          - Provides API for users to get the locations of the XDG
            directories.

        - Menu Specification Version 1.0
          - Provides API for the parsing and editing of XDG Menu files and the
            application menu. 

        - Desktop Entry Specification Version 0.9.4
          - Provides API to enable the parsing or creation of a .desktop or
            .directory file, check it for syntax and extract property values.

        - Icon Theme Specification Version 0.8
          - Provides API to enable the parsing or creation of Icon Theme
            .theme files, check for syntax and extract property values.

        - Recent File Spec 0.2
          - Provides API for loading/adding/deleting/saving of recently used
            files list.

        - Shared-MIME-Database Specification 0.13
          - Provides API to parse the XDG mime database and query/additions of
            type handlers.

        Of this list, on Solaris, we have the specifications listed with the
        following stability levels:

        Committed:
            - Base Directory Specification
            - Desktop Entry Specification
            - Menu Specification
            - Shared MIME Database Specification

        Volatile:
            - Recent File Specification

        I would like to propose increasing the Recent File Specification to
        Committed.
        

    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                
        --------------------------------------------------------------------
        SUNWpython-xdg              Uncommitted     Package name            
        xdg                         Uncommitted     Python Module
        ${HOME}/.recently-used      Committed       Recent File list in XML format.
                                                                            
        --------------------------------------------------------------------
        Imported                    Stability       Comments                
        --------------------------------------------------------------------
        Python 2.4.x                Contracted      PSARC 2005/532
                                    External        
        Base Directory Specification
                                    Committed       LSARC 2005/734
        Desktop Specification       Committed       LSARC 2005/734
        Menu Specification          Committed       LSARC 2005/734
        Shared MIME Database        Committed       LSARC 2007/146


    4.6. Doc Impact:

        Community provided man pages for each tool will be installed. 

    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, SUNWpython-xdg, approx 243 KB.
        Package will go into SUNWCall, SUNWCXall and SUNWCprog clusters.

    4.11. Security Impact:

        None.

    4.12. Dependencies:

        The following versions of the imported interfaces are required:
        Python                  >= 2.3
        GNOME                   >= 2.20

5. Reference Documents:

        PyXDG Project       - http://www.freedesktop.org/wiki/Software/pyxdg

        XDG Specifications  - http://www.freedesktop.org/wiki/Specifications

        PSARC 2005/532      - Python migration from /usr/sfw to /usr and upgrade