Re: giomm API review needed

[José Alburquerque <jaalburquerque cox net>]

Murray Cumming wrote:
> On Wed, 2008-01-09 at 17:58 +0100, Murray Cumming wrote:
>   
> > giomm is now in glibmm. But we need more people to take a look and
> > review the API. We'll have to freeze the API quite soon for GNOME 2.22,
> > though I'm not sure exactly when that will be for glib and glibmm.
> >
> > I am gradually adding documentation, but I'm only up to
> > Gio::FileEnumerator so far, alphabetically:
> > http://www.gtkmm.org/docs/glibmm-2.4/docs/reference/html/namespaceGio.html
> >
> > Gio::File is probably a good place to start, though I don't yet have a
> > good idea of the API as a whole:
> > http://www.gtkmm.org/docs/glibmm-2.4/docs/reference/html/classGio_1_1File.html#_details
> >     
>
> We are getting close to an API freeze for giomm, but I really want more
> people to test it and review the API. You'll have only yourselves to
> blame if you only discover the problems later.
>
>
>   
By doing a quick survey, I found a few things:

- MountOperation - missing properties and signals
- Cancellable - missing "cancelled" signal
- IOScheduler - missing
- FilterInputStream - missing "base-stream" property
- VolumeMonitor - missing signals
- Drive - missing signals
- UnixMountMonitor - missing
- ThemedIcon - missing
- FileNameCompleter - missing
- Vfs - missing
- IOModule - missing

Classes with virtual methods to be done:
- Seekable
- AppInfo
- Volume
- Mount
- Drive
- Icon
- LoadableIcon

Methods to be overloaded w/o Cancellable (Gio::File only)
- append_to
- create_file
- query_filesystem_info
- remove
- trash
- make_directory
- make_symbolic_link
- query_settable_attributes
- query_writable_namespace
- set_attributes_from_info
- set_attribute_string
- set_attribute_byte_string
- set_attribute_{uint32,int32,uint64,int64}

-Jose