sgml-ify

13 files changed, 542 insertions, 289 deletions

diff --git a/fml/doc/ja/tech/Makefile b/fml/doc/ja/tech/Makefile
new file mode 100644
index 00000000..21f914e4
--- /dev/null
+++ b/fml/doc/ja/tech/Makefile
@@ -0,0 +1,27 @@
+#
+# $FML: Makefile,v 1.8 2001/04/24 11:40:37 fukachan Exp $
+#
+
+TMP_DIR    = /tmp
+TARGET_DIR = ../../../../Documentation/ja/tech
+ID         = techtips.html
+
+all: export
+
+html:
+	env TMPDIR=$(TMP_DIR) sgmltools -v -b html -j "-v" book.sgml 2>&1 |\
+	uniq
+	@ perl -i.bak ../.fix_charset.pl book/@*/$(ID)
+	@ rm -f book/@*/*.html.bak
+
+clean:
+	find . -type f -print |grep '~' |perl -nple unlink
+	rm -fr book
+
+export: html
+	test -d $(TARGET_DIR) || mkdir $(TARGET_DIR)
+	rsync -a book/@*/ $(TARGET_DIR)/
+	chmod 755 $(TARGET_DIR)
+
+scan:
+	@ cvs -n update 2>&1 |grep -v : || echo ''
diff --git a/fml/doc/ja/tech/apache b/fml/doc/ja/tech/apache
deleted file mode 100644
index 7c1ac9a7..00000000
--- a/fml/doc/ja/tech/apache
+++ /dev/null
@@ -1,244 +0,0 @@
-		make apache+mod_ssl on NetBSD
-
-1) get sources 
-
-	apache_1.3.9.tar.gz
-	mod_ssl-2.4.8-1.3.9.tar.gz 
-	openssl-0.9.4.tar.gz
-
-2)  extract them
-
-% tar zxvf apache_1.3.9.tar.gz
-% tar zxvf mod_ssl-2.4.8-1.3.9.tar.gz 
-% tar zxvf openssl-0.9.4.tar.gz
-
-3 ) make openssl
-
-% cd openssl-0.9.4 
-% ./config
-% make
-% su
-# make install
-
-4 ) apply openssl patch to apache
-
-% cd mod_ssl-2.4.8-1.3.9
-% sh configure --with-apache=../apache_1.3.9
-% cd ../apache_1.3.9
-
-5 ) make apache-ssl
-
-% pwd
-/some/where/apache_1.3.9
-% env BASE_SSL=/usr/local/ssl ./configure --enable-module=ssl 
-% make
-
-6) create my CA (Certificate Agent) and install
-
-% make certificate TYPE=custom
-% make install
-
-7) remove pass phrase to start apache-ssl without query of pass phrase
-
-# cd /usr/local/apache/conf/ssl.key
-# openssl rsa -in server.key -out server.key
-# chmod 400 server.key
-
-8) start apache-ssl
-
-# /usr/local/apache/bin/apachectl startssl
-
---------->8--------->8--------->8--------->8--------->8--------->8
-RESULT: CA and Server Certification Files
-
-o  conf/ssl.key/ca.key
-   The PEM-encoded RSA private key file of the CA which you can
-   use to sign other servers or clients. KEEP THIS FILE PRIVATE!
-
-o  conf/ssl.crt/ca.crt
-   The PEM-encoded X.509 certificate file of the CA which you use to
-   sign other servers or clients. When you sign clients with it (for
-   SSL client authentication) you can configure this file with the
-   'SSLCACertificateFile' directive.
-
-o  conf/ssl.key/server.key
-   The PEM-encoded RSA private key file of the server which you configure
-   with the 'SSLCertificateKeyFile' directive (automatically done
-   when you install via APACI). KEEP THIS FILE PRIVATE!
-
-o  conf/ssl.crt/server.crt
-   The PEM-encoded X.509 certificate file of the server which you configure
-   with the 'SSLCertificateFile' directive (automatically done
-   when you install via APACI).
-
-o  conf/ssl.csr/server.csr
-   The PEM-encoded X.509 certificate signing request of the server file which
-   you can send to an official Certificate Authority (CA) in order
-   to request a real server certificate (signed by this CA instead
-   of our own CA) which later can replace the conf/ssl.crt/server.crt
-   file.
-
-Congratulations that you establish your server with real certificates.
---------->8--------->8--------->8--------->8--------->8--------->8
-
-********* Session Examples *********
-
-ENV: SSL_SESSION_ID => DBEB0B1448B2CA5E2ED7A3FF76CFC0F8B65328FD4951814193257C7106C33C96
-ENV: SSL_SERVER_ICN => beth.fml.org
-ENV: SERVER_SOFTWARE => Apache/1.3.9 (Unix) mod_ssl/2.4.8 OpenSSL/0.9.4
-ENV: SSL_SERVER_I_DN_C => jp
-ENV: SSL_CIPHER_ALGKEYSIZE => 128
-ENV: REMOTE_ADDR => 10.1.1.3
-ENV: SSL_SSLEAY_VERSION => OpenSSL/0.9.4
-ENV: REQUEST_METHOD => POST
-ENV: SSL_SERVER_KEY_SIZE => Not supported by mod_ssl
-ENV: SSL_SERVER_C => jp
-ENV: REMOTE_USER => admin
-ENV: SSL_VERSION_LIBRARY => OpenSSL/0.9.4
-ENV: SSL_SERVER_S_DN => /C=jp/ST=Hokkaido/L=sapporo/O=FML.ORG sapporo/OU=Technical Div./CN=beth.fml.org/Email=fukachan@fml.org
-ENV: SSL_SERVER_CERT_END => Nov  7 12:23:31 2000 GMT
-ENV: SSL_SERVER_I_DN_L => sapporo
-ENV: HTTPS_CIPHER => EXP-RC4-MD5
-ENV: SSL_SERVER_I_DN_O => FML.ORG Sapporo
-ENV: HTTP_ACCEPT => image/gif, image/x-xbitmap, image/jpeg, image/pjpeg, image/png, */*
-ENV: HTTP_ACCEPT_LANGUAGE => en
-ENV: SSL_SERVER_L => sapporo
-ENV: SSL_SERVER_ISP => hokkaido
-ENV: HTTPS => on
-ENV: SSL_SERVER_IOU => Technical Division
-ENV: SCRIPT_FILENAME => /usr/local/fml/www/cgi-bin/admin/makefml.cgi
-ENV: SSLEAY_VERSION => OpenSSL/0.9.4
-ENV: SSL_SERVER_O => FML.ORG sapporo
-ENV: SERVER_NAME => beth.fml.org
-ENV: SSL_SERVER_CN => beth.fml.org
-ENV: SSL_SERVER_M_VERSION => 3
-ENV: SSL_SECRETKEYSIZE => 40
-ENV: SERVER_PORT => 443
-ENV: SSL_CLIENT_CERT => 
-ENV: SSL_CLIENT_KEY_ALGORITHM => Not supported by mod_ssl
-ENV: SSL_SERVER_IDN => /C=jp/ST=hokkaido/L=sapporo/O=FML.ORG Sapporo/OU=Technical Division/CN=beth.fml.org/Email=fukachan@fml.org
-ENV: SERVER_SIGNATURE => <ADDRESS>Apache/1.3.9 Server at beth.fml.org Port 443</ADDRESS>
-
-ENV: SSL_SERVER_V_START => Nov  8 12:23:31 1999 GMT
-ENV: SSL_SERVER_SP => Hokkaido
-ENV: SSL_SERVER_OU => Technical Div.
-ENV: SSL_CIPHER => EXP-RC4-MD5
-ENV: HTTP_CONNECTION => Keep-Alive
-ENV: SSL_SERVER_I_DN_CN => beth.fml.org
-ENV: SSL_SERVER_S_DN_Email => fukachan@fml.org
-ENV: SSL_SERVER_CERT => -----BEGIN CERTIFICATE-----
-MIIDTjCCAregAwIBAgIBATANBgkqhkiG9w0BAQQFADCBsTELMAkGA1UEBhMCanAx
-SUogU2FwcG9ybzEbMBkGA1UECxMSVGVjaG5pY2FsIERpdmlzaW9uMR8wHQYDVQQD
-ExZiZXRoLnNhcHBvcm8uaWlqLmFkLmpwMSkwJwYJKoZIhvcNAQkBFhpmdWthY2hh
-bkBzYXBwb3JvLmlpai5hZC5qcDAeFw05OTExMDgxMjIzMzFaFw0wMDExMDcxMjIz
-MzFaMIGtMQswCQYDVQQGEwJqcDERMA8GA1UECBMISG9ra2FpZG8xEDAOBgNVBAcT
-B3NhcHBvcm8xFDASBgNVBAoTC0lJSiBzYXBwb3JvMRcwFQYDVQQLEw5UZWNobmlj
-SIb3DQEJARYaZnVrYWNoYW5Ac2FwcG9yby5paWouYWQuanAwgZ8wDQYJKoZIhvcN
-AQEBBQADgY0AMIGJAoGBAJ1/0it3TZQIoiTT9WQFdtssV25SCZEGeR/hwkmv7wPv
-XBng82cesCwpixGog4EGVQGIghCN6/6o9QYg8t1BY+C7IHjtHSn/GNWeim9TFQ/Y
-rEtf/TtbgJvnDh3PQuP+Z/MYjSwNCmyNP37LSehtztteoaUofL44TxQlVKD4vs6x
-AgMBAAGjeDB2MCUGA1UdEQQeMByBGmZ1a2FjaGFuQHNhcHBvcm8uaWlqLmFkLmpw
-MDoGCWCGSAGG+EIBDQQtFittb2Rfc3NsIGdlbmVyYXRlZCBjdXN0b20gc2VydmVy
-IGNlcnRpZmljYXRlMBEGCWCGSAGG+EIBAQQEAwIGQDANBgkqhkiG9w0BAQQFAAOB
-gQBBYnVVF7ILyCP/oSjJFvje9XUN25O9RNovnkYe/XQfsEeJZ2/wsuaX62aEY18x
-Y7cWn40sUEfDCQNGbUFNTkNjEOXgftYaQ3KANSAi/6PyWOP2eyGR8eQcBUJ4H7VE
-o4eS8dODzXmjyrNzxMCM0gfXvsIDLlbQPsDzf3t0m6YkzA==
------END CERTIFICATE-----
-
-ENV: SSL_KEYSIZE => 128
-ENV: SSL_SERVER_KEY_ALGORITHM => Not supported by mod_ssl
-ENV: HTTPS_KEYSIZE => 128
-ENV: REQUEST_URI => /cgi-bin/fml/admin/makefml.cgi
-ENV: SSL_SERVER_IEMAIL => fukachan@fml.org
-ENV: SSL_SERVER_DN => /C=jp/ST=Hokkaido/L=sapporo/O=FML.ORG sapporo/OU=Technical Div./CN=beth.fml.org/Email=fukachan@fml.org
-ENV: SSL_SERVER_S_DN_CN => beth.fml.org
-ENV: CONTENT_LENGTH => 67
-ENV: SSL_SERVER_I_DN => /C=jp/ST=hokkaido/L=sapporo/O=FML.ORG Sapporo/OU=Technical Division/CN=beth.fml.org/Email=fukachan@fml.org
-ENV: GATEWAY_INTERFACE => CGI/1.1
-ENV: DOCUMENT_ROOT => /usr/local/apache/htdocs
-ENV: SSL_SERVER_CERT_START => Nov  8 12:23:31 1999 GMT
-ENV: SSL_PROTOCOL => SSLv3
-ENV: SSL_SERVER_I_DN_SP => hokkaido
-ENV: SSL_SERVER_I_DN_OU => Technical Division
-ENV: SSL_PROTOCOL_VERSION => SSLv3
-ENV: SSL_SERVER_A_SIG => md5WithRSAEncryption
-ENV: QUERY_STRING => 
-ENV: SSL_SERVER_S_DN_SP => Hokkaido
-ENV: SSL_SERVER_S_DN_C => jp
-ENV: SSL_CIPHER_EXPORT => true
-ENV: SSL_SERVER_S_DN_OU => Technical Div.
-ENV: REMOTE_PORT => 58991
-ENV: SSL_SERVER_A_KEY => rsaEncryption
-ENV: SERVER_ADDR => 10.1.1.3
-ENV: SSL_SERVER_IC => jp
-ENV: HTTPS_EXPORT => true
-ENV: HTTP_ACCEPT_ENCODING => gzip
-ENV: SSL_SERVER_CERTFILE => Not supported by mod_ssl
-ENV: SSL_SERVER_S_DN_L => sapporo
-ENV: HTTP_PRAGMA => no-cache
-ENV: SSL_SERVER_S_DN_O => FML.ORG sapporo
-ENV: SSL_SERVER_IL => sapporo
-ENV: HTTPS_SECRETKEYSIZE => 40
-ENV: SSL_CIPHER_USEKEYSIZE => 40
-ENV: SSL_SERVER_IO => FML.ORG Sapporo
-ENV: SERVER_ADMIN => fukachan@beth.fml.org
-ENV: SSL_CLIENT_KEY_EXP => Not supported by mod_ssl
-ENV: SSL_CLIENT_VERIFY => NONE
-ENV: SSL_VERSION_INTERFACE => mod_ssl/2.4.8
-ENV: SERVER_PROTOCOL => HTTP/1.0
-ENV: SSL_SERVER_I_DN_Email => fukachan@fml.org
-ENV: SSL_SERVER_SESSIONDIR => Not supported by mod_ssl
-ENV: HTTP_REFERER => https://beth/cgi-bin/fml/admin/menu.cgi
-ENV: SSL_SERVER_CERTIFICATE => -----BEGIN CERTIFICATE-----
-MIIDTjCCAregAwIBAgIBATANBgkqhkiG9w0BAQQFADCBsTELMAkGA1UEBhMCanAx
-ETAPBgNVBAgTCGhva2thaWRvMRAwDgYDVQQHEwdzYXBwb3JvMRQwEgYDVQQKEwtJ
-SUogU2FwcG9ybzEbMBkGA1UECxMSVGVjaG5pY2FsIERpdmlzaW9uMR8wHQYDVQQD
-bkBzYXBwb3JvLmlpai5hZC5qcDAeFw05OTExMDgxMjIzMzFaFw0wMDExMDcxMjIz
-MzFaMIGtMQswCQYDVQQGEwJqcDERMA8GA1UECBMISG9ra2FpZG8xEDAOBgNVBAcT
-B3NhcHBvcm8xFDASBgNVBAoTC0lJSiBzYXBwb3JvMRcwFQYDVQQLEw5UZWNobmlj
-YWwgRGl2LjEfMB0GA1UEAxMWYmV0aC5zYXBwb3JvLmlpai5hZC5qcDEpMCcGCSqG
-SIb3DQEJARYaZnVrYWNoYW5Ac2FwcG9yby5paWouYWQuanAwgZ8wDQYJKoZIhvcN
-XBng82cesCwpixGog4EGVQGIghCN6/6o9QYg8t1BY+C7IHjtHSn/GNWeim9TFQ/Y
-rEtf/TtbgJvnDh3PQuP+Z/MYjSwNCmyNP37LSehtztteoaUofL44TxQlVKD4vs6x
-AgMBAAGjeDB2MCUGA1UdEQQeMByBGmZ1a2FjaGFuQHNhcHBvcm8uaWlqLmFkLmpw
-MDoGCWCGSAGG+EIBDQQtFittb2Rfc3NsIGdlbmVyYXRlZCBjdXN0b20gc2VydmVy
-IGNlcnRpZmljYXRlMBEGCWCGSAGG+EIBAQQEAwIGQDANBgkqhkiG9w0BAQQFAAOB
-gQBBYnVVF7ILyCP/oSjJFvje9XUN25O9RNovnkYe/XQfsEeJZ2/wsuaX62aEY18x
-Y7cWn40sUEfDCQNGbUFNTkNjEOXgftYaQ3KANSAi/6PyWOP2eyGR8eQcBUJ4H7VE
-o4eS8dODzXmjyrNzxMCM0gfXvsIDLlbQPsDzf3t0m6YkzA==
------END CERTIFICATE-----
-
-ENV: SSL_SERVER_CERTIFICATELOGDIR => Not supported by mod_ssl
-ENV: HTTP_USER_AGENT => Mozilla/4.61 [en] (X11; I; NetBSD 1.4D i386; Nav)
-ENV: PATH => /sbin:/usr/sbin:/bin:/usr/bin:/usr/pkg/sbin:/usr/pkg/bin:/usr/X11R6/bin:/usr/local/sbin:/usr/local/bin
-ENV: SSL_STRONG_CRYPTO => Not supported by mod_ssl
-ENV: SSL_SERVER_EMAIL => fukachan@fml.org
-ENV: SSL_SERVER_KEYFILE => Not supported by mod_ssl
-ENV: SSL_SERVER_KEYFILETYPE => Not supported by mod_ssl
-ENV: SSL_CLIENT_KEY_SIZE => Not supported by mod_ssl
-ENV: SSL_SERVER_V_END => Nov  7 12:23:31 2000 GMT
-ENV: SSL_SERVER_M_SERIAL => 01
-ENV: AUTH_TYPE => Basic
-ENV: SSL_EXPORT => true
-ENV: SSL_SERVER_CERT_SERIAL => 01
-ENV: SCRIPT_NAME => /cgi-bin/fml/admin/makefml.cgi
-ENV: HTTP_ACCEPT_CHARSET => iso-8859-1,*,utf-8
-ENV: SSL_SERVER_KEY_EXP => Not supported by mod_ssl
-ENV: CONTENT_TYPE => application/x-www-form-urlencoded
-ENV: HTTP_HOST => beth
-ENV: SSL_SERVER_SIGNATURE_ALGORITHM => md5WithRSAEncryption
-Config: submit-p => Remove
-Config: ML => sayori
-Config: PROC => destructml
-Config: LANGUAGE => Japanese
-Config: ML_DEF => 
-メーリングリスト: sayori
-を削除します。
-
-
-
-    makefml destructml mailing-list
-
-arguments of mailing-list is required
-
-$Id$
diff --git a/fml/doc/ja/tech/apache.sgml b/fml/doc/ja/tech/apache.sgml
new file mode 100644
index 00000000..3eaff87c
--- /dev/null
+++ b/fml/doc/ja/tech/apache.sgml
@@ -0,0 +1,285 @@
+<!--
+   $FML$
+-->
+
+<chapter id="apache">
+
+<title> apache </title>
+
+<sect1>
+   <title> apache + mod_ssl を作る </title>
+
+<para>
+まず、これらのソースを手に入れる。
+
+	apache_1.3.9.tar.gz
+	mod_ssl-2.4.8-1.3.9.tar.gz 
+	openssl-0.9.4.tar.gz
+
+そして、解凍する。
+<screen>
+% tar zxvf apache_1.3.9.tar.gz
+% tar zxvf mod_ssl-2.4.8-1.3.9.tar.gz 
+% tar zxvf openssl-0.9.4.tar.gz
+</screen>
+</para>
+
+<para>
+まず、openssl を作る。
+
+<screen>
+% cd openssl-0.9.4 
+% ./config
+% make
+% su
+# make install
+</screen>
+</para>
+
+<para>
+openssl を使えるようにするパッチを当てて、apache を compile する。
+<screen>
+% cd mod_ssl-2.4.8-1.3.9
+% sh configure --with-apache=../apache_1.3.9
+% cd ../apache_1.3.9
+% env BASE_SSL=/usr/local/ssl ./configure --enable-module=ssl 
+% make
+</screen>
+</para>
+
+</sect1>
+
+
+<sect1>
+   <title> apache + mod_ssl をインストールする </title>
+
+<para>
+apache をインストールする際に
+CA (Certificate Agent) を作らなければなりません。
+<screen>
+% make certificate TYPE=custom
+% make install
+</screen>
+</para>
+
+<para>
+apache がパスワードなしに起動できるようにパスフレーズを消します。
+そうしないと非対称鍵を読めないからねい。
+<screen>
+# cd /usr/local/apache/conf/ssl.key
+# openssl rsa -in server.key -out server.key
+# chmod 400 server.key
+</screen>
+</para>
+
+<para>
+apache を SSL モードでスタートさせます。
+<screen>
+# /usr/local/apache/bin/apachectl startssl
+</screen>
+</para>
+
+</sect1>
+
+<sect1>
+   <title> CA の例 </title>
+
+<screen>
+RESULT: CA and Server Certification Files
+
+o  conf/ssl.key/ca.key
+   The PEM-encoded RSA private key file of the CA which you can
+   use to sign other servers or clients. KEEP THIS FILE PRIVATE!
+
+o  conf/ssl.crt/ca.crt
+   The PEM-encoded X.509 certificate file of the CA which you use to
+   sign other servers or clients. When you sign clients with it (for
+   SSL client authentication) you can configure this file with the
+   'SSLCACertificateFile' directive.
+
+o  conf/ssl.key/server.key
+   The PEM-encoded RSA private key file of the server which you configure
+   with the 'SSLCertificateKeyFile' directive (automatically done
+   when you install via APACI). KEEP THIS FILE PRIVATE!
+
+o  conf/ssl.crt/server.crt
+   The PEM-encoded X.509 certificate file of the server which you configure
+   with the 'SSLCertificateFile' directive (automatically done
+   when you install via APACI).
+
+o  conf/ssl.csr/server.csr
+   The PEM-encoded X.509 certificate signing request of the server file which
+   you can send to an official Certificate Authority (CA) in order
+   to request a real server certificate (signed by this CA instead
+   of our own CA) which later can replace the conf/ssl.crt/server.crt
+   file.
+
+Congratulations that you establish your server with real certificates.
+</screen>
+
+</sect1>
+
+<sect1>
+   <title> SSL を使った CGI セッションの例 </title>
+
+<screen>
+ENV: SSL_SESSION_ID =&gt; DBEB0B1448B2CA5E2ED7A3FF76CFC0F8B65328FD4951814193257C7106C33C96
+ENV: SSL_SERVER_ICN =&gt; beth.fml.org
+ENV: SERVER_SOFTWARE =&gt; Apache/1.3.9 (Unix) mod_ssl/2.4.8 OpenSSL/0.9.4
+ENV: SSL_SERVER_I_DN_C =&gt; jp
+ENV: SSL_CIPHER_ALGKEYSIZE =&gt; 128
+ENV: REMOTE_ADDR =&gt; 10.1.1.3
+ENV: SSL_SSLEAY_VERSION =&gt; OpenSSL/0.9.4
+ENV: REQUEST_METHOD =&gt; POST
+ENV: SSL_SERVER_KEY_SIZE =&gt; Not supported by mod_ssl
+ENV: SSL_SERVER_C =&gt; jp
+ENV: REMOTE_USER =&gt; admin
+ENV: SSL_VERSION_LIBRARY =&gt; OpenSSL/0.9.4
+ENV: SSL_SERVER_S_DN =&gt; /C=jp/ST=Hokkaido/L=sapporo/O=FML.ORG sapporo/OU=Technical Div./CN=beth.fml.org/Email=fukachan@fml.org
+ENV: SSL_SERVER_CERT_END =&gt; Nov  7 12:23:31 2000 GMT
+ENV: SSL_SERVER_I_DN_L =&gt; sapporo
+ENV: HTTPS_CIPHER =&gt; EXP-RC4-MD5
+ENV: SSL_SERVER_I_DN_O =&gt; FML.ORG Sapporo
+ENV: HTTP_ACCEPT =&gt; image/gif, image/x-xbitmap, image/jpeg, image/pjpeg, image/png, */*
+ENV: HTTP_ACCEPT_LANGUAGE =&gt; en
+ENV: SSL_SERVER_L =&gt; sapporo
+ENV: SSL_SERVER_ISP =&gt; hokkaido
+ENV: HTTPS =&gt; on
+ENV: SSL_SERVER_IOU =&gt; Technical Division
+ENV: SCRIPT_FILENAME =&gt; /usr/local/fml/www/cgi-bin/admin/makefml.cgi
+ENV: SSLEAY_VERSION =&gt; OpenSSL/0.9.4
+ENV: SSL_SERVER_O =&gt; FML.ORG sapporo
+ENV: SERVER_NAME =&gt; beth.fml.org
+ENV: SSL_SERVER_CN =&gt; beth.fml.org
+ENV: SSL_SERVER_M_VERSION =&gt; 3
+ENV: SSL_SECRETKEYSIZE =&gt; 40
+ENV: SERVER_PORT =&gt; 443
+ENV: SSL_CLIENT_CERT =&gt; 
+ENV: SSL_CLIENT_KEY_ALGORITHM =&gt; Not supported by mod_ssl
+ENV: SSL_SERVER_IDN =&gt; /C=jp/ST=hokkaido/L=sapporo/O=FML.ORG Sapporo/OU=Technical Division/CN=beth.fml.org/Email=fukachan@fml.org
+ENV: SERVER_SIGNATURE =&gt; &le;ADDRESS&gt;Apache/1.3.9 Server at beth.fml.org Port 443&le;/ADDRESS&gt;
+
+ENV: SSL_SERVER_V_START =&gt; Nov  8 12:23:31 1999 GMT
+ENV: SSL_SERVER_SP =&gt; Hokkaido
+ENV: SSL_SERVER_OU =&gt; Technical Div.
+ENV: SSL_CIPHER =&gt; EXP-RC4-MD5
+ENV: HTTP_CONNECTION =&gt; Keep-Alive
+ENV: SSL_SERVER_I_DN_CN =&gt; beth.fml.org
+ENV: SSL_SERVER_S_DN_Email =&gt; fukachan@fml.org
+ENV: SSL_SERVER_CERT =&gt; -----BEGIN CERTIFICATE-----
+MIIDTjCCAregAwIBAgIBATANBgkqhkiG9w0BAQQFADCBsTELMAkGA1UEBhMCanAx
+SUogU2FwcG9ybzEbMBkGA1UECxMSVGVjaG5pY2FsIERpdmlzaW9uMR8wHQYDVQQD
+ExZiZXRoLnNhcHBvcm8uaWlqLmFkLmpwMSkwJwYJKoZIhvcNAQkBFhpmdWthY2hh
+bkBzYXBwb3JvLmlpai5hZC5qcDAeFw05OTExMDgxMjIzMzFaFw0wMDExMDcxMjIz
+MzFaMIGtMQswCQYDVQQGEwJqcDERMA8GA1UECBMISG9ra2FpZG8xEDAOBgNVBAcT
+B3NhcHBvcm8xFDASBgNVBAoTC0lJSiBzYXBwb3JvMRcwFQYDVQQLEw5UZWNobmlj
+SIb3DQEJARYaZnVrYWNoYW5Ac2FwcG9yby5paWouYWQuanAwgZ8wDQYJKoZIhvcN
+AQEBBQADgY0AMIGJAoGBAJ1/0it3TZQIoiTT9WQFdtssV25SCZEGeR/hwkmv7wPv
+XBng82cesCwpixGog4EGVQGIghCN6/6o9QYg8t1BY+C7IHjtHSn/GNWeim9TFQ/Y
+rEtf/TtbgJvnDh3PQuP+Z/MYjSwNCmyNP37LSehtztteoaUofL44TxQlVKD4vs6x
+AgMBAAGjeDB2MCUGA1UdEQQeMByBGmZ1a2FjaGFuQHNhcHBvcm8uaWlqLmFkLmpw
+MDoGCWCGSAGG+EIBDQQtFittb2Rfc3NsIGdlbmVyYXRlZCBjdXN0b20gc2VydmVy
+IGNlcnRpZmljYXRlMBEGCWCGSAGG+EIBAQQEAwIGQDANBgkqhkiG9w0BAQQFAAOB
+gQBBYnVVF7ILyCP/oSjJFvje9XUN25O9RNovnkYe/XQfsEeJZ2/wsuaX62aEY18x
+Y7cWn40sUEfDCQNGbUFNTkNjEOXgftYaQ3KANSAi/6PyWOP2eyGR8eQcBUJ4H7VE
+o4eS8dODzXmjyrNzxMCM0gfXvsIDLlbQPsDzf3t0m6YkzA==
+-----END CERTIFICATE-----
+
+ENV: SSL_KEYSIZE =&gt; 128
+ENV: SSL_SERVER_KEY_ALGORITHM =&gt; Not supported by mod_ssl
+ENV: HTTPS_KEYSIZE =&gt; 128
+ENV: REQUEST_URI =&gt; /cgi-bin/fml/admin/makefml.cgi
+ENV: SSL_SERVER_IEMAIL =&gt; fukachan@fml.org
+ENV: SSL_SERVER_DN =&gt; /C=jp/ST=Hokkaido/L=sapporo/O=FML.ORG sapporo/OU=Technical Div./CN=beth.fml.org/Email=fukachan@fml.org
+ENV: SSL_SERVER_S_DN_CN =&gt; beth.fml.org
+ENV: CONTENT_LENGTH =&gt; 67
+ENV: SSL_SERVER_I_DN =&gt; /C=jp/ST=hokkaido/L=sapporo/O=FML.ORG Sapporo/OU=Technical Division/CN=beth.fml.org/Email=fukachan@fml.org
+ENV: GATEWAY_INTERFACE =&gt; CGI/1.1
+ENV: DOCUMENT_ROOT =&gt; /usr/local/apache/htdocs
+ENV: SSL_SERVER_CERT_START =&gt; Nov  8 12:23:31 1999 GMT
+ENV: SSL_PROTOCOL =&gt; SSLv3
+ENV: SSL_SERVER_I_DN_SP =&gt; hokkaido
+ENV: SSL_SERVER_I_DN_OU =&gt; Technical Division
+ENV: SSL_PROTOCOL_VERSION =&gt; SSLv3
+ENV: SSL_SERVER_A_SIG =&gt; md5WithRSAEncryption
+ENV: QUERY_STRING =&gt; 
+ENV: SSL_SERVER_S_DN_SP =&gt; Hokkaido
+ENV: SSL_SERVER_S_DN_C =&gt; jp
+ENV: SSL_CIPHER_EXPORT =&gt; true
+ENV: SSL_SERVER_S_DN_OU =&gt; Technical Div.
+ENV: REMOTE_PORT =&gt; 58991
+ENV: SSL_SERVER_A_KEY =&gt; rsaEncryption
+ENV: SERVER_ADDR =&gt; 10.1.1.3
+ENV: SSL_SERVER_IC =&gt; jp
+ENV: HTTPS_EXPORT =&gt; true
+ENV: HTTP_ACCEPT_ENCODING =&gt; gzip
+ENV: SSL_SERVER_CERTFILE =&gt; Not supported by mod_ssl
+ENV: SSL_SERVER_S_DN_L =&gt; sapporo
+ENV: HTTP_PRAGMA =&gt; no-cache
+ENV: SSL_SERVER_S_DN_O =&gt; FML.ORG sapporo
+ENV: SSL_SERVER_IL =&gt; sapporo
+ENV: HTTPS_SECRETKEYSIZE =&gt; 40
+ENV: SSL_CIPHER_USEKEYSIZE =&gt; 40
+ENV: SSL_SERVER_IO =&gt; FML.ORG Sapporo
+ENV: SERVER_ADMIN =&gt; fukachan@beth.fml.org
+ENV: SSL_CLIENT_KEY_EXP =&gt; Not supported by mod_ssl
+ENV: SSL_CLIENT_VERIFY =&gt; NONE
+ENV: SSL_VERSION_INTERFACE =&gt; mod_ssl/2.4.8
+ENV: SERVER_PROTOCOL =&gt; HTTP/1.0
+ENV: SSL_SERVER_I_DN_Email =&gt; fukachan@fml.org
+ENV: SSL_SERVER_SESSIONDIR =&gt; Not supported by mod_ssl
+ENV: HTTP_REFERER =&gt; https://beth/cgi-bin/fml/admin/menu.cgi
+ENV: SSL_SERVER_CERTIFICATE =&gt; -----BEGIN CERTIFICATE-----
+MIIDTjCCAregAwIBAgIBATANBgkqhkiG9w0BAQQFADCBsTELMAkGA1UEBhMCanAx
+ETAPBgNVBAgTCGhva2thaWRvMRAwDgYDVQQHEwdzYXBwb3JvMRQwEgYDVQQKEwtJ
+SUogU2FwcG9ybzEbMBkGA1UECxMSVGVjaG5pY2FsIERpdmlzaW9uMR8wHQYDVQQD
+bkBzYXBwb3JvLmlpai5hZC5qcDAeFw05OTExMDgxMjIzMzFaFw0wMDExMDcxMjIz
+MzFaMIGtMQswCQYDVQQGEwJqcDERMA8GA1UECBMISG9ra2FpZG8xEDAOBgNVBAcT
+B3NhcHBvcm8xFDASBgNVBAoTC0lJSiBzYXBwb3JvMRcwFQYDVQQLEw5UZWNobmlj
+YWwgRGl2LjEfMB0GA1UEAxMWYmV0aC5zYXBwb3JvLmlpai5hZC5qcDEpMCcGCSqG
+SIb3DQEJARYaZnVrYWNoYW5Ac2FwcG9yby5paWouYWQuanAwgZ8wDQYJKoZIhvcN
+XBng82cesCwpixGog4EGVQGIghCN6/6o9QYg8t1BY+C7IHjtHSn/GNWeim9TFQ/Y
+rEtf/TtbgJvnDh3PQuP+Z/MYjSwNCmyNP37LSehtztteoaUofL44TxQlVKD4vs6x
+AgMBAAGjeDB2MCUGA1UdEQQeMByBGmZ1a2FjaGFuQHNhcHBvcm8uaWlqLmFkLmpw
+MDoGCWCGSAGG+EIBDQQtFittb2Rfc3NsIGdlbmVyYXRlZCBjdXN0b20gc2VydmVy
+IGNlcnRpZmljYXRlMBEGCWCGSAGG+EIBAQQEAwIGQDANBgkqhkiG9w0BAQQFAAOB
+gQBBYnVVF7ILyCP/oSjJFvje9XUN25O9RNovnkYe/XQfsEeJZ2/wsuaX62aEY18x
+Y7cWn40sUEfDCQNGbUFNTkNjEOXgftYaQ3KANSAi/6PyWOP2eyGR8eQcBUJ4H7VE
+o4eS8dODzXmjyrNzxMCM0gfXvsIDLlbQPsDzf3t0m6YkzA==
+-----END CERTIFICATE-----
+
+ENV: SSL_SERVER_CERTIFICATELOGDIR =&gt; Not supported by mod_ssl
+ENV: HTTP_USER_AGENT =&gt; Mozilla/4.61 [en] (X11; I; NetBSD 1.4D i386; Nav)
+ENV: PATH =&gt; /sbin:/usr/sbin:/bin:/usr/bin:/usr/pkg/sbin:/usr/pkg/bin:/usr/X11R6/bin:/usr/local/sbin:/usr/local/bin
+ENV: SSL_STRONG_CRYPTO =&gt; Not supported by mod_ssl
+ENV: SSL_SERVER_EMAIL =&gt; fukachan@fml.org
+ENV: SSL_SERVER_KEYFILE =&gt; Not supported by mod_ssl
+ENV: SSL_SERVER_KEYFILETYPE =&gt; Not supported by mod_ssl
+ENV: SSL_CLIENT_KEY_SIZE =&gt; Not supported by mod_ssl
+ENV: SSL_SERVER_V_END =&gt; Nov  7 12:23:31 2000 GMT
+ENV: SSL_SERVER_M_SERIAL =&gt; 01
+ENV: AUTH_TYPE =&gt; Basic
+ENV: SSL_EXPORT =&gt; true
+ENV: SSL_SERVER_CERT_SERIAL =&gt; 01
+ENV: SCRIPT_NAME =&gt; /cgi-bin/fml/admin/makefml.cgi
+ENV: HTTP_ACCEPT_CHARSET =&gt; iso-8859-1,*,utf-8
+ENV: SSL_SERVER_KEY_EXP =&gt; Not supported by mod_ssl
+ENV: CONTENT_TYPE =&gt; application/x-www-form-urlencoded
+ENV: HTTP_HOST =&gt; beth
+ENV: SSL_SERVER_SIGNATURE_ALGORITHM =&gt; md5WithRSAEncryption
+Config: submit-p =&gt; Remove
+Config: ML =&gt; sayori
+Config: PROC =&gt; destructml
+Config: LANGUAGE =&gt; Japanese
+Config: ML_DEF =&gt; 
+メーリングリスト: sayori
+を削除します。
+
+    makefml destructml mailing-list
+
+arguments of mailing-list is required
+</screen>
+
+</sect1>
+
+</chapter>
diff --git a/fml/doc/ja/tech/bind b/fml/doc/ja/tech/bind
deleted file mode 100644
index 9bd3774d..00000000
--- a/fml/doc/ja/tech/bind
+++ /dev/null
@@ -1,5 +0,0 @@
-	how to get bind version
-
-% nslookup -type=txt -class=CHAOS version.bind $HOST
-
-$Id$
diff --git a/fml/doc/ja/tech/bind.sgml b/fml/doc/ja/tech/bind.sgml
new file mode 100644
index 00000000..3386f8e9
--- /dev/null
+++ b/fml/doc/ja/tech/bind.sgml
@@ -0,0 +1,19 @@
+<!--
+   $FML$
+-->
+
+<chapter id="bind">
+
+<title> BIND (Berkeley Internet Name Domain) </title>
+
+
+<sect1>
+<title> BIND のバージョンを知る </title>
+
+<screen>
+% nslookup -type=txt -class=CHAOS version.bind $HOST
+</screen>     
+
+</sect1>
+
+</chapter>
diff --git a/fml/doc/ja/tech/book.sgml b/fml/doc/ja/tech/book.sgml
new file mode 100644
index 00000000..9f70005c
--- /dev/null
+++ b/fml/doc/ja/tech/book.sgml
@@ -0,0 +1,41 @@
+<!--
+This is an sgml using DocBook dtd. Use sgmltools version 2.0.x or above
+to generate various output formats.
+
+$FML: fml-devel.sgml,v 1.15 2001/04/26 11:02:39 fukachan Exp $
+-->
+
+<!doctype book public "-//OASIS//DTD DocBook V3.1//EN" [
+	<!entity % include SYSTEM "include.sgml"> %include;
+]>
+
+<book id="techtips">
+
+  &bookinfo;
+
+  <toc></toc>
+
+  <part>
+         <title> メール関連の話題 </title>
+
+   &postfix;
+   &qmail;
+   &bind;
+
+  </part>
+
+  <part>
+         <title> WWW 関連の話題 </title>
+
+    &apache;
+    &openssl;
+  </part>
+
+  <part>
+         <title> その多諸々の話題 </title>
+
+    &cvs;
+    &rsync;
+  </part>
+
+</book>
diff --git a/fml/doc/ja/tech/bookinfo.sgml b/fml/doc/ja/tech/bookinfo.sgml
new file mode 100644
index 00000000..57b5c1e9
--- /dev/null
+++ b/fml/doc/ja/tech/bookinfo.sgml
@@ -0,0 +1,41 @@
+<!--
+	$FML: bookinfo.sgml,v 1.1 2001/04/24 06:51:59 fukachan Exp $
+-->
+
+  <bookinfo>
+  <bookbiblio>
+    <title>
+	fml-devel (fml 5.0) テクニカル TIPS
+    </title>
+
+    <author>
+	<honorific> Dr        </honorific>
+	<firstname> Ken'ichi  </firstname>
+	<surname>   Fukamachi </surname>
+	<affiliation>
+		<orgname>FML.ORG</orgname>
+	    <address>
+		<email>
+		<ulink url="mailto:fukachan@fml.org">
+		fukachan@fml.org
+		</ulink> 
+		</email>
+	    </address>
+	</affiliation>
+    </author>
+
+    <copyright>
+	<year> 2001 </year>
+	<holder> Ken'ichi Fukamachi </holder>
+    </copyright>
+
+  </bookbiblio>
+
+    <legalnotice>
+      <para>
+	All rights reserved. This program is free software; you can
+	redistribute it and/or modify it under the same terms as Perl itself. 
+      </para>
+    </legalnotice>
+
+  </bookinfo>
diff --git a/fml/doc/ja/tech/cvs b/fml/doc/ja/tech/cvs
deleted file mode 100644
index c737ad9a..00000000
--- a/fml/doc/ja/tech/cvs
+++ /dev/null
@@ -1,15 +0,0 @@
-	How to make anonymous cvs
-
-
-0. install cvs-1.10.8
-
-1. configure
-
-	% cvs -d /exports/cvsroot init
-
-	XXX chdir NOT run "cvs co CVSROOT" !
-
-	% cd /exports/cvsroot/CVSROOT
-	% echo anoncvs > readers
-	% echo anoncvs: > passwd
-
diff --git a/fml/doc/ja/tech/cvs.sgml b/fml/doc/ja/tech/cvs.sgml
new file mode 100644
index 00000000..5f592558
--- /dev/null
+++ b/fml/doc/ja/tech/cvs.sgml
@@ -0,0 +1,38 @@
+<!--
+   $FML$
+-->
+
+<chapter id="cvs">
+
+<title> CVS (Concurrent Version System) </title>
+
+<sect1>
+<title> anonymous cvs を作る (cvs 1.10.8 の時代) </title>
+
+<para>
+cvs-1.10.8 をインストールした後、
+次のような操作をします。
+<screen>
+	% cvs -d /exports/cvsroot init
+	% cd /exports/cvsroot/CVSROOT
+	% echo anoncvs > readers
+	% echo anoncvs: > passwd
+</screen>
+ここで CVSROOT 以下を操作する際に、
+cvs co して取り出すのではなく、そのディレクトリで操作していることに注
+意されたい。
+これらのファイルはチェックアウトできてはいけないのである。
+</para>
+
+</sect1>
+
+<sect1>
+<title> anonymous cvs を作る (cvs 1.11 以降) </title>
+
+<para>
+何も考えなくても作れるはずだが… (未調査)
+</para>
+
+</sect1>
+
+</chapter>
diff --git a/fml/doc/ja/tech/include.sgml b/fml/doc/ja/tech/include.sgml
new file mode 100644
index 00000000..c8d482a0
--- /dev/null
+++ b/fml/doc/ja/tech/include.sgml
@@ -0,0 +1,22 @@
+<!--
+	$FML: include.sgml,v 1.15 2001/04/26 11:02:39 fukachan Exp $
+-->
+
+<!entity versin "1.1">
+
+<!-- include する SGML ファイル群 -->
+<!entity bookinfo SYSTEM "bookinfo.sgml">
+
+<!-- ポインタ -->
+<!entity fmlbible    "『fml バイブル』(オライリージャパン刊)">
+<!entity www.fml.org "http://www.fml.org/fml/">
+
+
+<!-- includes -->
+<!entity apache  SYSTEM "apache.sgml">
+<!entity bind    SYSTEM "bind.sgml">
+<!entity cvs     SYSTEM "cvs.sgml">
+<!entity openssl SYSTEM "openssl.sgml">
+<!entity postfix SYSTEM "postfix.sgml">
+<!entity qmail   SYSTEM "qmail.sgml">
+<!entity rsync   SYSTEM "rsync.sgml">
diff --git a/fml/doc/ja/tech/openssl b/fml/doc/ja/tech/openssl.sgml
index 350dda5e..a50557e5 100644
--- a/fml/doc/ja/tech/openssl
+++ b/fml/doc/ja/tech/openssl.sgml
@@ -1,8 +1,19 @@
-		OPENSSL: BASIC HOW-TO
+<!--
+   $FML$
+-->
 
