GCC options

C Programming - function * = void *

Generic Function Pointers In C And Void *

ISO C++ forbids casting between pointer-to-function and pointer-to-object

#344 (Jinja2 easy_install failing) - Jinja   Trac

Sphinx 0.6.2 では sphinx.builder が deprecated になったらしい

Running Sphinx v0.6.2

今度は日本語を含むドキュメントを変換しようとすると：

% find jetty-6.1.17/modules/jetty -name *.java | xargs grep -hE '^import\b' | grep -vE -e 'org\.mortbay\.' -e 'javax?\.' | awk '{ print $2 }' | sort | uniq
junit.framework.AssertionFailedError;
junit.framework.TestCase;
junit.framework.TestSuite;
org.xml.sax.Attributes;
org.xml.sax.ContentHandler;
org.xml.sax.helpers.DefaultHandler;
org.xml.sax.InputSource;
org.xml.sax.SAXException;
org.xml.sax.SAXParseException;
org.xml.sax.XMLReader;

% find jetty-6.1.17/modules/util -name *.java | xargs grep -hE '^import\b' | grep -vE -e 'org\.mortbay\.' -e 'javax?\.' | awk '{ print $2 }' | sort | uniq
junit.framework.Test;
junit.framework.TestCase;
junit.framework.TestSuite;
junit.textui.TestRunner;

% find jetty-6.1.17 -name *.java | xargs grep -hE '^import\b' | grep -vE -e 'org\.mortbay\.' -e 'javax?\.' | awk '{ print $2 }' | sort | uniq
bsh.EvalError;
bsh.Interpreter;
com.acme.Derived;
com.gigaspaces.annotation.pojo.SpaceId;
com.gigaspaces.annotation.pojo.SpaceProperty;
com.gigaspaces.annotation.pojo.SpaceProperty.IndexType;
com.gigaspaces.annotation.pojo.SpaceRouting;
com.google.gwt.user.client.rpc.AsyncCallback;
com.google.gwt.user.client.rpc.IncompatibleRemoteServiceException;
com.google.gwt.user.client.rpc.RemoteService;
com.google.gwt.user.client.rpc.SerializationException;
com.google.gwt.user.server.rpc.OpenRemoteServiceServlet;
com.google.gwt.user.server.rpc.UnexpectedException;
com.j_spaces.core.client.Query;
com.j_spaces.core.client.SQLQuery;
com.sun.grizzly.Context;
com.sun.grizzly.Controller;
com.sun.grizzly.Controller.Protocol;
com.sun.grizzly.DefaultPipeline;
com.sun.grizzly.DefaultProtocolChain;
com.sun.grizzly.DefaultProtocolChainInstanceHandler;
com.sun.grizzly.DefaultSelectionKeyHandler;
com.sun.grizzly.filter.ReadFilter;
com.sun.grizzly.Pipeline;
com.sun.grizzly.ProtocolChain;
com.sun.grizzly.ProtocolFilter;
com.sun.grizzly.SelectorHandler;
com.sun.grizzly.TCPSelectorHandler;
com.sun.grizzly.util.OutputWriter;
com.sun.grizzly.util.SelectorFactory;
com.sun.grizzly.util.WorkerThread;
com.sun.net.httpserver.Authenticator;
com.sun.net.httpserver.Authenticator...

Jetty 6.1.17 - jetty.xml

 

1. ThreadPool (org.mortbay.thread.QueuedThreadPool)

 

QueuedThreadPool は再利用できるスレッドがない場合、要求（ジョブ）をキューに保存する。

 

minThreads

 

最小スレッド数。初期値は 2。

 

maxThreads

 

最大スレッド数。初期値は 250。

 

spawnOrShrinkAt

 

キューに待機しているジョブの個数が、この設定値を超えたら新しいスレッドを生成する。また、アイドル状態で待機しているスレッドは maxIdleTimeMS が経過したあと、待機中のスレッド数がこの設定値を超えていた場合に破棄される。初期値は 0。

 

lowThreads

 

キューに待機しているジョブの個数が、この設定値を超えたら、QueuedThreadPool#isLowOnThreads が true を返すようになる。具体的には

org.mortbay.jetty.AbstractConnector.getLowResourceMaxIdleTime() を使用するかどうかの判定に使われている。初期値は 0 なので、ひとつでも待機中のジョブがあると true になる。

 

maxIdleTimeMs

 

ジョブをおえたスレッドが次のジョブが来るまでに待機する最大の時間 (ms) 。初期値は 60000。

 

maxStopTimeMs

 

