On Tue, 2008-07-01 at 11:16 +0200, Martin Desruisseaux wrote:
> Adrian Custer a écrit :
> > Standardizing the format and layout is probably a great idea.
> > 
> > Moving it to an obscure location is likely to make module maintainers
> > even less likely to create, update and maintain that file.
> 
> Well, the problem is that if we want to integrate the review in the Maven web 
> page, we don't have a lot of choices. The proposed location is the standard 
> one 
> for Maven pages to be included on the generated site. An alternative may be 
> to 
> hack the pom.xml. But it would make it yet more complicated and I'm not sure 
> that it would work.
> 
>       Martin

Yeah, I can imagine you suggested this move because it was needed. 


It seems that we need to define a standard format for all modules, which
we would present in:
http://docs.codehaus.org/display/GEOT/Creating+your+own+Module
http://docs.codehaus.org/display/GEOT/5.3+Module+Directory+Structure
http://docs.codehaus.org/display/GEOT/Supporting+your+module
and in the unsupported/example module
http://svn.geotools.org/trunk/modules/unsupported/example/


We need to agree on a layout of files. For isogeom, I've settled on:

LGPL     --- version 2.1 (i.e. a copy of each license applicable)
LICENSE  --- the actual text of the terms (example contents below)
pom.xml
README   --- module info
review.txt
src/
TODO     --- plans for the future

Martin suggests moving the review.txt into a site/ folder somewhere (see
his email for details). 


Can we come up with a standard layout for these core files?

--adrian


LICENSE 
(needs to be tweaked, e.g. the GeoTools [sic] line, the version number
to 2.1 only, but gives the idea)
-----------------------------------------------------------------------
  The files in this software library package are part of
  
      Geotools, an open source Java GIS toolkit
      
a free software effort of the Open Source Geospatial Foundation (OSGeo).
For more information on the project see http://geotools.org/ whilst the
homepage of the foundation can be found at http://osgeo.org/ .
  
Most files in this library are covered by a copyright of the Open Source
Geospatial Foundation (OSGeo) as documented in the file headers. Such
files are licensed to all under the terms of the GNU Lesser General
Public License (LGPL), version 2 or later. The directory containing this
file should also contain a copy of the LGPL, as a file named LGPL.
  
Some files or portions of files are licensed under one or more different
licenses as documented in the headers of individual files. A copy of any
license which is not designed to be included in the file header itself
should be also be included along side this file: look for files with
names such as GPL+CP.




-------------------------------------------------------------------------
Check out the new SourceForge.net Marketplace.
It's the best place to buy or sell services for
just about anything Open Source.
http://sourceforge.net/services/buy/index.php
_______________________________________________
Geotools-devel mailing list
Geotools-devel@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/geotools-devel

Reply via email to