-------------------------------------------------------------------------
-* create "private key"
+<chapter id="openssl">
 
+<title> openssl の使い方 </title>
+
+<sect1>
+<title> 非対称鍵を作る </title>
+
+<sect2>
+   <title> private key を作る </title>
+
+<para>
+<screen>
 % openssl genrsa -des 1024 > private.pem
 1120 semi-random bytes loaded
 Generating RSA private key, 1024 bit long modulus
@@ -13,11 +24,14 @@ Enter PEM pass phrase:
 Verifying password - Enter PEM pass phrase:
 % ls
 private.pem
+</screen>
+</para>
+</sect2>
 
+<sect2>
+   <title> create key to be submitted to CA </title>
 
-------------------------------------------------------------------------
-* create key to be submitted to CA
-
+<screen>
 % openssl req -new -key private.pem -out csr.pem
 Using configuration from /usr/local/ssl/openssl.cnf
 Enter PEM pass phrase:
@@ -42,10 +56,15 @@ A challenge password []:
 An optional company name []:
 % ls
 csr.pem         private.pem
+</screen>
+</sect2>
 
-------------------------------------------------------------------------
-* sign signature by CA (here myself == private.pem, but it is meaningless).
+<sect2>
+  <title> sign signature by CA 
+          (here myself == private.pem, but it is meaningless).
+  </title>
 
