hikiutils 0.2.3.13 → 0.2.3.14

data/hikiutils_yamane/latex_dir/hikiutils_yamane.log

@@ -1,4 +1,4 @@
-This is e-pTeX, Version 3.14159265-p3.7-160201-2.6 (utf8.euc) (TeX Live 2016) (preloaded format=platex 2017.1.26)  10 FEB 2017 15:01
+This is e-pTeX, Version 3.14159265-p3.7-160201-2.6 (utf8.euc) (TeX Live 2016) (preloaded format=platex 2017.1.26)  12 FEB 2017 12:03
 entering extended mode
  restricted \write18 enabled.
  file:line:error style messages enabled.
@@ -117,21 +117,20 @@ Package: jlisting 2006/02/20 0.2 (Thor)
 \lst@nextchar=\count99
 \lst@inputfile=\read1
 ) (./hikiutils_yamane.aux (./abstract.aux) (./introduction.aux)
-(./compare.aux) (./optparse.aux
+(./method.aux
 
 LaTeX Warning: Label `default' multiply defined.
 
 
 LaTeX Warning: Label `default' multiply defined.
 
-) (./command.aux
+) (./results.aux
 
 LaTeX Warning: Label `default' multiply defined.
 
 
 LaTeX Warning: Label `default' multiply defined.
 
-) (./thor.aux
 
 LaTeX Warning: Label `default' multiply defined.
 
@@ -141,7 +140,7 @@ LaTeX Warning: Label `default' multiply defined.
 
 LaTeX Warning: Label `default' multiply defined.
 
-))
+) (./discussion.aux))
 \openout1 = `hikiutils_yamane.aux'.
 
 LaTeX Font Info:    Checking defaults for OML/cmm/m/it on input line 38.
@@ -207,13 +206,13 @@ LaTeX Font Info:    Font shape `JY1/mc/m/n' will be
  [3]
 \openout2 = `abstract.aux'.
 
- (./abstract.tex) [4
+ (./abstract.tex)
+[4
 
 ]
 \openout2 = `introduction.aux'.
 
-
-(./introduction.tex
+ (./introduction.tex
 File: ../figs/./hikiutils_yamane.001.jpg Graphic file (type eps)
  <../figs/./hikiutils_yamane.001.jpg>
 LaTeX Font Info:    Font shape `JT1/mc/m/n' will be
@@ -223,17 +222,15 @@ LaTeX Font Info:    Font shape `JY1/mc/m/n' will be
 ) [5
 
 
-] [6] [7
+] [6]
+\openout2 = `method.aux'.
 
-]
-\openout2 = `compare.aux'.
 
-
-(./compare.tex
+(./method.tex
 LaTeX Font Info:    Font shape `JT1/gt/m/n' will be
-(Font)              scaled to size 11.53198pt on input line 2.
+(Font)              scaled to size 11.53198pt on input line 3.
 LaTeX Font Info:    Font shape `JY1/gt/m/n' will be
-(Font)              scaled to size 11.53198pt on input line 2.
+(Font)              scaled to size 11.53198pt on input line 3.
 
 (/usr/local/texlive/2016/texmf-dist/tex/latex/listings/lstlang1.sty
 File: lstlang1.sty 2015/06/04 1.6 listings language file
@@ -257,101 +254,95 @@ LaTeX Font Info:    Font shape `JY1/gt/m/n' will be
 (Font)              scaled to size 6.72699pt on input line 23.
 LaTeX Font Info:    Font shape `OT1/cmtt/bx/n' in size <7> not available
 (Font)              Font shape `OT1/cmtt/m/n' tried instead on input line 23.
- [8
-
-]
-[9]) [10]
-\openout2 = `optparse.aux'.
-
- (./optparse.tex
-File: ../figs/./hikiutils_yamane.005.jpg Graphic file (type eps)
- <../figs/./hikiutils_yamane.005.jpg> [11
+ [7
 
 
 ]
+[8] [9]
+File: ../figs/./hikiutils_yamane.005.jpg Graphic file (type eps)
+ <../figs/./hikiutils_yamane.005.jpg> [10]
 File: ../figs/./hikiutils_yamane.007.jpg Graphic file (type eps)
 
-<../figs/./hikiutils_yamane.007.jpg> [12] [13]) [14] [15
+<../figs/./hikiutils_yamane.007.jpg> [11] [12] [13]) [14]
+\openout2 = `results.aux'.
 
-]
-\openout2 = `command.aux'.
-
- (./command.tex
+ (./results.tex
 File: ../figs/./hikiutils_yamane.002.jpg Graphic file (type eps)
 
 <../figs/./hikiutils_yamane.002.jpg>
-LaTeX Font Info:    Try loading font information for OMS+cmr on input line 23.
+LaTeX Font Info:    Try loading font information for OMS+cmr on input line 24.
 
 (/usr/local/texlive/2016/texmf-dist/tex/latex/base/omscmr.fd
 File: omscmr.fd 2014/09/29 v2.5h Standard LaTeX font definitions
 )
 LaTeX Font Info:    Font shape `OMS/cmr/m/n' in size <10> not available
-(Font)              Font shape `OMS/cmsy/m/n' tried instead on input line 23.
- [16
+(Font)              Font shape `OMS/cmsy/m/n' tried instead on input line 24.
+ [15
 
-] [17]
-[18]) [19]
-\openout2 = `thor.aux'.
 
- (./thor.tex
+] [16]
+[17]
 File: ../figs/./hikiutils_yamane.003.jpg Graphic file (type eps)
- <../figs/./hikiutils_yamane.003.jpg> [20
-
-
-]
+ <../figs/./hikiutils_yamane.003.jpg> [18]
 File: ../figs/./hikiutils_yamane.004.jpg Graphic file (type eps)
 
-<../figs/./hikiutils_yamane.004.jpg> [21]
+<../figs/./hikiutils_yamane.004.jpg> [19] [20]
 File: ../figs/./hikiutils_yamane.006.jpg Graphic file (type eps)
- <../figs/./hikiutils_yamane.006.jpg>
-[22]
-Overfull \hbox (3.95764pt too wide) in paragraph at lines 84--85
+
+<../figs/./hikiutils_yamane.006.jpg>
+Overfull \hbox (3.95764pt too wide) in paragraph at lines 215--216
 \OT1/cmr/m/n/10 Thor \JY1/mc/m/n/10 では \OT1/cmr/m/n/10 start(ARGV) \JY1/mc/m/
 n/10 を呼び出すことで \OT1/cmr/m/n/10 CLI \JY1/mc/m/n/10 を開始する ． \OT1/cmr
 /m/n/10 Hikithor::CLI.start(ARGV)
  []
 
-[23]) [24]
-Underfull \hbox (badness 10000) in paragraph at lines 58--59
+[21]) [22]
+\openout2 = `discussion.aux'.
+
+ (./discussion.tex) [23
+
+
+]
+Underfull \hbox (badness 10000) in paragraph at lines 55--56
 []\OT1/cmr/m/n/10 hikidoc, \OT1/cmtt/m/n/10 https://rubygems.org/gems/hikidoc/v
 ersions/0.1.0,
  []
 
 
