The problems of over-documenting things

There is a certain school of thought in system documentation thatbelieves, to stereotype things, that there is no such thing as being tooexplicit or having too many examples. Much of Sun's Solaris documentationmakes a great example for this school.

Unfortunately, these people are wrong. There is such a thing as toomuch documentation, because having too much has a number of problems:

  • your documentation becomes less and less readable, as the importantthings are buried under a flood of examples, cross references,and low

必須旗幟鮮明地反對笨柒

今天四月二十六日,一九八九年「4.26人民日報社論」發表20年,題目是「 必須旗幟鮮明地反對動亂 」。當年這篇社論激起民憤的程度我還記得。裡面有些句子如「 甚至十年改革取得的巨大成果都可能喪失殆盡,全民族振

五號機真貌

電擊 Hobby 的六月號,刊有接下來新的 EVA 2.0《破》的人物和機體介紹,五號機隆重登場了:

其實在上一波的 裏,在不夠一秒的瞬間是有出現的,但總不夠這個清清楚楚。這個設計,令我想起 Tachikoma 的「輪子」腳…

Continue reading...

你要往哪兒去?

阿力吃力地按著鼻子,彷彿對此間空氣已經忍無可忍,他的呼吸漸漸急促,腦袋似被人用鐵錘猛烈打擊一般劇痛。

“我在這裡活不下去了,真的太辛苦了。”他大叫大嚷:“這裡有太多令人不舒服的東西,我一定要離開這個鬼地

玫瑰的美兒



劉美兒來到太子,找我午飯。我們去吃壽司,我發現原來這樣會令她吃得比較多。這幾天的確是吹面不寒楊柳風,但雨下得不止沾衣欲濕,我是家裡開窗都不知要帶傘的人,一下樓就後悔,而美兒對雨勢的評論是「還不知要不要

預祝www.ericayuen.com 瀏覽人數過一百萬

感覺像自己宣布自己生日一樣肉麻。

oh well, 高興的事不怕肉麻!!

=D

阿叔。。。

小學同學特意打來說,“袁彌明,你寫一篇關於阿叔的文章啦。我個心好唔舒服。”

他是球迷,阿叔伴他成長。阿叔的離去,無疑是將他生命中的一部分永久刪除。嚴重至此?是的。觀眾與螢幕中人透過媒體產生的感情,其實與

Lighttpd, CGIs, and standard error

Here's an issue that I ran into recently: from version 1.4.20 onwards,lighttpd has stopped passing stderr to CGI processes, should onebe peculiar enough to run CGIs on lighttpd ( which can be done ). If you need error logging from your CGIs, you will haveto roll something on your own.

(Fedora 10 has lighttpd 1.4.22 and so is affected by this.)

There is a bug report for this, but I don't know


A Bourne shell irritation: piping just stderr

I generally like the Bourne shell, but I will easily admit that it hasa number of things that are less than ideal. One of those less thanideal things is a peculiar omission: you cannot easily redirect just standard error into a pipeline.

This sounds like a peculiar thing to want, but there are situations where you do need to process stderrseparately; for example, you might need to timestamp all stderr outputand log it. In a hypothetical shell with this feature you could have a'timestamper' program


很少看, 很不耐煩...實在看不下去

文化評論員澄雨 (前七十年代無線電視台高層, 以評論電視製作聞名) 在《一百萬零一夜》上映時, 曾寫過一段: 我很少看印度電影, 最早接觸的是薩也哲雷的作品《阿甫》三部曲. 那已是更高層次、政治正確 的寫實, 手法是