my_help 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: b7748831520dc7c031ae3a9896b230b3cac6ad2b
+  data.tar.gz: 84cd874af8c122770dfc8b05a340893769a920a1
+SHA512:
+  metadata.gz: 0f37baeda38f155012232fdef59801bee91af8f1ba07e90813a35745a6c226a60a0d0569f0a83fa96220aba97358f39819f3bed8fa22d1f8dd126b4285f0cb52
+  data.tar.gz: 3397b6059109407b2b24a6b7ed77d0d7d3462e814eff019d2a78f201f6e378efbd04ded5a940e6af6750775d34c19f462a90899b438a99c0ad83dba4e38944c9

data/.gitignore

@@ -0,0 +1,9 @@
+/.bundle/
+/.yardoc
+/Gemfile.lock
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/

data/.travis.yml

@@ -0,0 +1,4 @@
+language: ruby
+rvm:
+  - 2.2.2
+before_install: gem install bundler -v 1.11.2

data/.yardopts

@@ -0,0 +1,2 @@
+-
+**/*.md

data/CODE_OF_CONDUCT.md

@@ -0,0 +1,49 @@
+# Contributor Code of Conduct
+
+As contributors and maintainers of this project, and in the interest of
+fostering an open and welcoming community, we pledge to respect all people who
+contribute through reporting issues, posting feature requests, updating
+documentation, submitting pull requests or patches, and other activities.
+
+We are committed to making participation in this project a harassment-free
+experience for everyone, regardless of level of experience, gender, gender
+identity and expression, sexual orientation, disability, personal appearance,
+body size, race, ethnicity, age, religion, or nationality.
+
+Examples of unacceptable behavior by participants include:
+
+* The use of sexualized language or imagery
+* Personal attacks
+* Trolling or insulting/derogatory comments
+* Public or private harassment
+* Publishing other's private information, such as physical or electronic
+  addresses, without explicit permission
+* Other unethical or unprofessional conduct
+
+Project maintainers have the right and responsibility to remove, edit, or
+reject comments, commits, code, wiki edits, issues, and other contributions
+that are not aligned to this Code of Conduct, or to ban temporarily or
+permanently any contributor for other behaviors that they deem inappropriate,
+threatening, offensive, or harmful.
+
+By adopting this Code of Conduct, project maintainers commit themselves to
+fairly and consistently applying these principles to every aspect of managing
+this project. Project maintainers who do not follow or enforce the Code of
+Conduct may be permanently removed from the project team.
+
+This code of conduct applies both within project spaces and in public spaces
+when an individual is representing the project or its community.
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be
+reported by contacting a project maintainer at shigeto_nishitani@me.com. All
+complaints will be reviewed and investigated and will result in a response that
+is deemed necessary and appropriate to the circumstances. Maintainers are
+obligated to maintain confidentiality with regard to the reporter of an
+incident.
+
+This Code of Conduct is adapted from the [Contributor Covenant][homepage],
+version 1.3.0, available at
+[http://contributor-covenant.org/version/1/3/0/][version]
+
+[homepage]: http://contributor-covenant.org
+[version]: http://contributor-covenant.org/version/1/3/0/

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in my_help.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2016 Shigeto R. Nishitani
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -0,0 +1,121 @@
+# 名前
+
+petit_help, general_help, my_help, ...
+
+# 概要
+
+CUI(CLI)ヘルプのUsage出力を真似て，user独自のhelpを作成・提供するgem.
+
+# 問題点
+CUIやshell, 何かのプログラミング言語などを習得しようとする初心者は，
+commandや文法を覚えるのに苦労します．少しのkey(とっかかり)があると
+思い出すんですが，うろ覚えでは間違えて路頭に迷います．問題点は，
+- manは基本的に英語
+- manualでは重たい
+- いつもおなじことをwebで検索して
+- 同じとこ見ている
+- memoしても，どこへ置いたか忘れる
+
+などです．
+
+# 特徴
+これらをgem環境として提供しようというのが，このgemの目的です．
+仕様としては，
+- userが自分にあったmanを作成
+- 雛形を提供
+  - おなじformat, looks, 操作, 階層構造
+- すぐに手が届く
+- それらを追加・修正・削除できる
+
+hikiでやろうとしていることの半分くらいはこのあたりのことなの
+かもしれません．memoソフトでは，検索が必要となりますが，my_helpは
+key(記憶のとっかかり)を提供することが目的です．
+
+# userの独自helpの達成方法
+exe中のファイルをrakeで自動生成．
+./lib/daddygongon/にそれらのdataを保存．以下ではその名前から
+exe中に実行ファイルを自動生成させている．
+```
+lib/daddygongon/
+└── emacs_help
+
+exe
+├── e_h
+└── emacs_help
+```
+ということ．これは，
+```
+rake my_help
+```
+で実行される．これを
+```
+rake install:local
+```
+すれば必要とするhelpがlocalな環境で表示される．
+
+たくさんの実行ファイルを/usr/loca/binに置くことになるので，
+```
+gem uninstall my_help
+gem uninstall emacs_help
+```
+でそこをcleanにしておくことが望ましい．
+```ruby
+desc "make own help from lib/daddygongon/files"
+task :my_help do
+  exe_cont="#!/usr/bin/env ruby\n"
+  user_name = 'daddygongon'
+  p entries=Dir.entries(File.join('.','lib',user_name))[2..-1]
+  entries.each{|file|
+    p file
+    p file_name=file.split('_')
+    target_files = [file, file_name[0][0]+"_"+file_name[1][0]]
+    p cont_name = File.join(user_name,file)
+#    exe_cont << "require '#{cont_name}'\n"
+    exe_cont << "require 'emacs_help'\n"
+    exe_cont << "EmacsHelp::Command.run(ARGV)\n"
+    target_files.each{|name|
+      p target=File.join('exe',name)
+      File.open(target,'w'){|file|
+        file.print exe_cont
+      }
+      FileUtils.chmod('a+x', target, :verbose => true)
+    }
+  }
+end
+```
+
+この後の実装方法は，emacs_helpに
+
+1. yaml形式でdataを入れ，command.runの入力ファイルとする
+1. hush形式でdataをいれ，それをrequireして使う
+
+かのどちらかで実装．speedとかdebugを比較・検証する必要あり．
+
+# どちらがいいか
+Rubyで日本語が使えるから，optionsを日本語にしてみた．
+```
+Usage: eh [options]
+    -v, --version                    show program Version.
+    -c, --カーソル                       Cursor移動
+    -p, --ページ                        Page移動
+    -f, --ファイル                       File操作
+    -e, --編集                         Edit操作
+    -w, --ウィンドウ                      Window操作
+    -b, --バッファ                       Buffer操作
+    -q, --終了                         終了操作
+```
+半角，全角がoptparseでは適切に判断できない様で，表示があまり揃っていない．
+しかし，初心者の振る舞いを見ているとわざわざ日本語に切り替えて打ち込むことは稀であり，
+key wordをhelpで参照してshort optionで入力している．そこで，
+```
+Usage: eh [options]
+    -v, --version      show program Version.
+    -c, --cursor       カーソル移動
+    -p, --page         ページ移動
+    -f, --file         ファイル操作
+    -e, --edit         編集操作
+    -w, --window       ウィンドウ操作
+    -b, --buffer       バッファ操作
+    -q, --quit         終了操作
+```
+としたほうがいいと提案する．アンケートを実施してみてほしい．

data/Rakefile

@@ -0,0 +1,74 @@
+require "bundler/gem_tasks"
+require 'yard'
+require "rake/testtask"
+require 'fileutils'
+p base_path = File.expand_path('..', __FILE__)
+p basename = File.basename(base_path)
+
+task :default do
+  system 'rake -T'
+end
+
+desc "make documents by yard"
+task :yard => [:hiki2md] do
+  YARD::Rake::YardocTask.new
+end
+
+desc "transfer hikis/*.hiki to wiki"
+task :hiki2md do
+  files = Dir.entries('hikis')
+  files.each{|file|
+    name=file.split('.')
+    case name[1]
+    when 'hiki'
+      p command="hiki2md hikis/#{name[0]}.hiki > #{basename}.wiki/#{name[0]}.md"
+      system command
+    when 'gif','png','pdf'
+      p command="cp hikis/#{file} #{basename}.wiki/#{file}"
+#      system command
+      FileUtils.cp("hikis/#{file}","#{basename}.wiki/#{file}",:verbose=>true)
+      FileUtils.cp("hikis/#{file}","doc/#{file}",:verbose=>true)
+    end
+  }
+  readme_en="#{basename}.wiki/README_en.md"
+  readme_ja="#{basename}.wiki/README_ja.md"
+  if File.exists?(readme_en)
+    FileUtils.cp(readme_en,"./README.md",:verbose=>true)  
+  elsif File.exists?(readme_ja)
+    FileUtils.cp(readme_ja,"./README.md",:verbose=>true)
+    FileUtils.cp(readme_ja,"#{basename}.wiki/Home.md",:verbose=>true)
+  end
+end
+
+desc "transfer hikis/*.hiki to latex"
+task :latex do
+  target = 'handout_sample'
+  command = "hiki2latex --pre latexes/handout_pre.tex hikis/#{target}.hiki > latexes/#{target}.tex"
+  system command
+  command = "open latexes/#{target}.tex"
+  system command
+end
+
+
+desc "make own help from lib/daddygongon/files"
+task :my_help do
+  exe_cont="#!/usr/bin/env ruby\n"
+  user_name = 'daddygongon'
+  p entries=Dir.entries(File.join('.','lib',user_name))[2..-1]
+  entries.each{|file|
+    p file
+    p file_name=file.split('_')
+    target_files = [file, file_name[0][0]+"_"+file_name[1][0]]
+    p cont_name = File.join(user_name,file)
+#    exe_cont << "require '#{cont_name}'\n"
+    exe_cont << "require 'my_help'\n"
+    exe_cont << "EmacsHelp::Command.run(ARGV)\n"
+    target_files.each{|name|
+      p target=File.join('exe',name)
+      File.open(target,'w'){|file|
+        file.print exe_cont
+      }
+      FileUtils.chmod('a+x', target, :verbose => true)
+    }
+  }
+end

data/bin/console

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+
+require "bundler/setup"
+require "my_help"
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+# (If you use this, don't forget to add pry to your Gemfile!)
+# require "pry"
+# Pry.start
+
+require "irb"
+IRB.start

data/bin/setup

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+set -euo pipefail
+IFS=$'\n\t'
+set -vx
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/exe/e_h

@@ -0,0 +1,3 @@
+#!/usr/bin/env ruby
+require 'my_help'
+EmacsHelp::Command.run(ARGV)

data/exe/emacs_help

@@ -0,0 +1,3 @@
+#!/usr/bin/env ruby
+require 'my_help'
+EmacsHelp::Command.run(ARGV)

data/exe/my_help

@@ -0,0 +1,3 @@
+#!/usr/bin/env ruby
+
+require "my_help"

data/hikis/README_ja.hiki

@@ -0,0 +1,116 @@
+!名前
+
+petit_help, general_help, my_help, ...
+
+!概要
+
+CUI(CLI)ヘルプのUsage出力を真似て，user独自のhelpを作成・提供するgem.
+
+!問題点
+CUIやshell, 何かのプログラミング言語などを習得しようとする初心者は，
+commandや文法を覚えるのに苦労します．少しのkey(とっかかり)があると
+思い出すんですが，うろ覚えでは間違えて路頭に迷います．問題点は，
+* manは基本的に英語
+* manualでは重たい
+* いつもおなじことをwebで検索して
+* 同じとこ見ている
+* memoしても，どこへ置いたか忘れる
+
+などです．
+
+!特徴
+これらをgem環境として提供しようというのが，このgemの目的です．
+仕様としては，
+* userが自分にあったmanを作成
+* 雛形を提供
+** おなじformat, looks, 操作, 階層構造
+* すぐに手が届く
+* それらを追加・修正・削除できる
+
+hikiでやろうとしていることの半分くらいはこのあたりのことなの
+かもしれません．memoソフトでは，検索が必要となりますが，my_helpは
+key(記憶のとっかかり)を提供することが目的です．
+
+!userの独自helpの達成方法
+exe中のファイルをrakeで自動生成．
+./lib/daddygongon/にそれらのdataを保存．以下ではその名前から
+exe中に実行ファイルを自動生成させている．
+<<<
+lib/daddygongon/
+└── emacs_help
+
+exe
+├── e_h
+└── emacs_help
+>>>
+ということ．これは，
+ rake my_help
+で実行される．これを
+ rake install:local
+すれば必要とするhelpがlocalな環境で表示される．
+
+たくさんの実行ファイルを/usr/loca/binに置くことになるので，
+ gem uninstall my_help
+ gem uninstall emacs_help
+でそこをcleanにしておくことが望ましい．
+<<< ruby
+desc "make own help from lib/daddygongon/files"
+task :my_help do
+  exe_cont="#!/usr/bin/env ruby\n"
+  user_name = 'daddygongon'
+  p entries=Dir.entries(File.join('.','lib',user_name))[2..-1]
+  entries.each{|file|
+    p file
+    p file_name=file.split('_')
+    target_files = [file, file_name[0][0]+"_"+file_name[1][0]]
+    p cont_name = File.join(user_name,file)
+#    exe_cont << "require '#{cont_name}'\n"
+    exe_cont << "require 'my_help'\n"
+    exe_cont << "EmacsHelp::Command.run(ARGV)\n"
+    target_files.each{|name|
+      p target=File.join('exe',name)
+      File.open(target,'w'){|file|
+        file.print exe_cont
+      }
+      FileUtils.chmod('a+x', target, :verbose => true)
+    }
+  }
+end
+>>>
+
+この後の実装方法は，emacs_helpに
+
+# yaml形式でdataを入れ，command.runの入力ファイルとする
+# hush形式でdataをいれ，それをrequireして使う
+
+かのどちらかで実装．speedとかdebugを比較・検証する必要あり．
+
+!どちらがいいか
+Rubyで日本語が使えるから，optionsを日本語にしてみた．
+<<<
+Usage: eh [options]
+    -v, --version                    show program Version.
+    -c, --カーソル                       Cursor移動
+    -p, --ページ                        Page移動
+    -f, --ファイル                       File操作
+    -e, --編集                         Edit操作
+    -w, --ウィンドウ                      Window操作
+    -b, --バッファ                       Buffer操作
+    -q, --終了                         終了操作
+>>>
+半角，全角がoptparseでは適切に判断できない様で，表示があまり揃っていない．
+しかし，初心者の振る舞いを見ているとわざわざ日本語に切り替えて打ち込むことは稀であり，
+key wordをhelpで参照してshort optionで入力している．そこで，
+<<<
+Usage: eh [options]
+    -v, --version      show program Version.
+    -c, --cursor       カーソル移動
+    -p, --page         ページ移動
+    -f, --file         ファイル操作
+    -e, --edit         編集操作
+    -w, --window       ウィンドウ操作
+    -b, --buffer       バッファ操作
+    -q, --quit         終了操作
+>>>
+としたほうがいいと提案する．アンケートを実施してみてほしい．
+

data/latexes/handout_pre.tex

@@ -0,0 +1,11 @@
+\documentclass[10pt,a4j,twocolumn]{jsarticle}
+
+\usepackage[dvipdfmx]{graphicx}
+
+\setlength{\textheight}{275mm}
+\headheight 5mm
+\topmargin -30mm
+\textwidth 185mm
+\oddsidemargin -15mm
+\evensidemargin -15mm
+\pagestyle{empty}

data/lib/emacs_help/version.rb

@@ -0,0 +1,3 @@
+module EmacsHelp
+  VERSION = "0.1.2"
+end

data/lib/emacs_help.rb

@@ -0,0 +1,122 @@
+# -*- coding: utf-8 -*-
+require "optparse"
+require "emacs_help/version"
+
+module EmacsHelp
+  class Command
+    def self.run(argv=[])
+      print "\n特殊キー操作"
+      print "\tc-f, controlキーを押しながら    'f'\n"
+      print "\t\tM-f, escキーを押した後一度離して'f'\n"
+      print "\t操作の中断c-g, 操作の取り消し(Undo) c-x u \n"
+      new(argv).execute
+    end
+
+    def initialize(argv=[])
+      @argv = argv
+      data_path = File.join(ENV['HOME'], '.hikirc')
+    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 = EmacsHelp::VERSION
+          puts opt.ver
+        }
+        opt.on('-c','--カーソル','Cursor移動') {cursor_move}
+        opt.on('-p','--ページ','Page移動') {page_move}
+        opt.on('-f','--ファイル','File操作') {file}
+        opt.on('-e','--編集','Edit操作') {edit}
+        opt.on('-w','--ウィンドウ','Window操作') {window}
+        opt.on('-b','--バッファ','Buffer操作') {buffer}
+        opt.on('-q','--終了','終了操作') {quit}
+      end
+      begin
+        command_parser.parse!(@argv)
+      rescue=> eval
+        p eval
+      end
+      exit
+    end
+
+    def disp(lines)
+      lines.each{|line|
+        if line.include?(',')
+          show line
+        else
+          puts "    #{line}"
+        end
+      }
+    end
+    def show(line)
+      puts "  #{line}"
+    end
+
+    def quit
+      puts "\n終了操作quit"
+      cont = ["c-x c-c, Quit emacs, ファイルを保存して終了",
+              "c-z, suspend emacs,  一時停止，fgで復活"]
+      disp(cont)
+    end
+
+    def window
+      puts "\nウィンドウ操作window"
+      cont=["c-x 2, 2 windows, 二つに分割",
+            "c-x 1, 1 windows, 一つに戻す",
+            "c-x 3, 3rd window sep,縦線分割",
+            "c-x o, Other windows, 次の画面へ移動"]
+      disp(cont)
+    end
+
+    def buffer
+      puts "\nバッファー操作buffer"
+      cont =[ "c-x b, show Buffer,   バッファのリスト",
+              "c-x c-b, next Buffer, 次のバッファへ移動"]
+      disp(cont)
+    end
+
+    def edit
+      puts "\n編集操作editor"
+      cont = ["c-d, Delete char, 一字削除",
+              "c-k, Kill line,   一行抹消，カット",
+              "c-y, Yank,        ペースト",
+              "c-w, Kill region, 領域抹消，カット",
+              "領域選択は，先頭or最後尾でc-spaceした後，最後尾or先頭へカーソル移動",
+              "c-s, forward incremental Search WORD, 前へWORDを検索",
+              "c-r, Reverse incremental search WORD, 後へWORDを検索",
+              "M-x query-replace WORD1 <ret> WORD2：対話的置換(y or nで可否選択)"]
+      disp(cont)
+    end
+
+    def file
+      puts "\nファイル操作file"
+      cont =[ "c-x c-f, Find file, ファイルを開く",
+              "c-x c-s, Save file, ファイルを保存",
+              "c-x c-w, Write file NAME, ファイルを別名で書き込む"]
+      disp(cont)
+    end
+
+    def page_move
+      puts "\nページ移動page"
+      cont = ["c-v, move Vertical,          次のページへ",
+              "M-v, move reversive Vertical,前のページへ",
+              "c-l, centerise Line,       現在行を中心に",
+              "M-<, move Top of file,    ファイルの先頭へ",
+              "M->, move Bottom of file, ファイルの最後尾へ"]
+      disp(cont)
+    end
+
+    def cursor_move
+      puts "\nカーソル移動cursor"
+      cont = ["c-f, move Forwrard,    前or右へ",
+              "c-b, move Backwrard,   後or左へ",
+              "c-a, go Ahead of line, 行頭へ",
+              "c-e, go End of line,   行末へ",
+              "c-n, move Next line,   次行へ",
+              "c-p, move Previous line, 前行へ"]
+      disp(cont)
+    end
+
+  end
+end

data/lib/my_help/version.rb

@@ -0,0 +1,3 @@
+module MyHelp
+  VERSION = "0.1.0"
+end

data/lib/my_help.rb

@@ -0,0 +1,6 @@
+require "my_help/version"
+require "emacs_help"
+
+module MyHelp
+  # Your code goes here...
+end

data/my_help.gemspec

@@ -0,0 +1,37 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'my_help/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "my_help"
+  spec.version       = MyHelp::VERSION
+  spec.authors       = ["Shigeto R. Nishitani"]
+  spec.email         = ["shigeto_nishitani@me.com"]
+
+  spec.summary       = %q{display emacs key bindings in Japanese.}
+  spec.description   = %q{Emulating CUI(CLI) help, user make and display his own help.}
+  spec.homepage      = "https://github.com/daddygongon/my_help"
+  spec.license       = "MIT"
+
+  # Prevent pushing this gem to RubyGems.org by setting 'allowed_push_host', or
+  # delete this section to allow pushing this gem to any host.
+#  if spec.respond_to?(:metadata)
+#    spec.metadata['allowed_push_host'] = 'http://rubygems.org'
+#  else
+#    raise "RubyGems 2.0 or newer is required to protect against public gem pushes."
+#  end
+
+  spec.files         = `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+  spec.bindir        = "exe"
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ["lib"]
+
+  spec.add_development_dependency "bundler", "~> 1.11"
+  spec.add_development_dependency "rake", "~> 10.0"
+  spec.add_development_dependency "minitest", "~> 5.0"
+  spec.add_development_dependency "yard"
+  spec.add_development_dependency "hiki2md"
+  spec.add_development_dependency "mathjax-yard"
+  spec.add_development_dependency "hiki2latex"
+end

data/my_help.wiki/Home.md

@@ -0,0 +1,121 @@
+# 名前
+
+petit_help, general_help, my_help, ...
+
+# 概要
+
+CUI(CLI)ヘルプのUsage出力を真似て，user独自のhelpを作成・提供するgem.
+
+# 問題点
+CUIやshell, 何かのプログラミング言語などを習得しようとする初心者は，
+commandや文法を覚えるのに苦労します．少しのkey(とっかかり)があると
+思い出すんですが，うろ覚えでは間違えて路頭に迷います．問題点は，
+- manは基本的に英語
+- manualでは重たい
+- いつもおなじことをwebで検索して
+- 同じとこ見ている
+- memoしても，どこへ置いたか忘れる
+
+などです．
+
+# 特徴
+これらをgem環境として提供しようというのが，このgemの目的です．
+仕様としては，
+- userが自分にあったmanを作成
+- 雛形を提供
+  - おなじformat, looks, 操作, 階層構造
+- すぐに手が届く
+- それらを追加・修正・削除できる
+
+hikiでやろうとしていることの半分くらいはこのあたりのことなの
+かもしれません．memoソフトでは，検索が必要となりますが，my_helpは
+key(記憶のとっかかり)を提供することが目的です．
+
+# userの独自helpの達成方法
+exe中のファイルをrakeで自動生成．
+./lib/daddygongon/にそれらのdataを保存．以下ではその名前から
+exe中に実行ファイルを自動生成させている．
+```
+lib/daddygongon/
+└── emacs_help
+
+exe
+├── e_h
+└── emacs_help
+```
+ということ．これは，
+```
+rake my_help
+```
+で実行される．これを
+```
+rake install:local
+```
+すれば必要とするhelpがlocalな環境で表示される．
+
+たくさんの実行ファイルを/usr/loca/binに置くことになるので，
+```
+gem uninstall my_help
+gem uninstall emacs_help
+```
+でそこをcleanにしておくことが望ましい．
+```ruby
+desc "make own help from lib/daddygongon/files"
+task :my_help do
+  exe_cont="#!/usr/bin/env ruby\n"
+  user_name = 'daddygongon'
+  p entries=Dir.entries(File.join('.','lib',user_name))[2..-1]
+  entries.each{|file|
+    p file
+    p file_name=file.split('_')
+    target_files = [file, file_name[0][0]+"_"+file_name[1][0]]
+    p cont_name = File.join(user_name,file)
+#    exe_cont << "require '#{cont_name}'\n"
+    exe_cont << "require 'emacs_help'\n"
+    exe_cont << "EmacsHelp::Command.run(ARGV)\n"
+    target_files.each{|name|
+      p target=File.join('exe',name)
+      File.open(target,'w'){|file|
+        file.print exe_cont
+      }
+      FileUtils.chmod('a+x', target, :verbose => true)
+    }
+  }
+end
+```
+
+この後の実装方法は，emacs_helpに
+
+1. yaml形式でdataを入れ，command.runの入力ファイルとする
+1. hush形式でdataをいれ，それをrequireして使う
+
+かのどちらかで実装．speedとかdebugを比較・検証する必要あり．
+
+# どちらがいいか
+Rubyで日本語が使えるから，optionsを日本語にしてみた．
+```
+Usage: eh [options]
+    -v, --version                    show program Version.
+    -c, --カーソル                       Cursor移動
+    -p, --ページ                        Page移動
+    -f, --ファイル                       File操作
+    -e, --編集                         Edit操作
+    -w, --ウィンドウ                      Window操作
+    -b, --バッファ                       Buffer操作
+    -q, --終了                         終了操作
+```
+半角，全角がoptparseでは適切に判断できない様で，表示があまり揃っていない．
+しかし，初心者の振る舞いを見ているとわざわざ日本語に切り替えて打ち込むことは稀であり，
+key wordをhelpで参照してshort optionで入力している．そこで，
+```
+Usage: eh [options]
+    -v, --version      show program Version.
+    -c, --cursor       カーソル移動
+    -p, --page         ページ移動
+    -f, --file         ファイル操作
+    -e, --edit         編集操作
+    -w, --window       ウィンドウ操作
+    -b, --buffer       バッファ操作
+    -q, --quit         終了操作
+```
+としたほうがいいと提案する．アンケートを実施してみてほしい．

data/my_help.wiki/README_ja.md

@@ -0,0 +1,121 @@
+# 名前
+
+petit_help, general_help, my_help, ...
+
+# 概要
+
+CUI(CLI)ヘルプのUsage出力を真似て，user独自のhelpを作成・提供するgem.
+
+# 問題点
+CUIやshell, 何かのプログラミング言語などを習得しようとする初心者は，
+commandや文法を覚えるのに苦労します．少しのkey(とっかかり)があると
+思い出すんですが，うろ覚えでは間違えて路頭に迷います．問題点は，
+- manは基本的に英語
+- manualでは重たい
+- いつもおなじことをwebで検索して
+- 同じとこ見ている
+- memoしても，どこへ置いたか忘れる
+
+などです．
+
+# 特徴
+これらをgem環境として提供しようというのが，このgemの目的です．
+仕様としては，
+- userが自分にあったmanを作成
+- 雛形を提供
+  - おなじformat, looks, 操作, 階層構造
+- すぐに手が届く
+- それらを追加・修正・削除できる
+
+hikiでやろうとしていることの半分くらいはこのあたりのことなの
+かもしれません．memoソフトでは，検索が必要となりますが，my_helpは
+key(記憶のとっかかり)を提供することが目的です．
+
+# userの独自helpの達成方法
+exe中のファイルをrakeで自動生成．
+./lib/daddygongon/にそれらのdataを保存．以下ではその名前から
+exe中に実行ファイルを自動生成させている．
+```
+lib/daddygongon/
+└── emacs_help
+
+exe
+├── e_h
+└── emacs_help
+```
+ということ．これは，
+```
+rake my_help
+```
+で実行される．これを
+```
+rake install:local
+```
+すれば必要とするhelpがlocalな環境で表示される．
+
+たくさんの実行ファイルを/usr/loca/binに置くことになるので，
+```
+gem uninstall my_help
+gem uninstall emacs_help
+```
+でそこをcleanにしておくことが望ましい．
+```ruby
+desc "make own help from lib/daddygongon/files"
+task :my_help do
+  exe_cont="#!/usr/bin/env ruby\n"
+  user_name = 'daddygongon'
+  p entries=Dir.entries(File.join('.','lib',user_name))[2..-1]
+  entries.each{|file|
+    p file
+    p file_name=file.split('_')
+    target_files = [file, file_name[0][0]+"_"+file_name[1][0]]
+    p cont_name = File.join(user_name,file)
+#    exe_cont << "require '#{cont_name}'\n"
+    exe_cont << "require 'emacs_help'\n"
+    exe_cont << "EmacsHelp::Command.run(ARGV)\n"
+    target_files.each{|name|
+      p target=File.join('exe',name)
+      File.open(target,'w'){|file|
+        file.print exe_cont
+      }
+      FileUtils.chmod('a+x', target, :verbose => true)
+    }
+  }
+end
+```
+
+この後の実装方法は，emacs_helpに
+
+1. yaml形式でdataを入れ，command.runの入力ファイルとする
+1. hush形式でdataをいれ，それをrequireして使う
+
+かのどちらかで実装．speedとかdebugを比較・検証する必要あり．
+
+# どちらがいいか
+Rubyで日本語が使えるから，optionsを日本語にしてみた．
+```
+Usage: eh [options]
+    -v, --version                    show program Version.
+    -c, --カーソル                       Cursor移動
+    -p, --ページ                        Page移動
+    -f, --ファイル                       File操作
+    -e, --編集                         Edit操作
+    -w, --ウィンドウ                      Window操作
+    -b, --バッファ                       Buffer操作
+    -q, --終了                         終了操作
+```
+半角，全角がoptparseでは適切に判断できない様で，表示があまり揃っていない．
+しかし，初心者の振る舞いを見ているとわざわざ日本語に切り替えて打ち込むことは稀であり，
+key wordをhelpで参照してshort optionで入力している．そこで，
+```
+Usage: eh [options]
+    -v, --version      show program Version.
+    -c, --cursor       カーソル移動
+    -p, --page         ページ移動
+    -f, --file         ファイル操作
+    -e, --edit         編集操作
+    -w, --window       ウィンドウ操作
+    -b, --buffer       バッファ操作
+    -q, --quit         終了操作
+```
+としたほうがいいと提案する．アンケートを実施してみてほしい．

metadata

@@ -0,0 +1,168 @@
+--- !ruby/object:Gem::Specification
+name: my_help
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Shigeto R. Nishitani
+autorequire: 
+bindir: exe
+cert_chain: []
+date: 2016-10-27 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.11'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.11'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+- !ruby/object:Gem::Dependency
+  name: minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.0'
+- !ruby/object:Gem::Dependency
+  name: yard
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: hiki2md
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: mathjax-yard
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: hiki2latex
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Emulating CUI(CLI) help, user make and display his own help.
+email:
+- shigeto_nishitani@me.com
+executables:
+- e_h
+- emacs_help
+- my_help
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".travis.yml"
+- ".yardopts"
+- CODE_OF_CONDUCT.md
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- bin/console
+- bin/setup
+- exe/e_h
+- exe/emacs_help
+- exe/my_help
+- hikis/README_ja.hiki
+- latexes/handout_pre.tex
+- lib/daddygongon/emacs_help
+- lib/emacs_help.rb
+- lib/emacs_help/version.rb
+- lib/my_help.rb
+- lib/my_help/version.rb
+- my_help.gemspec
+- my_help.wiki/Home.md
+- my_help.wiki/README_ja.md
+homepage: https://github.com/daddygongon/my_help
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.5.1
+signing_key: 
+specification_version: 4
+summary: display emacs key bindings in Japanese.
+test_files: []