-Overfull \hbox (30.69658pt too wide) in paragraph at lines 59--60
+Overfull \hbox (28.25214pt too wide) in paragraph at lines 56--57
 []\JY1/mc/m/n/10 「\OT1/cmr/m/n/10 Thor \JY1/mc/m/n/10 の使い方まとめ 」 \OT1/c
-mr/m/n/10 , \OT1/cmtt/m/n/10 http://qiita.com/succi0303/items/32560103190436c94
-35b
+mr/m/n/10 ,\OT1/cmtt/m/n/10 http://qiita.com/succi0303/items/32560103190436c943
+5b
  []
 
 
-Underfull \hbox (badness 10000) in paragraph at lines 60--61
+Underfull \hbox (badness 10000) in paragraph at lines 57--58
 []\JY1/mc/m/n/10 「\OT1/cmr/m/n/10 15.5. opt-parse - \JY1/mc/m/n/10 コマンドラ
 インオプシ ョン解析器 」 \OT1/cmr/m/n/10 ,
  []
 
 
-Overfull \hbox (38.02074pt too wide) in paragraph at lines 61--62
+Overfull \hbox (38.02074pt too wide) in paragraph at lines 58--59
 []\JY1/mc/m/n/10 「\OT1/cmr/m/n/10 library opt-parse\JY1/mc/m/n/10 」 \OT1/cmr/
 m/n/10 , \OT1/cmtt/m/n/10 https://docs.ruby-lang.org/ja/latest/library/optparse
 .html
  []
 
-[25
+[24
 
 ] (./hikiutils_yamane.aux (./abstract.aux) (./introduction.aux)
-(./compare.aux) (./optparse.aux) (./command.aux) (./thor.aux))
+(./method.aux) (./results.aux) (./discussion.aux))
 
 LaTeX Warning: There were multiply-defined labels.
 
  ) 
 Here is how much of TeX's memory you used:
