Software Engineers Handbook/Language Dictionary/Sample Template

<Language Name Here>Edit

<Describe the language, include a brief history if possible.>

TypeEdit

<Describe if this is a scripting, mini language, full language: procedural or functional.>

Execution Entry PointEdit

<Describe how/where the program is started i.e. C++ main()>

General SyntaxEdit

<Try to give a high level description of the contents of a typical line of code. An assignment example may be appropriate such as

a = b;

>

CommentsEdit

<Describe and show the syntax for comments such as

// this is an inline comment.  Everything after the // is a comment.

Block comments are specified by a starting /* and ending */ They can span multiple lines.

/*
 * this is a block comment 
 */

>

Variable DeclarationsEdit

<Describe if variable declarations are necessary, and give examples of the different types, such as

declare i as an integer

int i;

two ways to declare i as an integer and give it an initial value of 0

int i = 0;
int i(0);

>

Method Declaration/ImplementationEdit

<Describe how methods/functions/procedures are declared and implemented.>

ScopeEdit

<Describe how scope is defined.>

Conditional StatementsEdit

<Describe the conditional statements in text and present

code examples. 

(put a space in the front of the line to format as code)>

Looping StatementsEdit

<Describe looping statements in English and present code examples.>

Output StatementsEdit

<Describe how to output Hello world! including the new-line with or without a carriage return.>

Error Handling/RecoveryEdit

<Describe error handling and recovery. Give examples as appropriate.>

ContainersEdit

<List containers or references to lists of containers available natively for this language. List ways to incorporate containers if they are not native to the language.>

AlgorithmsEdit

<List algorithms or references to lists of algorithms available natively for this language. List ways to incorporate algorithms if they are not native to the language. Or, if not available, describe that.>

Garbage collectionEdit

<Describe whether the garbage collection is automatic or manual.>

Physical StructureEdit

<Describe how the files, libararies, and parts are typically divided and arranged.>

TipsEdit

<Please include tips that make it easier to switch to this language from another language.>

Web ReferencesEdit

<List additional references on the web. Please include for what level reader the references are appropriate. (beginner/intermediate/advanced)>

Books and ArticlesEdit

<List additional books and articles that may be helpful. Please include for what level reader the references are appropriate. (beginner/intermediate/advanced)>

Last modified on 8 June 2009, at 04:08