0 以上の値が指定された場合、スレッド・プールの終了時に実行中のジョブが完了するまでの待機時間が maxStopTimeMS までに制限される。初期値は 0。

 

2. Connector (org.mortbay.jetty.nio.SelectChannelConnector)

 

 

maxIdleTime

 

接続の最大待機時間。次のリクエストが来るまで待機する場合や、書き込み、読み込みにも適用される。初期値は 30000

 

lowResourcesConnections

 

処理中の接続数がこの設定値を超えたら low resources 状態だと判定される。ただし、0 の場合は無効。初期値は 0

 

lowResourcesMaxIdleTime

 

low resources 状態で使われる maxIdleTime。初期値は 0

 

lowResourceMaxIdleTime

 

非推奨。SelectChannelConnector では使われていない。

 

acceptors

 

接続確立に使われるスレッド数。実際のスレッドは ThreadPool から確保される。初期値は 1

 

acceptQueueSize

 

java.net.ServerSocket.ServerSocket(int, int) に渡す backlog 引数。初期値は 0 だが、0 の場合はデフォルトが使われるので、実質的には 50 になる。

bash のカスタマイズ

 

ユーザがログインすると、すべてのユーザ共通の設定として /etc/profile が読み込まれ、次にユーザ固有の設定として ~/.bash_profile が読み込まれる。~/.bash_profile がなければ ~/.bash_login が読み込まれ、それもない場合は、~/.profile が読み込まれる。

 

.bashrc は、プロセスとしてbashを起動したときに読み込まれる。bashrc にはエイリアスのようなシェルの基本的な動作の設定を書いておき、.bash_profile にはログイン時にのみ行いたい処理を書いておけばよいわけだ。

~/.bash_aliases

 

alias l="ls -l --show-control-char"
alias la="ls -la --show-control-char"

~/.profile

 

LANG=C
LC_ALL=C
PS1="[\h:\w]\n% "

export LANG LC_ALL PS1

 

ホスト側から SSH ログインしたときに、プロンプトにホスト名が出ていた方が便利なので \h も指定

 

GRUB

 

設定ファイル：/boot/grub/menu.lst

 

% sudo vi /boot/grub/menu.lst

# Pretty colours
color cyan/blue white/blue

...

## e.g. defoptions=vga=791 resume=/dev/hda5
# defoptions=quiet splash

vga=791 は 1024x768 16bit という意味（実際には 1024*768 では大きすぎるのでデフォルトのままにしてある）

 

% sudo update-grub

 

OpenSSH

Mac のターミナルから SSH ログインして使うつもりなので、SSH サーバのセットアップを行う。Ubuntu は最小構成だが、SSH クライアントはインストールされている：

% which ssh
/usr/bin/ssh

なので、ここではサーバのみをインストールする：

% sudo apt-get install openssh-server

インストールすると自動で起動される：

% which sshd
/usr/sbin/sshd
% ps aux | grep sshd | grep -v grep
root ... /usr/sbin/sshd

また、/etc/init.d/ssh も配置してくれる。

 

公開鍵方式

 

このままだとパスワード認証になっているので、パスワード認証は無効にして、公開鍵方式のみにしたい。まずは、公開鍵をリモートに転送：

% cat ~/.ssh/id_rsa.pub | ssh -p 12345 -l hogehgoe localhost 'mkdir -p .ssh; cat >>$HOME/.ssh/authorized_keys'

 

OpenSSH サーバの設定

 

/etc/ssh/sshd_config にて設定を変更する。

 

% sudo vi /etc/ssh/sshd_config

 

ログイン猶予時間は短めにする（デフォルトでは 60 秒）：

LoginGraceTime 15

root で直接ログインできないようにする：

PermitRootLogin no

パスワード認証の無効化：

PasswordAuthentication no
PermitEmptyPasswords no

以降は Ubuntu 8.10 の OpenSSH_5.1p1 では変更の必要がなかった
rhostでの接続の無効化：

RhostsRSAAuthentication no

チャレンジレスポンス認証を無効化：

ChallengeResponseAuthentication no

ログを残す：

SyslogFacility AUTH
LogLevel INFO

変更を保存して、サーバを再起動する：

 

% sudo /etc/init.d/ssh restart

ssh-agent

 

Mac OS X 側：Leopard には ssh-agent が組み込まれているので、鍵を追加しておこう：

 

% ssh-add
Enter passphrase for /.ssh/id_rsa:
Identi...