- 2624 strings out of 493683
- 36097 string characters out of 6149653
- 249697 words of memory out of 5000000
- 6151 multiletter control sequences out of 15000+600000
+ 2619 strings out of 493683
+ 36077 string characters out of 6149653
+ 259998 words of memory out of 5000000
+ 6153 multiletter control sequences out of 15000+600000
  15673 words of font info for 72 fonts, out of 8000000 for 9000
  934 hyphenation exceptions out of 8191
- 35i,9n,51p,777b,1725s stack positions out of 5000i,500n,10000p,200000b,80000s
+ 35i,9n,51p,777b,1684s stack positions out of 5000i,500n,10000p,200000b,80000s
 
-Output written on hikiutils_yamane.dvi (25 pages, 91988 bytes).
+Output written on hikiutils_yamane.dvi (24 pages, 95744 bytes).

data/hikiutils_yamane/latex_dir/hikiutils_yamane.tex

@@ -48,15 +48,12 @@
 
 \include{abstract}
 \include{introduction}
-\section{方法}
-\include{compare}
-\include{optparse}
-\section{結果}
-\include{command}
-\include{thor}
+\include{method}
+\include{results}
+\include{discussion}
 \begin{thebibliography}{99}
 \bibitem{1-1}   hikidoc, \verb|https://rubygems.org/gems/hikidoc/versions/0.1.0,| \verb|https://github.com/hiki/hikidoc,2017/1/30| アクセス.
-\bibitem{1-2}   「Thorの使い方まとめ」, \verb|http://qiita.com/succi0303/items/32560103190436c9435b| ,2017/1/30 アクセス.
+\bibitem{1-2}   「Thorの使い方まとめ」,\verb|http://qiita.com/succi0303/items/32560103190436c9435b| 2015/01/14更新,2017/1/30 アクセス.
 \bibitem{1-3}   「15.5. optparse - コマンドラインオプション解析器」, \verb|http://docs.python.jp/2/library/optparse.html| ,2017/1/30 アクセス.
 \bibitem{1-4}   「library optparse」, \verb|https://docs.ruby-lang.org/ja/latest/library/optparse.html| ,2017/1/30 アクセス.
 \end{thebibliography}

data/hikiutils_yamane/latex_dir/hikiutils_yamane.toc

@@ -1,31 +1,31 @@
 \contentsline {section}{\numberline {1}概要}{4}
 \contentsline {section}{\numberline {2}序論}{5}
 \contentsline {section}{\numberline {3}方法}{7}
-\contentsline {subsection}{\numberline {3.1}optparseとthorの比較}{8}
-\contentsline {subsubsection}{\numberline {3.1.1}optparse}{8}
+\contentsline {subsection}{\numberline {3.1}optparseとthorの比較}{7}
+\contentsline {subsubsection}{\numberline {3.1.1}Thor}{7}
+\contentsline {paragraph}{fizzbuzzメソッド，versionメソッド}{8}
+\contentsline {subsubsection}{\numberline {3.1.2}optparse}{8}
 \contentsline {paragraph}{runメソッド}{9}
 \contentsline {paragraph}{initializeメソッド}{9}
 \contentsline {paragraph}{executeメソッド}{9}
-\contentsline {paragraph}{fizzbuzzメソッド}{10}
+\contentsline {paragraph}{fizzbuzzメソッド}{9}
 \contentsline {paragraph}{versionメソッド}{10}
-\contentsline {subsubsection}{\numberline {3.1.2}Thor}{10}
-\contentsline {paragraph}{fizzbuzzメソッド，versionメソッド}{10}
-\contentsline {subsection}{\numberline {3.2}既存のhikiutilsのコマンド解説}{11}
-\contentsline {subsubsection}{\numberline {3.2.1}コマンドの登録と実行メソッド}{11}
-\contentsline {subsubsection}{\numberline {3.2.2}CLIの実行プロセス}{12}
-\contentsline {subsubsection}{\numberline {3.2.3}コード}{13}
+\contentsline {subsection}{\numberline {3.2}既存のhikiutilsのコマンド解説}{10}
+\contentsline {subsubsection}{\numberline {3.2.1}コマンドの登録と実行メソッド}{10}
+\contentsline {subsubsection}{\numberline {3.2.2}CLIの実行プロセス}{11}
+\contentsline {subsubsection}{\numberline {3.2.3}コード}{12}
 \contentsline {section}{\numberline {4}結果}{15}
-\contentsline {subsection}{\numberline {4.1}コマンドの命名原則}{16}
-\contentsline {subsubsection}{\numberline {4.1.1}hikiutilsの想定利用形態}{16}
-\contentsline {subsubsection}{\numberline {4.1.2}コメンド名と振る舞いの詳細}{17}
+\contentsline {subsection}{\numberline {4.1}コマンドの命名原則}{15}
+\contentsline {subsubsection}{\numberline {4.1.1}hikiutilsの想定利用形態}{15}
+\contentsline {subsubsection}{\numberline {4.1.2}コメンド名と振る舞いの詳細}{16}
 \contentsline {paragraph}{open FILE}{17}
