色々日記（ざ・めも）

検索条件

全8件 (1/1ページ) 記事本文を表示

2004/08/31(火)doxygen スタイルシート

2004/08/31 01:00 PC（プログラミング）

スタイルシートちょっとお勉強して、doxygen.cssを書き換え。
書き換えたdoxygen.cssはc:\online\doxygen\に置いた。
これを指定してdocumentを作る場合は、設定ファイルに

HTML_STYLESHEET        = c:\online\doxygen\doxygen.css

を指定する。

H2 {
&nbsp&nbsp padding: 0px 0px 2px 4px;
&nbsp&nbsp font-family: Geneva, Arial, Helvetica, sans-serif;
&nbsp&nbsp color: White;
&nbsp&nbsp background-color: DarkBlue;
}

グループセクション名が目立たないので、反転系に。

.mdescRight {
       padding: 2px 8px 4px 20px;
&nbsp&nbsp font-size: 12px;
/*&nbsp&nbsp font-style: italic; */
&nbsp&nbsp background-color: #FAFAFA;
&nbsp&nbsp border-top: 1px none #E0E0E0;
&nbsp&nbsp border-right: 1px none #E0E0E0;
&nbsp&nbsp border-bottom: 1px none #E0E0E0;
&nbsp&nbsp border-left: 1px none #E0E0E0;
&nbsp&nbsp margin: 0px;
}

目次部の簡略説明がどうにも見にくいので、文字小、イタリック無し、paddingで偽インデント。

b {
&nbsp&nbsp border-bottom: 2px Solid MediumSlateBlue
}
dd {
&nbsp&nbsp padding-top: 6px;
}
em {
&nbsp&nbsp color: #BB0000;
&nbsp&nbsp font-style: normal;
&nbsp&nbsp font-weight: bold;
}

上記は相当強引。

&ltb&gtは"引数"、"返り値"などの見出し用。太めのアンダーライン付加。
&ltdd&gtは"引数"等の説明用。上の見出しとちょっと離した。
&ltem&gtは引数名のピックアップ用。斜体になって見づらかったので、濃いめの赤、普通字体、強調表示とした。

スタイルシートってこの程度しかできないんだっけか。勉強不足だな。うーん。

コメント（0件）

2004/08/31(火)doxygenあれこれ

2004/08/31 01:00 PC（プログラミング）

色々いじってみたのでメモ。

とりあえず、当面我が家でのコメントの書き方。

//! ジャンル判定２（曖昧）
(*!
	@par
	指定文節のかっこを除去した文字列が、あらかじめ読み込んでおいたGenreList中の文字列に”含まれる”かどうかを判定する。
	@param id [in] 文節番号
	@return 含まれるならばTrue、そうでないならFalse
*)

procedure / function...

//! 簡略説明

/*! */ 詳細ブロック

@par 詳細説明（doxygen本来の規定では@parは必要ないが、つけないと簡略と区切りが分からなくなる）

@param 引数

@return 返り値

@note 覚え書き

@bug バグ

重要なのはここらあたりだろう。出来れば詳細ブロック内でもHTMLタグは書きたくない。
どちらがメジャーか分からないが、JavaDocよりはQtスタイルで良し。
参考： http://members.at.infoseek.co.jp/sakura_editor/comment-rule.html

引数には、[in],[out],[i/o]を書けという指示があったがデファクトだろうか？　（doxygenではピックアップされない）

ところで、関数説明部のタグは&ltdl compact&gtとなっている。そのため、短いパートによっては行変えが行われないなどなんかいまいちな仕様。compactは推奨されないはずでは？　ソースのhtmlDocVisitor.cppをいじれば何とかなりそうではあるが、やりたくない以上に今コンパイル環境がない。まあ、やりたくなったら。あ、BCBでいけるか？

さて、スタイルシートもいじったのだが、長くなりそうなので次項に回す。

コメント（0件）

2004/08/30(月)doxygen + Delphi

2004/08/30 00:00 PC（プログラミング）

for doxygen 1.3.8

Delphi(Object Pascal)のソースをdoxygenでドキュメント化させてみようと思い立つ。
doxygenはデフォルトではpascalのソースに対応していないが、pas2doxというツールがある。こいつはpascalのソースをCっぽいソースに変換してくれる。あとはdoxygenに渡すだけである。