% mvn archetype:generate -U -DarchetypeGroupId=net.liftweb -DarchetypeArtifactId=lift-archetype-blank -DarchetypeVersion=1.0 -DremoteRepositories=http://scala-tools.org/repo-releases -DgroupId=demo.helloworld -DartifactId=helloworld -Dversion=1.0-SNAPSHOT

% cd helloworld/

vi か Emacs くらい使えないと、プログラマとして認めてもらえないらしい。

年末という節目でもあるし、いい機会だ。サーバ作業でも多用する vi/vim を習得しよう。

 

     現在の習熟度：サーバ上で設定ファイルを編集するときのために基本的なコマンド（移動、編集、削除、検索／置換など）が使える程度

     目標設定：年明けまでに C++ や Python のコードが不自由なく書けるくらいにはなりたい。

 

Vim のインストール

 

Ubuntu を最小構成でインストールしたせいかもしれないけど、デフォルトでインストールされている vim は vim-tiny というパッケージで、これはパッケージサイズを小さく保つために色々と便利な機能のみならずドキュメント（ヘルプ）も含まれていない。

 

% which vi
/usr/bin/vi
% l /usr/bin/vi
lrwxrwxrwx 1 root root 20 Dec 16 18:45 /usr/bin/vi -> /etc/alternatives/vi
% l /etc/alternatives/vi
lrwxrwxrwx 1 root root 17 Dec 16 18:45 /etc/alternatives/vi -> /usr/bin/vim.tiny

 

dpkg でも確認：

 

% dpkg -l | grep vim
ii vim-common 1:7.1.314-3ubuntu3 Vi IMproved - Common files
ii vim-tiny 1:7.1.314-3ubuntu3 Vi IMproved - enhanced vi editor - compact

 

見事に vim-tiny のみ。どうせなのでフルセットの vim をインストールしておこう：

 

% sudo apt-get install vim

...

% l /etc/alternatives/vim
lrwxrwxrwx 1 root root 18 Dec 24 22:34 /etc/alternatives/vim -> /usr/bin/vim.basic

 

めでたく、vim.basic になった。

 

環境変数

いくつかの探索ルールはあるものの、:version コマンドで確認する限り、Ubuntu でのデフォルトは /usr/share/vim/vimcurrent/ である

 

コードハイライト

 

:syntax enable でコードハイライトが有効になる。

 

色が気に入らない

 

:colorscheme でスキンのように変更することが可能。選択可能なテーマは

 

% ls /usr/share/vim/vimcurrent/colors/ | grep \.vim$
...

 

常に有効にする

 

vimrc に syntax enable を追加：

 

 

自動インデント

 

vimrc

set encoding=utf-8
set autoindent
set cindent

set tabstop=2
set shiftwidth=2
set softtabstop=2
set expandtab
autocmd FileType make setlocal noexpandtab

set backupdir=$HOME/.vim/backup

let &directory=&backupdir

set hlsearch
set smartcase
set incsearch
set grepprg=ack\ --noenv\ --nogroup

 

if &term == "xterm-256color"
  set t_Co=256
" set t_AB=^[[48;5;%dm
" set t_AF=^[[38;5;%dm
endif

if &t_Co > 1
  syntax enable
  colorscheme railscasts 
endif

 

独自の colorscheme

 

~/.vim/colors/myscheme,vim

元々のファイルは Mac では /usr/share/vim/ にあった

 

colorscheme:

 

 

Mac の Terminal.app で CTRL-H が...

コマンドラインから Spotlight を操作する

% mdimport -p .
Total processing time spent in importer plug-ins: 0.114901 seconds for 3 files
Top 3 most expensive files for importer plug-ins:
1 /Users/ishikawa/Pictures/Elements/20081211: 0.060532 seconds
2 /Users/ishikawa/Pictures/Elements/20081211/20081211_0202.JPG: 0.052955 seconds

...

-p オプションを指定すると、検索に追加されたエントリ毎のパフォーマンス情報が表示される。

ボリューム単位で索引を再構築する場合は mdutil を使う

個人的に vim 勉強中なので、vim か shell から使える tips やツール限定。できれば、vim 単体で完結したコードリーディング環境を構築したい。

 

Vim

 

情報の表示

 

<C-G> 表示中のファイル名を表示

g <C-G> カーソルの位置を行番号などで表示、<S-V> で行選択モードにした方がカーソル行がハイライトされてわかりやすい

 

挿入モード

 

<C-J> 改行

<C-W> 前単語削除

<C-U> 行頭まで削除

<C-A> 直前に挿入したテキストを挿入。<C-@> は同時に挿入モードを抜ける