-\contentsline {paragraph}{ls [FILE]}{18}
-\contentsline {paragraph}{rsync}{18}
+\contentsline {paragraph}{ls [FILE]}{17}
+\contentsline {paragraph}{rsync}{17}
 \contentsline {paragraph}{touch FILE}{18}
-\contentsline {paragraph}{pwd}{19}
-\contentsline {paragraph}{cd VAL}{19}
-\contentsline {subsection}{\numberline {4.2}Thorによる実装}{20}
-\contentsline {subsubsection}{\numberline {4.2.1}クラス初期化}{20}
-\contentsline {subsubsection}{\numberline {4.2.2}コマンド定義}{21}
-\contentsline {subsubsection}{\numberline {4.2.3}CLIの実行プロセス}{22}
-\contentsline {subsubsection}{\numberline {4.2.4}optparseとの全体的な比較}{24}
+\contentsline {paragraph}{pwd}{18}
+\contentsline {paragraph}{cd VAL}{18}
+\contentsline {subsection}{\numberline {4.2}Thorによる実装}{18}
+\contentsline {subsubsection}{\numberline {4.2.1}クラス初期化}{18}
+\contentsline {subsubsection}{\numberline {4.2.2}コマンド定義}{19}
+\contentsline {subsubsection}{\numberline {4.2.3}CLIの実行プロセス}{21}
+\contentsline {section}{\numberline {5}optparseからThorへの移行}{23}

data/hikiutils_yamane/latex_dir/introduction.tex

@@ -1,5 +1,5 @@
 \section{序論}
-hikiは，hiki記法を用いたwiki cloneである．wikiはウォード・カニンガムが作ったwikiwikiwebを源流とするhome page制作を容易にするシステムで，hikiもwikiの基本要求仕様を満足するシステムを提供する．wikiの特徴であるweb上で編集する機能を提供する．これを便宜上hiki web systemと呼ぶ．図にある通り，一般的な表示画面の他に，編集画面が提供されており，ユーザーはこの編集画面からコンテンツを編集することが可能である．リンクやヘッダー，リスト，引用，表，図の表示などの基本テキストフォーマットが用意されている．
+hikiは，hiki記法を用いたwiki cloneである．wikiはウォード・カニンガムが作ったwikiwikiwebを源流とするhome page制作を容易にするシステムで，hikiもwikiの基本要求仕様を満足するシステムを提供する．wikiの特徴であるweb上で編集する機能を提供する．これを便宜上hiki web systemと呼ぶ．図\ref{fig:one}にある通り，一般的な表示画面の他に，編集画面が提供されており，ユーザーはこの編集画面からコンテンツを編集することが可能である．リンクやヘッダー，リスト，引用，表，図の表示などの基本テキストフォーマットが用意されている．
 
 hiki web systemの実際の基本動作は，hiki.cgiプログラムを介して行われている．こちらを便宜上hiki systemと呼ぶ．図\ref{fig:one}に従ってhiki systemの動作概要を説明する．hiki systemは，data/textに置かれた書かれたプレーンテキストをhtmlへ変換する．この変換はhikidoc\cite{1-1}というhikiフォーマットconverterを使っている．また，添付書類はcache/attachに，一度フォーマットしたhtmlはparserに置かれており，それらを参照してhtmlを表示する画面をhiki.cgiは作っている．さらにhiki systemでは検索機能，自動リンク作成などが提供されている
 

data/hikiutils_yamane/latex_dir/method.aux

