www.delorie.com/gnu/docs/libobjects/libobjects_8.html

search

	Buy GNU books!

User's Guide to the GNU Objective-C Class Library

5.1 Stylistic Conventions

• Objective-C source files have file extension `.m'. Both C-compatibility header files and class declaration files have extension `.h'.

• Objective-C class names begin with capital letters. Multi-word class names capitalize each word, with no underscore separation.

• Include files that define Objective-C classes begin with capital letters (as do the names of the classes themselves).

• All protocols end with ing. All collection protocols end with Collecting. All collection abtract superclasses (classes which are not usable without subclassing) end with Collection.

• Include files that supply function prototypes for other C functions are all lower case.

• Instance variables begin with an underscore, are all lower case, and have underscores separating their component words. The leading underscore distinguishes them from local varibles defined inside methods.

• All include files define a preprocessor variable __X_h_INCLUDE_GNU, where X is the name of the file, and conditionally compile only if this has not been already defined.

• The following macros and variables make the relevant version numbers available:

  Macro: COLL_VERSION

  The version number of the collection library. Declared in `coll/collstd.h'

  Macro: COLL_GCC_VERSION

  The version number of the compiler used to compile the collection library. Declared in `coll/collstd.h'

  Variable: char[] coll_version

  A string containing the version number of the collection library. Declared in `coll/collstd.h'

  Variable: char[] coll_gcc_version

  A string containing the version number of the compiler used to compile the collection library. Declared in `coll/collstd.h'