儲存庫 vbox 的更動 62705

時間撮記:

2016-7-29 下午08:18:30 (8 年 以前)

作者:

vboxsync

訊息:

CodingGuidelines: Reverted r109277 (PC) and clarified 'c' instead which was my actual intention.

檔案:

• trunk/doc/VBox-CodingGuidelines.cpp (修改) (4 筆差異)

trunk/doc/VBox-CodingGuidelines.cpp

@@ -60 +60 @@
  *        them from defines.
  *
- *      - Pointer typedefs start with 'P'.
+ *      - Pointer typedefs start with 'P'. If pointer to const then 'PC'.
  *
  *      - Function typedefs start with 'FN'. If pointer to FN then 'PFN'.
@@ -511 +511 @@
  *
  *      - The 'c' prefix means count.  For instance 'cbBlock' could be read,
- *        count of bytes in block.
+ *        count of bytes in block. (1)
  *
  *      - The 'cx' prefix means width (count of 'x' units).
@@ -583 +583 @@
  *      - The 'pcsz' prefix is used to indicate constant string pointers in
  *        parts of the code.  Most code uses 'psz' for const and non-const
- *        string pointers.
+ *        string pointers, so please ignore this one.
  *
  *      - The 'l' prefix means (signed) long.  We try avoid using this,
@@ -594 +594 @@
  *        long' on 64-bit non-Windows platforms and can cause confusion.
  *        Alternatives: 'u' or 'u32'.  [type]
+ *
+ *
+ * (1)  Except in the occasional 'pcsz' prefix, the 'c' prefix is never ever
+ *      used in the meaning 'const'.
  *
  *