@@ -0,0 +1,46 @@
+\relax 
+\citation{1-2}
+\citation{1-2}
+\citation{1-2}
+\@writefile{toc}{\contentsline {section}{\numberline {3}方法}{7}}
+\@writefile{toc}{\contentsline {subsection}{\numberline {3.1}optparseとthorの比較}{7}}
+\@writefile{toc}{\contentsline {subsubsection}{\numberline {3.1.1}Thor}{7}}
+\citation{1-3}
+\citation{1-4}
+\@writefile{toc}{\contentsline {paragraph}{fizzbuzzメソッド，versionメソッド}{8}}
+\@writefile{toc}{\contentsline {subsubsection}{\numberline {3.1.2}optparse}{8}}
+\@writefile{toc}{\contentsline {paragraph}{runメソッド}{9}}
+\@writefile{toc}{\contentsline {paragraph}{initializeメソッド}{9}}
+\@writefile{toc}{\contentsline {paragraph}{executeメソッド}{9}}
+\@writefile{toc}{\contentsline {paragraph}{fizzbuzzメソッド}{9}}
+\@writefile{toc}{\contentsline {paragraph}{versionメソッド}{10}}
+\@writefile{toc}{\contentsline {subsection}{\numberline {3.2}既存のhikiutilsのコマンド解説}{10}}
+\@writefile{toc}{\contentsline {subsubsection}{\numberline {3.2.1}コマンドの登録と実行メソッド}{10}}
+\@writefile{lof}{\contentsline {figure}{\numberline {2}{\ignorespaces コマンドの登録と実行メソッドの対応．}}{10}}
+\newlabel{fig:005}{{2}{10}}
+\newlabel{default}{{2}{10}}
+\@writefile{toc}{\contentsline {subsubsection}{\numberline {3.2.2}CLIの実行プロセス}{11}}
+\@writefile{lof}{\contentsline {figure}{\numberline {3}{\ignorespaces CLIの実行プロセス．}}{12}}
+\newlabel{fig:007}{{3}{12}}
+\newlabel{default}{{3}{12}}
+\@writefile{toc}{\contentsline {subsubsection}{\numberline {3.2.3}コード}{12}}
+\@setckpt{method}{
+\setcounter{page}{15}
+\setcounter{equation}{0}
+\setcounter{enumi}{2}
+\setcounter{enumii}{0}
+\setcounter{enumiii}{0}
+\setcounter{enumiv}{0}
+\setcounter{footnote}{0}
+\setcounter{mpfootnote}{0}
+\setcounter{part}{0}
+\setcounter{section}{3}
+\setcounter{subsection}{2}
+\setcounter{subsubsection}{3}
+\setcounter{paragraph}{0}
+\setcounter{subparagraph}{0}
+\setcounter{figure}{3}
+\setcounter{table}{0}
+\setcounter{lstnumber}{38}
+\setcounter{lstlisting}{0}
+}

data/hikiutils_yamane/latex_dir/method.tex

