Re: design directory, ERM; was: Doxygen - is there a status?

2014-09-05 Thread Geert Janssens
On Thursday 04 September 2014 16:37:14 John Ralls wrote: > On Sep 4, 2014, at 4:18 PM, Geert Janssens wrote: > > On Thursday 04 September 2014 15:11:59 John Ralls wrote: > > > On Sep 4, 2014, at 9:04 AM, Frank H. Ellenberger > > > wrote: > > > > > > > - Explanation of namespaces gnc_, qof_, xa

Namespaces, file names,...

2014-09-05 Thread Geert Janssens
This topic was lightly touched in the doxygen/design thread currently active on this list. I thought it to be important enough to start a new thread on it. Historically, gnucash as acquired a lot of namespaces (think function and type prefixes) for various reasons. Some examples: * The oldest

Re: Namespaces, file names,...

2014-09-05 Thread John Ralls
On Sep 5, 2014, at 2:46 AM, Geert Janssens wrote: > This topic was lightly touched in the doxygen/design thread currently active > on this list. I > thought it to be important enough to start a new thread on it. > > Historically, gnucash as acquired a lot of namespaces (think function and >

Re: Namespaces, file names,...

2014-09-05 Thread Buddha Buck
On Fri, Sep 5, 2014 at 11:08 AM, John Ralls wrote: > So the question becomes: > * Is Gnc OK for the namespace name? > * Do we want to use camel-case or underscore-separated function and > variable names? > > N.B. The C++ code above mirrors the old C code to emphasize the different > naming and ca

Re: Namespaces, file names,...

2014-09-05 Thread Mike Alexander
On Sep 5, 2014, at 11:26 AM, Buddha Buck wrote: > > When every method name has to be Hungarian-notated to work with > pseudonamespaces, short namespace abbreviations make sense. > > But with true namespaces, using directives, and namespace aliasing > available in C++, I see benefits in readabili

Re: Namespaces, file names,...

2014-09-05 Thread John Ralls
On Sep 5, 2014, at 10:02 AM, Mike Alexander wrote: > On Sep 5, 2014, at 11:26 AM, Buddha Buck wrote: >> >> When every method name has to be Hungarian-notated to work with >> pseudonamespaces, short namespace abbreviations make sense. >> >> But with true namespaces, using directives, and names