+<screen>
 % openssl x509 -in csr.pem -out crt.pem -req -signkey private.pem 
 Signature ok
 subject=/C=JP/ST=Hokkaido/L=Sapporo/O=fml project/CN=beth.fml.org/Email=fukachan@fml.org
@@ -53,5 +72,9 @@ Getting Private key
 Enter PEM pass phrase:
 % ls
 crt.pem         csr.pem         private.pem
+</screen>
+</sect2>
+
+</sect1>
 
-$Id$
+</chapter>
diff --git a/fml/doc/ja/tech/rsync b/fml/doc/ja/tech/rsync
deleted file mode 100644
index bd2511be..00000000
--- a/fml/doc/ja/tech/rsync
+++ /dev/null
@@ -1,16 +0,0 @@
-	how to set up rsyncd
-
-1. set up /etc/rsyncd.conf
-
-	[ftp]
-	path    = /var/spool/ftp/pub
-	comment = ftp area
-
-1.1 edit /etc/inetd.conf
-
-2. test: run in this way !
-
-	% rsync -av rsync://rsync.fml.org/ftp/fml/ ./
-
-
-$Id$
diff --git a/fml/doc/ja/tech/rsync.sgml b/fml/doc/ja/tech/rsync.sgml
new file mode 100644
index 00000000..aa668961
--- /dev/null
+++ b/fml/doc/ja/tech/rsync.sgml
@@ -0,0 +1,37 @@
+<!--
+   $FML$
+-->
+
+<chapter id="rsync">
+
+<title> RSYNC </title>
+
+<sect1>
+<title> rsync サーバを作る </title>
+
+<para>
+まず /etc/rsyncd.conf を定義します。
+samba.conf とそっくりですが、それは
+samba と rsync の作者が同じ人だからです :-)
+
+<screen>
+[ftp]
+path    = /var/spool/ftp/pub
+comment = ftp area
+</screen>
+</para>
+
+<para>
+次に /etc/inetd.conf を編集して下さい。
+</para>
+
+<para>
+では、テストです。
+<screen>
+% rsync -av rsync://rsync.fml.org/ftp/fml/ ./
+</screen>
+</para>
+
+</sect1>
+
+</chapter>