r17929 - gnucash/trunk/src/engine - Doxygen: Adjust the style of a comment block for consistency and to eliminate a splint warning.

[Charles Day]

On Tue, Feb 17, 2009 at 9:53 AM, Phil Longstaff <plongstaff at rogers.com>wrote:

> Yesterday, I started looking at splint to see if it would find any
> potential
> problems in the SQL backend.  I've seen a reference on the web to
> integrating
> splint into automake-generated projects but haven't followed through.  I
> may
> create a new branch to investigate the benefits of full annotation, since
> you
> can have splint track ownership of memory, routine pre/post conditions, and
> other interesting issues.
>

That might be a good idea, as my splint results are full of memory
management warnings that are mostly false positives. Splint seems to assume
that functions returning pointers are "only" in style. On the other hand,
I'm not quite sure what the proper annotation should be for something
like gnc_get_current_book() or xaccSplitGetParent().


> Phil
>

-Charles


>
> On February 17, 2009 11:49:53 am Charles Day wrote:
> > Author: cedayiv
> > Date: 2009-02-17 11:49:52 -0500 (Tue, 17 Feb 2009)
> > New Revision: 17929
> > Trac: http://svn.gnucash.org/trac/changeset/17929
> >
> > Modified:
> >    gnucash/trunk/src/engine/Account.h
> > Log:
> > Doxygen: Adjust the style of a comment block for consistency and to
> > eliminate a splint warning.
> >
> >
> > _______________________________________________
> > gnucash-patches mailing list
> > gnucash-patches at gnucash.org
> > https://lists.gnucash.org/mailman/listinfo/gnucash-patches
>
> _______________________________________________
> gnucash-devel mailing list
> gnucash-devel at gnucash.org
> https://lists.gnucash.org/mailman/listinfo/gnucash-devel
>