Jump to content

Software Engineers Handbook/Language Dictionary/Sample Template

From Wikibooks, open books for an open world

<Language Name Here>

[edit | edit source]

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

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

Execution Entry Point

[edit | edit source]

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

General Syntax

[edit | edit source]

<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;

>

Comments

[edit | edit source]

<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 Declarations

[edit | edit source]

<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/Implementation

[edit | edit source]

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

Scope

[edit | edit source]

<Describe how scope is defined.>

Conditional Statements

[edit | edit source]

<Describe the conditional statements in text and present

code examples. 

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

Looping Statements

[edit | edit source]

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

Output Statements

[edit | edit source]

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

Error Handling/Recovery

[edit | edit source]

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

Containers

[edit | edit source]

<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.>

Algorithms

[edit | edit source]

<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 collection

[edit | edit source]

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

Physical Structure

[edit | edit source]

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

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

Web References

[edit | edit source]

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

Books and Articles

[edit | edit source]

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