コーディングスタイル (Kazehakase-devel) - Kazehakase

zoeです。

On Sun, 02 Feb 2003 03:11:31 +0900
Takuro Ashie <ashie****@homa*****> wrote:

> 足永です．

お待ちしてました(笑

> KazehakaseやKazehakaseEmbed等はkazehakase-type.hで構造体が定義/宣言され
> それを操作する関数群はkazehakase.hでプロトタイプ宣言されていますが
> (SipStoneのスタイルをそのまま継承?)ソースの規模がある程度以上になると，
> このスタイルではコードの見通しが悪くなりますし，保守も面倒になります．
> 
> 一般的に見やすいとされるスタイルは
> 
> * 一つのCソースファイル(*.c)に対しては基本的に同名のヘッダファイル(*.h)
>   を用意し(例外はありますが)，Cソースファイル内で定義された関数のうち，
>   外部に公開する関数はヘッダファイルに記述し，公開しない関数はstaticを
>   付けて，必要ならばCソースファイルの先頭で宣言する
> 
> * ファイル名と関数群のプレフィックスを揃える
> 
> てな感じだと思います．特にKazehakaseやKazehakaseEmbedのように状態を保
> 持する構造体が存在する場合，自然とオブジェクト指向的な記述になりますか
> ら，この辺りのスタイルの持つ意味は重要です．
> (こういったスタイルが日本語で明文化されている文書としては，例えばMAlib
> のドキュメント http://www.malib.net/api/ja/node2.html が綺麗にまとまっ
> ています)
> 
> というわけで，そのように修正しちゃってよろしいでしょうか?

ありがとうございます。そのドキュメントを読んでおきます。修正も足永さんの意のまま
にやっていただいて結構です。というか、うれしいです。


> あと，Emacs使いとしては，ファイルの先頭に
> 
> /* -*- Mode: C; tab-width: 8; indent-tabs-mode: t; c-basic-offset: 8 -*- */
> 
> とか入ってると嬉しいのですが，これも併せてやっちゃってよろしいでしょう
> か?

ああ、これEmacs用だったんですね。どうぞお願いします。
これってjedでも効くのかな？
やってみたけど効きませんでした。。がくり。

Kazehakase

[Kazehakase-devel] コーディングスタイル