search

pombreda / libkml

Automatically exported from code.google.com/p/libkml
Other
0 stars 0 forks source link

Comment the Abstract* DOM classes to provide reasoning for abstraction #20

Closed GoogleCodeExporter closed 9 years ago

GoogleCodeExporter commented 9 years ago 
While browsing the DOM files, it's not immediately obvious the reasoning
behind some of the abstract classes, like AbstractLatLonBox and
AbstractLink. It'd be helpful to explain this in comments in either the .h
or .cc files.

Original issue reported on code.google.com by pamela.fox on 2 Aug 2008 at 5:30

GoogleCodeExporter commented 9 years ago 
the intention is to match the OGC KML standard and XSD:
http://schemas.opengis.net/kml/2.2.0/ogckml22.xsd

we'll heed your suggestion and try to make clear where
we are matching the OGC KML standard and where
we've introduced classes for coding convenience

(AbstractLatLonBox is an example of something
straight out of the standard)

Original comment by kml.b...@gmail.com on 2 Aug 2008 at 11:07

GoogleCodeExporter commented 9 years ago 
the abstract class headers are now commented like this:

// OGC KML 2.2 Standard: 9.14 kml:AbstractLatLonAltBox
// OGC KML 2.2 XSD: <complexType name="AbstractLatLonBoxType" abstract="true">
class AbstractLatLonBox : public Object {

Original comment by kml.b...@gmail.com on 29 Oct 2008 at 3:07