comp.lang.ada
 help / color / mirror / Atom feed
* SPC Ada Quality and Style guide, version 2
@ 1991-11-22  0:17 Michael Feldman
  0 siblings, 0 replies; 2+ messages in thread
From: Michael Feldman @ 1991-11-22  0:17 UTC (permalink / raw)


In the rush to send off the posting about capitalization religions,
I neglected to mention that, IMNSHO, the SPC document is a nice and 
generally thoughtful compendium of the current wisdom on Ada code
quality and style. It's thought-provoking, for sure, and instead of
re-inventing the wheel, cites other sources where appropriate (the
old Nissen/Wallis compendium, other draft handbooks, etc.). All in
all, a well-done and intellectually-honest reference.

Some of the statements, especially on religious but relatively minor
matters like capitalization, are too equivocal, in my opinion; they
should either take a strong stand or show examples of the different
valid ways to do it. But on the whole, and on matters more substantial
than lexical style, the recommendations guidelines to represent mainstream 
consensus and present the issues in a balanced and well-considered fashion.

As I said in the other post, SPC cannot be held responsible if a
narrow-minded manager adopts their guidelines as gospel. There are
many paths to good style and good design, and a savvy design team -
managers and tekkies alike - will work things out in a consistent
manner best-suited to the project at hand.

I believe it would be a mistake for DoD or any other large
organization to adopt a guidebook as a _standard_ and mandate
compliance. That sort of oversimplification is exactly what we do
NOT need. 

Get a copy and read it, if you're serious about Ada. You might not
agree with everything in it (I don't), but it'll make you think, and
that's (part of) what it's all about.

Mike

^ permalink raw reply	[flat|nested] 2+ messages in thread

* Re: SPC Ada Quality and Style guide, version 2
@ 1991-11-22 15:22 sdd.hp.com!cs.utexas.edu!mars.tsd.arlut.utexas.edu!larry
  0 siblings, 0 replies; 2+ messages in thread
From: sdd.hp.com!cs.utexas.edu!mars.tsd.arlut.utexas.edu!larry @ 1991-11-22 15:22 UTC (permalink / raw)


I hate to join the religous wars on capitalization since I don't have any
preferred capitalization style myself.  I would like to say, however, that 
instead of a convention why don't we have Ada be case sensitive and mandate 
the capitalization convention.  This would solve the consistency problem
once and for all.  Please, no flames.  This suggestion is only half serious 
at best.

+-----------------------------------+----------------------------------------+
|                                   |                                        |
| Larry Maturo                      | Opinions expressed herein must be      |
| Applied Research Laboratories     | yours, neither I nor my employer have  |
| University of Texas at Austin     | any.                                   |
| P.O. Box 8029                     +----------------------------------------+
| Austin, Texas 78713-8029          |                                        |
|                                   | When you're as great as I am it's hard |
| larry @titan.tsd.arlut.utexas.edu | to be modest, but I succeed where      |
|                                   | others fail.                           |
+-----------------------------------+----------------------------------------+

^ permalink raw reply	[flat|nested] 2+ messages in thread

end of thread, other threads:[~1991-11-22 15:22 UTC | newest]

Thread overview: 2+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
1991-11-22  0:17 SPC Ada Quality and Style guide, version 2 Michael Feldman
  -- strict thread matches above, loose matches on Subject: below --
1991-11-22 15:22 sdd.hp.com!cs.utexas.edu!mars.tsd.arlut.utexas.edu!larry

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