# HG changeset patch
# User "Yann E. MORIN" <yann.morin.1998@anciens.enib.fr>
# Date 1255368710 -7200
# Node ID f8143840971d9619f7dd9e27bf4562861a0d99e9
# Parent  2b43f4952b53b8dde56a7e8f82db75a9a5524a48
docs: adding naming conventions for crosstool-NG

diff -r 2b43f4952b53 -r f8143840971d docs/overview.txt
--- a/docs/overview.txt	Mon Oct 12 19:25:41 2009 +0200
+++ b/docs/overview.txt	Mon Oct 12 19:31:50 2009 +0200
@@ -11,6 +11,7 @@
 
 Introduction
 History
+Referring to crosstool-NG
 Installing crosstool-NG
   Install method
   The hacker's way
@@ -117,6 +118,41 @@
 made it available to the community, in case it was of interest to any one.
 
 
+_____________________________
+                            /
+Referring to crosstool-NG  /
+__________________________/
+
+
+The long name of the project is crosstool-NG:
+  * no leading uppercase (except as first word in a sentence)
+  * crosstool and NG separated with a hyphen (dash)
+  * NG in uppercase
+
+Crosstool-NG can also be referred to by its short name CT-NG:
+  * all in uppercase
+  * CT and NG separated with a hyphen (dash)
+
+The long name is preferred over the short name, except in mail subjects, where
+the short name is a better fit.
+
+When referring to a specific version of crosstool-NG, append the version number
+either as:
+  * crosstool-NG X.Y.Z
+    - the long name, a space, and the version string
+  * crosstool-ng-X.Y.Z
+    - the long name in lowercase, a hyphen (dash), and the version string
+    - this is used to name the release tarballs
+  * crosstool-ng-X.Y.Z+hg_id
+    - the long name in lowercase, a hyphen, the version string, and the Hg id
+      (as returned by: ct-ng version)
+    - this is used to differentiate between releases and snapshots
+
+The frontend to crosstool-NG is the command ct-ng:
+  * all in lowercase
+  * ct and ng separated by a hyphen (dash)
+
+
 ___________________________
                           /
 Installing crosstool-NG  /