"Daniel Espinosa" <[EMAIL PROTECTED]> writes: > 2007/6/1, Derek Atkins <[EMAIL PROTECTED]>: >> "Daniel Espinosa" <[EMAIL PROTECTED]> writes: >> > When will be performed a code clean up? I mean: >> > (a) delete the documentation in headers, >> >> Never. We WANT the documentation in the headers! Why would you >> want to delete this documentation? >> > > To help others to better understand the code; users must use a API > documentation like DevHelp can show, but new developers for QOF can > understand so quickly the QOF's internals if there's not TOO many > notes and documentation in the code (I can talk about my experience).
If you think the comments are too verbose, and could be more succinct or concise, I think we would all love a patch that made things simpler. I believe the comments that exist now are way too wordy and have a low S/N ratio. >> > Could QofCollections be GObjects? >> >> I suppose. >> > > Well make it happend. (That sounds like a demand...) It will happen when reasonable changes to do so are committed. >> > Could QofBook directy use a Database engine instead of in-memory >> > collections? I mean: use database's tables, instead to have a [...] > If we made QofBook encapsulate all backend operations, maybe it could > help some API users to use GC in more easy, and could help the > following point... Strictly API users shouldn't care about the backend. You're not suggesting API changes or simplifications. As such, I'm not sure why it would make it any easier or harder for API users. -- ...jsled http://asynchronous.org/ - a=jsled; b=asynchronous.org; echo [EMAIL PROTECTED]
pgpMX1GNHOV6Z.pgp
Description: PGP signature
_______________________________________________ gnucash-devel mailing list [email protected] https://lists.gnucash.org/mailman/listinfo/gnucash-devel