ところが、単体のファイルをコマンドラインでちまちまやるとできるのに、doxygenに一括で処理させると上手くいかなかった。設定ファイルの書き方に注意が要る。

以下、上手くいったときのdoxygenファイル抜粋。

#---------------------------------------------------------------------------
# configuration options related to the input files
#---------------------------------------------------------------------------
INPUT                  = d:\renamer
FILE_PATTERNS          = *.c \
                         *.cc \
                         *.cxx \
                         *.cpp \
                         *.c++ \
                         *.java \
                         *.ii \
                         *.ixx \
                         *.ipp \
                         *.i++ \
                         *.inl \
                         *.h \
                         *.hh \
                         *.hxx \
                         *.hpp \
                         *.h++ \
                         *.idl \
                         *.odl \
                         *.cs \
                         *.php \
                         *.php3 \
                         *.inc \
                         *.m \
                         *.mm \
                         *.pas
RECURSIVE              = YES
EXCLUDE                = 
EXCLUDE_SYMLINKS       = NO
EXCLUDE_PATTERNS       = 
EXAMPLE_PATH           = 
EXAMPLE_PATTERNS       = *
EXAMPLE_RECURSIVE      = NO
IMAGE_PATH             = 
INPUT_FILTER           = c:\online\doxygen\bin\pas2dox.exe
FILTER_PATTERNS        = 
FILTER_SOURCE_FILES    = YES

FILE_PATTERNSに*.pasを追加し、FILTER_SOURCE_FILES = YESにする。

注意点は、INPUT_FILTER, FILTER_PATTERNSに関して。

・INPUT_FILTER
コマンドパスを書くときに、""（ダブルクォーテーション）,クォーテーション無しはOK。''（シングルクォーテーション）は×。

コマンドはフルパスで書く必要がある。(doxygenのフォルダ)/binに置いても、フルパスでないとダメなようだ。エラーメッセージ出せよ……

・FILTER_PATTERNS
新しいオプションのようだ。*.pas、"*.pas"等指定してもうまくいかない。

d:/renamer/FileNameAnalyze.pas:23: Warning: Found ';' while parsing initializer list! (doxygen could be confused by a macro call without semicolon)

というエラーが延々出てしまう。軽く調べてみたが、書き方のサンプルも見つからない。機能していないのだろうか？　今のところ、空白にしておくのが正解のようだ。

コメント（0件）

2004/08/28(土)GetClientRectの謎

2004/08/28 20:00 PC（プログラミング）

知り合いにきかれたので調べたのだが、私も迷宮に迷い込んでしまった。
さっさと、メモって忘れてしまおう。

GetClientRectで取得した短形領域を子フォームのWindows Sizeに指定すると、子フォームのサイズがクライエント領域から少しはみ出す問題。

API自体大して知らないので、表示の方から逆に調査してみることにした。
適当にDelphiアプリを作って、色々いじってみる。

まず、CapCapで取得したフォームの全体サイズが1088x750だった。
BoundsRectでWindow Sizeを取得すると、ltrbが192,107,1280,857で返ってくるのでサイズは合っているようである。TRectの基準はどうもよく分からないが、left-right=Widthなので、TopLeftが左上ピクセル端、BottomRigthが右下ピクセル端に1pixelずつずらした点だろうか。

さて、GetClientRectだと、lrtbが0,0,1080,723である。GetClient領域の描画エリアの幅がタイトルバーの青く色が変わっている部分と同じ幅で、描画できるエリアはそれより少し狭い。

これをMDI子フォームのWindowサイズに指定すると若干はみだし、それぞれ幅、高さそれぞれ-4するとぴったり。枠線幅の分だろうか？　枠線の幅は所得できるが、確証がもてない。

なぞ

眠くて何書いてるのか分からない……

コメント（0件）

2004/08/28(土)Ruby動かすまで

2004/08/28 00:00 PC（プログラミング）

Rubyで書いたCGIを動かすにあたり、Apacheの設定は特に追加しなくても通りました。

注意点として、Samba経由だとサクラエディタで保存時に改行コードをLF(Linux)にしないと、

bad interpreter

といわれて怒らります。Sambaの設定で変えられると思うんですけどね。

なおもちろん実行属性が必要なので、Sambaだけでは無理。WinSCPを一緒に立ち上げながら作業すると良いでしょう。なお、Internal Server Errorでログに

