[Qgis-developer] Questions about backwards compatibility and documentation

Fri Dec 19 00:09:13 EST 2008

Hi

On Thu, 2008-12-18 at 20:44 -0700, icosa atropa wrote:
> I'm curious about the overall backwards compatibility plan looking
> forwards.  Are things stabilizing?  

Versions of QGIS prior to 1.0 did not guarantee API stability since the
application was undergoing rapid development of new features and we did
not want to commit ourselves to a fixed API. The upcoming release of
QGIS 1.0 will guarantee a backwards compatible API  for the 1.x and
1.0.x release series. 1.x releases will be our 'unstable' development
builds and 1.0.x releases our stable (bugfixes and very minor tweaks
only). 1.0.0 is due for release in about 2 weeks.

>
> I have a bunch of old work from
> Ganymede that consitently crashes with the following message in the
> terminal:
> 
> row number 0 is out of range 0..-1
> Fatal: ASSERT failure in QList<T>::operator[]: "index out of range",
> file /usr/include/qt4/QtCore/qlist.h, line 399
> 

Posting a code snippet of what you were doing may help us to understand
why.

> When I clicked though on the message box that comes up about reporting
> issues to https://svn.qgis.org/trac/wiki, this page has a certificate
> that expired a year ago and was generated for spatialserver.net.  So
> confused!

Since we have become an OSGEO Project, we have moved many of our web
properties onto OSGEO servers for long term continuity. Unfortunately
there is no easy way to update old URLS in deployed software. The
http://qgis.org site will always remain the canonical place for
information and you can consult that site for current links to trac etc.

http://trac.osgeo.org/qgis is the current trac link.

> 
> Will this be less of a problem going forwards into 1.0?  Is there a
> single file that's causing problems?  Is backwards and forwards
> compatibility addressed within the documentation?  I didn't see this
> *very* important issue mentioned in FAQ, ganymede (most recent) user,
> etc.
> 

We have updated a lot of the API documentation for the 1.0 release, and
based on your email I have added a comment about API stability to the
doxygen generated documentation. We will also be mentioning the fact
that we now provide a stable api in various other places as we make the
release.

> Incidentally, I'm available for limited and
> relatively-time-insensitive user guide proofreading and copy editing
> over the next few weeks, if needed :)

