X-Git-Url: http://git.osdn.jp/view?p=pettanr%2FclientJs.git;a=blobdiff_plain;f=0.6.x%2Fjs%2F01_core%2F01_X.js;fp=0.6.x%2Fjs%2F01_core%2F01_X.js;h=fabeeebc22b01070e2a53ebd352ea97307065bea;hp=81ed30deac515302d2ffb77c176cba6d152f40bd;hb=9e30a8480de03f0b36d2411a0ecb7f1d0f47b61f;hpb=321cf844195090369e92f5d0c67dcd360eaa6fdd

diff --git a/0.6.x/js/01_core/01_X.js b/0.6.x/js/01_core/01_X.js
index 81ed30d..fabeeeb 100644
--- a/0.6.x/js/01_core/01_X.js
+++ b/0.6.x/js/01_core/01_X.js
@@ -1,3 +1,44 @@
+/**
+ * <h4>はじめに:Web 開発の世界へようこそ！</h4>
+ * DHTML と XHR 等を活用した Ajax によってその真価を発揮した javascript は、現在では RIA に SPA や 3D ゲームなど、あらゆるアプリケーションがブラウザ上で動きつつあります。
+ * それらの素晴らしいデモに触れ、これから Web 開発に望む皆さんは、胸をときめかせていることでしょう。
+ * そうです、今や Web ブラウザは、あなたの夢を何でも描くことの出来る自由なフロンティアです。
+ * 
+ * しかし、いざ Javascript を触り始め、初めての開発に着手すると、Web ブラウザというフロンティアは、少し雑草の茂るだけの荒野だと気付くでしょう。
+ * ここに RIA や 3D ゲームといった素晴らしいテーマパークを築機上げるには、まずは測量に整地、地盤や土壌の改良といった膨大な作業をしなくてはいけません。
+ * 
+ * 簡素な物置小屋のための最初の柱を建てるのにも、それ以前に膨大な作業の必要なことに、あなたは唖然となるでしょう。
+ * そのような基礎もそこそこに、勇んで建てた一本目の柱は傾き、または無残に朽ち果てるのを目撃し、あなたは深いため息をつくかもしれません。
+ * 
+ * Javascript は様々な問題を孕みつつも、今や最もあらゆるプラットフォームで動作する言語のひとつへと躍進しました。
+ * これから、このフロンティアに如何に基礎を作り、その上にテーマパークを作るのか？一緒に考えていきましょう。
+ * ようこそ、Web 開発の世界へ！
+ * 
+ * <h4>pettanR フレームワーク API ドキュメントについて</h4>
+ * このAPIドキュメントには、折に触れこのような長文が登場します。
+ * Web 開発は今では、そのカジュアルなイメージとは裏腹に、膨大な知識と経験が必要なものになってしまっています。
+ * どのようにして、それらの情報を、妥当な業務時間の間に継承していけばよいか？
+ * 
+ * この意識は常にありましたが、このたび pettanR フレームワークの API ドキュメントを作成するにあたり、それに付記していく形で取り組んでみようと思います。
+ * 
+ * <h4>フレームワークのレイヤー構造について</h4>
+ * 
+ * 
+ * ライブラリは X という名前空間を使用します。
+ * @example //ショートハンド
+ * X( func ) == X.ViewPort.listenOnce(X.Event.XDOM_READY, func);
+ * X('#mydiv') == X.Doc.find('#mydiv');
+ * @namespace X
+ */ 
+function X( v ){
+	if( X.Type.isFunction( v ) ){
+		X.ViewPort.listenOnce( X.Event.XDOM_READY, v );
+	} else
+	if( X_shortcutFunction ){
+		return X_shortcutFunction.apply( X_shortcutContext || X, arguments );
+	};
+};
+
 //{+DEV
 if( !window['console'] || ( window.parent && window.parent.log ) )
 	console = { log : function(a){
@@ -17,23 +58,23 @@ var undefined,
 	X_shortcutContext;
 
 /**
- * @namespace ライブラリは X という名前空間を使用します。X( func ) で  X.ViewPort.listenOnce(X.Event.XDOM_READY, func)、　X('#mydiv') として X.Doc.find('#mydiv') のショートハンドになります。
- */ 
-function X( v ){
-	if( X.Type.isFunction( v ) ){
-		X.ViewPort.listenOnce( X.Event.XDOM_READY, v );
-	} else
-	if( X_shortcutFunction ){
-		return X_shortcutFunction.apply( X_shortcutContext || X, arguments );
-	};
-};
-
+ * バージョン文字列:"0.6.123"
+ * @type {string} */
 X.VERSION = '0.6.127';
-		
+
+/**
+ * ブートタイム ms
+ * @type {number} */
 X.bootTime = + new Date;
 
+/**
+ * 空の関数
+ * @type {Function} */
 X.emptyFunction = new Function;
 
+/**
+ * このscriptはheadタグの中にあるか？
+ *  @type {boolean} */
 // TODO defer の場合もあるので、document.readyState を見る
 // MacIE で false
 X.inHead = (function( s ){