[sword-devel] Method Name Normalization
greg.hellings at gmail.com
Sun Jan 20 14:02:50 MST 2013
On Sun, Jan 20, 2013 at 1:28 PM, Greg Hellings <greg.hellings at gmail.com>wrote:
> On Sat, Jan 19, 2013 at 10:13 AM, Troy A. Griffitts <scribe at crosswire.org>wrote:
>> In anticipation of a new release, I have a large checkin I'm about to
>> commit which will break everything for everyone compiling with -Werror.
>> We've been normalizing method names toward a clean API interface at 2.0.
>> SWORD started 20+ years ago when there was not standard naming
>> conventions. In fact, originally we tried to keep variable names less than
>> 8 characters, as, at the time, some compilers stopped disambiguating after
>> this. Besides these, there are a number of conventions we used back then
>> for which standards have now become the norm: camelCase conventions,
>> standard set/getProperty naming, and the like. We've been slowly moving
>> toward these changes and have been deprecating old names for a few years
>> now. What I'm about to introduces standard names for all methods within
>> the SWKey and SWModule classes and deprecates the non standard names.
>> A few not obvious changes:
>> Headings() has been renamed to setIntros(bool) and bool isIntros()
>> Headings() -- used to turn on chapter, book, testament, and module
>> introductions, has frequently been a point of confusion with the global
>> option "Headings" -- used to turn on and off section headings in the text.
>> This new property name will hopefully remove that confusion.
>> Error() has become popError(), as the functionality has always been to
>> return and clear any error code for the object.
>> The bindings are probably in a state of disarray now. I've updated the
>> omniorb bindings. I'd appreciated any help with other stuff.
Additionally, BibleTime's sword-svn-compat branch has been updated to build
cleanly against this, (excluding the unused variables message I mentioned
in the other thread).
-------------- next part --------------
An HTML attachment was scrubbed...
More information about the sword-devel