[desktop-discuss] Re: proposal for GNOME 2.18 umbrella ARC case, for review
Irene (Shi Ying) Huang
Irene.Huang at Sun.COM
Wed Jan 31 01:31:24 PST 2007
Changing, and cc desktop-discuss at opensolaris.org.
Sorry for the typo.
--Irene
On Wed, 2007-01-31 at 16:39 +0800, Brian Cameron wrote:
> Irene:
>
> First of all, great job!
>
> First question - I thought we went through a bunch of effort to move
> arc-documents CVS module to external SVN. Why did we do this if
> we are having the ARC discussion on internal mail aliases. Why not
> have this discussion on desktop-discuss at opensolaris.org? I don't
> think there is anything proprietary here.
>
> > Here I am attaching the draft proposal for GNOME 2.18 ARC case for
> > review.
> >
> > We are looking forward to making GNOME 2.18 ARC case as a FAST-TRACK,
> > since we found out that only minor changes are introduced in the
> > Committed Interfaces in GNOME 2.18. The changes only happens in
> > o libatk
> > o libgnomeui-2
> > o libORBit-2
> > o libpango
>
> libgnomeui-2 and libORBit-2 are not Committed interfaces. They are
> GNOME Platform libraries, so they are ABI stable, but not committed
> by Sun. Refer to the manpages to see what is Committed if you aren't
> sure.
>
> For example:
>
> % cd spec-files/Solaris/manpages
> % grep -i committed */*
>
> > with new APIs added and no deprecations of existing APIs.
> >
> > * As for new modules, there are only two for us to pay attention to,
> > which in fact still needs discussion.
> >
> > 1. devhelp:
> > Simon Zheng from Beijing are proposing to introduce Devhelp into GNOME
> > 2.18 since it has now become an official component in the GNOME
> > community. I guess there will be little hardship for integrating it into
> > JDS, as long as its exported interfaces are not significant.
>
> We should think carefully about putting this in our 2.18 umbrella case,
> especially if our intent is to FastTrack. I note devhelp isntalls a
> library so we'd need to be very clear about what interfaces are added
> and the intended users if we want to include this. Might be better to
> be a separate FastTrack.
>
> > 2. Enchant
> > I found the enchant spec file is currently in jds spec-file repository.
> > It is a popular spell checking that GEdit is currently depend on, and is
> > packaged in SUNWgnome-spell. The problem is: are we going ship this in
> > GNOME 2.18? Enchant is not an official GNOME application, it is an
> > external dependency documented at
> > http://live.gnome.org/TwoPointSeventeen/ExternalDependencies. It is
> > introduced as a spell-checker of GEdit on popular request.
> > If we want to ship Enchant, then I guess we will have to go through OSR
> > review first.
> > Of cause, as a plugin, enchant can be disabled by GEdit if we do not
> > like it.
>
> As discussed, this is just a wrapper, so probably okay to ARC. Since
> this was added to keep gedit from breaking, I think that the gedit
> module owner (Rick Ju) should provide materials or fix gedit so it
> does not need enchant. If this module has no owner and nobody wants
> to provide materials, then I say it is okay with me if gedit spell
> checking breaks and becomes a 2.18 bug.
>
> > * About DBUS. since Brian is currently working on a separate DBUS case
> > to upgrade it, I do not include any information of DBus in this
> > proposal.
>
> Yes, also note the D-Bus ARC FastTrack includes gphoto2/libgphoto2.
>
> > * We are also talking about making some freedesktop specifications
> > committed in this case. The only interface that is not yet made
> > committed, and which we do think makes sense to make,
> > is /usr/bin/update-mime-database. For Committed interfaces, we need to
> > provide manpages for them. And, as well, we may have to make sure that
> > the existing manapges for /usr/bin/update-desktop-database
> > and /usr/bin/gtk-update-icon-cache are correct and uptodate.
> >
> > Glynn, can you take this Action Item, say, creating a manpage
> > for /usr/bin/update-mime-database and make it committed, and reviewing
> > the existing manpages for /usr/bin/gtk-update-icon-cache. Thanks :).
>
> I see Glynn did this already! Awesome. Thanks!
>
> More comments below...
>
> > ------------------------------------------------------------------------
> >
> > 1. Introduction
> > 1.1. Project/Component Working Name:
> >
> > GNOME 2.18
> >
> > 1.2. Name of Document Author/Supplier:
> >
> > Irene Huang (irene.huang at sun.com)
> > Brian Cameron (brian.cameron at sun.com)
> >
> > 1.3. Email Aliases:
> > 1.3.1. Responsible Manager: leo.binchy at sun.com
> > zhaozhou.li at sun.com
> > 1.3.2. Responsible Engineer: irene.huang at sun.com
> > brian.cameron at sun.com
> > 1.3.3. Marketing Manager: max.herrmann at sun.com
> > 1.3.4. Interest List: desktop-cteam at sun.com
> > accessprogramoffice at sun.com
>
> Isn't Jeff McMeekin our Marketing Manager now?
>
> Also might want to include a trusted solaris mail alias on the
> interest list?
>
> > 2. Project Summary
> > 2.1. Project Description
> >
> > This project continues on LSARC 2006/462 to provide a newer version
> > of GNOME, as part of the Java Desktop System, targeted for Nevada.
> > More formally, this project will integrate GNOME 2.18 along with
> > some other components that aren't currently part of the official
> > community release. The code name of this project is "Vermillion".
>
> I don't think we need to mention the code name, especially if we sent
> this externally.
>
> > 2.2. Risks and Assumptions
> >
> > 2.2.1 Schedule
> >
> > This project is targeted to be bundled with Nevada, with an
> > expected integration date between Build 62 and build 64, of the
> > current Solaris OS release schedule.
>
> I'd say "intended" rather than "expected".
>
> > 2.2.2 Accessibility
> >
> > Accessibility is still a key concern in the GNOME desktop. With
> > little community momentum behind the project, it is likely that
> > core parts of the desktop may not be fully accessible. The
> > project team is adding resources according to need and
> > associating time to market schedules.
>
> I'd say "there are concerns that core parts of the desktop may not be
> fully acceptable" rather than "likely".
>
> > 3. Technical Description
> >
> > This project will build on the base we built with LSARC 2006/462
> > GNOME For Nevada, and provide a newer version of the GNOME desktop
> > into Nevada.
> >
> > The GNOME Project's focus on users and usability continues in GNOME 2.18
> > with its hundreds of bug fixes and user-requested improvements. This
> > project provides many usability improvements, performance tunings,
> > improved configuration, and updated branding. More details on specific
> > improvements can be found on the release notes [not yet released] -
>
> I'd say "GNOME 2.18 community release notes" not just "release notes".
>
> > http://www.gnome.org/start/2.18/notes/
> >
> > Currently, the community provides a draft the release note, based
> > on GNOME unstable release:
>
> I'd more simply say "GNOME 2.18 draft release notes"
>
> > http://live.gnome.org/TwoPointSeventeen/ReleaseNotes
> >
> > Where possible, we will coordinate with those componets that
>
> components is misspelled.
>
> > are shipped as part of the official GNOME community release. We may
> > be forced or choose to deviate on a number of these components, but
>
> I'd more simply say "The JDS team may deviate from the GNOME community
> release..."
>
> > only where there is an apporpriate business justification or engineering
>
>
> appropriate is misspelled.
>
> > impact. A number of components may be put through seperate reviews.
>
> separate is misspelled.
>
> > Interface classification summary.
> >
> > - Changes of Committed interfaces
> >
> > Minor changes are introduced in GNOME 2.18 for
> >
> > o libatk
> > o libgnomeui-2
> > o libORBit-2
>
> libgnomeui-2 and libORBit-2 are not Sun committed interfaces. Don't
> mention these.
>
> > o libpango
> >
> > New APIs are added without deprecating anything. For details please
> > refer to section 3.1
>
> deprecated is the wrong word. I'd say "New interfaces have been added
> and no interfaces removed from Committed interfaces".
>
> > The following are new proposed components to be added to the desktop
> > release, as yet to be decided
> >
> > - Devhelp: Devhelp is an API documentation browser for GNOME 2. It
> > works natively with gtk-doc (the API reference framework developed
> > for GTK+ and used throughout GNOME for API documentation).
> > Devhelp is shipped in the GNOME official release
> >
> > http://developer.imendio.com/projects/devhelp.
> >
> > To make Solaris a better platform for developers, having handy
> > documentation and easy searching/indexing tool available is always
> > a necessity.
>
> Again, I think we should be very comfortable that the interfaces in
> devhelp are non-controversial before we put this in the umbrella case.
>
> > - Enchant: Enchant is a generic spell checking library. Enchant is
> > capable of having multiple backends loaded at once making it easier
> > for spell-checking of documents with multiple languages.
> > This is introduced, on popular request as a dependency of gedit which
> > has switched its spell plugin to the enchant library in GNOME 2.18.
> > And it is packaged in SUNWgnome-spell.
> >
> > http://www.abisource.com/projects/enchant/
>
> We need more here. Should add information about new binaries and new
> packages.
>
> > 3.1 Interface tables
> >
> > Exported interfaces
> > In this table, we are only listing the changes of API for the committed
> > interfaces.
> >
> > Name Classification Comments
> > ========================================================================
> > Committed Interfaces
> > libatk
> > atk_misc_get_instance Committed New Function
> > atk_misc_get_type Committed New Function
> > atk_misc_threads_enter Committed New Function
> > atk_misc_threads_leave Committed New Function
> > atk_misc_instance Committed New Global Data
> >
> > libgnomeui-2
> > gnome_keyring_proto_decode_get_item_info
> > Committed New Function
> > gnome_keyring_proto_encode_op_string_int_int
> > Committed New Function
> > gnome_password_dialog_get_new_password
> > Committed New Function
> > gnome_password_dialog_set_new_password
> > Committed New Function
> > gnome_password_dialog_set_password_quality_func
> > Committed New Function
> > gnome_password_dialog_set_show_new_password
> > Committed New Function
> > gnome_password_dialog_set_show_new_password_quality
> > Committed New Function
> >
> > libORBit-2
> > giop_recv_set_timeout Committed New Function
>
> Again, no need to mention libgnomeui-2 or libORBit-2 or any other
> non-Committed interfaces.
>
> > libpango-1.0
> > pango_color_to_string Committed New Function
> > pango_context_get_base_gravity
> > Committed New Function
> > pango_context_get_gravity Committed New Function
> > pango_context_set_base_gravity
> > Committed New Function
> > pango_extents_to_pixels Committed New Function
> > pango_font_description_get_gravity
> > Committed New Function
> > pango_font_description_set_gravity
> > Committed New Function
> > pango_gravity_get_type Committed New Function
> > pango_gravity_to_rotation Committed New Function
> > pango_language_get_default Committed New Function
> > pango_layout_get_line_readonly
> > Committed New Function
> > pango_layout_get_lines_readonly
> > Committed New Function
> > pango_layout_iter_get_line_readonly
> > Committed New Function
> > pango_layout_iter_get_run_readonly
> > Committed New Function
> > pango_matrix_to_gravity
> > pango_matrix_transform_distance
> > Committed New Function
> > pango_matrix_transform_pixel_rectangle
> > Committed New Function
> > pango_matrix_transform_point
> > pango_matrix_transform_rectangle
> > Committed New Function
> > pango_units_from_double Committed New Function
> > pango_units_to_double Committed New Function
> > pango_version Committed New Function
> > pango_version_check Committed New Function
> > pango_version_string Committed New Function
>
> Might be nice to refer to the gtk-docs for more information about the
> new interfaces.
>
> Also you seem to neglect quite a few new interfaces:
>
> New packages (all Committed):
>
> SUNWgnome-a11y-dasher-root (seems to contain a new GConf schemas file)
> SUNWgnome-python-desktop-devel (not sure - probably need to see why
> this is new).
> SUNWgnome-spell-devel (due to enchant)
>
> New pkgconfig files (all Volatile)
>
> libslab.pc
> gnome-python-desktop-2.0.pc
> enchant.pc
>
> Removed pkgconfig files
>
> didn't we remove the libgtkhtml-38.pc file?
>
> New binaries (All volatile)
>
> glchess, gnome-gnuchess, gnome-sudoku (I know games aren't that
> important but they are new and including them shows we have done
> some degree of homework)
> totem-video-indexer
> enchant
> enchant-lsmod
>
> Removed binaries:
>
> gataxx game
>
> Do new binaries have new manpages? If not, module owners should be
> pinged about this.
>
> New libraries (all Volatile but need some info about what they do)
>
> libOggFLAC
> libOggFLAC++ (do we really want to ship C++ interfaces here?)
> libslab
> libenchant
>
> New plug-ins (all Volatile)
>
> GIMP: gtkcons, pdbbrowse, gimpprocbrowser were all removed
> antialias and pyconsole added
> rhythmbox: iradio, magnatune and power-manager added (note audiocd
> plugin was moved to a new location but probably doesn't need
> to be mentioned
> gedit: externaltools added.
>
> What about our imported interface table. Some new things I'm aware of:
>
> Would be nice to mention we now depend on the new
> mlib_VideoColorRGBint_to_BGRAint mediaLib 2.5 function. This is a
> Committed interface, but worth mentioning in our Imported Interface
> table with a note that says our patch starts building with this
> interface when mediaLib 2.5 goes into Nevada.
>
> Don't we now depend on the new Composite Xserver extension for
> gnome-mag? We might need a contract here?
>
> Any other new interfaces? Anything new in /usr/sfw that we depend upon?
>
> > Version differences of modules between GNOME 2.16 and GNOME 2.18 can
> > be found in [1].
> >
> > Package comparisions between GNOME 2.16 and GNOME 2.18 can be found
> > in [2]
> >
> > 4. Reference Documents
> >
> > GNOME Public Websites:
> >
> > http://www.gnome.org/
> > http://developer.gnome.org/
> >
> > GNOME 2.18 Release Notes:
> >
> > http://www.gnome.org/start/2.18/notes/
> > http://live.gnome.org/TwoPointSeventeen/ReleaseNotes
> >
> > External Dependencies of GNOME 2.17.x
> >
> > http://live.gnome.org/TwoPointSeventeen/ExternalDependencies
> >
> > JDS Engineering Internal Website:
> >
> > http://jds.ireland/
> >
> > Other Related ARC Cases:
> >
> > LSARC 2006/462 GNOME 2.16
> >
> > LSARC 2006/368 D-BUS Message Bus System
> > PSARC 2005/399 Tamarack: Removable Media Enhancement in
> > Solaris
> >
> > lsarc 2006/464 libtiff upgrade to version 2.8.3
> > LSARC 2006/531 sdtimage EOF
> > LSARC 2006/532 Java-Gnome 1.1
> > LSARC 2006/538 Solaris Java Media Player EOF
> > LSARC 2006/541 GNOME System Log Viewer Plugin Interface
> > LSARC 2006/580 gnopernicus EOF
> > LSARC 2006/600 Now applet EOF
> > LSARC 2006/640 Desktop battery project
> > LSARC 2006/682 Pilot-link Package Update
> > LSARC 2006/685 Off-the-Record (OTR) Messaging plugin for GAIM
> > LSARC 2007/018 Sane-backends and XSane
>
> Some other new cases that are related:
>
> LSARC 2006/693 - Thunderbird 2 for Solaris Nevada and Solaris 10 Update
> LSARC 2006/694 - Firefox 2 for Solaris Nevada and Solaris 10 Update
> LSARC 2007/042 - JDS GNOME gDesklets
> LSARC 2007/043 - Lightning 0.3
> LSARC 2007/063 D-Bus update to 1.0.2
>
> LSARC 2007/058 mediaLib 2.5.
>
> PSARC 2007/051 Xorg server upgrade to 7.2.
>
> > [1] http://sceri.prc/download/incoming/ARC/modulediffs.txt
> > [2] http://sceri.prc/download/incoming/ARC/pkgcmp/
> > Note that the above URLs are intended for temparory use, I'll change
>
> temporary is misspelled.
>
> > the URL to point to the case directory once the fastrack is filed.
> >
> > 5. Resources and Schedule
> >
> > 5.1. Projected Availability
> >
> > This project will be included in Solaris Nevada.
> >
> > 5.2. Cost of Effort
> >
> > Refer to the PLC documentation which includes P&L for the project.
> >
> > 5.3. Cost of Capital Resources
> >
> > Refer to the PLC documentation which includes P&L for the project.
> >
> > 5.4. ARC review type: [Standard/FastTrack/SelfReview]
> >
> > FastTrack
> >
> > 6. Prototype Availability
> > 6.1. Prototype Availability
> >
> > Development versions of GNOME 2.18 are available here:
> >
> > http://gnome.ireland/gnome/releng/jds/
> >
> > 6.2. Prototype Cost
> >
> > Provided as an ongoing effort to keep the latest release of GNOME
> > available on the Solaris SPARC and x86 platforms.
>
More information about the desktop-discuss
mailing list