"spir" <denis.spir@[...].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@[...].org
To unsubscribe or change subscription options:
http://mail.python.org/mailman/listinfo/tutor