comp.lang.ada
 help / color / mirror / Atom feed
From: mfb@mbunix.mitre.org (Michael F Brenner)
Subject: Re: IDENTIFIERS in Upper Case
Date: 1997/03/27
Date: 1997-03-27T00:00:00+00:00	[thread overview]
Message-ID: <5hdnih$g1d@top.mitre.org> (raw)
In-Reply-To: 1997Mar26.185431.12742@nosc.mil


The worst capitalization scheme is one that involves the programmers
instead of doing it automatically with tools. The second worst is any
capitalization scheme that introduces capital letters to identifiers
or keywords. The correct scheme is to use a typesetting tool to 
emphasize the assertions (preconditions, invariants, and postconditions),
and de-emphasize the identifiers and keywords. An exception is that,
during debugging or during expository text, the typesetting tools 
should be set to give various colors to what you are currently 
describing. For example, in solving the year 2000 problem, the
typesetting tool should color all inter-chip messages containing
2-digit year fields in red, should capitalize all uses of the word
NEW, should color all date processing logig using the Zeller congruence
in blue, and should italicize all preconditions involving date
calculations. When people in authority have personal stylistic
preferences for capitalization, they should identify them as
personal preferences, and not as software engineering. It takes
time to for humans to carry out those preferences, which impacts
the amount of time it takes to change software and to analyze
the impact of those changes.




  parent reply	other threads:[~1997-03-27  0:00 UTC|newest]

Thread overview: 25+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
1997-03-26  0:00 IDENTIFIERS in Upper Case Charles H. Sampson
1997-03-26  0:00 ` Matthew Heaney
1997-03-27  0:00 ` Jeff Burns
1997-03-27  0:00   ` Matthew Heaney
1997-03-28  0:00     ` Robert A Duff
1997-03-28  0:00       ` William Clodius
1997-03-29  0:00         ` Robert A Duff
1997-03-28  0:00       ` Tom Moran
1997-03-28  0:00     ` Jerry Petrey
1997-03-28  0:00       ` Robert A Duff
1997-03-28  0:00         ` Robert Dewar
1997-03-28  0:00     ` Robert Dewar
1997-04-09  0:00   ` Graham C. Hughes
1997-03-27  0:00 ` Michael F Brenner [this message]
1997-03-27  0:00 ` Bob Collins
1997-03-28  0:00   ` Steve Doiel
1997-03-28  0:00     ` Robert Dewar
1997-03-29  0:00       ` Robert A Duff
1997-03-30  0:00         ` Robert Dewar
1997-04-01  0:00           ` Charles Lindsey
1997-04-03  0:00             ` John English
1997-04-04  0:00               ` Robert Dewar
1997-04-04  0:00               ` Robert Dewar
1997-03-28  0:00     ` Robert Dewar
1997-03-29  0:00       ` Doug Smith
replies disabled

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox