On Fri, Apr 15, 2011 at 02:51:46PM -0400, Galen Charlton wrote:
> Hi,
> 
> On Apr 15, 2011, at 1:36 PM, Soulliere, Robert wrote:
> > I watered down the DocBook stylesheet to only include the database tables 
> > without comments. It has been watered down because the database schema is 
> > massive as is. Including table comments would currently includes repetitive 
> > licensing preamble for every table thus increasing the size of this 
> > appendix quite a bit.
> 
> I think this has been discussed before, but is there any reason not to remove 
> or at least significantly trim the license preamble from in-database 
> comments?  Copyright and license are stated in the source SQL files that 
> initialize the schema, and the lengthy header does interfere with the 
> usability of the comments. 

I don't recall a discussion about this, but I'm entirely in favour of
removing the license headers from the in-database comments and just
keeping the license header in "--" comments at the top of each file, for
the reason that you state.
_______________________________________________
OPEN-ILS-DOCUMENTATION mailing list
[email protected]
http://list.georgialibraries.org/mailman/listinfo/open-ils-documentation

Reply via email to