Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Revision History

DateVersionDescriptionAuthor
<dd/mmm/yy><x.x><details><name>

Table of Contents

[1. Introduction](#1. Introduction)

[1.1 Purpose](#1.1 Purpose)

[1.2 Scope](#1.2 Scope)

[1.3 Definitions, Acronyms and Abbreviations](#1.3 Definitions, Acronyms and Abbreviations)

[1.4 References](#1.4 References)

[1.5 Overview](#1.5 Overview)

[2. Code Organization and Style](#2. Code Organization and Style)

[3. Comments](#3. Comments)

[4. Naming](#4. Naming)

[5. Declaration](#5. Declaration)

[6. Expressions and Statements](#6. Expressions and Statements)

[7. Memory Management](#7. Memory Management)

[8. Error Handling and Exception](#8. Error Handling and Exception)

[9. Portability](#9. Portability)

[10. Reuse](#10. Reuse)

[11. Compilation issues](#11. Compilation issues)

[12. Annex: Summary of Guidelines](#12. Annex: Summary of Guidelines)

Programming Guidelines

1.                  Introduction

[The introduction of the Programming Guidelines should provide an overview of the entire document. It should include the purpose, scope, definitions, acronyms, abbreviations, references, and overview of the Programming Guidelines.]

1.1               Purpose

[Specify the purpose of the Programming Guidelines.]

1.2               Scope

[A brief description of the scope of the Programming Guidelines; what Project(s) it is associated with, and anything else that is affected or influenced by this document.]

1.3               Definitions, Acronyms and Abbreviations

[This subsection should provide the definitions of all terms, acronyms, and abbreviations required to properly interpret the Programming Guidelines.  This information may be provided by reference to the project Glossary.]

1.4               References

[This subsection should provide a complete list of all documents referenced elsewhere in the Programming Guidelines. Each document should be identified by title, report number (if applicable), date, and publishing organization. Specify the sources from which the references can be obtained. This information may be provided by reference to an appendix or to another document.]

1.5               Overview

[This subsection should describe what the rest of the Programming Guidelines contains and explain how the document is organized.]

2.                  Code Organization and Style

[A description of the size of a module, layout of a module, space, nesting, legibility, and so on.]

3.                  Comments

[A description of the use of comments.]

4.                  Naming

[A description of how each kind of entity (such as types, variables, and subprograms) should be named.]

5.                  Declaration

[A description of how declarations should be written.]

6.                  Expressions and Statements

[A description of how expressions and statements should be written.]

7.                  Memory Management

[A description of how memory should be managed.]

8.                  Error Handling and Exception

[This section gives rules and guidelines on how error handling and exceptions should be handled.]

9.                  Portability

[This section describes special rules to ensure portability across different platforms and compilers.]

10.             Reuse

[This section gives rules and guidelines to foster easier reuse.]

11.             Compilation issues

[This section describes dependencies between modules, compiler directives, and so on.]

12.             Annex: Summary of Guidelines

[This section summarizes all guidelines; one line for each.]