On Wed, 29 Mar 2006 13:27:00 +0200 Davor Ocelic <suppressed> wrote: > On Wed, 29 Mar 2006 13:12:33 +0200 > Davor Ocelic <suppressed> wrote: > > > On Wed, 29 Mar 2006 05:43:19 +0200 > > Andreas Grau <suppressed> wrote: > > > > > > --- qb_safe.filter 8 Nov 2005 18:14:32 -0000 1.6 > > > > +++ qb_safe.filter 27 Mar 2006 22:21:13 -0000 1.7 > > > > @@ -1,11 +1,7 @@ > > > > # Copyright 2002-2005 Interchange Development Group (http://www.icdevgroup.org/) > > > > # Copyright 1996-2002 Red Hat, Inc. > > > > # Licensed under the GNU GPL v2. See file LICENSE for details. > > > > -# $Id: qb_safe.filter,v 1.6 2005/11/08 18:14:32 jon Exp $ > > > > - > > > > -# QuickBooks Safe: make data safe for quickbooks > > > > -# QB will crash at the drop of a hat, so don't forget to remove > > > > -# any unfriendly characters. > > > > +# $Id: qb_safe.filter,v 1.7 2006/03/27 22:21:13 docelic Exp $ > > > > > > > > > > What's wrong with the comment ? > > Oh yes, and another point is: we will be having documentation available > in manpages format. So you will just say "man qb_safe", without the > need for opening web browsers or PDF viewers. This is good news. When will this be ? Other than that, and I don't want to be a pain in the neck (although I probably am), my questions remains open: _For which reason_ do you take the comments out. You could *copy* them, for example. Or you could even *add* to them. Are you going to delete *all* inline documentation ? I am meaning not WHY (because there the answer is clear: it has been decided), I am asking "for what purpose". There once was a time, when generating documentation from inline comments was state of the art, because one found that programmers, who are known to notoriously avoid writing documentation, prefer to document as they code, instead of keeping two different files in sync. I am curious to understand the reasoning what benefit tearing all apart may bring. And how you intend to keep the docs in sync. Thanks, Andreas _______________________________________________ interchange-users mailing list suppressed http://www.icdevgroup.org/mailman/listinfo/interchange-users
Mail converted by mhonarc 2.6.15
This archive provided courtesy of JSW4.NET, Internet Hosting Services for Small Business.