The two (at least) forms of documentation

The problem with GNU Texinfo is not that it is a bad format fordocumentation as such. The problem is what sort of documentationgets written in GNU texinfo format.

To simplify, there are at least two forms of documentation: tutorialsand references. Where I draw the line between the two is that is thattutorial documentation is intended to be read from start to finish,while reference documentation is intended to be skimmed and skippedthrough.

Writing something as a tutorial has at least three effects that arerelevant here:

  • it

讀者自理

1.《潮爆中國》新書發佈跨媒體秀
作者:李照興
主持:李照興
嘉賓:黃源順、曾凡
日期:4月19日(星期六)
時間:2:30pm
地點:Kubrick 書店 (油麻地眾坊街3號駿發花園百老匯電影中心旁)

2.《書到用時》新書發佈會

The limits of isolated interfaces

So you've carefully isolated your management interfaces , making sure that packets can't leak fromone side to another because they literally can't see the other side.You're safe, right?

Well, not quite. While an attacker can't get their own packets across toyour management interface, they may still be able to trick things onyour machine into generating outgoing packets for them. There's a numberof cases:

  • packets with a management origin to your management IP: this should

夫復何求


終於追到梁文道的稿之後,突然連電影節飛都搵番。所謂求全之毀。幸而還有牯嶺街和三套褒曼,就算是火場裡搶救回來的了。

千金小姐

(明報週二世紀版自尋短見)


《腹稿》銷量不俗,大家都期待今年 葉愛蓮 會出版新作。在香港市場,《腹稿》介乎流行文學與嚴肅文學之間,我寧可把它歸類為流行文學裡的優秀作品——若香港有一個更開闊更有品味的大眾市場

宰羊人 (Killer of Sheep)



看《宰羊人》(Killer of Sheep, 1977) , 是一次與別不同的觀影體驗.
習慣娛樂性豐富的電影, 承受藝術電影的悶藝. 根據表面證據, 《宰羊人》是後者. 比較其他藝術電影的事先張揚, 《宰羊人》卻十分內斂. 由頭到尾, 也許不
Continue reading...

The appeal of GNU tools

I admit that every so often the freakish superintelligence of the GNUversions of programs has its appeal. Consider, say, units :

You have: 7 feet + 2.5 inchYou want: mm        * 2197.1        / 0.00045514542

GNU date is another good one:

; date -d 'last sunday'Sun Apr 13 00:00:00 EDT 2008

Or even better:

; date -d

My secret mouse fear

One of my little computer terrors is that someday I won't be able tofind good quality plain three button mice any more, because everyonewill have stopped making them. In fact it may already be too late to getdecent USB three button mice, which worries me; although I have a stashof PS/2 ones, I may someday have to migrate to a USB-only machine.

(Searching the web is basically no help in finding out, and since I havea reasonably large stash of suitable


「沒有玫瑰的花店」主題曲

日本樂壇真的有趣,很難想像,一位像山下達郎這類的創作歌手,可以由60年代唱到今時今日,還要久不久為年輕偶像度身訂造新歌,又或者親自出手,主唱人氣日劇主題曲,真係Out都未Out過。

能夠受到跨年代樂迷的喜愛,正


恐怖的人群

反對輸入外勞的勞動者心聲,我們聽過。反對同工不同籌的呼籲,我們也聽過。但很少人會聽聽外勞的心聲,也很少人會了解他們在澳門面對的是厚待還是剝削。不了解他們的生活,不明白人家的文化,卻總是對他們仇視或歧視