@@ -0,0 +1,247 @@
+
+\section{方法}
+\subsection{optparseとthorの比較}
+今回の研究対象のhikiutilsは，optparseというコマンドライン解析ライブラリで実装されている．
+本研究ではこの代替ライブラリとしてThorの採用を検討した．
+本章の最初では，FizzBuzzという簡単なコードを例にoptparseとThorにより作成するコマンドライン解析コードの比較を行う．FizzBuzzはThorの使い方を解説した記事\cite{1-2}で紹介されている．比較しやすくするためoptparseでFizzBuzzを新たに実装した．
+
+\subsubsection{Thor}
+Thorとは，コマンドラインツールの作成を支援するライブラリのことである．gitやbundlerのようにサブコマンドを含むコマンドラインツールを簡単に作成することができる\cite{1-2}．
+
+Thorの基本的な流れとしては
+
+\begin{enumerate}
+\item Thorを継承したクラスのメソッドがコマンドになる
+\item クラス.start(ARGV)でコマンドラインの処理をスタートする
+\end{enumerate}
+である\cite{1-2}.
+
+startに渡す引数が空の場合，Thorはクラスのヘルプリストを出力する．また，Thorはサブコマンドやサブサブコマンドも容易に作ることができる．
+
+以下に示したコードがThorで記述されたfizzbuzzである．
+\begin{lstlisting}[style=customRuby,basicstyle={\scriptsize\ttfamily}]
+module Fizzbuzz                                                   
+  class CLI < Thor
+
+    desc 'fizzbuzz', 'Get fizzbuzz result from limit number'
+    def fizzbuzz(limit)
+      print Fizzbuzz.fizzbuzz(limit).join(',')
+      exit
+    end
+
+    desc 'version', 'version'
+    def version
+      puts Fizzbuzz::VERSION
+    end
+  end
+end
+\end{lstlisting}
+このコードもoptparseのfizzbuzzと同様fizzbuzzとversionのコマンドを実行させる．
+
+\paragraph{fizzbuzzメソッド，versionメソッド}
+descでコマンド一覧で表示させるコマンド名と説明を書く．メソッド内ではそれぞれのコマンドの処理内容が書かれている．
+
+\subsubsection{optparse}
+optparseとは，getoptよりも簡便で，柔軟性に富み，かつ強力なコマンドライン解析ライブラリである．optparseでは，より宣言的なスタイルのコマンドライン解析手法，すなわちOptionParserのインスタンスでコマンドラインを解析するという手法をとっている．これを使うと，GNU/POSIX構文でオプションを指定できるだけでなく，使用法やヘルプメッセージの生成も行える\cite{1-3}．利用頻度はあまり高くないが古くから開発され，使用例が広く紹介されている．
+
+optparseの基本的な流れとしては
+
+\begin{enumerate}
+\item OptionParserオブジェクトoptを生成する
+\item オプションを取り扱うブロックをopt.onに登録する
+\item opt.parse(ARGV)でコマンドラインを実際にparseする
+\end{enumerate}
+である.
+
+OptionParserはコマンドラインのオプション取り扱うためのクラスであるためオブジェクトoptを生成されopt.onにコマンドを登録することができる．しかし，OptionParser\#onにはコマンドが登録されているだけであるため，OptionParser\#parseが呼ばれた時，コマンドラインにオプションが指定されていれば実行される．optparseにはデフォルトとして--helpと--versionオプションを認識する\cite{1-4}.
+
+以下に示したコードがoptparseで記述したfizzbuzzである．
+\begin{lstlisting}[style=customRuby,basicstyle={\scriptsize\ttfamily}]
+module Fizzbuzz
+  class Command
+
+     def self.run(argv)
+       new(argv).execute
+     end
+
+     def initialize(argv)
+       @argv = argv
+     end
+
+     def execute
+       options = Options.parse!(@argv)
+       sub_command = options.delete(:command)
+       case sub_command
+            when 'fizzbuzz'
+              fizzbuzz(options[:id])
+            when 'version'
+              version
+            end
+     end
+
+     def fizzbuzz(limit_number)
+       (0..limit_number).map do |num|
+         if (num % 15).zero? then print 'FizzBuzz'
+         elsif (num % 5).zero? then print 'Buzz'
+         elsif (num % 3).zero? then print 'Fizz'
+         else print num.to_s
+         end
+         print ' '
+       end
+     end
+
+     def version
+       puts Fizzbuzz::VERSION
+       exit
+     end
+  end
+end
+\end{lstlisting}
+このコードはfizzbuzzとversionをコマンドとして実行できる．
+
+\paragraph{runメソッド}
+コマンド実行を行うためのメソッドであり，argv配列を代入することでexecuteメソッドを実行する．
+
+\paragraph{initializeメソッド}
+初期化を行うメソッドである．
+\begin{quote}\begin{verbatim}
+@argv = argv
+\end{verbatim}\end{quote}
+こうすることでargvをクラス内で利用できるようにする．
+
+\paragraph{executeメソッド}
+上記でoptparseではopt.onにコマンドを登録する必要があると説明したが，opt.onで登録できるものはハイフンがついたコマンドだけであり，ハイフンなしのコマンドの登録はこのようになる．
+
+argv配列の解析を行うOptions.parse!(@argv)をoptionsに代入して解析を行いsub\_commandに代入する．sub\_commandがfizzbuzzであればfizzbuzz(options[:id])メソッドを実行，versionであればversionメソッドを実行する．
+
+\paragraph{fizzbuzzメソッド}
+引数としてlimit\_numberを受け取り，0〜limit\_numberまでの数字を繰り返す．numが15であればFizzbuzzを表示，5であればBuzzを表示，3であればFizzを表示，それ以外は数字を表示し，その後に空白を表示する．
+
+\paragraph{versionメソッド}
+fizzbuzzのバージョンを表示する．
+
+\subsection{既存のhikiutilsのコマンド解説}
+既存のhikiutilsはコマンド解析ライブラリのoptparseを用いて，コマンドの処理を行っている．
+optparseの特徴は，「コマンドの登録，実行method」に分けて記述することが期待されている．
+また，CLIの起動の仕方が特徴的である．この二つを取り出して，動作とコードを説明する．
+
+\subsubsection{コマンドの登録と実行メソッド}
+\begin{figure}[htbp]\begin{center}
+\includegraphics[width=10cm,bb= 0 0 737 553]{../figs/./hikiutils_yamane.005.jpg}
+\caption{コマンドの登録と実行メソッドの対応．}
+\label{fig:005}
+\label{default}\end{center}\end{figure}
+optparseでは以下の通り，コマンドの登録と実行が行われる．
+
+\begin{enumerate}
+\item OptionParserオブジェクトoptを生成
+\item optにコマンドを登録
+\item 入力されたコマンドの処理のメソッドへ移動
+\end{enumerate}
+optparseではOptionParserオブジェクトoptの生成を行い，コマンドをoptに登録することでコマンドを作成することができる．しかし，これはコマンドを登録しているだけでコマンドの一覧ではこれを表示することができるが，コマンドの実行を行うためには実行を行うためのメソッドを作成する必要がある．optparseでのコマンドの実行はoptで登録されたコマンドが入力されることでそれぞれのコマンドの処理を行うメソッドに移動し処理を行う．しかし，このコマンド登録はハイフンを付けたコマンドしか登録ができず，ハイフンなしのコマンド登録はまた別の手段でやらなくてはいけない．
+\begin{lstlisting}[style=customRuby,basicstyle={\scriptsize\ttfamily}]
+    def execute
+      @argv << '--help' if @argv.size==0
+      command_parser = OptionParser.new do |opt|
+        opt.on('-v', '--version','show program Version.') { |v|
+          opt.version = HikiUtils::VERSION
+          puts opt.ver
+        }
+        opt.on('-s', '--show','show sources') {show_sources}
+        opt.on('-a', '--add','add sources info') {add_sources }
+        opt.on('-t', '--target VAL','set target id') {|val| set_target(val)}
+        opt.on('-e', '--edit FILE','open file') {|file| edit_file(file) }
+
+        ...省略...
+
+      end
+      begin
+        command_parser.parse!(@argv)
+      rescue=> eval
+        p eval
+      end
+      dump_sources
+      exit
+    end    
+    
+    def show_sources()
+      printf("target_no:%i\n",@src[:target])
+      printf("editor_command:%s\n",@src[:editor_command])
+
+      ...省略...
+
+    end
+
+    以下略
+
+\end{lstlisting}
+\subsubsection{CLIの実行プロセス}
+\begin{figure}[htbp]\begin{center}
+\includegraphics[width=10cm,bb= 0 0 737 553]{../figs/./hikiutils_yamane.007.jpg}
+\caption{CLIの実行プロセス．}
+\label{fig:007}
+\label{default}\end{center}\end{figure}
+optparseを用いた場合のCLIの実行プロセスは次の通りとなる．
+
+\begin{enumerate}
+\item HikiのHikiUtils::Command.run(ARGV)でhikiutils.rbのrunメソッドを呼ぶ
+\item new(argv).executeでexecuteメソッドが実行される
+\end{enumerate}
+optparseではHikiutils::Command.run(ARGV)で実行され，requireで呼び出されたhikiutils.rbのrunメソッドが実行される．そこでコマンドを登録しているexecuteメソッドへ移動し入力したコマンドと対応させる．そして，対応したコマンドの処理が行われるメソッドに移動することで実行される．このようにoptparseでは実行を行うためのメソッドが必要である.
+
+\subsubsection{コード}
+optparseの呼び出し側のexe/hikiのコードは次の通りである．
+\begin{lstlisting}[style=customRuby,basicstyle={\scriptsize\ttfamily}]
+#!/usr/bin/env ruby                                                             
+
+require "hikiutils"
+
+HikiUtils::Command.run(ARGV)
+\end{lstlisting}
+「require "hikituils"」ではlib/hikiutils.rbを読み出してくることを期待している．
+これはgemspecファイルでlibへのロードパスの記述がされているため，hikiutils.rbを参照することができる．
+「Hikiuils::Command.run(ARGV)」ではlib/hikiutils.rbのHikiUtilsモジュールCommandクラスのrunメソッドを実行する記述が成されている．
+
+また呼び出される側のlib/hikiutils.rbのrunおよびexecute部のコードは次の通りとなる．
+\begin{lstlisting}[style=customRuby,basicstyle={\scriptsize\ttfamily}]
+    def self.run(argv=[])
+      print "hikiutils: provide utilities for helping hiki editing.\n"
+      new(argv).execute
+    end
+
+    def execute
+      @argv << '--help' if @argv.size==0
+      command_parser = OptionParser.new do |opt|
+        opt.on('-v', '--version','show program Version.') { |v|
+          opt.version = HikiUtils::VERSION
+          puts opt.ver
+        }
+        opt.on('-s', '--show','show sources') {show_sources}
+        opt.on('-a', '--add','add sources info') {add_sources }
+        opt.on('-t', '--target VAL','set target id') {|val| set_target(val) }
+        opt.on('-e', '--edit FILE','open file') {|file| edit_file(file) }
+        opt.on('-l', '--list [FILE]','list files') {|file| list_files(file) }
+        opt.on('-u', '--update FILE','update file') {|file| update_file(file) }
+        opt.on('-r', '--rsync','rsync files') {rsync_files}
+        opt.on('--database FILE','read database file') {|file| db_file(file)}
+        opt.on('--display FILE','display converted hikifile') {|file| display(f\
+ile)}
+        opt.on('-c', '--checkdb','check database file') {check_db}
+        opt.on('--remove FILE','remove file') {|file| remove_file(file)}
+        opt.on('--move FILES','move file1,file2',Array) {|files| move_file(file\
+s)}
+        opt.on('--euc FILE','translate file to euc') {|file| euc_file(file) }
+        opt.on('--initialize','initialize source directory') {dir_init() }
+      end
+      begin
+        command_parser.parse!(@argv)
+      rescue=> eval
+        p eval
+      end
+      dump_sources
+      exit
+    end  
+\end{lstlisting}
+runメソッドでは「hikiutils: provide utilities for helping hiki editing.」を表示させ，executeメソッドを実行させる．
+executeメソッドでは最初に「@argv \<\< '--help' if @argv.size==0」と記述する．これはもしargv配列の中身が空であればargv配列に'--help'を代入する．「command\_parser = OptionParser.new do |opt|」ではOptionParserオブジェクトがoptを生成しコマンドを登録していき，command\_parserに代入する．そして，「command\_parser.parse!(@argv)」では@argvにある文字列をcommand\_parserでparseする．つまり，ここでは入力されたコマンドを解析し，登録されたコマンドと一致すればその処理が行われる．もし，一致しなければevalメソッドで表示する．
+

