From 1c0f534eafd7d910708a8154a1208e25da28f1f2 Mon Sep 17 00:00:00 2001
From: j8takagi <j8takagi@nifty.com>
Date: Fri, 19 Feb 2010 02:04:40 +0900
Subject: [PATCH] =?utf8?q?=E3=83=89=E3=82=AD=E3=83=A5=E3=83=A1=E3=83=B3?=
 =?utf8?q?=E3=83=88=E6=9B=B4=E6=96=B0?=
MIME-Version: 1.0
Content-Type: text/plain; charset=utf8
Content-Transfer-Encoding: 8bit

---
 doc/Makefile     |  21 +++++----
 doc/style.css    |  26 ++++++++---
 doc/yacasl2.texi | 117 ++++++++++++++++++++++++-----------------------
 3 files changed, 92 insertions(+), 72 deletions(-)

diff --git a/doc/Makefile b/doc/Makefile
index c9a2cb8..98b03fc 100644
--- a/doc/Makefile
+++ b/doc/Makefile
@@ -1,23 +1,28 @@
 DOCNAME = yacasl2
 SRC = $(DOCNAME).texi
+CSS = style.css
 TEXBIN = /usr/local/teTeX/bin
 PTEX = $(TEXBIN)/ptex
 TEXINDEX = $(TEXBIN)/texindex
 DVI2PDF = $(TEXBIN)/dvipdfmx
 TEXOBJDIR = texobj
 
-.PHONY: html pdf clean
-$(DOCNAME).html: $(SRC)
-	@makeinfo -o $@ --no-split --no-headers --html --css-include=style.css $^
-html: $(SRC)
-	@cp style.css $@/; \
-         makeinfo -o $@ --html --css-ref=style.css $^
+.PHONY: all htmlnosplit pdf clean
+all: htmlnosplit html pdf
+htmlnosplit: $(DOCNAME).html
+$(DOCNAME).html: $(SRC) $(CSS)
+	@makeinfo -o $@ --no-split --no-headers --html --css-include=$(CSS) $(SRC)
+html: $(SRC) $(CSS)
+	@if test ! -s $@; then mkdir $@; fi; \
+     cp $(CSS) $@/$(CSS); \
+     makeinfo -o $@ --html --css-ref=style.css $(SRC)
+pdf: $(DOCNAME).pdf
+$(DOCNAME).pdf: $(DOCNAME).dvi
+	@$(DVI2PDF) $^
 $(DOCNAME).dvi: $(SRC)
 	@if test ! -s $(TEXOBJDIR); then mkdir $(TEXOBJDIR); fi; \
      cd $(TEXOBJDIR); \
      TEX=ptex texi2dvi --texinfo=@afourpaper -o ../$@ ../$^; \
      cd -
-$(DOCNAME).pdf: $(DOCNAME).dvi
-	@$(DVI2PDF) $^
 clean:
 	@rm -rf html $(TEXOBJDIR) $(DOCNAME).html $(DOCNAME).dvi $(DOCNAME).pdf
diff --git a/doc/style.css b/doc/style.css
index 6e9bcfe..42c692e 100644
--- a/doc/style.css
+++ b/doc/style.css
@@ -9,10 +9,14 @@ h1, h2 {
     margin-left: -2em;
 }
 
