Index: /trunk/doc/VBox-CodingGuidelines.cpp
===================================================================
--- /trunk/doc/VBox-CodingGuidelines.cpp	(revision 44114)
+++ /trunk/doc/VBox-CodingGuidelines.cpp	(revision 44115)
@@ -272,5 +272,6 @@
  *        vertical space on debug logging).
  *
- *      - Comments should try stay within the usual 80 columns.
+ *      - Comments should try stay within the usual 80 columns as these are
+ *        denser and too long lines may be harder to read.
  *
  *      - Curly brackets are not indented.  Example:
@@ -402,4 +403,11 @@
  * @subsection sec_vbox_guideline_optional_prefix   Variable / Member Prefixes
  *
+ * Prefixes are meant to provide extra context clues to a variable/member, we
+ * therefore avoid using prefixes that just indicating the type if a better
+ * choice is available.
+ *
+ *
+ * The prefixes:
+ *
  *      - The 'g_' (or 'g') prefix means a global variable, either on file or module level.
  *
@@ -435,4 +443,11 @@
  *        count of bytes in block.
  *
+ *      - The 'cx' prefix means width (count of 'x' units).
+ *
+ *      - The 'cy' prefix means height (count of 'y' units).
+ *
+ *      - The 'x', 'y' and 'z' prefix refers to the x-, y- , and z-axis
+ *        respectively.
+ *
  *      - The 'off' prefix means offset.
  *
@@ -441,5 +456,6 @@
  *
  *      - The 'i[1-9]+' prefix means a fixed bit size variable.  Frequently
- *        used with the int[1-9]+_t types.  [type]
+ *        used with the int[1-9]+_t types where the width is really important.
+ *        In most cases 'i' is more appropriate.  [type]
  *
  *      - The 'e' (or 'enm') prefix means enum.
@@ -448,5 +464,7 @@
  *
  *      - The 'u[1-9]+' prefix means a fixed bit size variable.  Frequently
- *        used with the uint[1-9]+_t types and with bitfields.  [type]
+ *        used with the uint[1-9]+_t types and with bitfields where the width is
+ *        really important.  In most cases 'u' or 'b' (byte) would be more
+ *        appropriate.  [type]
  *
  *      - The 'b' prefix means byte or bytes.  [type]