[postgis-devel] Documenting new ST_Buffer

strk strk at keybit.net
Mon Jun 29 09:37:17 PDT 2009


Regina, were all the issues described here fixed by your latest commit ?

BTW, I've noticed the new "NEW in version xxx" sections in the manual,
but it used to be in the release notes appendices, which do now end
at 1.3....

--strk;

On Fri, Jun 26, 2009 at 12:07:45AM -0400, Paragon Corporation wrote:
> Strk,
> 
>  One problem I noticed is you don't have the Availability part in place.
> 
> Take a look at the Union one
> 
> http://postgis.refractions.net/documentation/manual-svn/ST_Union.html
> 
> There should be an Availability: 1.5.0 ... And detail of what was added.
> 
> Once you do that and I've modified the xsl script for the special sections,
> it will put this function in the What's new in 1.5  (I'll probably get to
> modifying the xsl script sometime tomorrow, but would be good if this were
> in so I can verify it is working).  It will appear here with the
> availability description details.
> 
> http://postgis.refractions.net/documentation/manual-svn/ch08.html#NewFunctio
> ns
> 
> Other issue -- you should probably update the short-description since
> ST_buffer now does more than simple buffering. The short description is what
> appears on the index page 
> http://postgis.refractions.net/documentation/manual-svn/ch07.html#Geometry_P
> rocessing
> 
> and is what gets put in the postgis_comments.sql
> 
> Other issue: The fact that ST_Buffer for some cases has a requirement for
> GEOS 3.2 poses a small documentation problem.  Not a big one in this case
> since we will still have all the signatures in place.  But it does bring up
> the question that since our flag for GEOS 3.2 is for the overall function
> (not each individual signature), how would we account for this in terms of
> sql comments generation etc (which I haven't done yet - sql comments just
> picks all up regardless of GEOS version)
> 
> Thanks,
> Regina
> 
> 
> 
> 
> 
> -----Original Message-----
> From: strk [mailto:strk at keybit.net] 
> Sent: Thursday, June 25, 2009 8:04 AM
> To: Paragon Corporation
> Cc: 'PostGIS Development Discussion'
> Subject: Re: [postgis-devel] Documenting new ST_Buffer
> 
> On Wed, Jun 24, 2009 at 10:13:08AM -0400, Paragon Corporation wrote:
> > I haven't tried to see if you can stuff in the examples section.   If a
> > table casing is allowed.  I suppose that would be the logical place.
> 
> As of r4217 the examples for ST_Buffer have queries right below the diagram.
> Revisions welcome. 
> I haven't droped the final (original) section as it contains other tips.
> Probably adding images to those too would be nice.
> 
> --strk;
> 
>  Free GIS & Flash consultant/developer      ()  ASCII Ribbon Campaign
>  http://foo.keybit.net/~strk/services.html  /\  Keep it simple! 
> 
> 
> 
> _______________________________________________
> postgis-devel mailing list
> postgis-devel at postgis.refractions.net
> http://postgis.refractions.net/mailman/listinfo/postgis-devel

-- 

 Free GIS & Flash consultant/developer      ()  ASCII Ribbon Campaign
 http://foo.keybit.net/~strk/services.html  /\  Keep it simple! 



More information about the postgis-devel mailing list