malformed header

と出るときは、"Content-Type:html/text; charset=Shift_JIS"の出力忘れだ！

ええい！　……思わずShift_JISにしてしまったけど、何で統一するのがベストなんだっけ。WebだとUTF-8だっけか。

コメント（0件）

2004/08/23(月)eperl ? embperl?

2004/08/23 16:00 PC（プログラミング）

eRubyと同様に、html等に埋め込めるPerlを調べてみた。

さて、まず規格乱立である。この時点でやる気をなくさせる。

eperlとembperlが比較的メジャーなようだが余りWEBドキュメントがない。うーむ。

而して、Rubyとなると見やすいリファレンスが見つかっておらずまだ導入にためらいがある。

Perlポケットリファレンスはそこそこに使えるんだよなあ……

コメント（0件）

2004/08/22(日)Delphi ListView挙動色々

2004/08/22 05:00 PC（プログラミング）

・ListView.Canvas.Brush.Color

等を変更した場合、

ListView.Canvas.Refreshしないと反映されないことがある。再現性は不明。とりあえず、心に留めてテスとしながら作っていくほか無いようだ。

・ListViewにはDoubleBufferedプロパティがある。結構ちらつきに効きます。こんなの知らなきゃ分からないですよ。

・Brush.Style を bsCross等にして、ListView.Canvas.FillRectするとなぜか十字線の隙間が真っ黒に！
Pen.StyleをpsClear(透明)にして、Canvas.Rectangleするしかなさそう……　何だろうこの仕様。

・ListViewのデフォルトの表示に何か付け足そうと思ったら、すなおにListView1.CustomDrawItemを全部書いた方がよい。なぜかというと、ListView本来の描画に重ね書きするのは存外に難しいのだ。この際、OwnerDraw := True, OwnerData := True, で、OnDataには何も書く必要はない(OnDataは本来のListViewの表示にオリジナルのデータを載せたいときのもの)。CustomDrawItemで、DefaultDrawをFalseにしておく。

・OwnerData等の時、OnSelectItemで送られてきたItemのItem.Indexを取るとAccessViolationするようだ。仕様は不明だが、OnMouseDown等で座標から辿るか、ListView1.Focuced等で逆から辿ることで代用する。

・ListViewでOnColumnClickが２回連続で発生してしまっていた問題。原因はListViewのWndProc（ウィンドウプロシージャ）をオリジナルの物で上書きしていたから。これは、確か多値チェックを実現するために導入したはずだったが、現在は必要なくなっていた。この部分を削除すると正常に１回発生に戻った。他のイベントが正常だったため原因の切り分けに時間がかかった。起こらないようにするための手法は分かっていない。WINDOWS APIをよく理解していない所為で、本来なら真っ先に勉強しなきゃいけないのだが、今そんな時間がない。分からなくてもやっていくしかない。

コメント（0件）

2004/08/19(木)ShellTreeView!

2004/08/19 02:00 PC（プログラミング）

エクスプローラっぽい画面であるところのShellTreeView。

Delphi付属のサンプルタブにある時点でなにやら怪しい気がしますが、6の頃からどうもバグとかがあって評判は悪いです（こういうところがDelphiがメジャーになれない理由）。

んでー、RootプロパティがTRoot型=Stringなのですね。これだと、どうやってマイコンピュータとかをトップにするのか分かりません。実用上というか、初期設定はデスクトップなのでマイコンピュータにしたいだけなのですが……　リファレンスガイド本見ると、rfMyComputerとかで設定できると書いてあるのですが、出来ない気配ですん。で、非常に情報が少ないのもDelphiのマイナスポイント。ML探してもようとして見つかりません。しゃあないので断念です。VCL_BAに書いてないと手が出ないな……

DirectoryListBox,DriveComboBoxを使うことにいたしましょう。いや実際速度的な話ならこちらの方が圧倒的に早いです。アイコンイメージを読み込まないですし、検索にも行かないので。問題かなと思うのは、長いディレクトリで横スクロールバーが出ないと。うーん。

コメント（0件）

		2004/08
日	月	火	水	木	金	土
1	2	3	4	5	6	7
8	9	10	11	12	13	14
15	16	17	18	19	20	21
22	23	24	25	26	27	28
29	30	31