I'm sure that Otto Dassau will appreciate your inputs here. He is not
ready for proof readers yet, but if you keep an eye on the
qgis-community mailing list (details for joining this list on
http://qgis.org) he will announce when he is ready for proof readers and
no doubt be pleased to get your inputs!

Regards

Tim
> 
> best,
> christian
> 
> On Thu, Dec 18, 2008 at 10:00 AM,
> <qgis-developer-request at lists.osgeo.org> wrote:
> > Send Qgis-developer mailing list submissions to
> >        qgis-developer at lists.osgeo.org
> >
> > To subscribe or unsubscribe via the World Wide Web, visit
> >        http://lists.osgeo.org/mailman/listinfo/qgis-developer
> > or, via email, send a message with subject or body 'help' to
> >        qgis-developer-request at lists.osgeo.org
> >
> > You can reach the person managing the list at
> >        qgis-developer-owner at lists.osgeo.org
> >
> > When replying, please edit your Subject line so it is more specific
> > than "Re: Contents of Qgis-developer digest..."
> >
> >
> > Today's Topics:
> >
> >   1. Re: icons (Robert Szczepanek)
> >   2. Python plugin repositories (Gary Sherman)
> >   3. Re: icons (Paolo Cavallini)
> >   4. Re: QGIS 1.0 Branched - please read to prepare for        1.0.0
> >      release! (Paolo Cavallini)
> >   5. Re: QGIS 1.0 Branched - please read to prepare for        1.0.0
> >      release! (Tim Sutton)
> >   6. Re: [Qgis-community-team] Re: [Qgis-developer] QGIS 1.0
> >      Branched -        please read to prepare for 1.0.0 release! (Borys Jurgiel)
> >   7. Re: Python plugin repositories (Borys Jurgiel)
> >   8. Re: remove layer from QgsMapLayerRegistry (Martin Dobias)
> >   9. Re: delete feature (Martin Dobias)
> >
> >
> > ----------------------------------------------------------------------
> >
> > Message: 1
> > Date: Thu, 18 Dec 2008 00:31:16 +0100
> > From: Robert Szczepanek <robert at szczepanek.pl>
> > Subject: Re: [Qgis-developer] icons
> > To: tim at linfiniti.com
> > Cc: qgis-developer at lists.osgeo.org
> > Message-ID: <49498BC4.6050903 at szczepanek.pl>
> > Content-Type: text/plain; charset=ISO-8859-2; format=flowed
> >
> >> The plugin icons live under src/plugins/foo (each plugin manages its own
> >> icon). 'Core' plugins are all those that exist in the afore mentioned
> >> plugins directory. These plugins are shipped as default with QGIS so it
> >> would be great to have them consistent with the rest of QGIS.
> >>
> >> Currently the plugin subdirs dont support theming properly - I will work
> >> to resolve this over the weekend.
> >
> > Set of 13 icons for core plugins is ready for download at
> > http://robert.szczepanek.pl/icons.php
> >
> > best regards,
> > --
> > Robert Szczepanek
> >
> >
> > ------------------------------
> >
> > Message: 2
> > Date: Wed, 17 Dec 2008 20:23:01 -0900
> > From: Gary Sherman <sherman at mrcc.com>
> > Subject: [Qgis-developer] Python plugin repositories
> > To: qgis-developer List <qgis-developer at lists.osgeo.org>
> > Message-ID: <6AAC0B6E-10C6-4AB2-AC83-3AEA5FFC99C5 at mrcc.com>
> > Content-Type: text/plain; charset=US-ASCII; format=flowed; delsp=yes
> >
> > All,
> > The "official" repository is ready for testing. It consists of an
> > administrative interface to manage the upload of plugins and the xml
> > generator.
> >
> > The XML contains the following new tags, which can be ignored or used
> > as desired:
> > <qgis_minimum_version/> - Minimum version of qgis required by the plugin
> > <uploaded_by/> - user id of admin that uploaded the plugin to the
> > official repository
> > <create_date/> - date the plugin was initially uploaded
> > <update_date/> - date the plugin or its metadata was updated
> >
> > Additional fields as suggested by some can be easily added but this
> > should be sufficient to allow inclusion in the packaging effort.
> >
> > The administrative interface is at: http://pyqgis.org/admin/official
> >
> > The xml describing the plugins in the repository is at: http://pyqgis.org/repo/official
> >
> > If you wish to test the admin interface by uploading or editing
> > plugins you will need an account and admin privileges. Accounts from
> > the previous repository were carried forward. Send me an email if you
> > want admin access for testing purposes. At present the following users
> > have admin:
> >
> > Tim Sutton
> > Borys Jurgiel
> >
> > Any admin can grant admin privileges to a user. Final determination as
> > to who gets admin privileges at release time is pending further
> > discussion.
> >
> > There is an XSL stylesheet to render http://pyqgis.org/admin/official
> > in your browser. Please note that neither this or the admin interface
> > is meant to be and end user interface. Users should interact with the
> > repository through the plugin installer. Future work on a
> > "presentation" layer for the XML is under consideration.
> >
> > The interface for the user- contributed plugins is not ready yet but
> > will be found at http://pyqgis.org/admin/contributed.
> >
> > The XML for the contributed plugins will be generated by http://pyqgis.org/repo/contributed
> > .
> >
> > Please test and report problems to me.
> >
> > Thanks,
> > -gary
> >
> > "No worries..."
> >
> > -_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-
> > Gary Sherman
> > Chair, QGIS Project Steering Committee
> > -Micro Resources: http://mrcc.com
> >   *Geospatial Hosting
> >   *Web Site Hosting
> > -Desktop GIS Book:
> >   *http://desktopgisbook.com
> > "We work virtually everywhere"
> > -_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-_-
> >
> >
> >
> > ------------------------------
> >
> > Message: 3
> > Date: Thu, 18 Dec 2008 08:20:11 +0100
> > From: Paolo Cavallini <cavallini at faunalia.it>
> > Subject: Re: [Qgis-developer] icons
> > To: Robert Szczepanek <robert at szczepanek.pl>
> > Cc: qgis-developer at lists.osgeo.org
> > Message-ID: <4949F9AB.1020308 at faunalia.it>
> > Content-Type: text/plain; charset=ISO-8859-2
> >
> > Robert Szczepanek ha scritto:
> >>
> >> Set of 13 icons for core plugins is ready for download at
> >> http://robert.szczepanek.pl/icons.php
> >
> > Thanks Robert for your good work!
> > pc
> > --
> > Paolo Cavallini, see: * http://www.faunalia.it/pc *
> >
> >
> > ------------------------------
> >
> > Message: 4
> > Date: Thu, 18 Dec 2008 08:37:38 +0100
> > From: Paolo Cavallini <cavallini at faunalia.it>
> > Subject: Re: [Qgis-developer] QGIS 1.0 Branched - please read to
> >        prepare for     1.0.0 release!
> > To: "qgis-psc at lists.osgeo.org" <qgis-psc at lists.osgeo.org>
> > Cc: qgis-developer <qgis-developer at lists.osgeo.org>
> > Message-ID: <4949FDC2.9020400 at faunalia.it>
> > Content-Type: text/plain; charset=ISO-8859-15
> >
> > Paolo Cavallini ha scritto:
> >
> >>>> - do we have an active PayPal account to link to the page?
> >>> As far as I know not.
> >>
> >> So what can we do for this? I would avoid setting up a new one, and we
> >> have the problem of which account the money should go to. Any ideas?
> >
> > Sorry to insist, but I think we should fin a solution soon: is there an
> > existing Paypal account we can use for this? If nothing better is
> > available, I can suggest our no-profit GFOSS.it http://gfoss.it/ (of
> > course a new button in English should be prepared).
> > I think it would be good to launch the service along the 1.0 and new
> > website.
> > All the best.
> > pc
> > --
> > Paolo Cavallini, see: * http://www.faunalia.it/pc *
> >
> >
> > ------------------------------
> >
> > Message: 5
> > Date: Thu, 18 Dec 2008 10:41:16 +0200
> > From: "Tim Sutton" <tim at linfiniti.com>
> > Subject: Re: [Qgis-developer] QGIS 1.0 Branched - please read to
> >        prepare for     1.0.0 release!
> > To: cavallini at faunalia.it
> > Cc: "qgis-psc at lists.osgeo.org" <qgis-psc at lists.osgeo.org>,
> >        qgis-developer <qgis-developer at lists.osgeo.org>
> > Message-ID:
> >        <d368056f0812180041g4f43c248ua14fe59e1f26ae85 at mail.gmail.com>
> > Content-Type: text/plain; charset=ISO-8859-1
> >
> > Hi
> >
> > 2008/12/18 Paolo Cavallini <cavallini at faunalia.it>:
> >> Paolo Cavallini ha scritto:
> >>
> >>>>> - do we have an active PayPal account to link to the page?
> >>>> As far as I know not.
> >>>
> >>> So what can we do for this? I would avoid setting up a new one, and we
> >>> have the problem of which account the money should go to. Any ideas?
> >>
> >> Sorry to insist, but I think we should fin a solution soon: is there an
> >> existing Paypal account we can use for this? If nothing better is
> >> available, I can suggest our no-profit GFOSS.it http://gfoss.it/ (of
> >> course a new button in English should be prepared).
> >> I think it would be good to launch the service along the 1.0 and new
> >> website.
> >
> >
> > Sorry for not  replying sooner but I don't really have a good
> > solution. If we set up a paypal account my feeling is that it should
> > be a completely separate on from any other account for clarity of
> > accounting. I agree it would be great to get paypal / sponsors etc
> > sorted out for the release.
> >
> > For me probably the ideal would probably be if we can form a EU non
> > profit organisation 'QGIS.org', open a bank account and have you, Otto
> > and Marco as co-signaturies on the account. And then setup paypal to
> > put money straight into that account. I dont know if this is even
> > possible, but as our financial guru I guess I'm looking to you for
> > leadership on this.
> >
> > Thanks for following up on this!
> >
> > Regards
> >
> > Tim
> >
> >
> >> All the best.
> >> pc
> >> --
> >> Paolo Cavallini, see: * http://www.faunalia.it/pc *
> >> _______________________________________________
> >> Qgis-developer mailing list
> >> Qgis-developer at lists.osgeo.org
> >> http://lists.osgeo.org/mailman/listinfo/qgis-developer
> >>
> >
> >
> >
> > --
> > Tim Sutton - QGIS Project Steering Committee Member (Release  Manager)
> > ==============================================
> > Visit http://linfiniti.com to find out about:
> >  * QGIS programming services
> >  * Mapserver and PostGIS based hosting plans
> >  * FOSS Consulting Services
> > Skype: timlinux Irc: timlinux on #qgis at freenode.net
> > ==============================================
> >
> >
> > ------------------------------
> >
> > Message: 6
> > Date: Thu, 18 Dec 2008 14:40:45 +0100
> > From: Borys Jurgiel <borys at wolf.most.org.pl>
> > Subject: Re: [Qgis-community-team] Re: [Qgis-developer] QGIS 1.0
> >        Branched -      please read to prepare for 1.0.0 release!
> > To: qgis-developer at lists.osgeo.org
> > Message-ID: <200812181440.45765.borys at wolf.most.org.pl>
> > Content-Type: text/plain;  charset="iso-8859-2"
> >
> > Tuesday 16 of December 2008 11:39:11 Carson Farmer napisa³(a):
> >> Borys: If you do organise a pyQGIS irc meeting, let me know, and I'll
> >> try to make that.
> >
> > I'm too busy these days, so I only can stop for a while in a net coffee and
> > join an existing meetting. I have no free brain resources for organizing
> > anything.
> >
> >
> > ------------------------------
> >
> > Message: 7
> > Date: Thu, 18 Dec 2008 16:12:07 +0100
> > From: Borys Jurgiel <borys at wolf.most.org.pl>
> > Subject: Re: [Qgis-developer] Python plugin repositories
> > To: qgis-developer at lists.osgeo.org
> > Message-ID: <200812181612.08880.borys at wolf.most.org.pl>
> > Content-Type: text/plain;  charset="iso-8859-2"
> >
> > Thursday 18 of December 2008 06:23:01 Gary Sherman napisa³(a):
> >> All,
> >> The "official" repository is ready for testing. It consists of an
> >> administrative interface to manage the upload of plugins and the xml
> >> generator.
> >
> > Thanks a lot!
> >
> >> The XML contains the following new tags, which can be ignored or used
> >> as desired:
> >> <qgis_minimum_version/> - Minimum version of qgis required by the plugin
> >
> > This tag should be required.
> >
> > Also, I see the possibility to upload plugins for the 0.x.  I thought we're
> > going to leave the old repository for 0.x and use the new ones only for 1.x.
> > If you prefer to move completely to the new repositories and close the old
> > one, I can implement it in Installer.
> >
> >> The administrative interface is at: http://pyqgis.org/admin/official
> >
> > I can't edit the plugin you've uploaded. I think every admin should be allowed
> > to edit any plugin, not only those uploaded by himself.
> >
> > Regards,
> > B.
> >
> >
> > ------------------------------
> >
> > Message: 8
> > Date: Thu, 18 Dec 2008 17:26:01 +0100
> > From: "Martin Dobias" <wonder.sk at gmail.com>
> > Subject: Re: [Qgis-developer] remove layer from QgsMapLayerRegistry
> > To: piko <piklas at gmail.com>
> > Cc: qgis-developer at lists.osgeo.org
> > Message-ID:
> >        <e8e7199c0812180826k6485c38t78de39c1580e9516 at mail.gmail.com>
> > Content-Type: text/plain; charset=ISO-8859-1
> >
> > On Mon, Dec 15, 2008 at 3:43 PM, piko <piklas at gmail.com> wrote:
> >>
> >> Folks
> >>
> >> in one of my plugin , i create a layer, add it to canvas and then need to
> >> remove it both from canvas and from layer registry, with this code:
> >>
> >> QgsMapLayerRegistry.instance().removeMapLayer(self.sprayerLayer.getLayerID())
> >>
> >> The layer is deleted from canvas but not from the layer registry.
> >> Do you know why ?
> >>
> >> Is there another way to update the registry ?
> >
> > I'm unable to replicate your problem. My test case:
> > - open a layer in QGIS
> > - open python console:
> >>>> id = iface.mapCanvas().currentLayer().getLayerID()
> >>>> QgsMapLayerRegistry.instance().mapLayers()
> > (prints a dictionary with QString keys and map layers as values)
> >>>> QgsMapLayerRegistry.instance().removeMapLayer(id)
> > (layer is removed from legend and canvas)
> >>>> QgsMapLayerRegistry.instance().mapLayers()
> > (prints empty dictionary)
> >
> >
> > Martin
> >
> >
> > ------------------------------
> >
> > Message: 9
> > Date: Thu, 18 Dec 2008 17:32:41 +0100
> > From: "Martin Dobias" <wonder.sk at gmail.com>
> > Subject: Re: [Qgis-developer] delete feature
> > To: piko <piklas at gmail.com>
> > Cc: qgis-developer at lists.osgeo.org
> > Message-ID:
> >        <e8e7199c0812180832u213005b0wc7f3f0268e37df87 at mail.gmail.com>
> > Content-Type: text/plain; charset=ISO-8859-1
> >
> > On Fri, Dec 12, 2008 at 1:02 PM, piko <piklas at gmail.com> wrote:
> >>
> >> sprayerProvider = self.sprayerLayer.dataProvider()
> >> sprayerProvider.addAttributes( { "name" : "string" } )
> >>
> >> if self.sprayerLayer.featureCount() ==1:
> >>   sprayerProvider.deleteFeatures([0])
> >>   self.canvas.refresh()
> >>
> >> [...]
> >>
> >> So the feature is created and the layer added,
> >> but i want to delete and replace the feature each time the user click
> >> i guess my deleteFeatures doesn't work, because each click creates a new
> >> feature in the layer
> >
> > You can't expect that feature id when inserting to an empty layer will
> > be zero. That's why deleteFeatures() isn't working for you.
> >
> > Martin
> >
> >
> > ------------------------------
> >
> > _______________________________________________
> > Qgis-developer mailing list
> > Qgis-developer at lists.osgeo.org
> > http://lists.osgeo.org/mailman/listinfo/qgis-developer
> >
> >
> > End of Qgis-developer Digest, Vol 34, Issue 27
> > **********************************************
> >
> 
> 
> 
> _______________________________________________
> Qgis-developer mailing list
> Qgis-developer at lists.osgeo.org
> http://lists.osgeo.org/mailman/listinfo/qgis-developer

-- 
Tim Sutton - QGIS Project Steering Committee Member (Release  Manager)
==============================================
Visit http://linfiniti.com to find out about:
 * QGIS programming services
 * Mapserver and PostGIS based hosting plans
 * FOSS Consulting & Support Services
Skype: timlinux Irc: timlinux on #qgis at freenode.net
==============================================
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 197 bytes
Desc: This is a digitally signed message part
Url : http://lists.osgeo.org/pipermail/qgis-developer/attachments/20081219/f25d06ad/attachment-0001.bin