[問題] Recommended C coding standards 6ed

[zzss2003 (brotherD)]

圖片:https://imgur.com/a/kopJm

嗨，各位好。小弟最近在唸網路上的Recommended C Style and Coding Standards，想說
可以提高程式的可攜性、簡易debug難度等等。唸到一些覺得跟自己觀念上有矛盾的內容，
想請教各位的看法。


首先先描述這個file的用途、作者、版本等等，這個沒問題，第二個是放header file，也
沒問題。

第三點，Any defines and typedefs that apply to the file as a whole are next.這
句我聽不太懂是什麼意思。我自己的作法是把defines跟typdefs都放在同一個header檔，
然後main.c再include起來。那如果我是用這種方式的話，照作者的意思就是要把這個
header檔的順序排在最後一個囉?

第四點畫紅線的部分我看不懂，不曉得有版友可以給個例子嗎?


謝謝各位!

--
※ 發信站: 批踢踢實業坊(ptt.cc), 來自: 60.248.26.157
※ 文章網址: https://www.ptt.cc/bbs/C_and_CPP/M.1515393504.A.CE8.html
→ MOONRAKER: 紅線是你自己畫的？
是
→ dannypsnl: 應該是接下來放適用於整個文件的defines跟typedefs的意
→ dannypsnl: 思
推 Raymond0710: 只有這.c檔用到的define typedef放在所有#include後
奇怪，我記得我有放縮網址，怎麼點進來後不見了@@
※ 編輯: zzss2003 (60.248.26.157), 01/09/2018 09:17:44
推 LPH66: 縮網址是 ppt 的話請換一家
我是用Imgur
※ 編輯: zzss2003 (60.248.26.157), 01/09/2018 14:19:31
→ MOONRAKER: 還是看不到紅線啦 什麼都沒看到
拍謝!已補上!
※ 編輯: zzss2003 (60.248.26.157), 01/10/2018 09:53:58
→ phishingphi: 目前我看到的紅線文字為 If a set of defines
→ phishingphi: applies to a particular piece of global data
→ phishingphi: (such as a flags word), the defines should be
→ phishingphi: immediately after the data declaration or
→ phishingphi: embedded in structure declarations, indented to
→ phishingphi: put the defines one level deeper than the first
→ phishingphi: keyword of the declaration to which they apply.
→ phishingphi: 不負責的解讀成某個資料結構先宣告出來，那些相關的
→ phishingphi: defines出現的位置，要嘛是在那個 data structure 後
→ phishingphi: 不然就是 embedded 在 structure 裡面並且縮排。
→ phishingphi: 比如說一個 struct audit_context 用某個 enum
→ phishingphi: audit_context 表示其狀態，他應該在規定那個 enum
→ phishingphi: 出現的次序為何
→ phishingphi: enum 應該出現在那個 struct 之後或者包在 struct 內
→ phishingphi: 並且要縮排一層
→ phishingphi: 額剛剛看了第三段，他的defines 好像是 macros 那麼
→ phishingphi: 就把例子裡的enum改成#define 不過大概的意思是那樣
→ phishingphi: 沒改變