my_help 0.4.5 → 0.5.0

data/docs/yagi/bachelor_thesis/final/thesis/mk_latex/split_files/chapter1/chapter1.tex

@@ -0,0 +1,8 @@
+\chapter{はじめに}\label{ux306fux3058ux3081ux306b}
+
+\section{目的}\label{ux76eeux7684}
+
+西谷研究室で使われているユーザメモソフト，my\_helpの振る舞いを制御しているサブコマンドは，マイナスを付した省略記法が取られている．プログラミング初心者にとってこの省略記法は，覚えにくかったりわかりにくかったりするという問題があり，現在はフルワードを使った自然言語に近い記述法が多く用いられている．
+そこで，本研究ではコマンドラインツール作成ライブラリを自然言語に近いサブコマンド体系を実装しやすいライブラリであるThorに変更する．rubyの標準ライブラリであるoptparseで作成されているmy\_helpをThorによって書き直し，異なった2つライブラリで作成されたmy\_helpの使用感を比較検討することを目的とする．
+
+    

data/docs/yagi/bachelor_thesis/final/thesis/mk_latex/split_files/chapter2/chapter2.log

@@ -0,0 +1,28 @@
+This is pdfTeX, Version 3.14159265-2.6-1.40.18 (TeX Live 2017) (preloaded format=pdflatex 2017.12.7)  13 FEB 2018 16:41
+entering extended mode
+ restricted \write18 enabled.
+ file:line:error style messages enabled.
+ %&-line parsing enabled.
+**chapter2.tex
+(./chapter2.tex
+LaTeX2e <2017-04-15>
+Babel <3.15> and hyphenation patterns for 84 language(s) loaded.
+./chapter2.tex:1: Undefined control sequence.
+l.1 \chapter
+            {基本的事項}\label{ux57faux672cux7684ux4e8bux9805}
+? 
+./chapter2.tex:1: Emergency stop.
+l.1 \chapter
+            {基本的事項}\label{ux57faux672cux7684ux4e8bux9805}
+End of file on the terminal!
+
+ 
+Here is how much of TeX's memory you used:
+ 5 strings out of 492985
+ 131 string characters out of 6132586
+ 54187 words of memory out of 5000000
+ 3668 multiletter control sequences out of 15000+600000
+ 3640 words of font info for 14 fonts, out of 8000000 for 9000
+ 1141 hyphenation exceptions out of 8191
+ 5i,0n,1p,78b,8s stack positions out of 5000i,500n,10000p,200000b,80000s
+./chapter2.tex:1:  ==> Fatal error occurred, no output PDF file produced!

data/docs/yagi/bachelor_thesis/final/thesis/mk_latex/split_files/chapter2/chapter2.tex

@@ -0,0 +1,127 @@
+\chapter{基本的事項}\label{ux57faux672cux7684ux4e8bux9805}
+
+\section{my\_help}\label{my_help}
+
+\subsection{my\_helpの目的}\label{my_helpux306eux76eeux7684}
+
+my\_helpとは，ユーザー独自のマニュアルを作成することができるユーザメモソフトである．これは，terminalだけを用いて簡単に起動，編集，削除などをすることができるため，非常に便利である．さらに，そのマニュアルは自分ですぐに編集，参照することができるので，メモとしての機能も果たし
+ている．これにより，プログラミング初心者が，頻繁に使うコマンドやキーバインドなどをいちいちweb
+browserを立ち上げて調べるのではなく，terminal上で即座に取得できるため，プログラム開発を集中することが期待される．
+
+メモやtodoリストの作成が行えることや，保存場所を共通化することでどこでも立ち上げることができることなど，emacsのorg-modeと類似している点がいくつか存在する．しかし，明確な相違点も存在する．org-modeはemacsを起動させなければならないが，my\_helpはemacsを起動させる必要がなくterminalで編集することが可能である．また，org-modeを使用するとなるとorg-mode独自のコマンドを学ぶ必要があり，学習コストがかかってしまう．my\_helpにはその必要がなく，非常に単純な操作でアプリを使用することができるので，org-modeの使い方を理解していない初心者にとって使いやすいものとなっている．
+
+また，アプリやプログラミング言語などの正式なマニュアルは英語で書かれていることが多く，初心者には理解するのが困難である．my\_helpを使用すれば，自分なりのマニュアルを作成することができるので，仕様を噛み砕いて理解することが可能である．tarminal上でいつでもメモを参照できるため，どこにメモをしたかを忘れるリスクも軽減される．
+
+\subsection{使用法}\label{ux4f7fux7528ux6cd5}
+
+インストールする方法だが，gemの標準とは少し方法が異なっている．
+まず，githubにあるmy\_helpのリポジトリをフォーク，クローンすることでローカル（ネットワークに繋がれていない環境）でもmy\_helpを操作することができるようになる．
+
+\begin{quote}
+git clone git@github.com:daddygongon/my\_help.git
+\end{quote}
+これ以降の作業はbundleにて行っていく．
+
+\begin{quote}
+bundle update
+\end{quote}
+を実行することでmy\_help.gemspecに記述されている必要なgemsがbundleされる．ここでCould
+not locate
+Gemfileとエラーが出た場合は、Gemfileのある場所を探し、その配下に移動してから再びコマンドを入力する．
+
+\begin{quote}
+bundle exec exe/my\_help
+\end{quote}
+でmy\_helpに用意されているコマンドを参照することができる．デフォルトでemacs\_helpというemacsのヘルプが用意されている．これはemacs\_helpの他に，省略形のe\_hでも表示されるようになっている．
+
+次に，独自のヘルプを作成する方法であるが，まず，
+
+\begin{quote}
+bundle exec exe/my\_help -i new\_help
+\end{quote}
+とすることでnew\_helpという名前のヘルプが作成され，そこにテンプレートが格納される．また，
+
+\begin{quote}
+bundle exec exe/my\_help -e new\_help
+\end{quote}
+で，自分の好きなように編集することができる．ヘルプが完成したら，
+
+\begin{quote}
+bundle exec exe/my\_help -m
+\end{quote}
+とすることでexeディレクトリにnew helpが追加され，new
+help，n\_hが使用可能になるという手順である．
+
+    \section{option}\label{option}
+
+今日，複雑な機能を持つコマンドが増加している．そのようなコマンドは，オプション（サブコマンド）を使用することで適切な動作を実行することが可能になる．例えばgitコマンドはオプションなしでは意味をなさない．オプションでどのような動作をするかが決まるので，オプションを入力することで正常に動作するのである．
+
+\subsection{optionの種類}\label{}
+
+optionの種類については以下のように述べられている．
+
+\begin{quote}
+そもそも，オプションにはショートオプションとロングオプションの２種類がある．ショートオプションはハイフンの後に英字１字を付けた形式のもので，-aや-vなどといったものがショートオプションである．また，ショートオプションは２つ以上のオプションを１つにまとめて実行することもできる．例えば，-l，-a，-tの３つのオプションを１つにまとめて-latとして実行することが可能である．それに対してロングオプションは，ハイフン２つの後に英字２字以上を付けることができる形式である．例えば-\/-allや-\/-versionなどである．ロングオプションは英字を２字以上使用することができるので，どのようなオプションであるかを明確にするために一般的にフルワードが採用されている．-\/-no-の形にすることで否定形のオプションを作成することも可能である．ロングオプションはショートオプションのように複数のオプションを１つにまとめることは不可能であり，１つ１つをスペースで区切る必要がある\cite{awesome}pp.14-5．
+\end{quote}
+
+ショートオプションを設定する際，英字１文字しか使用することができないので基本的には対応づけられたロングオプション（そのオプションがどのような動作を行うのかを表す単語）の頭文字であることが多く，慣れている人であればショートオプションを使うことで素早くアプリケーションを動かすことが可能である．しかし，用いるアプリが１つであるとは限らないし，全てのアプリのショートオプションを統一するのも困難である．またinitialとinstallなど，頭文字が重複してしまう２つのオプションがある場合，-iというショートオプションがinitialを意味するのかinstallを意味するのかを判断するのは，初心者には容易ではなく，混乱を引き起こしかねない．そのため，ヒューマンエラーを引き起こしてしまったり，学習コストがかかってしまったりすることがある．
+
+ショートオプションの場合，複数のオプションを一つにまとめることができると記述したが，これは引数を必要としないオプションの場合である．引数を必要とするオプションの場合，２文字目以降の英字は引数扱いになってしまう．例えば上に示した-latにおいて，-lが引数を必要とするオプションであれば，-latはatという引数が与えられた-lという風に解釈されてしまうので注意が必要である．そういった点においてもショートオプションは初心者にとって扱いにくい形式であると言える．
+
+Command Line Applicationのオプションの記述方法には幾つもの流儀があるようで
+何らかの標準があるわけではない．
+しかし，それら全てに対応することはできず，なんらかの
+基準に従ってオプション記法を解釈する必要がある．
+
+ここでは， "Build awesome command-line application in ruby 2"に従って
+オプション記法と用語をまとめておく．
+
+コマンドラインの基本形は，
+
+\begin{quote}
+ls -lat dir\_name
+\end{quote}
+というように
+
+\begin{quote}
+executabel options arguments
+\end{quote}
+での形であった．これは，GNU標準に基本構造が記載されている．
+
+その後，幾つかのswitchやflagを組み合わせて，複雑な
+命令を解釈できるようにするに従って，
+
+\begin{quote}
+grep -\/-igonre-case -C 4 "some string" /tmp
+\end{quote}
+などとほぼ呪文のような形態となってきた．
+
+その後，command line suiteと呼ばれる一群のcommand line
+applicationが登場した．典型的なのはgitである\cite{awesome}pp.14-5．
+
+gitはlinuxのバックアップを分散処理するために， Linus
+Torvaldsが開発したものであるが，いくつもの
+機能に従ってそれぞれ個別のコマンドが用意されていた．
+それぞれ，git-commitとかgit-fetchなどであった．
+それがある時，すべてをまとめてsuiteとして
+パッケージし直され，1つのまとまったcommandとして提供された．
+すなわち，git commitやgit fetchなどである\cite{awesome}p.16．
+
+\subsection{Command Line Interface}\label{}
+
+Graphical User Interface（GUI）はコンピュータグラフィックスとポインティングデバイスを用いて操作を行う方法である．
+それに対しCommand Line Interface（CLI）はCharacter User Interface（CUI）とも呼ばれ，キーボードからの入力と文字による情報の表示だけを用いて操作を行う方法である．
+
+ "Build awesome command-line application in ruby 2"の中で，
+
+\begin{quote}
+グラフィカルユーザーインターフェース(GUI)はいろんな点で素晴らしいものです． 冷たくまたたくカーソルの殺伐とした輝きよりも， GUIはとりわけ初心者にとても優しいものです． でも，それには犠牲が伴います．GUIの熟練者になるには，奥義のようなキーボードショートカットを学ぶ必要があります． そうだとしても，あなたは生産性と効率の限界にぶち当たります． GUIはスクリプトして自動化しにくいことで悪名高いし，それができたとしても，あなたのスクリプトは移植しにくい傾向にあります\cite{awesome}pp.3-4．
+\end{quote}
+
+と述べられており，GUIの限界について示唆している．また，
+
+\begin{quote}
+あなたのアプリをインストールした後，それを用いたユーザーが最初に体験するのは実際のコマンドラインインターフェイスでしょう．もしそのインターフェイスが難しく，直感的でなく，もしくは，とても醜いならば，たくさんの自信を呼び起こすことはできないし，ユーザーはそれを使って明確で簡潔な目的を達成するのに苦労するでしょう．逆に，使いやすければ，あなたのインターフェイスはアプリケーションに観衆と鋭さを与えてくれるでしょう\cite{awesome}pp.3-4．
+\end{quote}
+
+とも述べられている．

data/{my_help_nasu/latex_dir/method_cucumber.log → docs/yagi/bachelor_thesis/final/thesis/mk_latex/split_files/chapter3/chapter3.log}

@@ -1,28 +1,28 @@
-This is e-pTeX, Version 3.14159265-p3.7-160201-2.6 (utf8.euc) (TeX Live 2016) (preloaded format=platex 2017.1.26)  8 FEB 2017 06:33
+This is e-pTeX, Version 3.14159265-p3.7-160201-2.6 (utf8.euc) (TeX Live 2016) (preloaded format=platex 2017.1.26)  14 FEB 2018 18:49
 entering extended mode
  restricted \write18 enabled.
  file:line:error style messages enabled.
  %&-line parsing enabled.
-**method_cucumber.tex
-(./method_cucumber.tex
+**chapter3.tex
+(./chapter3.tex
 pLaTeX2e <2016/11/29> (based on LaTeX2e <2017/01/01>)
 Babel <3.9r> and hyphenation patterns for 83 language(s) loaded.
-./method_cucumber.tex:2: Undefined control sequence.
-l.2 \subsection
-               {Cucumberについて}
+./chapter3.tex:1: Undefined control sequence.
+l.1 \chapter
+            {研究内容}\label{ux7814ux7a76ux5185ux5bb9}
 ? 
-./method_cucumber.tex:2: Emergency stop.
-l.2 \subsection
-               {Cucumberについて}
+./chapter3.tex:1: Emergency stop.
+l.1 \chapter
+            {研究内容}\label{ux7814ux7a76ux5185ux5bb9}
 End of file on the terminal!
 
  
 Here is how much of TeX's memory you used:
  4 strings out of 493683
- 74 string characters out of 6149653
+ 46 string characters out of 6149653
  53892 words of memory out of 5000000
  3671 multiletter control sequences out of 15000+600000
  7511 words of font info for 31 fonts, out of 8000000 for 9000
  929 hyphenation exceptions out of 8191
- 5i,0n,3p,51b,8s stack positions out of 5000i,500n,10000p,200000b,80000s
+ 5i,0n,3p,65b,8s stack positions out of 5000i,500n,10000p,200000b,80000s
 No pages of output.

data/docs/yagi/bachelor_thesis/final/thesis/mk_latex/split_files/chapter3/chapter3.tex

@@ -0,0 +1,328 @@
+\chapter{研究内容}\label{ux7814ux7a76ux5185ux5bb9}
+
+\section{optparseとThorの比較}\label{}
+
+\subsection{optparse}\label{optparse}
+
+今回の研究対象のmy\_helpは，optparseで実装されている．optparseはrubyの標準ライブラリであり，rubyでコマンドラインのオプションを操作するためのライブラリである\cite{opt1}．optparseが操作するオプションは，下記のonメソッドで設定する．
+
+\begin{screen}
+{\small
+\begin{verbatim}
+def execute
+  @argv << ’--help’ if @argv.size==0
+  command_parser = OptionParser.new do |opt|
+    opt.on(’-v’, ’--version’,’show program Version.’ ) { |v|
+      opt.version = MyHelp::VERSION
+      puts opt.ver
+    }
+    opt.on(’-l’, ’--list’, ’list specific helps’){list_helps}
+    #中略
+  end
+  #中略
+end
+    
+def list_helps
+#中略
+end
+#後略
+\end{verbatim}}
+\end{screen} 
+
+
+上記のコードはoptparse版my\_helpの一部である．第１引数はショートオプションで，-aや-dのような形で設定する．同様にして，第２引数はロングオプションを表し，-\/-addや-\/-deleteのように，第３引数はそのオプションの説明文で，helpで表示される説明文を設定する．後ろのブロックには，そのオプションが指定された場合に実行されるコードを記述する
+\cite{opt2}．しかしこのライブラリでは自然言語に近い，ハイフンなしのサブコマンドを実装するには相当な書き換えが必要となる．
+
+メソッドの引数でオプションを定義し，引数が指定された時の処理をブロックで記述する．ブロックの引数にはオプションが指定されたことを示すtrueが渡される．onメソッドが呼ばれた時点ではオプションは実行されず，定義されるだけである．parseが呼ばれた際，コマンドラインにオプションが登録されていれば実行される．
+
+オプション定義の際，スペースの後に任意の文字を追加すると，そのオプションは引数を受け取るオプションになる．その文字に{[}{]}をつけることで引数は必須でなくなる．また引数がハイフンで始まる場合，オプションとの間にハイフンを２つ挟むことで引数として認識される．
+
+helpとversionのサブコマンドはデフォルトで作成される．
+
+\subsection{Thor}\label{thor}
+
+本研究ではoptparseの代わりのライブラリとしてThorの採用を検討する．Thorは，コマンドラインツールの作成を支援するライブラリであり，gitやbundlerのようにサブコマンドを含むコマンドラインツールを簡単に作成することができる
+\cite{koichiro}．Thorには以下のような特徴がある．
+
+\begin{itemize}
+\item コマンドラインオプションのパーズやサブコマンドごとのヘルプを作るなどの面倒な作業を簡単にこなすことができ，手早くビルドツールや実行可能なコマンドを作成できる
+\cite{hibariya}．
+
+\item 特殊なDSL(Domain Specific
+Language)を使わずにメソッドを定義することで処理を記述するため，テストを行いやすい
+\cite{hibariya}．
+
+\item optparseでは作成することが困難な，マイナスを伴わない(自然言語に近い)サブコマンドを実装することが可能である．下記はThor版my\_helpの一部である．
+\end{itemize}
+
+\begin{screen}
+{\small
+\begin{verbatim}
+desc 'list, --list', 'list specific helps'
+    map "--list" => "list"
+    def list
+      print "Specific help file:\n"
+      local_help_entries.each{|file|
+        file_path=File.join(@local_help_dir,file)
+        help = YAML.load(File.read(file_path))
+        print "  #{file}\t:#{help[:head][0]}\n"
+      }
+    end
+end
+\end{verbatim}}
+\end{screen}
+
+表\ref{opt_thor}にoptparseとThorの比較をまとめた．
+optparseではonメソッドでコマンドの登録を行い，その後のdefでコマンドの振る舞いを定義している．それに対してThorは登録と定義を同時に行うことが可能である．また，Thorを継承したクラスのパブリックメソッドがそのままコマンドになるので非常に簡単にコマンドを作成することが可能である．Thorはコマンドを作成した時点で自動的にヘルプを生成し，コマンドを指定せずにコマンドラインアプリを実行するとヘルプを表示する．
+\begin{table}[H]
+\centering
+\begin{center}
+\caption{optparse とThor の比較. \label{opt_thor}}
+\includegraphics[width=150mm]{../.././figs/opt_thor.png}
+\end{center}
+
+
+\label{fig:This}
+\end{table}
+
+\subsection{比較}\label{}
+
+書き換えの前に，単純なCLIを例にoptparseとThorの比較を行った．今回はコマンドに続けてnameを入力すると，Hello nameと出力するCLIをoptparseとThor，それぞれを用いて作成し，コード量や使用感を比較する．１つめのソースコードがoptparseを用いたもの（optparse.rb），２つめのソースコードがThorを用いたもの（thor.rb）である．
+
+\begin{screen}
+{\small
+\begin{verbatim}
+
+options = {:name => nil}
+
+parser = OptionParser.new do|opts|
+  opts.on('-n', '--name name', 'Give your own name') do |name|
+    options[:name] = name;
+    end
+
+  opts.on('-h', '--help', 'Displays Help') do
+    puts opts
+    exit
+    end
+end
+
+parser.parse!
+
+sayHello = 'Hello ' + options[:name]
+
+puts sayHello
+
+\end{verbatim}}
+\end{screen}
+
+\begin{screen}
+{\small
+\begin{verbatim}
+
+require 'thor'
+
+class MyCLI < Thor
+  desc "hello NAME", "say hello to NAME"
+  def hello(name)
+    puts "Hello #{name}"
+  end
+end
+
+MyCLI.start(ARGV)
+
+\end{verbatim}}
+\end{screen}
+
+optparse.rbは，onメソッドで，入力された名前を受け取る-nというコマンドの定義を行い，parser.parse!以降でHello nameと出力するように記述を行った．また，-hのコマンドでヘルプを表示できるようにコマンドを登録した．本来ならば，-nではなく-h（helloの頭文字）で登録したかったのだが，ヘルプを表示するコマンドが-hであり，重複してしまうためやむを得ず-nとした．一方thor.rbでは，Thorを継承したクラスの中でnameの受け取りとHello nameの表示を行うようにhelloコマンドを設定した．optparseと違い，Thorでは自動でヘルプが作成されるため，helpコマンドは作成していない．optparse.rbはサブコマンドを書かずに実行すると，エラーになってしまうが，thor.rbではコマンド一覧を表示してくれる．
+
+コード量は，helpを自動で生成する分，thor.rbの方が短くなっており，descの中で一つのコマンドが完結しているということもあってoptparse.rbよりも書きやすく感じられた．また，実際にコマンドを入力する際，thor.rbの方が自然言語に近いコマンドのため直感的に入力することができた．さらに，thor.rbでhelloの後にname（引数）を入力せずに実行するとhelloコマンドのusageが表示されるなど，使用感はthor.rbの方がよく感じられた．
+
+    \section{Thor化に伴う書き換え（具体的な作業）}\label{thorux5316ux306bux4f34ux3046ux66f8ux304dux63dbux3048ux5177ux4f53ux7684ux306aux4f5cux696d}
+
+optparseからThorへの書き換えの際，第一に必要となるのは，\textasciitilde{}.gemspecファイル内にThorがインストールされるように変更を加えることである．
+
+\begin{verbatim}
+spec.add_development_dependency "thor"
+\end{verbatim}
+
+この記述は，作成しているコマンドラインツールがThorに依存性を持つことを意味している．optparseで書いた場合は，Thorに依存性を持つ必要がなく，当然このような記述はされていないので，上の一文を書き加える必要がある．また，bundle
+updateをターミナル上で実行することで，ローカルでのコマンドラインツールを実行した際にThorが適用されるようにアップデートされる．そうすることで，Thorの記述が実際にソースファイルで使用できるようになる．
+
+\section{Thorによるサブコマンド}\label{thorux306bux3088ux308bux30b5ux30d6ux30b3ux30deux30f3ux30c9}
+
+次に，コマンドが呼ばれる流れについて説明する．
+
+\begin{enumerate}
+\def\labelenumi{\arabic{enumi}.}
+\tightlist
+\item
+  コマンドを実行する．
+\item
+  コマンドを実行すると，exeディレクトリの中にあるコマンド名と同じ名前のファイル（以降コマンドファイルと呼ぶ）が実行される．
+\item
+  コマンドファイル内でlibディレクトリ内のソースファイルをrequireしておき，クラス内のコマンドを解析する関数を呼び出す．
+\item
+  ソースファイル内に書かれた処理が実行される．
+\end{enumerate}
+
+このような流れでコマンドが呼び出され，処理が行われる．Thorとoptpaseの差異は4.におけるコマンドの解析による処理関数への中継の方法である．
+
+\section{exeディレクトリの書き換え}\label{exeux30c7ux30a3ux30ecux30afux30c8ux30eaux306eux66f8ux304dux63dbux3048}
+
+exeディレクトリの中にあるコマンドファイルについて書き換えを行う．まずはoptparseを使用した際のコマンドファイルの記述を記載する．
+
+\begin{screen}
+{\small
+\begin{verbatim}
+!/usr/bin/env ruby                                                                                                               
+require "my_help_opt"
+
+MyHelp::Command.run(ARGV)
+\end{verbatim}}
+\end{screen}
+
+optparseの場合，MyHelp::Command.run(ARGV)というクラス関数を実行することでコマンドを呼び出している．しかし，Thorはoptparseのようにrun(ARGV)を用いず，start(ARGV)というクラス関数を実行してコマンドを呼び出す．よって，runをstartに書き換える作業が必要になる．以下にThorを使用した際のコマンドファイルの記述を記載する．
+
+\begin{screen}
+{\small
+\begin{verbatim}
+!/usr/bin/env ruby                                                                                                               
+require "my_help_thor"
+
+MyHelp::Command.start(ARGV)
+\end{verbatim}}
+\end{screen}
+
+\section{libディレクトリ}\label{libux30c7ux30a3ux30ecux30afux30c8ux30ea}
+
+まず，self.runについてであるが，Thorでは使用されないのでこの一文は削除する．次にinitializeであるが，こちらについては変更が必要である．そもそもinitializeとはmy\_helpを動かすのに必要なディレクトリがあるかどうかを調べるメソッドであり，なければここで作ることができる．optparseのinitializeではargv={[}{]}となっているところをThorでは（アスタリスク）argvとする必要がある．また，大きな違いはsuperの有無である．optparseではsuperは必要ないのだが，Thorでは必要になる．
+
+\section{その他オプション}\label{ux305dux306eux4ed6ux30aaux30d7ux30b7ux30e7ux30f3}
+
+optparseではコマンド実行の際，引数の解析を行い，その引数に合わせた関数を呼び出す，という手順で動作している．その手順を記述した関数がexecuteである．
+
+
+\begin{screen}
+{\small
+\begin{verbatim}
+def execute
+      @argv << '--help' if @argv.size==0
+      command_parser = OptionParser.new do |opt|
+        opt.on('-v', '--version','show program Version.') { |v|
+          opt.version = MyHelp::VERSION
+          puts opt.ver
+        }
+        
+        opt.on('-l', '--list', 'list specific helps'){list_helps}
+        opt.on('-e NAME', '--edit NAME',
+         'edit NAME help(eg test_help)'){|file| edit_help(file)}
+        opt.on('-i NAME', '--init NAME',
+         'initialize NAME help(eg test_help).'){|file| init_help(file)}
+        opt.on('-m', '--make', 'make executables for all helps.'){make_help}
+        opt.on('-c', '--clean', 'clean up exe dir.'){clean_exe}
+        opt.on('--install_local','install local after edit helps')
+        {install_local}
+        opt.on('--delete NAME','delete NAME help'){|file| delete_help(file)}
+      end
+      
+      begin
+        command_parser.parse!(@argv)
+      rescue=> eval
+        p eval
+      end
+      exit
+end
+\end{verbatim}}
+\end{screen}
+
+しかしThorの場合，executeのような間を取り持つ関数を用意する必要がなく，関数自体をコマンドとして登録していく形をとっているので，この関数は不必要である．以下にThorでの関数宣言を記載する．optparseの場合，-iというコマンドで呼び出されている処理をinitというコマンドで呼び出されるように書き換えたのが以下の関数である．
+
+
+\begin{screen}
+{\small
+\begin{verbatim}
+desc 'init NAME, --init NAME', 'initialize NAME help(eg test_help).'
+ # 関数についての説明，ここがヘルプで表示される．
+map "--init" => "init"
+ --オプションでも呼び出すことが可能．
+def init(file)
+以下は変更なし
+    p target_help=File.join(@local_help_dir,file)
+    if File::exists?(target_help)
+        puts "File exists. rm it first to initialize it."
+        exit
+    end
+    p template = File.join(@default_help_dir,'template_help')
+    FileUtils::Verbose.cp(template,target_help)
+end
+\end{verbatim}}
+\end{screen}
+
+このように書き換えることで，Thorを使用したオプションの設定を行うことができるのだが，実際に動かしてみるとエラーが表示されることがある．ここで表示されるエラーは，コマンドとして設定されていない関数があることについての警告文である．その関数はコマンドとして使用しないということを明確に記述することでこの警告を消すことが可能である．
+
+\begin{screen}
+{\small
+\begin{verbatim}
+no_commands do
+
+    この間にコマンド設定しない関数を記述
+
+end
+\end{verbatim}}
+\end{screen}
+
+\section{変更後のオプション}\label{}
+
+オプションを省略記法から自然言語に近い記法に変更したことでより直感的なコマンド入力が可能になると思われる．以下にThorで書き換えた後のmy\_helpのオプション一覧を示す．
+
+\begin{screen}
+{\small
+\begin{verbatim}
+Commands:
+my_help clean, --clean clean up exe dir.
+my_help delete NAME, --delete NAME delete NAME help
+my_help edit NAME, --edit NAME edit NAME help(eg test_help)
+my_help help {[}COMMAND{]} Describe available commands or one specific
+command
+my_help init NAME, --init NAME initialize NAME help(eg test_help).
+my_help install_local, --install_local install local after edit
+helps
+my_help list, --list list specific helps
+my_help make, --make make executables for all helps.
+my_help version, -v show program version
+\end{verbatim}}
+\end{screen}
+
+\section{コマンドの自動生成}\label{}
+
+自分で作成したヘルプにはデフォルトでどのヘルプにも存在するコマンドと，個別に存在するコマンドがある．デフォルトで存在するコマンドを自動生成する部分をThorで記述しようとすると非常に複雑になるため，その部分の記述をoptparseで記述した．これにより，Thorで記述すると非常に冗長になってしまうソースコードを簡潔に記述することができた．
+
+\begin{screen}
+{\small
+\begin{verbatim}
+Commands:
+  emacs_help add NAME, --add NAME        # add NAME help
+  emacs_help all, --all                  # all help
+  emacs_help backup NAME, --backup NAME  # backup NAME help
+  emacs_help edit, --edit                # edit help
+  emacs_help help [COMMAND]              # Describe available commands
+  emacs_help hiki, --hiki                # hiki help
+  emacs_help remove NAME, --remove NAME  # remove NAME help
+  emacs_help store NAME, --store         # store NAME help
+
+Usage: emacs_help [options]
+    -v, --version                    show program Version.
+    -c, --cursor                     Cursor移動
+    -p, --ページ                        Page移動
+    -f, --ファイル                       File操作
+    -e, --編集                         Edit操作
+    -w, --ウィンドウ                      Window操作
+    -b, --バッファ                       Buffer操作
+    -q, --終了                         終了操作
+\end{verbatim}}
+\end{screen}
+
+上記はemacs\_helpという独自のヘルプのコマンドである．前半部分のコマンドがThorで記述されたもの，後半部分のコマンドはoptparseで自動生成したものである．
+
+
+

data/docs/yagi/bachelor_thesis/final/thesis/mk_latex/split_files/chapter4/chapter4.tex

@@ -0,0 +1,13 @@
+\chapter{総括}\label{ux7dcfux62ec}
+
+今回の研究では，ユーザメモソフトであるmy\_helpのThorによる書き換えを行った．この書き換えによる成果は以下の通りである．
+
+\begin{enumerate}
+\def\labelenumi{\arabic{enumi}.}
+\item
+  オプションの記法を-（ハイフン）を用いた省略記法からフルワードを用いた自然言語に近い記法に変更した．これにより，初心者でも直感的にオプションを使用することができ，学習コストの削減，学習効率の向上に繋がると考えられる．
+\item
+  Thorを用いることによってoptparseを用いた時よりもソースコードを短くすることに成功した．
+\end{enumerate}
+
+    

data/docs/yagi/bachelor_thesis/final/thesis/mk_latex/split_files/chapter5/chapter5.tex

@@ -0,0 +1,5 @@
+\chapter*{謝辞}\label{ux8b1dux8f9e}
+
+本研究を行うにあたって，終始多大なるご指導，ご鞭撻を頂いた関西学院大学理工学部情報科学科西谷滋人教授に対し，深く御礼申し上げます．また，本研究の進行に伴い，様々な助力，協力をして頂きました西谷研究室の先輩方，同輩達に心から感謝いたします．西谷研究室の益々のご発展，ご多幸を心よりお祈り申し上げます．
+
+    

data/docs/yagi/bachelor_thesis/final/thesis/mk_latex/split_files/chapter6/chapter6.log

@@ -0,0 +1,38 @@
+This is e-pTeX, Version 3.14159265-p3.7-160201-2.6 (utf8.euc) (TeX Live 2016) (preloaded format=platex 2017.1.26)  14 FEB 2018 19:09
+entering extended mode
+ restricted \write18 enabled.
+ file:line:error style messages enabled.
+ %&-line parsing enabled.
+**chapter6.tex
+(./chapter6.tex
+pLaTeX2e <2016/11/29> (based on LaTeX2e <2017/01/01>)
+Babel <3.9r> and hyphenation patterns for 83 language(s) loaded.
+
+./chapter6.tex:3: LaTeX Error: Environment thebibliography undefined.
+
+See the LaTeX manual or LaTeX Companion for explanation.
+Type  H <return>  for immediate help.
+ ...                                              
+                                                  
+l.3 \begin{thebibliography}
+                           {9}
+? 
+./chapter6.tex:3: Emergency stop.
+ ...                                              
+                                                  
+l.3 \begin{thebibliography}
+                           {9}
+Your command was ignored.
+Type  I <command> <return>  to replace it with another command,
+or  <return>  to continue without it.
+
+ 
+Here is how much of TeX's memory you used:
+ 6 strings out of 493683
+ 207 string characters out of 6149653
+ 54216 words of memory out of 5000000
+ 3672 multiletter control sequences out of 15000+600000
+ 7511 words of font info for 31 fonts, out of 8000000 for 9000
+ 929 hyphenation exceptions out of 8191
+ 5i,0n,4p,67b,16s stack positions out of 5000i,500n,10000p,200000b,80000s
+No pages of output.

data/docs/yagi/bachelor_thesis/final/thesis/mk_latex/split_files/chapter6/chapter6.tex

@@ -0,0 +1,28 @@
+%\chapter*{参考文献}\label{ux53c2ux8003ux6587ux732e}
+
+\begin{thebibliography}{9}
+\bibitem{awesome}  David Bryant Copeland, {\it Build Awesome Command-Line Applications in Ruby 2}，(Pragmatic Bookshelf, 2013).
+
+\bibitem{opt1} library optparse, erikhuda, 
+\texttt{https://docs.ruby-lang.org/ja/latest/library\slash optparse.html}, 
+accessed 2018.2.9.
+
+\bibitem{opt2} コマンドライン引数によるオプションに対応する (optparse),
+\texttt{http://maku77.github.io/ruby/io/optparse.html}, 
+accessed 2018.2.1.
+
+\bibitem{koichiro} S.Koichiro,
+Thorの使い方まとめ,
+\texttt{http://qiita.com/succi0303/items\slash32560103190436c9435b}, 
+accessed 2018.2.9.
+
+\bibitem{hibariya} Hibariya,
+Thorで簡単にコマンドラインアプリをつくる,
+\url{http://note.hibariya.org/articles/20111025/a0.html}, 
+accessed 2018.2.9.
+\end{thebibliography}
+
+
+    % Add a bibliography block to the postdoc
+    
+\end{document}

data/docs/yagi/bachelor_thesis/final/thesis/mk_latex/split_files/informations/informations.aux

@@ -0,0 +1 @@
+\relax