"spir" <denis.s...@free.fr> wrote
English is terrible. From wiktionary (abstracts)/
Indeed. and the fact that computer Scientists often abuse English
makes it worse!
header
Text, or other visual information, used to mark off a quantity of text,
often titling or summarizing it.
This is probaly the closest to the usual CS definition.
A class header in C++, Delphi, Objective C and some other
languages is separate to its definition and provides a summary
or statement of the class interface. The implementation of the
class is then done elsewhere (although possibly in the same file).
Thats why I don;t think the class name definition is sufficient to
constitute a "header", it doesn't give any clue about the operations
or attributes - no summary in other words.
A class name and well written docstring could just about be called
a header, but its not common usage in Python and its accuracy
would depend entirely on the quality of the docstring!
All IMHO of course! :-)
--
Alan Gauld
Author of the Learn to Program web site
http://www.alan-g.me.uk/
_______________________________________________
Tutor maillist - Tutor@python.org
To unsubscribe or change subscription options:
http://mail.python.org/mailman/listinfo/tutor
