[postgis-devel] Update Documentation

[David William Bitner]

Once a format for how we want the documentation to work is figured
out, I would be very happy to help fill in the docs.

David

On Mon, Jun 23, 2008 at 11:45 AM, Obe, Regina <robe.dnd at cityofboston.gov> wrote:
>
>> I had
>>a very good laugh when someone pointed out our descriptive definitions.
>  > Honestly, I never paid much attention to this before:
>
>>ST_ConvexHull() - returns the convex hull of this geometry
>>ST_Centroid() - return the centroid of the geometry
>>ST_Touches() - returns true if the geometries "spatial touch"
>>ST_Crosses() - return true if the geometries "spatial cross"
>
> Well I pointed out the ConvexHull one I think.  Maybe someone else did
> before me.  I did get a kick out of those definitions too.   Seems almost a
> shame to get rid of them because you can't go wrong with them :).
>
> A lot of definitions are decent though.  Besides once you have it as meta
> data in the database it will be easier to pinpoint the laughable ones with a
> simple regular expression select.
>
>
>>In the end, I think this would be the best approach.  But I'm not sure
>>about stitching it back together.  I think a single page would be far
>>too large to load (with all the new content and pictures for every
>>function).  Perhaps a single page for constructors, a page for
>>accessors, etc.
>
> By stitching I was thinking more along the line of for generating the PDF
> version.  I still like the PDF version a lot as a handy take away.  I just
> wish the table of contents in the PDF was more thorough, but I suppose we
> can make it so when we separate things out a bit more.
>
> Thanks,
> Regina
>
> ________________________________
>
> The substance of this message, including any attachments, may be
> confidential, legally privileged and/or exempt from disclosure pursuant to
> Massachusetts law. It is intended solely for the addressee. If you received
> this in error, please contact the sender and delete the material from any
> computer.
>
> ________________________________
>
> Help make the earth a greener place. If at all possible resist printing this
> email and join us in saving paper.
>
> _______________________________________________
> postgis-devel mailing list
> postgis-devel at postgis.refractions.net
> http://postgis.refractions.net/mailman/listinfo/postgis-devel
>
>



-- 
************************************
David William Bitner