data/hikiutils_yamane/latex_dir/results.aux

@@ -0,0 +1,49 @@
+\relax 
+\@writefile{toc}{\contentsline {section}{\numberline {4}結果}{15}}
+\@writefile{toc}{\contentsline {subsection}{\numberline {4.1}コマンドの命名原則}{15}}
+\@writefile{toc}{\contentsline {subsubsection}{\numberline {4.1.1}hikiutilsの想定利用形態}{15}}
+\@writefile{lof}{\contentsline {figure}{\numberline {4}{\ignorespaces hikiutilsがあらかじめ想定している利用形態．}}{15}}
+\newlabel{fig:002}{{4}{15}}
+\newlabel{default}{{4}{15}}
+\@writefile{toc}{\contentsline {subsubsection}{\numberline {4.1.2}コメンド名と振る舞いの詳細}{16}}
+\@writefile{lot}{\contentsline {table}{\numberline {1}{\ignorespaces コマンドオプションとshellコマンドの対応．}}{17}}
+\newlabel{table:ShellOption}{{1}{17}}
+\newlabel{default}{{1}{17}}
+\@writefile{toc}{\contentsline {paragraph}{open FILE}{17}}
+\@writefile{toc}{\contentsline {paragraph}{ls [FILE]}{17}}
+\@writefile{toc}{\contentsline {paragraph}{rsync}{17}}
+\@writefile{toc}{\contentsline {paragraph}{touch FILE}{18}}
+\@writefile{toc}{\contentsline {paragraph}{pwd}{18}}
+\@writefile{toc}{\contentsline {paragraph}{cd VAL}{18}}
+\@writefile{toc}{\contentsline {subsection}{\numberline {4.2}Thorによる実装}{18}}
+\@writefile{toc}{\contentsline {subsubsection}{\numberline {4.2.1}クラス初期化}{18}}
+\@writefile{lof}{\contentsline {figure}{\numberline {5}{\ignorespaces Thorのinitializeでのコード}}{19}}
+\newlabel{default}{{5}{19}}
+\@writefile{toc}{\contentsline {subsubsection}{\numberline {4.2.2}コマンド定義}{19}}
+\@writefile{lof}{\contentsline {figure}{\numberline {6}{\ignorespaces Thorにおけるコマンド記述のひな形．}}{20}}
+\newlabel{fig:004}{{6}{20}}
+\newlabel{default}{{6}{20}}
+\@writefile{toc}{\contentsline {subsubsection}{\numberline {4.2.3}CLIの実行プロセス}{21}}
+\@writefile{lof}{\contentsline {figure}{\numberline {7}{\ignorespaces CLIの実行プロセス．}}{21}}
+\newlabel{fig:006}{{7}{21}}
+\newlabel{default}{{7}{21}}
+\@setckpt{results}{
+\setcounter{page}{23}
+\setcounter{equation}{0}
+\setcounter{enumi}{2}
+\setcounter{enumii}{0}
+\setcounter{enumiii}{0}
+\setcounter{enumiv}{0}
+\setcounter{footnote}{0}
+\setcounter{mpfootnote}{0}
+\setcounter{part}{0}
+\setcounter{section}{4}
+\setcounter{subsection}{2}
+\setcounter{subsubsection}{3}
+\setcounter{paragraph}{0}
+\setcounter{subparagraph}{0}
+\setcounter{figure}{7}
+\setcounter{table}{1}
+\setcounter{lstnumber}{14}
+\setcounter{lstlisting}{0}
+}