robot
最新文章(10)
Mqskit 和其它相關工具
CPython 的 GC 二、三事
寫 Mecurial Extension 是件快樂的事!
Mozilla 台灣辨公室徵人啟事
關於 Apple 的兩項專利
core dump 之前的 frame
怎麼發出 beep 聲?
先承認你要找的是奴才吧!
程式碼要清的多乾淨?
FreeBSD 的 Thread-Local Storage 實作
首頁
新編
最新留言
Entries RSS
重要關鍵字(10)
coding (122)
Python (93)
FreeBSD (71)
WEB (61)
URL (48)
hardware (46)
javascript (36)
Linux (34)
blog (30)
C++ (16)
所有關鍵字
新增 URL
程式註解如何寫
by thinker
2 Columns
關鍵字:
coding
偶然的情況下,當我在搜尋寫作材料時,發現了這個網頁 linkname:[Source Code Comments] http://www.literateprogramming.com/quotes_sc.html 收集了十二則,來自不同書刊、不同人物,對如何寫程式註解的看法。內容囊括了 * 為什麼要寫註解? * 註解的作用方式。 * 怎麼寫 * 種類 * 內容 * 風格、流派 各個層面。 裡面也包括了一些相左、衝突的看法。例如,有些人認為程式碼本身就說明了一切,只要選定好的變數、函數等名稱,程式碼本身就足夠了。另一方面也有人提倡把所有的東西都寫進程式碼的註解裡,讓程式碼儘可能的詳盡。 寫註解,其實是一個值得探討的題目,也一直是許多程式設計師心中的痛。好奇的是,國內的程式設計師養成單位,似乎對這個議題都只是輕輕帶過,只對學生說「註解很重要」,其它就沒了。或許又是一句老話,「 linkname:[學校的老師們大多不寫程式吧!!] http://heaven.branda.to/~thinker/GinGin_CGI.py/show_id_doc/284 」。
最後更新時間: 2007-10-28 18:51:11 CST |
引用
查詢:
COMMENTS: