Re: GnomeVFS to GVFS migration guide

[Dave Neary <bolsh gnome org>]

Hi Karl,

I was trying hard to smart quote your mail, but since it's all pretty
good, I'm going to leave it intact (adding mobile-devel-list on CC).

This sounds like something that GNOME Mobile participants might be
interested in participating in. In fact, I bet that some of the
documentation you mention exists already in some form or other.

A quick search found these sections in the Maemo training materials:
http://maemo.org/maemo_training_material/maemo4.x/html/maemo_Application_Development/Chapter_04_Support_Libraries.html#GConfbasics
http://maemo.org/maemo_training_material/maemo4.x/html/maemo_Platform_Development/Chapter_06_Asynchronous_GConf.html

Cheers,
Dave.

Karl Lattimer wrote:
> Hi all,
> 
> Googling around a bit I have been unable to locate a migration guide for
> switching from GnomeVFS to GVFS. If we are to make large changes to API,
> modules etc... then it is important that we include adequate documentation
> in our library. I think that in future any changes like this need to have
> guides added to http://library.gnome.org/devel/guides in order to prevent
> causing problems for developers. If there is a guide available then can
> somebody please add it to the library, if there isn't I would be much
> appreciative if someone could write one (unfortunately I'm too short on
> time) and publish it in the appropriate place.
> 
> I think at this point we should consider developing our documentation ready
> for 3.0 so developers have a place where they can get involved, learn about
> the changes and help ensure that developers continue to maintain their
> software in appropriate time with the GNOME releases.
> 
> Some suggested documentation;
> 
>  * Custom widget guides e.g. composite widgets, derived widgets, popup
> widgets like context menus and custom widgets from scratch
>  * Developing GtkBuilder compatible widgets
>  * Panel applet development guide
>  * Using dialogs and creating custom dialogs
>  * Adding printing support to your application
>  * Localising your application
>  * Creating a plugin system for your application
>  * Using GConf
>  * Various guides regarding keying into available data sources and useful
> services, e.g. EDS and GNOME Keyring
> 
> and of course...
> 
>  * The aforementioned GnomeVFS to GVFS migration guide
> 
> Other migration guides could be added although I can't think of any right
> now. 
> 
> 
> I have created this as a page on live;
> http://live.gnome.org/DocumentationProject/DeveloperDocs please feel free
> to edit and contribute to this page, provide links to documents already
> existing in the halls of the intertubes so we can accumulate any already
> existing documentation onto library.
> 
> BR,
>  K
> 
> _______________________________________________
> desktop-devel-list mailing list
> desktop-devel-list gnome org
> http://mail.gnome.org/mailman/listinfo/desktop-devel-list
> 
> 


-- 
Dave Neary
GNOME Foundation member
bolsh gnome org