タグ

Perlとdocumentationに関するraimon49のブックマーク (2)

  • manがあるコマンドは偉いし、manを付けるべき - Lambdaカクテル

    社内で、crontabのtabは実はtableだからクーロンタブじゃなくてクーロンテーブルなんだよね、という話が盛り上がった。 ファクトチェックとして、crontab(5)が紹介されていた(cron tableという言葉が出現している)。 manで事実確認がすぐできてすごいと思う一方、それを可能たらしめているmanもありがたいと思った。 man(1) とかの数字って何? 意外なものにmanがある 最近のコマンドにman pageが無い件 manまわりのコマンドの紹介 man(1) とかの数字って何? ちなみに、manのマニュアルやコマンド自体をアドレスするときに使うman(1)といった記法のカッコ内の数字は、manのセクション番号である。 コマンドと設定ファイルが同名であることがしばしばあるため、カッコ内にセクション番号を書くことで識別できるようにしている(例えば、crontab(1)はそ

    manがあるコマンドは偉いし、manを付けるべき - Lambdaカクテル
    raimon49
    raimon49 2022/10/13
    >山崎春のman祭りみたいなのを定期的に開催して、man pageが無いコマンドにman pageを付けていくといった活動が必要。
  • 礼儀正しさ重要(Good Manners Matter 日本語訳)

    以下の文章は、Rich Bowen による Good Manners Matter(Open Advice に収録)の日語訳である。 Rich Bowen は、約15年もの間フリー/オープンソースソフトウェアに携わってきた。その時間の大半は Apache HTTP Server に費やしてきたが、PerlPHP やいろんなウェブアプリケーションにも取り組んできた。彼は『Apache Cookbook』や『The Definitive Guide to Apache mod_rewrite』他いろんなの著者であり、様々な技術カンファレンスに頻繁に参加している。 僕は2000年の9月に Apache HTTP Server のドキュメンテーションプロジェクトに携わり出した。少なくとも、僕が初めてドキュメントをコミットしたのはそのときだった。それ以前は電子メールでいくつかパッチを登録し

    raimon49
    raimon49 2012/06/21
    >僕がオープンソースのドキュメンテーションに何年も携わって学んだのは、ドキュメンテーションの専門家、またより一般的にはカスタマサポートの専門家にとっての三大美徳は、怠惰、忍耐、そして謙虚であるというこ
  • 1