1. Introduction

   1.1. Project/Component Working Name:
        libchamplain

   1.2. Name of Document Author/Supplier:
        Simon Jin

   1.3. Date of This Document:
        01/26/2010

   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 O'Dea

        1.4.4. The name of your business unit:
               Software - OPG

   1.5. Email Aliases:
        1.5.1. Responsible Manager: 
               leo.binchy@sun.com

        1.5.2. Responsible Engineer:
               yuntong.jin@sun.com

        1.5.3  Marketing Manager:
               glynn.foster@sun.com

        1.5.4. Interest List: 
               desktop-discuss@opensolaris.org 

2. Project Summary
   2.1. Project Description:

        Libchamplain v0.43 is a Clutter based map ClutterActor and Gtk+ widget to display street maps, 
        cycle maps or other maps.
        It is written using Clutter and can be used inside a pure Clutter application or as a Gtk+ widget.

4. Technical Description:
   4.1. Details:

   libchamplain follows the Clutter version numbering and API/ABI
   stability plan.  Some i18n work remains to be done, and a11y
   support is under discussion. 

   libchamplain uses sqlite as map database, and the cache,
   the cache is intelligently validated against the server every 7 days.

   libchamplain is already used by an EOG-plugin to display where an image has been taken
   since EXIF (Exchangeable Image File Format) data can contain GPS data
   
   libchamplain loads maps from the network using libsoup.  Some
   preconfigured network map sources are built into this library.  
   Maps are loaded from these network map sources in the following order:
   http://www.openstreetmap.org 
   http://www.cloudmade.com
   http://tile.öpnvkarte.de/
   http://maps-for-free.com 

   4.2. Interfaces:
        
      Exported Interfaces                           Stability             Comments
      -----------------------                       --------------------  -------------
      /usr/lib/libchamplain-0.4.so.0.2.0             Volatile             lib for libchamplain
      /usr/lib/libchamplain-gtk-0.4.so.0.2.0         Volatile             lib for libchamplain Gtk widget

      /usr/lib/girepository-1.0/Champlain-0.4.typelib Volatile            introspection information in binary format 
      /usr/lib/girepository-1.0/GtkChamplain-0.4.typelib  Volatile        introspection information in binary format 

      /usr/share/gir-1.0/Champlain-0.4.gir           Volatile             introspection information in XML format
      /usr/share/gir-1.0/GtkChamplain-0.4.gir        Volatile             introspection information in XML format

      /usr/include/libchamplain-0.4/champlain/       Volatile             headers for libchamplain
      /usr/include/libchamplain-gtk-0.4/champlain-gtk/  Volatile          headers for libchamplain Gtk widget

      /usr/lib/pkgconfig/champlain-0.4.pc            Uncommitted          
      /usr/lib/pkgconfig/champlain-gtk-0.4.pc        Uncommitted 

      ~/.cache/champlain/{map-source-name}           Volatile             cache files of maps

      SUNWlibchamplain         Uncommitted           libchamplain packaging contains libraries and girepository.
      SUNWlibchamplain-devel   Uncommitted           Development package contains headers and development guider

      Imported Interfaces      Stability          Comments
      --------------------     ---------------    -----------------------
      SUNWclutter               Volatile          LSARC/2008/426/
      SUNWclutter-gtk           Volatile          LSARC/2008/426/
      SUNWsqlite3               Volatile          LSARC/2008/059/
      SUNWglib2                 Volatile          LSARC/2009/475/
      SUNWlibsoup               Volatile

	  http://www.openstreetmap.org       Volatile built-in map sources  
	  http://www.cloudmade.com           Volatile built-in map sources 
	  http://tile.öpnvkarte.de/          Volatile built-in map sources 
	  http://maps-for-free.com           Volatile built-in map sources 

   4.3. Doc Impact:

        N/A

   4.4. Packaging & Delivery:
        
        SUNWlibchamplain
        SUNWlibchamplain-devel

        IPS schema: library/desktop/libchamplain

   4.5. Dependencies:
        SUNWgobject-introspection
        SUNWclutter
        SUNWclutter-gtk
        SUNWsqlite3
	    SUNWglib2
        SUNWlibsoup

   4.6. L10N Impact:

        N/A

   4.7. Security Impact:
        N/A
       
5. Reference Documents:

    Libchamplain webpage:
    http://projects.gnome.org/libchamplain/
       
    Libchamplain API documentation:
	http://library.gnome.org/devel/libchamplain/unstable/