hoge diary - February 12, 2007

[雑記] ユーザーズマニュアル

今回はただのぼやきです.情報量は 0 です.ご注意ください.

さて,今,自分自身が大学の研究のために作ったプログラムを後で見た人が動かせるようにするべく,ユーザーズマニュアルを書いていますが,これがまた面倒です.

リファレンスマニュアルなら Doxygen が自動生成してくれますが,ユーザーズマニュアルとなると... やはり手で書くしかないわけです.

コンパイルやインストール方法などは Autotools (Autoconf/Automake/Libtool) を使ってるので,お決まりの 3 行:

% ./configure
% make
% make install

で済むので割と楽(実際には ./configure に渡すオプションの説明も書きます)ですが.

ソースコードからユーザーズマニュアルを自動的に生成するソフトがいつの日か出ることを期待しつつ,その日が来るまでひたすら手でマニュアルを書くことにします.

コメント

p2 (posted on: Sat Feb 17 00:15:57 JST 2007)

昔はドメインを取ると住所とかをwhoisでさらされていたのに...。
個人情報保護法万歳という感じ。
.jp よりも .com とかの方が安いと思うです。

pakuchan (posted on: Sat Feb 17 13:23:54 JST 2007)

やはり whois をチェックしましたか.
もちろん .com やら .net も考えました.でも .jp に高級感を感じてしまい,奮発しました.

名前(何でも可):

テキスト(http:// を含む内容は投稿できません):

トラックバック

トラックバック URI: https://www.pakunet.jp/hoge/trackback/2007021201

トラックバックはありません.


Valid XHTML 1.1! Valid CSS!
© 2004-2009 ぱくちゃん.
Last modified: Thu Nov 01 01:17:15 JST 2007