<C-Y><C-E> 上、または下の行から一文字コピー

<C-O> {command} 通常モードのコマンドを実行

 

編集モードへ移るためのキー

 

A 現在行の末尾に追加

O 現在行の前に行挿入

o 現在行の次に行挿入

 

便利な削除

 

di""" で囲まれたテキストを削除

da"" も含み、"" で囲まれたテキストを削除

 

y ならコピー、他にも ( とか { とか

 

 

コマンドライン行の編集で便利なコマンド

 

<C-W> 単語削除

<C-U> すべて削除

<C-P> 前の候補

 

左右の移動モーション

 

削除などと組み合わせると便利

 

f<char> 右方向に <char> まで移動（検索対象文字含む）

t<char> 右方向に <char> まで移動（検索対象文字含まない）

 

 

ファイル内検索

 

:h / （ヘルプ参照）

* カーソル位置の単語を前方検索

# カーソル位置の単語を後方検索

:set hls[earch] 検索結果をハイライト。邪魔なときは :nohlsearch でハイライト消去

:set incsearch インクリメンタル検索

:set ignorecase 大文字・小文字無視

:set smartcase 検索語が小文字のみの場合、大文字・小文字無視

 

正規表現

 

vim の正規表現は独特だが、基本的に、スターを除けばバックスラッシュをつける感じで：

 

\(...\) グループ化

\+ 1 個以上

\= 0 個か 1 個

\{n, m} 繰り返し回数指定

\| または

 

ファイル間検索

 

:vimgrep vim 独自のファイル間検索。ファイル内検索と同じように動くが遅い

:grep grep か類似の外部プログラムによる検索（後述の ack も指定できる）

 

ack を使うために

 

set grepprg=ack\ --noenv --color

 

とした。詳細は :help grep と :help quickfix 参照

 

行番号表示

 

:set nu[mber] 各行に行番号を表示

:# 挿入ポイントがある行を行番号とともに表示

 

ファイルブラウザ

 

:new . or :Sex カレントディレクトリ表示（縦）

:vnew . or :Vex カレントディレクトリ表示（横）

 

タブ表示

 

:tabe[dit] {file} ファイルを新規タブで開く

:tab {cmd} vim コマンドの実行結果をタブで開く :tab help tabedit

 

:tabp[revious] or <C-PageUp> or gT 前のタブ

:tabn[ext] or <C-PageDown> or gt 次のタブ

:tabs タブ一覧表示

 

ウインドウ分割

 

:sp 現在のファイルを分割して表示（縦）

:vsp 現在のファイルを分割して表示（横）

 

複数ウインドウ

 

:new 新規ウインドウ（縦）

:vnew 新規ウインドウ（横）

[n]<C-w><C-w> ウインドウ切り替え

<C-W> w ウインドウ切り替え

<C-w><移動> ウインドウ切り替え

 

ウインドウのサイズ変更

 

<C-W> + 高さ

<C-W> -

{height}<C-W> _

 

 

ファイルを開く

 

 

CTRL-W gf カーソル下のファイルを新規タブで開く

 

これらのコマンドの検索パスは path 変数にカンマ区切りで指定する。相対パスは ./ や ../ で始めない。カレントディレクトリは空文字、１個の . はカレントディレクトリからの相対パスという意味。e.g. :set path=.,include,/usr/include

 

 

ファイルタイプの関連づけ

 

% cat ~/.vim/ftdetect/apache.vim
au BufRead,BufNewFile *.conf            set filetype=apache

 

外部ツール

 

 

プログラマ向け grep ともいうべき、ソースコード検索に適した...

 

ユーザー：アプリケーションの利用者

サービスプロバイダー：ユーザのアカウント情報や写真など、リソースを管理する側

コンシューマー：リソースを利用し、サービスを提供する側

 

OpenSocialのOAuthまとめ

 

OAuthの署名方式を掘り下げる

 

APIアクセス権を委譲するプロトコル、OAuthを知る

あるとき push しようとしたら怒られた。

% git push origin master
To git@github.com:xxxx/xxxx.git
! [rejected] master -> master (non-fast forward)
error: failed to push some refs to 'git@github.com:xxxx/xxxx.git'

こういうときは pull してみる

% git pull origin master
...
% git push origin master

Mac OS X Leopard (10.5.6) 上に VirtualBox をインストールし、ゲスト OS として Ubuntu をインストールする。コマンドラインでの開発環境として使うことを念頭に置き、デスクトップ環境は整えない。

 

VIrtualBox

仮想マシンの作成

 

「新規仮想マシン作成ウィザード」で新しい仮想マシンを作成する：

Ubuntu のインストール

 

ダウンロードページから Ubuntu 8.10 の Server Edition (i386) をダウンロードし、MD5 チェックサムを検証する。

 

% test `md5 -q ~/Downloads/ubuntu-8.10-server-i386.iso` == a2ec9975a91e1228c8292ed9799dc302 && echo OK
OK

 

ダウンロードした ISO イメージファイルを VirtualBox で使うには、まず、仮想ディスクマネージャに登録する必要がある：

Ubuntu

 

仮想マシンを起動して Ubuntu のインストールを開始する：

"This kernel requires the following features not present on the CPI: pae" で起動しない：

VirtualBox で仮想マシンの「一般」＞「高度」＞「PAE/NX を有効にする」にチェックを入れて再起動（PAE - Physical Address Extension = 物理アドレス拡張）。

 

The VirtualBox Guest Additions

 

ゲスト拡張（Guest Additions）はデバイスドライバとシステムアプリケーションで構成され、仮想マシンに組み込むことで、ゲスト OS の機能をより使いやすいものにする。VirtualBox がサポートするすべてのゲスト OS に対するゲスト拡張は、一枚の CD-ROM イメージファイル VBoxGuestAdditions.iso で提供されている。仮想マシンにゲスト拡張を組み込むには、この CD-ROM イメージファイルを仮想 CD-ROM としてマウントし、ゲスト拡張をインストールする。

 

dkms

 

カーネルモジュールをビルドできるようにゲスト OS 側に Dynamic Kernel Module Support (DKMS) とカーネルのヘッダファイルを導入する。

 

% sudo apt-get install dkms linux-headers-2.6.27-7-server

 

VBoxGuestAdditions.iso

 

VBoxGuestAdditions.iso は /Applications/VirtualBox.app/Contents/MacOS/VBoxGuestAdditions.iso にあるのだが、Ubuntu の実行中にメニューから「デバイス」＞「Guest Additions のインストール」を実行すると、VBoxGuestAdditions.iso がマウント可能な状態になる。

そして、マウントする：

 

% sudo mount -r /dev/cdrom /media/cdrom0/

 

マウントされたディレクトリに移動し、インストールスクリプトを実行

 

% cd /media/cdrom0/
% sudo sh ./VBoxLinuxAdditions-x86.run kernel-module vfs-module control timesync

 

X11 拡張はいらないので、必要なモジュールを個別に...

最近は git ばかりで Subversion を使っていないので、Subversion によるバージョン管理で復習する

 

apt で subversion をインストール

 

% sudo aptitude install subversion

 

ローカルにリポジトリを作成

 

% svnadmin create ~/svnrepos

% ls ~/svnrepos
README.txt conf db format hooks locks

 

以下の hello ディレクトリをバージョン管理する

 

% pwd
/home/ishikawa/hello
% ls
Makefile hello.c

 

まずは定番のディレクトリ構造を作成し、import する：

 

% mkdir -p tmp/trunk tmp/branches tmp/tags

% cd tmp/

% svn import . file:///home/ishikawa/svnrepos/hello -m "initial import"
Adding trunk
Adding branches
Adding tags

Committed revision 1.

 

一次ディレクトリを削除し、さきほど import したディレクトリ構造の trunk をバージョン管理したいディレクトリにチェックアウトする：

 

% cd ..; rm -rf tmp

% svn co file:///home/ishikawa/svnrepos/hello/trunk .
Checked out revision 1.

 

バージョン管理情報を確認してみる：

 

% svn info
Path: .
URL: file:///home/ishikawa/svnrepos/hello/trunk
Repository Root: file:///home/ishikawa/svnrepos

...

% svn status

? hello.c
? Makefile

 

では、最初のコミット：

 

% svn add *
A Makefile
A hello.c
% svn commit -m "initial commit"
Adding Makefile
Adding hello.c
Transmitting file data ..
Committed revision 2.

 

まあ、このへんは問題ない

 

無視するファイル

 

Makefile は all: hello としているので、make すると hello という実行ファイルができる。

 

% make
cc hello.c -o hello
% ls
Makefile hello hello.c

 

hello はコミットしたくないので、無視するよう svn:ignore という特殊な属性をディレクトリにつけておく：

 

% svn propset svn:ignore "hello" .
property 'svn:ignore' set on '.'

% svn status
M .
M hello.c
M Makefile

 

コミット

 

% svn commit -m "Added files"
Sending .
Sending Makefile
Sending hello.c
Transmitting file data ..
Committed revision 3.

 

複数人での開発

 

複数人での開発をシミュレートするために、ホスト側でもチェックアウトしてみる：

 

% svn co svn+ssh://vbox-ubuntu/home/ishikawa/svnrepos/hello/trunk hello
A hello/hello.c
A hello/Makefile
U hello

% cd hello

 

更新 (U) や追加 (A) はわかりやすいので、変更が衝突せずにマージ (G) される、というのをシミュレートしてみる。

ホスト側とゲスト側で hello.c を変更し、ゲスト側で commit、そのあと、ホスト側で update する：

 

% svn up
G hello.c
Updated to revision 4.

 

G は merGed の G らしい

 

 

svn diff の出力を色つきで

 

svn diff foo.c | vim -R - とか colordiff とか

svn cat の出力とローカルのファイルを、vimdiff プログラムで比較するとか

自分なりにまとめてみると：

1. 既存プロダクトのコードを読みつつ、Perl っぽいコードや頻出するライブラリを学ぶ
2. 分からないところは perldoc コマンド、またはオンライン版で調べつつ、
3. 自分が作りたいものを作る

という学習方法がよさそうだ。というか、これってたぶん、他の言語でもそう。特に、他のプログラミング言語の経験があるのなら、マニュアルを一から読むよりは、上記のようにトップダウンで学んでいく方が上達が早いし、継続できた気がする。もっとも、はじめて関数型言語を使う、とかパラダイムが異なるものはマニュアルなりから入るほうがいいだろうけど。

学習の方針
上に書いたとおりなんだけど、問題は何のコードを参考に、何をつくるか：

• Catalyst や Moose は他モジュールへの依存も規模もでかくて大変そう
• Mojo は依存もすくないし、なんか最先端っぽいのでよさげ
• でも、依存がすくないということは、逆にライブラリの使い方を学ぶのには適してなさそう
• ちょうど、ライフログ的なアプリが欲しかったので、それをつくってみることに決定
• Mojo ベースでつくって、Plagger も読んでみようかな...
• う、、それ以前に vim でのコードリーディングを、もっと効率的にできるようにならなにと。。
• Plagger のプレゼン資料読んでるけど面白そう

参考ページとか：
Mojoを使ってみた - Charsbar::Note
Elementary, ... Googleで「はらへった」と検索するとピザが届くようにするまで
PlaggerPresentations - Plagger - Trac

Perl の対話環境

Ruby における irb のような REPL がないと、ちょっとした動作確認が面倒。

Devel::REPL - re.pl というコマンドがついてくる。CPAN で入れるのがよさげ

Mojo の開発版を git clone する：

% mkdir -p Mojo; cd Mojo

% git clone git://github.com/kraih/mojo.git mojo

% cd mojo/
% git show 
commit ca87975ef061383b793a92fbd18b3ee5c5b86251
Author: Sebastian Riedel <sri@labs.kraih.com>
Date: Tue Dec 16 18:32:11 2008 +0100

試しに、いきなりコマンドを実行してみる；

% perl ./bin/mojo
Welcome to the Mojo Framework!

HINT: In case you don't know what you are doing here try the manual!
perldoc Mojo::Manual
perldoc Mojo::Manual::GettingStarted

This is the interactive script interface, the syntax is very simple.
mojo <script><options>

おぉ、動いた。

perldoc の検索パス

ん、、perldoc Mojo::Manual しても、ちゃんとマニュアルが表示されるな。いや、もちろん、表示されるのは嬉しいんだけど、これってどうやってマニュアルの場所を特定してるんだろう。lib ディレクトリを特別扱いするとか、カレントディレクトリ以下を探索する、とか？

perldoc -l Mojo とすると lib/Mojo.pm が出力されるので、perldoc が lib 以下を探索してるのは間違いなさそう。man perldoc しても環境変数みるよ、とかしか書いてないな。perldoc に -v オプションつけると、どこを検索してるかが表示される：

% perldoc -lv Mojo
...

Looking for Mojo in /usr/bin . lib /etc/perl /usr/local/lib/perl/5.10.0 /usr/local/share/perl/5.10.0 /usr/lib/perl5 

...

lib/Mojo.pm

やはり、lib を検索対象に含めてるようだ。

% perl -le 'print foreach @INC;'
/etc/perl
/usr/local/lib/perl/5.10.0
/usr/local/share/perl/5.10.0
/usr/lib/perl5
/usr/share/perl5
/usr/lib/perl/5.10
/usr/share/perl/5.10
/usr/local/lib/site_perl
.

@INC には含まれていないところをみると、perldoc の挙動なのかな。Pod::Perldoc のソースを読んでみるか：

% vi `perldoc -lm Pod::Perldoc`
 428 $self->maybe_diddle_INC();
...
 454 sub maybe_diddle_INC {
1455 my $self = shift;
1456
1457 # Does this look like a module or extension directory?
1458
1459 if (-f "Makefile.PL") {
1460
1461 # Add "." and "lib" to @INC (if they exist)
1462 eval q{ use lib qw(. lib); 1; } or die;

maybe_diddle_INC 関数の中で追加してるっぽい。納得。

Mojo と Mojolicious を使用可能にする

通常は Makefile.PL でインストールするようだが、今回はインストールせずに clone したディレクトリそのままで...

設定の変更

cpan> o conf <name> <param>

cpan> o conf commit

o commit しなければ、そのセッション中だけ有効。あるモジュールでだけ設定を変更したい場合などは o commit しない。

[Y/n] で自動的に Y を選ぶ設定

cpan> o conf prerequisites_policy follow
cpan> o conf commit

CPAN 自体のアップデート

cpan> install Bundle::CPAN

cpan> reload cpan

手動でインデックス更新とキャッシュのスキャン

perl -MCPAN -e 'CPAN::Index->force_reload; my $c = CPAN::CacheMgr->new; $c->{SCAN} = q/atstart/; $c->scan_cache'

m4 のクォートは '`' と ''' だが、 これらはシェルスクリプトで頻繁に使われるため、autoconf はクォート文字を '[' と ']' に変更している。もしも、スクリプト中で '[' と ']' を使いたい場合は、@<:@ と @:>@ を使う（参考：Autoconf, Automake, and Libtool: Quoting）。ちなみに $ 記号を書く場合は @S|@ とする（参考：8.1.6 Quadrigraphs）

当初、configure.ac のリテラルで '$' を使うために、autoconf の特殊文字を使って；

  AC_INIT([A @S|@1 Gesture Recognizer], [0.1], [bugs@...])

としていたのだが、これだと生成された configure を --help オプション指定で実行すると、$1 が変数展開されてしまう。

そこで、バックスラッシュでエスケープしてみる：

  AC_INIT([A \@S|@1 Gesture Recognizer], [0.1], [bugs@...])

そうすると、今度は config.h で：

  /* Define to the full name and version of this package. */
  #define PACKAGE_STRING "A \$1 Gesture Recognizer 0.1"

こうなってしまい、\$ は不正なエスケープシーケンスとなってしまう。

Makefile.in での変数展開

configure スクリプトで Makefile.in から Makefile を生成するとき、Makefile.in に書かれた @...@ 形式の変数は展開される。automake を使っている場合、Makefile.in は Makefile.am から生成されるので、これらの変数を Makefile.am に書く（4.8 Substitutions in Makefiles | Autoconf）。

autoscan.log
Makefile
autom4te.cache
config.log
config.status
config.h
stamp-h1
.deps

Automake

% autoscan
% ls
autoscan.log configure.scan hello.c

% touch NEWS ChangeLog README AUTHORS
% aclocal% autoconf
% automake -a -c

% ./configure 
% make
% ./hello
Hello, World!
% ls
AUTHORS INSTALL Makefile.in aclocal.m4 config.log configure.ac install-sh
COPYING Makefile NEWS autom4te.cache config.status depcomp missing
ChangeLog Makefile.am README autoscan.log configure hello.c

これら、autoconf や automake の実行は autoreconf 一発でいい：
% autoreconf --install

AM_INIT_AUTOMAKE

AM_INIT_AUTOMAKE にオプションを渡せる

• foreign NEWS README など必要なくする
• nostdinc デフォルトの -I をなくす

参考情報

Native Client は予期しない副作用を防ぐための、制限された実行環境と安全なコードを実行するためのランタイムで構成されている。

参考情報

-Wunused について

-Wunused は -W が有効な場合、-Wunused-parameter も有効になる。-Wunused は -Wall によっても暗黙的に有効になるため、-W と -Wall を両方指定すると、-Wunused-parameter が有効になる。このとき、もし、-Werror も有効になっていると、関数の引数で使われていないとコンパイルエラーになってしまい都合が悪い。たとえば、テスト駆動開発では関数の中身を空にしておくことがあるが、上記の場合は、これがエラーになってしまう。

Xcode (Mac OS X Leopard) 付属の Apple gcc 4.0.1 の場合、-Wno-unused-parameter を指定することで「未使用の関数引数」警告自体をなくすことはできる。しかし、できれば、「未使用の関数引数」も警告のまま残し、他の警告はエラー扱いしたい。

  % gcc -Iinclude -O0 -std=c++98 -pedantic -Wall -Wextra -Werror -Wno-unused-parameter -c -o src/utils.o src/utils.cpp

gcc 4.2 からは -Werror= および -Wno-error= というオプションが追加され、エラー扱いにする警告を個別に指定できるようになった。このオプションを使えば、-Wunused-parameter は警告のまま、その他の警告をエラーに出来るだろう。Mac OS X Leopard では gcc 4.2.1 は gcc-4.2 という名前でインストールされている。

  % gcc-4.2 -Iinclude -O0 -std=c++98 -pedantic -Wall -Wextra -Werror -Wno-error=unused-parameter -c -o src/utils.o src/utils.cpp
  src/utils.cpp:108: warning: unused parameter 'start'
  src/utils.cpp:108: warning: unused parameter 'end'
  src/utils.cpp:108: warning: unused parameter 'positiveOnly'

しかし、Mac の場合、gcc 4.2.1 がデフォルトでない以上、このオプションを使っていいのか悩むところ。

Makefile には直接書かずに、環境変数で指定する、という手もある：

  % CXX=gcc-4.2 CPPFLAGS=-Wno-error=unused-parameter make

オンラインマニュアル

ソースコードをダウンロードして解凍

  % curl -LO http://llvm.org/releases/2.4/llvm-2.4.tar.gz

  % tar xvzf llvm-2.4.tar.gz 

  % cd llvm-2.4

コンパイル、インストール

  % ./configure --prefix=/Users/ishikawa/Developer/Workspace/Pekoe/llvm

  % gmake -k -j2 2>&1 | tee make.log

特に、書き残すまでもなかったかな...

既存のプログラムがコンパイル通らない

LLVM 2.4 にすると、コンパイルできなくなった。こんなエラー：

g++ -g -O2 -I./include -Wall -W -Wwrite-strings -Wno-unused -Wpointer-arith -Wstrict-aliasing=2 -Winit-self -ansi -std=c++98 `llvm-config --cxxflags core jit native` -c -o src/generator.o src/generator.cc
src/generator.cc:67: error: ISO C++ forbids declaration of 'IRBuilder' with no type

llvm::IRBuilder が変更された？ Release Note を読む。これかな？

ActionScript VM 上で動作するプログラムを C/C++ コードで記述できるようになる。これはつまり、既存の C/C++ プログラムが Flash Player や AIR 上で動作することを意味している。また、C/C++ プログラムのコンパイルには LLVM を利用しており、そこで生成された中間コードが ActionScript 3.0 のソースコードに変換される（そのままバイトコードには変換しない）。その後、生成された ActionScript コードが Alchemy 特製の ActionScript コンパイラで ActionScript Byte Code  (ABC) にコンパイルされるようだ。

インストール

  % adt -version
  adt version "1.5.0.7220"

Alchemy のディレクトリに移動し、config プログラムを実行する

  % cd Developer/System/Flash/alchemy-darwin-v0.4a/
  % ./config

config プログラムで生成された alchemy-setup をシェルの起動時に読み込むようにする：

  source /Users/ishikawa/Developer/System/Flash/alchemy-darwin-v0.4a/alchemy-setup

また、alchemy-setup は PATH を変更する前に読み込むらしい。

そして、次に、${ALCHEMY_HOME}/achacks を PATH に追加する。最終的に以下のようになる：

  # Flash, Flex, Alchemy ...
  source /Users/ishikawa/Developer/System/Flash/alchemy-darwin-v0.4a/alchemy-setup
  PATH=${PATH}:/Users/ishikawa/Developer/System/Flash/flex_sdk_3/bin
  PATH=${PATH}:${ALCHEMY_HOME}/achacks

  ...

  export PATH

サンプルを試す

では、同梱されているサンプルを試してみよう：

  % cd $ALCHEMY_HOME/samples/stringecho
  % which gcc
  /usr/bin/gcc
  % alc-on; which gcc
  /Users/ishikawa/Developer/System/Flash/alchemy-darwin-v0.4a/achacks/gcc

まず、alc-on を実行すると、gcc が Alchemy 独自のものに切り替わるのが分かると思う。

そして、samples/stringecho にあるファイルは以下の通り：

  - EchoTest.as

- readme.txt

- stringecho.c