[net.lang.ada] Ada style guide wanted

joe@petsd.UUCP (Joe Orost) (05/14/85)

I would like to see a style guide for writing Ada code covering topics
like indenting, type and object naming, etc.  If you have knowledge
of anything like this, please drop me a note.


					regards,
					joe

--
Full-Name:  Joseph M. Orost
UUCP:       ..!{decvax,ucbvax,ihnp4}!vax135!petsd!joe
ARPA:	    vax135!petsd!joe@BERKELEY
US Mail:    MS 313; Perkin-Elmer; 106 Apple St; Tinton Falls, NJ 07724
Phone:      (201) 758-7284	<<--NEW NUMBER 4/15/85-->>
Location:   40 19'49" N / 74 04'37" W

jans@mako.UUCP (Jan Steinman) (05/14/85)

In article <521@petsd.UUCP> joe@petsd.UUCP (Joseph M. Orost) writes:
>I would like to see a style guide for writing Ada code covering topics
>like indenting, type and object naming, etc.

"Ada Style Manual" was (as of fall, 1983) free for the asking from:

	INTELLIMAC, Inc.
	6001 Montrose Road
	Rockville, MD 20852
	(301)984-8000

They also had a periodic newsletter for (prospective) users of their 68000-
based machine.

I am not connected with this company.  I evaluated, and eventually specified
their product as a consultant on an RFP for IBM FSD.
-- 
:::::: Jan Steinman		Box 1000, MS 61-161	(w)503/685-2843 ::::::
:::::: tektronix!tekecs!jans	Wilsonville, OR 97070	(h)503/657-7703 ::::::

rrw@ccice2.UUCP (Rick Wessman) (05/16/85)

In article <521@petsd.UUCP> joe@petsd.UUCP (Joseph M. Orost) writes:
>I would like to see a style guide for writing Ada code covering topics
>like indenting, type and object naming, etc.  If you have knowledge
>of anything like this, please drop me a note.
>
>
>					regards,
>					joe
>
>--

I would really like one, too, because I am doing my M.S. thesis in
Ada.

				Thanks,
					Rick

tancill@dcvax.DEC (05/21/85)

I am aware of two "Ada* style guides", both of which I've found
found to be quite useful.

Ada* Style Manual
Copyright 1983
Intellimac, Inc.
6001 Montrose Road
Rockville, Maryland 20852

It's more like a couple of sheets of paper, but it covers the
importance of consistent style across a project team.  Topics
are 1. Identifiers, 2. Identation and aliignment, 3. Comments
4. Capitalization, 5. Highlighting, 6. Spacing, 7. Global
variables, and 8. Use clauses.  The second edition includes
revisions based on comments from readers and users of the
first edition.  Please drop me a note if you find there is a 
third edition by now. 
Soon you'll be coding identifiers like:

  Console_Input_Vector_To_Terminal_Driver_P{ackage

The other guide is

Studies in Ada Style
Second Edition, Jan. 1983
Peter Hibbard, Andy Hisgen, Jonathan Rosenberg, Mary Shaw, Mark Sherman
Dept. of CS, CMU, Schenley Park, Pittsburg PA 15213

Copyright 1983 by Springer-Verlag New York Inc.

This is a meater guide which discusses the impact of abstraction concerns
on modern languages and studies example Ada* programs.

I believe one can call Intellimac directly for their guide, but I
can't remeber for the life of me how I obtain the second one by
the folks at CMU.

Hope that helps,                      jeff

Return_Address: "decvax!decwrl!dec-rhea!dec-dcvax!tancill

*Ada is, of course, a registered trademark of the U. S. Gov't, AJPO

sth@rayssd.UUCP (05/23/85)

Try Grady Booch's book, "Software Engineering with Ada".  Indenting seems to
be a matter of personal preference; I like the Pascal system for standard code.
I try to do select statements like:

	select
	  accept A
	  do
	    WHATEVER;
	  end A;
	or
	  accept B;
	  STATEMENTS;
	or
	  accept C;
	end select;

but that too is a matter of preference.  Do what seems right.