+.node{
+    margin-left: -3em;
+}
+
 h2 {
+    padding: 0.25em;
     color: white;
     background-color: navy;
-    padding: 0.25em;
 }
 
 h3, h4 {
@@ -35,19 +39,17 @@ a:hover {
     font-family: monospace;
 }
 
+table.cartouche {
+    width: 60%;
+}
+
 pre.example {
-    width: 100%;
     padding: 0.5em 1em 0.5em 1em;
     color: #CCC;
     background: black;
     font-size: 90%;
 }
 
-pre.example b {
-    color: white;
-    background-color: black;
-}
-
 a {
     text-decoration: none;
 }
@@ -62,3 +64,13 @@ table, th, td {
     border: 1px solid #CCC;
     border-collapse: collapse; /* 枠線の表示方法 */
 }
+
+table.cartouche, table.cartouche th, table.cartouche td  {
+    border: none;
+}
+
+pre.example .command {
+    font-weight: bold;
+    background-color: inherit;
+    color: white;
+}
\ No newline at end of file
diff --git a/doc/yacasl2.texi b/doc/yacasl2.texi
index a6e2c57..c7d1bff 100644
--- a/doc/yacasl2.texi
+++ b/doc/yacasl2.texi
@@ -1,37 +1,42 @@
 \input texinfo   @c -*-texinfo-*-
 @c %**start of header
 @setfilename yacasl2.info
-@settitle YACASL2 - Linux上のCASL2処理系
+@settitle YACASL2 - Linux上のCASL II処理系
 @c %**end of header
 
-@exampleindent 2
-
 @copying
 Copyright @copyright{} 2010 j8takagi
 @end copying
 
+@exampleindent 2
+
+@dircategory Basics
+@direntry
+* YACASL2: (yacasl2).
+@end direntry
+
 @titlepage
-@title
+@title YACASL2
+@subtitle Linux上のCASL II処理系
+@author j8takagi
+@insertcopying
 @end titlepage
+
+@ifnottex
 @node Top
+@end ifnottex
 
 @menu
-* YACASL2の概要:about.
-* YACASL2のインストール:install.
-* YACASL2の使い方:tutorial.
+* YACASL2の概要::
+* YACASL2のインストール::
+* YACASL2の使い方::
 @end menu
 
-
-@c Output the table of contents at the beginning.
 @contents
 
-@insertcopying
-
-@node about, install, Top, Top
+@node YACASL2の概要, YACASL2のインストール, Top, Top
 @chapter YACASL2の概要
 
-@cindex chapter, first
-
 YACASL2は、Linux上で動作するオープンソースのCASL II処理系です。CASL IIは情報処理試験で用いられるアセンブラ言語で、次の資料により仕様が公開されています。
 
 @quotation
@@ -75,9 +80,8 @@ Vine Linux 4.2
 
 インストール時に、@command{tar}、@command{gcc}、@command{make}が必要です。
 
-@node install, tutorial, about, Top
+@node YACASL2のインストール, YACASL2の使い方, YACASL2の概要, Top
 @chapter YACASL2のインストール
-
 YACASL2をインストールするには、Linux上で次の作業をします。
 
 @enumerate
@@ -101,7 +105,7 @@ YACASL2をインストールするには、Linux上で次の作業をします
 詳細なテスト
 
 @item
-環境設定@var{PATH}の設定
+環境変数@var{PATH}の設定
 @end enumerate
 
 以下の操作は、端末を開きコマンドを実行します。
@@ -111,9 +115,9 @@ YACASL2をインストールするには、Linux上で次の作業をします
 
 @cartouche
 @example
-$ @b{cd}
-$ @b{wget somewhere/yacasl2.tar.gz}
-$ @b{wget somewhere/yacasl2.tar.gz.md5sum}
+$ @command{cd}
+$ @command{wget somewhere/yacasl2.tar.gz}
+$ @command{wget somewhere/yacasl2.tar.gz.md5sum}
 @end example
 @end cartouche
 
@@ -125,7 +129,7 @@ $ @b{wget somewhere/yacasl2.tar.gz.md5sum}
 
 @cartouche
 @example
-$ @b{md5sum yacasl2.tar.gz | diff -s yacasl2.tar.gz.md5sum -}
+$ @command{md5sum yacasl2.tar.gz | diff -s yacasl2.tar.gz.md5sum -}
 Files yacasl2.tar.gz.md5sum and - are identical
 @end example
 @end cartouche
@@ -136,7 +140,7 @@ Files yacasl2.tar.gz.md5sum and - are identical
 
 @cartouche
 @example
-$ @b{tar xvzf yacasl2.tar.gz}
+$ @command{tar xvzf yacasl2.tar.gz}
 @end example
 @end cartouche
 
@@ -146,8 +150,8 @@ $ @b{tar xvzf yacasl2.tar.gz}
 
 @cartouche
 @example
-$ @b{cd yacasl2}
-$ @b{make}
+$ @command{cd yacasl2}
+$ @command{make}
 make -C src
 make[1]: Entering directory ‘/home/kazubito/yacasl2/src’
 gcc -c -g -Wall -I ../include casl2.c
@@ -180,7 +184,7 @@ make[1]: Leaving directory ‘/home/kazubito/yacasl2/src’
 
 @cartouche
 @example
-$ @b{./casl2 as/hello.casl}
+$ @command{./casl2 as/hello.casl}
 Hello, World!
 @end example
 @end cartouche
@@ -191,7 +195,7 @@ Hello, World!
 
 @cartouche
 @example
-$ @b{make check}
+$ @command{make check}
 194 / 194 tests passed. Details in /home/kazubito/yacasl2/test/integra
 tion/casl2/Test.log
 All tests are succeded.
@@ -204,38 +208,37 @@ All tests are succeded.
 @end example
 @end cartouche
 
-@section 環境設定@var{PATH}の設定
+@section 環境変数@var{PATH}の設定
 
 環境変数@var{PATH}にYACASL2のディレクトリーを追加すると、どのディレクトリーでも@command{casl2}、@command{comet2}、@command{dumpword}を実行できます。
 
-環境変数の設定方法は使っているシェルによって異なります。シェルは、次のコマンドで確認できます。現在もっとも多く使われているのは、BASHでしょう。
+環境変数の設定方法は使っているシェルによって異なります。シェルは、次のコマンドで確認できます。
 
 @cartouche
 @example
-$ @b{echo $SHELL}
+$ @command{echo $SHELL}
 /bin/bash
 @end example
 @end cartouche
 
-シェルがBASHの場合、次のコマンドを実行すると環境変数@var{PATH}にYACASL2のディレクトリーが追加されます。
+現在もっとも多く使われているシェルは、BASHでしょう。BASHでは、次のコマンドを実行すると環境変数@var{PATH}にYACASL2のディレクトリーが追加されます。
 
 @cartouche
 @example
-$ @b{PATH=$PATH:~/yacasl2 && export PATH}
+$ @command{PATH=$PATH:~/yacasl2 && export PATH}
 @end example
 @end cartouche
 
-シェルの初期設定ファイルに上記のコマンドを追加すれば、今後ログインした後は自動的にどのディレクトリーでも @command{casl2}、@command{comet2}、@command{dumpword}を実行できるようになります。BASHの場合はホームディレクトリーにある@file{.bashrc}が初期設定ファイルのため、コマンドは次のようになります。
+シェルの初期設定ファイルに上記のコマンドを追加すれば、今後ログインした後は自動的にどのディレクトリーでも @command{casl2}、@command{comet2}、@command{dumpword}を実行できます。BASHではホームディレクトリーにある@file{.bashrc}が初期設定ファイルのため、次のコマンドで追加されます。
 
 @cartouche
 @example
-$ @b{echo ’PATH=$PATH:~/yacasl2 && export PATH’ >>~/.bashrc}
+$ @command{echo ’PATH=$PATH:~/yacasl2 && export PATH’ >>~/.bashrc}
 @end example
 @end cartouche
 
-@node tutorial,, install, Top
+@node YACASL2の使い方,, YACASL2のインストール, Top
 @chapter YACASL2 の使い方
-
 YACASL2 は、テキストファイルに記述されたCASLプログラムを処理します。以下の例で用いられるCASLプログラムのファイルは、テキストエディタなどで作成してください。また、インストールしたディレクトリーの中にある@file{as}ディレクトリーからコピーして作成することもできます。
 
 @section 実行結果の出力だけを表示
@@ -244,7 +247,7 @@ YACASL2 は、テキストファイルに記述されたCASLプログラムを
 
 @cartouche
 @example
-$ @b{cat hello.casl}
+$ @command{cat hello.casl}
 MAIN     START
          OUT     OBUF,LEN
          RET
@@ -258,7 +261,7 @@ LEN      DC      13
 
 @cartouche
 @example
-$ @b{casl2 hello.casl}
+$ @command{casl2 hello.casl}
 Hello, World!
 @end example
 @end cartouche
@@ -267,7 +270,7 @@ Hello, World!
 
 @cartouche
 @example
-$ @b{cat addl.casl}
+$ @command{cat addl.casl}
 ;;; ADDL r,adr
 MAIN     START
          LD      GR1,A
@@ -283,7 +286,7 @@ B        DC      1
 
 @cartouche
 @example
-$ @b{casl2 addl.casl}
+$ @command{casl2 addl.casl}
 $
 @end example
 @end cartouche
@@ -294,7 +297,7 @@ $
 
 @cartouche
 @example
-$ @b{cat sum_10.casl}
+$ @command{cat sum_10.casl}
 ;;; sum_10.casl
 ;;; 出力 GR0: 1から10までの整数をすべて加算した値
 MAIN    START
@@ -318,7 +321,7 @@ STEP    DC      1               ; 公差
 このプログラムも、オプションなしで実行した場合には結果が出力されません。
 @cartouche
 @example
-$ @b{casl2 sum_10.casl}
+$ @command{casl2 sum_10.casl}
 $
 @end example
 @end cartouche
@@ -330,7 +333,7 @@ casl2の処理途中で行われるアセンブルの結果を表示するには
 
 @cartouche
 @example
-$ @b{casl2 -a -l hello.casl}
+$ @command{casl2 -a -l hello.casl}
 
 Assemble hello.casl (0)
 
@@ -389,7 +392,7 @@ Hello, World!
 
 @cartouche
 @example
-$ @b{casl2 -a -l addl.casl}
+$ @command{casl2 -a -l addl.casl}
 
 Assemble addl.casl (0)
 
@@ -428,7 +431,7 @@ YACASL2では実行中のCPUのレジスターとメモリーの内容をそれ
 
 @cartouche
 @example
-$ @b{casl2 -t -d -M8 addl.casl | less}
+$ @command{casl2 -t -d -M8 addl.casl | less}
 
 Assemble addl.casl (0)
 
@@ -489,7 +492,7 @@ Executing machine codes
 
 @cartouche
 @example
-$ @b{casl2 -t addl.casl | grep 'GR1:'}
+$ @command{casl2 -t addl.casl | grep 'GR1:'}
 #0000: GR1:      0 = #0000 = 0000000000000000
 #0002: GR1:      3 = #0003 = 0000000000000011
 #0004: GR1:      4 = #0004 = 0000000000000100
@@ -517,14 +520,14 @@ $ @b{casl2 -t addl.casl | grep 'GR1:'}
 
 @cartouche
 @example
-$ @b{casl2 -t addl.casl | grep 'GR1:' | tail -1}
+$ @command{casl2 -t addl.casl | grep 'GR1:' | tail -1}
 #0004: GR1:      4 = #0004 = 0000000000000100
 @end example
 @end cartouche
 
 @cartouche
 @example
-$ @b{casl2 -t sum_10.casl | grep 'GR0:' | tail -1}
+$ @command{casl2 -t sum_10.casl | grep 'GR0:' | tail -1}
 #0010: GR0:     55 = #0037 = 0000000000110111 = '7'
 @end example
 @end cartouche
@@ -535,14 +538,14 @@ $ @b{casl2 -t sum_10.casl | grep 'GR0:' | tail -1}
 
 @cartouche
 @example
-$ @b{casl2 -t hello.casl | grep 'GR1:' | wc -l}
+$ @command{casl2 -t hello.casl | grep 'GR1:' | wc -l}
 11
 @end example
 @end cartouche
 
 @cartouche
 @example
-$ @b{casl2 -t addl.casl | grep 'GR1:' | wc -l}
+$ @command{casl2 -t addl.casl | grep 'GR1:' | wc -l}
 3
 @end example
 @end cartouche
@@ -551,18 +554,18 @@ $ @b{casl2 -t addl.casl | grep 'GR1:' | wc -l}
 
 @cartouche
 @example
-$ @b{casl2 -t sum_10.casl | grep 'GR0:' | wc -l}
+$ @command{casl2 -t sum_10.casl | grep 'GR0:' | wc -l}
 54
 @end example
 @end cartouche
 
 @section アセンブルと実行を別に行う
 
-@command{casl2}に@option{-O}<@file{ファイル名}>を指定すると、オブジェクトファイルを作成できます。
+@command{casl2}に@option{-O}@file{ファイル名}を指定すると、オブジェクトファイルを作成できます。
 
 @cartouche
 @example
-$ @b{casl2 -Ohello.o hello.casl}
+$ @command{casl2 -Ohello.o hello.casl}
 @end example
 @end cartouche
 
@@ -570,7 +573,7 @@ $ @b{casl2 -Ohello.o hello.casl}
 
 @cartouche
 @example
-$ @b{od -t x2 hello.o}
+$ @command{od -t x2 hello.o}
 0000000 7001 0000 7002 0000 1210 0013 1220 0020
 0000020 f000 0002 1210 0021 1220 0022 f000 0002
 0000040 7120 7110 8100 0048 0065 006c 006c 006f
@@ -584,7 +587,7 @@ $ @b{od -t x2 hello.o}
 
 @cartouche
 @example
-$ @b{comet2 hello.o}
+$ @command{comet2 hello.o}
 Hello, World!
 @end example
 @end cartouche
@@ -596,7 +599,7 @@ CASL2では、1語（16ビット）を単位としてデータが処理されま
 
 @cartouche
 @example
-$ @b{dumpword 72}
+$ @command{dumpword 72}
     72:     72 = #0048 = 0000000001001000 = 'H'
 @end example
 @end cartouche
@@ -605,7 +608,7 @@ $ @b{dumpword 72}
 
 @cartouche
 @example
-$ @b{dumpword -- -72}
+$ @command{dumpword} @verb{|--|} @command{-72}
    -72:    -72 = #FFB8 = 1111111110111000
 @end example
 @end cartouche
@@ -614,7 +617,7 @@ $ @b{dumpword -- -72}
 
 @cartouche
 @example
-$ @b{dumpword '#0048'}
+$ @command{dumpword '#0048'}
  #0048:     72 = #0048 = 0000000001001000 = 'H'
 @end example
 @end cartouche
-- 
2.18.0