From: minakaji Date: Tue, 26 Dec 2000 12:07:05 +0000 (+0000) Subject: * README.en: Change major mode to outline-mode. X-Git-Tag: apel-10_3~10 X-Git-Url: http://git.chise.org/gitweb/?a=commitdiff_plain;h=5fbad900555eb64158390bd9c8fe9c9526b69734;p=elisp%2Fapel.git * README.en: Change major mode to outline-mode. (What's APEL?): Add description about pym.el, pces, time-stamp.el, timezone.el, and product.el. (run in expanded place): Add a reference to `make.bat (for MS-DOS family)'. * README.ja: Change major mode to outline-mode. (What's APEL?): Add description about pym.el, pces, time-stamp.el, timezone.el, and product.el. --- diff --git a/ChangeLog b/ChangeLog index 3311a2b..c5e0f1a 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,15 @@ +2000-12-26 NAKAJIMA Mikio + + * README.en: Change major mode to outline-mode. + (What's APEL?): Add description about pym.el, pces, time-stamp.el, + timezone.el, and product.el. + (run in expanded place): Add a reference to `make.bat (for MS-DOS + family)'. + + * README.ja: Change major mode to outline-mode. + (What's APEL?): Add description about pym.el, pces, time-stamp.el, + timezone.el, and product.el. + 2000-12-24 NAKAJIMA Mikio * poe.el (minor-mode-overriding-map-alist): Remove the filename diff --git a/README.en b/README.en index 6f01f23..c19b3e4 100644 --- a/README.en +++ b/README.en @@ -1,274 +1,314 @@ +-*- outline -*- + [README for APEL (English Version)] -What's APEL? -============ +* What's APEL? + +APEL stands for "A Portable Emacs Library". It consists of following +modules: + +** poe.el + +This is an emulation module mainly for basic functions and special +forms/macros of latest emacsen. + + poe-xemacs.el --- for XEmacs + poe-18.el --- for Emacs 18/Nemacs + env.el --- env.el for Emacs 18 + localhook.el --- hook functions for Emacs 19.28 and earlier. + pym.el --- macros for poe. + +** poem.el + +This module provides basic functions to write portable MULE programs. + + poem-nemacs.el --- for Nemacs + poem-ltn1.el --- for Emacs 19/XEmacs without MULE + poem-om.el --- for MULE 1.*, 2.* + poem-20.el --- shared module between Emacs 20 and XEmacs-MULE + poem-e20_2.el --- for Emacs 20.1/20.2 + poem-e20_3.el --- for Emacs 20.3 + poem-xm.el --- for XEmacs-MULE + +** pces.el + +This module provides portable character encoding scheme +(coding-system) features. + + pces-20.el --- for Emacs 20 and XEmacs with coding-system. + pces-e20.el --- for Emacs 20. + pces-e20_2.el --- for Emacs 20.1 and 20.2. + pces-nemacs.el --- for Nemacs. + pces-om.el --- for Mule 1.* and Mule 2.*. + pces-raw.el --- for emacsen without coding-system features. + pces-xfc.el --- for XEmacs with file coding. + pces-xm.el --- for XEmacs-mule. - APEL stands for "A Portable Emacs Library". It consists of - following modules: +** invisible.el - poe.el --- emulation module mainly for basic functions and special - forms/macros of latest emacsen - poe-xemacs.el --- for XEmacs - poe-18.el --- for Emacs 18/Nemacs - env.el --- env.el for Emacs 18 - localhook.el --- hook functions for Emacs 19.28 and earlier. +This modules provides features about invisible region. - poem.el --- provide basic functions to write portable MULE - programs - poem-nemacs.el --- for Nemacs - poem-ltn1.el --- for Emacs 19/XEmacs without MULE - poem-om.el --- for MULE 1.*, 2.* - poem-20.el --- shared module between Emacs 20 and XEmacs-MULE - poem-e20_2.el --- for Emacs 20.1/20.2 - poem-e20_3.el --- for Emacs 20.3 - poem-xm.el --- for XEmacs-MULE + inv-18.el --- for Emacs 18 + inv-19.el --- for Emacs 19 + inv-xemacs.el --- for XEmacs - invisible.el --- provide features about invisible region - inv-18.el --- for Emacs 18 - inv-19.el --- for Emacs 19 - inv-xemacs.el --- for XEmacs +** mcharset.el - mcharset.el --- provide MIME charset related features - mcs-nemacs.el --- for Nemacs - mcs-ltn1.el --- for Emacs 19/XEmacs without MULE - mcs-om.el --- for MULE 1.*, 2.* - mcs-20.el --- shared module between Emacs 20 and XEmacs-MULE - mcs-e20.el --- for Emacs 20 - mcs-xm.el --- for XEmacs-MULE - mcs-xmu.el --- for XEmacs-MULE to unify ISO646 characters +This modules provides MIME charset related features. - static.el --- utility for static evaluation + mcs-nemacs.el --- for Nemacs + mcs-ltn1.el --- for Emacs 19/XEmacs without MULE + mcs-om.el --- for MULE 1.*, 2.* + mcs-20.el --- shared module between Emacs 20 and XEmacs-MULE + mcs-e20.el --- for Emacs 20 + mcs-xm.el --- for XEmacs-MULE + mcs-xmu.el --- for XEmacs-MULE to unify ISO646 characters - broken.el --- provide information of broken facilities of Emacs +** static.el --- utility for static evaluation - pccl.el --- utility to write portable CCL program - pccl-om.el --- for MULE 2.* - pccl-20.el --- for Emacs 20/XEmacs-21-MULE +** broken.el --- provide information of broken facilities of Emacs - alist.el: utility for Association-list +** pccl.el --- utility to write portable CCL program - calist.el: utility for condition tree and - condition/situation-alist + pccl-om.el --- for MULE 2.* + pccl-20.el --- for Emacs 20/XEmacs-21-MULE - path-util.el: utility for path management or file detection +** alist.el: utility for Association-list - filename.el: utility to make file-name +** calist.el: utility for condition tree and condition/situation-alist - install.el: utility to install emacs-lisp package +** path-util.el: utility for path management or file detection - mule-caesar.el: ROT 13-47-48 Caesar rotation utility +** filename.el: utility to make file-name - emu.el --- (emu bundled in tm-7.106 compatibility module; it - required poe, poem and mcharset) - emu-mule: for MULE 1.*, 2.* - richtext.el --- text/richtext module - for Emacs 19.29 or later, - XEmacs 19.14 or later - tinyrich.el --- text/richtext module for old emacsen +** install.el: utility to install emacs-lisp package - pcustom.el --- provide portable custom environment +** mule-caesar.el: ROT 13-47-48 Caesar rotation utility - tinycustom.el --- emulation module of custom.el +** emu.el +This module provides emu bundled in tm-7.106 compatibility. It +required poe, poem and mcharset. -Installation -============ + emu-mule: --- for MULE 1.*, 2.*. + richtext.el --- text/richtext module for Emacs 19.29 or later, + XEmacs 19.14 or later + tinyrich.el --- text/richtext module for old emacsen -(a) run in expanded place +** pcustom.el --- provide portable custom environment - If you don't want to install other directories, please do only - following: + tinycustom.el --- emulation module of custom.el - % make +** time-stamp.el - You can specify the emacs command name, for example +This is a utility to maintain last change time stamps in files edited +by Emacs. - % make EMACS=xemacs +** timezone.el - If `EMACS=...' is omitted, EMACS=emacs is used. +This is a utility of time zone. This is a Y2K fixed version. This +works with old GNUS 3.14.4 under version 18 of Emacs, too. -(b) make install +** product.el --- Functions for product version information. - If you want to install other directories, please do following: +* Installation - % make install +** run in expanded place - You can specify the emacs command name, for example +If you don't want to install other directories, please do only +following (You can use make.bat for MS-DOS OS family. If you want to +use it, see `make.bat (for MS-DOS family)'): - % make install EMACS=xemacs + % make - If `EMACS=...' is omitted, EMACS=emacs is used. +You can specify the emacs command name, for example - You can specify the prefix of the directory tree for Emacs Lisp - programs and shell scripts, for example: + % make EMACS=xemacs - % make install PREFIX=~/ +If `EMACS=...' is omitted, EMACS=emacs is used. - If `PREFIX=...' is omitted, the prefix of the directory tree of the - specified emacs command is used (perhaps /usr/local). +** make install - For example, if PREFIX=/usr/local and Emacs 20.2 is specified, it - will create the following directory tree: +If you want to install other directories, please do following: - /usr/local/share/emacs/20.2/site-lisp/ --- emu - /usr/local/share/emacs/site-lisp/apel/ --- APEL + % make install - You can specify the lisp directory for Emacs Lisp programs, - for example: +You can specify the emacs command name, for example - % make install LISPDIR=~/elisp + % make install EMACS=xemacs - You can also specify the version specific lisp directory where the - emu modules will be installed in, for example: +If `EMACS=...' is omitted, EMACS=emacs is used. - % make install VERSION_SPECIFIC_LISPDIR=~/elisp +You can specify the prefix of the directory tree for Emacs Lisp +programs and shell scripts, for example: - If you would like to know what files belong to the emu modules or - the apel modules, or where they will be installed in, for example, - please type the following command. + % make install PREFIX=~/ - % make what-where LISPDIR=~/elisp VERSION_SPECIFIC_LISPDIR=~/elisp +If `PREFIX=...' is omitted, the prefix of the directory tree of the +specified emacs command is used (perhaps /usr/local). - You can specify other optional settings by editing the file - APEL-CFG. Please read comments in it. +For example, if PREFIX=/usr/local and Emacs 20.2 is specified, it +will create the following directory tree: -(c) install as a XEmacs package + /usr/local/share/emacs/20.2/site-lisp/ --- emu + /usr/local/share/emacs/site-lisp/apel/ --- APEL - If you want to install to XEmacs package directory, please do - following: +You can specify the lisp directory for Emacs Lisp programs, +for example: - % make install-package + % make install LISPDIR=~/elisp - You can specify the emacs command name, for example +You can also specify the version specific lisp directory where the +emu modules will be installed in, for example: - % make install-package XEMACS=xemacs-21 + % make install VERSION_SPECIFIC_LISPDIR=~/elisp - If `XEMACS=...' is omitted, XEMACS=xemacs is used. +If you would like to know what files belong to the emu modules or +the apel modules, or where they will be installed in, for example, +please type the following command. - You can specify the package directory, for example: + % make what-where LISPDIR=~/elisp VERSION_SPECIFIC_LISPDIR=~/elisp - % make install PACKAGEDIR=~/.xemacs +You can specify other optional settings by editing the file +APEL-CFG. Please read comments in it. - If `PACKAGEDIR=...' is omitted, the first existing package - directory is used. +** install as a XEmacs package - Notice that XEmacs package system requires XEmacs 21.0 or later. +If you want to install to XEmacs package directory, please do +following: + % make install-package -(d) make.bat (for MS-DOS family) +You can specify the emacs command name, for example - make.bat is available for MS-DOS family. You have to edit - make.bat if you want to use it. If you use cygwin environment, - you can use make.exe and Makefile instead of make.bat. + % make install-package XEMACS=xemacs-21 - In make.bat, a line which contain `rem' in its beginning is a - comment. You have to insert or delete `rem', if necessary. +If `XEMACS=...' is omitted, XEMACS=xemacs is used. - Default setups of make.bat is; +You can specify the package directory, for example: - set MEADOWVER=1.10 - set PREFIX=c:\usr\meadow - set EMACS=%PREFIX%\%MEADOWVER%\bin\meadow95.exe - set LISPDIR=%PREFIX%\site-lisp - set VLISPDIR=%PREFIX%\%MEADOWVER%\site-lisp + % make install PACKAGEDIR=~/.xemacs - It assumes that meadow executable binary exists in - c:\usr\meadow\1.10\bin\meadow95.exe. On such basis make.bat will - try to install meadow version independent modules of APEL to; +If `PACKAGEDIR=...' is omitted, the first existing package +directory is used. - c:\usr\meadow\site-lisp +Notice that XEmacs package system requires XEmacs 21.0 or later. - and meadow version dependent modules to; - c:\usr\meadow\1.10\site-lisp +** make.bat (for MS-DOS family) - Please edit make.bat for your own environment and run make.bat +make.bat is available for MS-DOS family. You have to edit +make.bat if you want to use it. If you use cygwin environment, +you can use make.exe and Makefile instead of make.bat. - Emacs 19.3x or earlier does not have (e.x. Mule for Windows based on - 19.28) an Emacs version dependent site-lisp directory - (e.x. c:\usr\meadow\1.10\site-lisp), and its load-path does not refer - to such directory by default. If you want install APEL to such an Emacs - you may install all APEL modules to an Emacs version independent - site-lisp directory such as c:\usr\mule\site-lisp. +In make.bat, a line which contain `rem' in its beginning is a +comment. You have to insert or delete `rem', if necessary. - We cannot provide you with a Demacs example for make.bat. If you install - APEL to Demacs, please send us such an example to apel-en@m17n.org (you - can post a message to the ML, even if you are not a member). +Default setups of make.bat is; - If you checkout APEL by using Windows native cvs.exe (not cygwin), - cvs.exe will regularize end of line codes, LF to CRLF. And it also will - try to convert CRLF to CRCRLF. make.bat of which eol code is CRCRLF does - not work, so if you get such a make.bat, edit it to really regularize eol - codes to CRLF. If you need further information, see the following URL - (n.b. Japanese only) + set MEADOWVER=1.10 + set PREFIX=c:\usr\meadow + set EMACS=%PREFIX%\%MEADOWVER%\bin\meadow95.exe + set LISPDIR=%PREFIX%\site-lisp + set VLISPDIR=%PREFIX%\%MEADOWVER%\site-lisp - http://openlab.ring.gr.jp/skk/cvswin-ja.html +It assumes that meadow executable binary exists in +c:\usr\meadow\1.10\bin\meadow95.exe. On such basis make.bat will +try to install meadow version independent modules of APEL to; -load-path (for Emacs or MULE) -============================= + c:\usr\meadow\site-lisp - If you are using Emacs or Mule, please add directory of apel to - load-path. If you install by default setting with Emacs 19.29 or - later or Emacs 20.1/20.2, you can write subdirs.el for example: +and meadow version dependent modules to; - -------------------------------------------------------------------- - (normal-top-level-add-to-load-path '("apel")) - -------------------------------------------------------------------- + c:\usr\meadow\1.10\site-lisp - If you are using Emacs 20.3 or later or XEmacs, there are no need to - set up load-path with normal installation. +Please edit make.bat for your own environment and run make.bat +Emacs 19.3x or earlier does not have (e.x. Mule for Windows based on +19.28) an Emacs version dependent site-lisp directory +(e.x. c:\usr\meadow\1.10\site-lisp), and its load-path does not refer +to such directory by default. If you want install APEL to such an Emacs +you may install all APEL modules to an Emacs version independent +site-lisp directory such as c:\usr\mule\site-lisp. -Version specific information -============================ +We cannot provide you with a Demacs example for make.bat. If you install +APEL to Demacs, please send us such an example to apel-en@m17n.org (you +can post a message to the ML, even if you are not a member). -For Emacs 18 users: "old byte-compiler" vs "new byte-compiler" +If you checkout APEL by using Windows native cvs.exe (not cygwin +version), cvs.exe will regularize end of line codes, LF to CRLF. And +it also will try to convert CRLF to CRCRLF. make.bat of which eol +code is CRCRLF does not work, so if you get such a make.bat, edit it +to really regularize eol codes to CRLF. If you need further +information, see the following URL (n.b. Japanese only) - In this package, we use compile-time evaluation heavily. - Unfortunately, the byte-compiler bundled with Emacs 18 (the "old - byte-compiler") does not have features such as `eval-when-compile' - and `eval-and-compile', and our emulation version of these macros - evaluate "compile-time evaluation" at load-time or at run-time! - In addition, the "old byte-compiler" cannot compile top-level use of - macros and leaves most of our code uncompiled. + http://openlab.ring.gr.jp/skk/cvswin-ja.html - Therefore, we recommend you to use the "new" optimizing byte-compiler. - It is the origin of byte-compiler bundled with Emacs 19 and later. +* load-path (for Emacs or MULE) - Optimizing byte-compiler for Emacs 18 is available from the Emacs - Lisp Archive and its mirrors. +If you are using Emacs or Mule, please add directory of apel to +load-path. If you install by default setting with Emacs 19.29 or +later or Emacs 20.1/20.2, you can write subdirs.el for example: - In Mule 1.* days, "contrib" package for Mule 1.* was distributed and - it contained the "new byte-compiler" for Mule. But, I think it is - difficult to obtain this package now. +-------------------------------------------------------------------- +(normal-top-level-add-to-load-path '("apel")) +-------------------------------------------------------------------- - AFAIK, the "new byte-compiler" for Emacs 18 is also bundled with SKK - 9.6 or SKK 10.62a. You can get SKK 10.62a from the following URL; - http://openlab.ring.gr.jp/skk/maintrunk - They include patch for Mule 1.*. +If you are using Emacs 20.3 or later or XEmacs, there are no need to +set up load-path with normal installation. -For Emacs 19.34 and XEmacs 19.14 users: "old custom" vs "new custom" +* Version specific information - "custom" library bundled with Emacs 19.32 - 19.34, XEmacs 19.14, and - Gnus 5.2/5.3 is "old", its API is incompatible with "new custom" - bundled with Emacs 20.1, XEmacs 19.15, or newer, and Gnus 5.4/5.5. +** For Emacs 18 users: "old byte-compiler" vs "new byte-compiler" - "new custom" for Emacs 19.34 and XEmacs 19.15 - 20.2 is available - from the following URL. +In this package, we use compile-time evaluation heavily. +Unfortunately, the byte-compiler bundled with Emacs 18 (the "old +byte-compiler") does not have features such as `eval-when-compile' +and `eval-and-compile', and our emulation version of these macros +evaluate "compile-time evaluation" at load-time or at run-time! +In addition, the "old byte-compiler" cannot compile top-level use of +macros and leaves most of our code uncompiled. - ftp://ftp.dina.kvl.dk/pub/Staff/Per.Abrahamsen/custom/custom-1.9962.tar.gz +Therefore, we recommend you to use the "new" optimizing byte-compiler. +It is the origin of byte-compiler bundled with Emacs 19 and later. - (Note that "new custom" bundled with XEmacs 19.15 - 20.2, and Gnus - 5.4/5.5 is older than this version.) +Optimizing byte-compiler for Emacs 18 is available from the Emacs +Lisp Archive and its mirrors. - Before installing "new custom", you should check the following points. +In Mule 1.* days, "contrib" package for Mule 1.* was distributed and +it contained the "new byte-compiler" for Mule. But, I think it is +difficult to obtain this package now. - 1) If you stick to Gnus 5.2/5.3 (or any other applications which - use "old custom"), you should not install "new custom". +AFAIK, the "new byte-compiler" for Emacs 18 is also bundled with SKK +9.6 or SKK 10.62a. You can get SKK 10.62a from the following URL; - 2) If you use Mule (based on Emacs 19), you must apply this patch - to "new custom". + http://openlab.ring.gr.jp/skk/maintrunk + +They include patch for Mule 1.*. + + +** For Emacs 19.34 and XEmacs 19.14 users: "old custom" vs "new custom" + +"custom" library bundled with Emacs 19.32 - 19.34, XEmacs 19.14, and +Gnus 5.2/5.3 is "old", its API is incompatible with "new custom" +bundled with Emacs 20.1, XEmacs 19.15, or newer, and Gnus 5.4/5.5. + +"new custom" for Emacs 19.34 and XEmacs 19.15 - 20.2 is available +from the following URL. + +ftp://ftp.dina.kvl.dk/pub/Staff/Per.Abrahamsen/custom/custom-1.9962.tar.gz + +(Note that "new custom" bundled with XEmacs 19.15 - 20.2, and Gnus +5.4/5.5 is older than this version.) + +Before installing "new custom", you should check the following points. + + 1) If you stick to Gnus 5.2/5.3 (or any other applications which + use "old custom"), you should not install "new custom". + + 2) If you use Mule (based on Emacs 19), you must apply this patch + to "new custom". ----8<------8<------8<------8<------8<------8<------8<------8<---- --- custom-1.9962/cus-face.el~ Wed Mar 4 19:52:39 1998 @@ -284,189 +324,178 @@ For Emacs 19.34 and XEmacs 19.14 users: "old custom" vs "new custom" (let* ((frames (frame-list)) ----8<------8<------8<------8<------8<------8<------8<------8<---- - 3) Applications compiled with "custom" require the same version of - "custom" at load-time (and run-time). Therefore, if you use - "new custom", you must always include "new custom" in your - load-path. The easiest way to achieve this is "subdirs.el"; - if you installed "new custom" in "/usr/local/share/emacs/19.34/ - site-lisp/custom/", put the following line to "/usr/local/share/ - emacs/19.34/site-lisp/subdirs.el". + 3) Applications compiled with "custom" require the same version of + "custom" at load-time (and run-time). Therefore, if you use "new + custom", you must always include "new custom" in your load-path. + The easiest way to achieve this is "subdirs.el"; if you installed + "new custom" in "/usr/local/share/emacs/19.34/site-lisp/custom/", + put the following line to "/usr/local/share/emacs/19.34/site-lisp/subdirs.el". (normal-top-level-add-to-load-path '("custom")) -How to use -========== +* How to use -alist ------ +** alist -Function put-alist (ITEM VALUE ALIST) +*** Function put-alist (ITEM VALUE ALIST) - Modify ALIST to set VALUE to ITEM. If there is a pair whose car is - ITEM, replace its cdr by VALUE. If there is not such pair, create - new pair (ITEM . VALUE) and return new alist whose car is the new - pair and cdr is ALIST. +Modify ALIST to set VALUE to ITEM. If there is a pair whose car is +ITEM, replace its cdr by VALUE. If there is not such pair, create +new pair (ITEM . VALUE) and return new alist whose car is the new +pair and cdr is ALIST. -Function del-alist (ITEM ALIST) +*** Function del-alist (ITEM ALIST) - If there is a pair whose key is ITEM, delete it from ALIST. +If there is a pair whose key is ITEM, delete it from ALIST. -Function set-alist (SYMBOL ITEM VALUE) +*** Function set-alist (SYMBOL ITEM VALUE) - Modify a alist indicated by SYMBOL to set VALUE to ITEM. +Modify a alist indicated by SYMBOL to set VALUE to ITEM. Ex. (set-alist 'auto-mode-alist "\\.pln$" 'text-mode) -Function modify-alist (MODIFIER DEFAULT) +*** Function modify-alist (MODIFIER DEFAULT) - Modify alist DEFAULT into alist MODIFIER. +Modify alist DEFAULT into alist MODIFIER. -Function set-modified-alist (SYMBOL MODIFIER) +*** Function set-modified-alist (SYMBOL MODIFIER) - Modify a value of a SYMBOL into alist MODIFIER. The SYMBOL should - be alist. If it is not bound, its value regard as nil. +Modify a value of a SYMBOL into alist MODIFIER. The SYMBOL should be +alist. If it is not bound, its value regard as nil. -path-util ---------- +** path-util -Function add-path (PATH &rest OPTIONS) +*** Function add-path (PATH &rest OPTIONS) - Add PATH to `load-path' if it exists under `default-load-path' - directories and it does not exist in `load-path'. +Add PATH to `load-path' if it exists under `default-load-path' +directories and it does not exist in `load-path'. - You can use following PATH styles: +You can use following PATH styles: - load-path relative: "PATH" (it is searched from - `default-load-path') + load-path relative: "PATH" (it is searched from `default-load-path') - home directory relative: "~/PATH" "~USER/PATH" + home directory relative: "~/PATH" "~USER/PATH" - absolute path: "/FOO/BAR/BAZ" + absolute path: "/FOO/BAR/BAZ" - You can specify following OPTIONS: +You can specify following OPTIONS: - 'all-paths --- search from `load-path' instead of - `default-load-path' + 'all-paths --- search from `load-path' instead of + `default-load-path' - 'append --- add PATH to the last of `load-path' + 'append --- add PATH to the last of `load-path' -Function add-latest-path (PATTERN &optional ALL-PATHS) +*** Function add-latest-path (PATTERN &optional ALL-PATHS) - Add latest path matched by regexp PATTERN to `load-path' if it - exists under `default-load-path' directories and it does not exist - in `load-path'. +Add latest path matched by regexp PATTERN to `load-path' if it +exists under `default-load-path' directories and it does not exist +in `load-path'. - For example, if there is bbdb-1.50 and bbdb-1.51 under site-lisp, - and if bbdb-1.51 is newer than bbdb-1.50, and site-lisp is - /usr/local/share/emacs/site-lisp, +For example, if there is bbdb-1.50 and bbdb-1.51 under site-lisp, +and if bbdb-1.51 is newer than bbdb-1.50, and site-lisp is +/usr/local/share/emacs/site-lisp, - (add-latest-path "bbdb") + (add-latest-path "bbdb") - it adds "/usr/local/share/emacs/site-lisp/bbdb-1.51" to top of - `load-path'. +it adds "/usr/local/share/emacs/site-lisp/bbdb-1.51" to top of +`load-path'. - If optional argument ALL-PATHS is specified, it is searched from all - of `load-path' instead of `default-load-path'. +If optional argument ALL-PATHS is specified, it is searched from all +of `load-path' instead of `default-load-path'. -Function get-latest-path (PATTERN &optional ALL-PATHS) +*** Function get-latest-path (PATTERN &optional ALL-PATHS) - Return latest directory in default-load-path which is matched to - regexp PATTERN. If optional argument ALL-PATHS is specified, it is - searched from all of load-path instead of default-load-path. +Return latest directory in default-load-path which is matched to +regexp PATTERN. If optional argument ALL-PATHS is specified, it is +searched from all of load-path instead of default-load-path. Ex. (let ((gnus-path (get-latest-path "gnus"))) (add-path (expand-file-name "lisp" gnus-path)) (add-to-list 'Info-default-directory-list - (expand-file-name "texi" gnus-path)) - ) - -Function file-installed-p (FILE &optional PATHS) + (expand-file-name "texi" gnus-path))) - Return absolute-path of FILE if FILE exists in PATHS. If PATHS is - omitted, `load-path' is used. +*** Function file-installed-p (FILE &optional PATHS) -Function exec-installed-p (FILE &optional PATHS SUFFIXES) +Return absolute-path of FILE if FILE exists in PATHS. If PATHS is +omitted, `load-path' is used. - Return absolute-path of FILE if FILE exists in PATHS. If PATHS is - omitted, `exec-path' is used. If SUFFIXES is omitted, - `exec-suffix-list' is used. +*** Function exec-installed-p (FILE &optional PATHS SUFFIXES) -Function module-installed-p (MODULE &optional PATHS) +Return absolute-path of FILE if FILE exists in PATHS. If PATHS is +omitted, `exec-path' is used. If SUFFIXES is omitted, +`exec-suffix-list' is used. - Return non-nil if MODULE is provided or exists in PATHS. If PATHS - is omitted, `load-path' is used. +*** Function module-installed-p (MODULE &optional PATHS) -filename --------- +Return non-nil if MODULE is provided or exists in PATHS. If PATHS is +omitted, `load-path' is used. -Function replace-as-filename (string) +** filename - Return safety file-name from STRING. +*** Function replace-as-filename (string) - It refers variable `filename-filters'. It is list of functions for - file-name filter. Default filter refers following variables: +Return safety file-name from STRING. - Variable filename-limit-length +It refers variable `filename-filters'. It is list of functions for +file-name filter. Default filter refers following variables: - Limit size of file-name. +**** Variable filename-limit-length - Variable filename-replacement-alist +Limit size of file-name. - Alist list of characters vs. string as replacement. List of - characters represents characters not allowed as file-name. +**** Variable filename-replacement-alist +Alist list of characters vs. string as replacement. List of +characters represents characters not allowed as file-name. -Bug reports -=========== +* Bug reports - If you write bug-reports and/or suggestions for improvement, please - send them to the APEL Mailing List: +If you write bug-reports and/or suggestions for improvement, please +send them to the APEL Mailing List: - apel-en@m17n.org (English) - apel-ja@m17n.org (Japanese) + apel-en@m17n.org (English) + apel-ja@m17n.org (Japanese) - Via the APEL ML, you can report APEL bugs, obtain the latest release - of APEL, and discuss future enhancements to APEL. To join the APEL - ML, send an empty e-mail to +Via the APEL ML, you can report APEL bugs, obtain the latest release +of APEL, and discuss future enhancements to APEL. To join the APEL +ML, send an empty e-mail to - apel-en-ctl@m17n.org (English) - apel-ja-ctl@m17n.org (Japanese) + apel-en-ctl@m17n.org (English) + apel-ja-ctl@m17n.org (Japanese) -Anonymous FTP -============= +* Anonymous FTP - Latest release of APEL can be obtained from: +Latest release of APEL can be obtained from: - ftp://ftp.m17n.org/pub/mule/apel/ + ftp://ftp.m17n.org/pub/mule/apel/ -CVS -=== +* CVS - Development of APEL uses CVS. So latest developing version is - available at CVS. +Development of APEL uses CVS. So latest developing version is +available at CVS. -(0) cvs login (first time only) +** cvs login (first time only) - % cvs -d :pserver:anonymous@cvs.m17n.org:/cvs/root login + % cvs -d :pserver:anonymous@cvs.m17n.org:/cvs/root login - CVS password: [CR] # NULL string + CVS password: [CR] # NULL string -(1) checkout +** checkout - % cvs -d :pserver:anonymous@cvs.m17n.org:/cvs/root checkout apel + % cvs -d :pserver:anonymous@cvs.m17n.org:/cvs/root checkout apel If you would like to join CVS based development, please send mail to - cvs@cvs.m17n.org + cvs@cvs.m17n.org - with your account name and your public key for ssh. cvsroot is - :ext:cvs@cvs.m17n.org:/cvs/root. +with your account name and your public key for ssh. cvsroot is +:ext:cvs@cvs.m17n.org:/cvs/root. - If you cannot use ssh, please send UNIX /etc/passwd style crypted - password. you can commit with the cvsroot - :pserver:@cvs.m17n.org:/cvs/root. +If you cannot use ssh, please send UNIX /etc/passwd style crypted +password. you can commit with the cvsroot +:pserver:@cvs.m17n.org:/cvs/root. - We hope you will join the open development. +We hope you will join the open development. diff --git a/README.ja b/README.ja index 36a23d6..bf05894 100644 --- a/README.ja +++ b/README.ja @@ -1,286 +1,321 @@ +-*- outline -*- + [APEL の README (日本語版)] -APEL とは? -============ +* APEL とは? + +APEL は "A Portable Emacs Library." の略です。これは以下のモジュールで +構成されています: + +** poe.el + +主に最新の emacs 環境のための基礎的な関数と特殊形式/マクロの emulation +のモジュール。 + + poe-xemacs.el --- XEmacs用 + poe-18.el --- Emacs 18/Nemacs 用 + env.el --- Emacs 18 用の env.el + localhook.el --- Emacs 18 と Emacs 19.28 以前用の hook 関数群 + pym.el --- poe のための macros + +** poem.el + +移植性の高い MULE プログラムを書くための基礎的な関数を提供する。 + + poem-nemacs.el --- Nemacs 用 + poem-ltn1.el --- MULE なし Emacs 19/XEmacs 用 + poem-om.el --- MULE 1.*, 2.* 用 + poem-20.el --- Emacs 20 と XEmacs-MULE の共有モジュール + poem-e20_2.el --- Emacs 20.1/20.2 用 + poem-e20_3.el --- Emacs 20.3 用 + poem-xm.el --- XEmacs-MULE 用 + +** pces.el + +移植性の高い character encoding スキーム (coding-system) を提供する。 + + pces-20.el --- coding-system 機能を持つ Emacs 20 and XEmacs 用 + pces-e20.el --- Emacs 20 用 + pces-e20_2.el --- Emacs 20.1 and 20.2 用 + pces-nemacs.el --- Nemacs 用 + pces-om.el --- Mule 1.* and Mule 2.* 用 + pces-raw.el --- coding-system 機能を持たない emacsen 用 + pces-xfc.el --- file coding 機能を持つ XEmacs 用 + pces-xm.el --- XEmacs-mule 用 - APEL は "A Portable Emacs Library." の略です。これは以下のモジュール - で構成されています: +** invisible.el --- 不可視 region に関する機能を提供する - poe.el --- 主に最新の emacs 環境のための基礎的な関数と特殊形式/マ - クロの emulation のモジュール - poe-xemacs.el --- XEmacs用 - poe-18.el --- Emacs 18/Nemacs 用 - env.el --- Emacs 18 用の env.el - localhook.el --- Emacs 18 と Emacs 19.28 以前用の hook 関数群 + inv-18.el --- for Emacs 18 + inv-19.el --- for Emacs 19 + inv-xemacs.el --- for XEmacs - poem.el --- 移植性の高い MULE プログラムを書くための基礎的な関数を - 提供する - poem-nemacs.el --- Nemacs 用 - poem-ltn1.el --- MULE なし Emacs 19/XEmacs 用 - poem-om.el --- MULE 1.*, 2.* 用 - poem-20.el --- Emacs 20 と XEmacs-MULE の共有モジュール - poem-e20_2.el --- Emacs 20.1/20.2 用 - poem-e20_3.el --- Emacs 20.3 用 - poem-xm.el --- XEmacs-MULE 用 +** mcharset.el --- MIME charset 関連の機能を提供する - invisible.el --- 不可視 region に関する機能を提供する - inv-18.el --- for Emacs 18 - inv-19.el --- for Emacs 19 - inv-xemacs.el --- for XEmacs + mcs-nemacs.el --- Nemacs 用 + mcs-ltn1.el --- MULE Emacs 19/XEmacs 用 + mcs-om.el --- MULE 1.*, 2.* 用 + mcs-20.el --- Emacs 20 と XEmacs-MULE 用の共有モジュール + mcs-e20.el --- Emacs 20 用 + mcs-xm.el --- XEmacs-MULE 用 + mcs-xmu.el --- XEmacs-MULE 用 (ISO646 文字の単一化) - mcharset.el --- MIME charset 関連の機能を提供する - mcs-nemacs.el --- Nemacs 用 - mcs-ltn1.el --- MULE Emacs 19/XEmacs 用 - mcs-om.el --- MULE 1.*, 2.* 用 - mcs-20.el --- Emacs 20 と XEmacs-MULE 用の共有モジュール - mcs-e20.el --- Emacs 20 用 - mcs-xm.el --- XEmacs-MULE 用 - mcs-xmu.el --- XEmacs-MULE 用 (ISO646 文字の単一化) +** static.el --- 静的評価のためのユーティリティー - static.el --- 静的評価のためのユーティリティー +** broken.el --- Emacs の壊れている機能の情報を提供する - broken.el --- Emacs の壊れている機能の情報を提供する +** pccl.el --- 移植可能な CCL プログラムを書くためのユーティリティー - pccl.el --- 移植可能な CCL プログラムを書くためのユーティリティー - pccl-om.el --- MULE 2.* 用 - pccl-20.el --- Emacs 20/XEmacs-21-MULE 用 + pccl-om.el --- MULE 2.* 用 + pccl-20.el --- Emacs 20/XEmacs-21-MULE 用 - alist.el: 連想リストのためのユーティリティー +** alist.el: 連想リストのためのユーティリティー - calist.el: 状態木と状態/状況連想リスト用のユーティリティー +** calist.el: 状態木と状態/状況連想リスト用のユーティリティー - path-util.el: パス管理とファイル探索のためのユーティリティー +** path-util.el: パス管理とファイル探索のためのユーティリティー - filename.el:ファイル名を作るためのユーティリティ +** filename.el:ファイル名を作るためのユーティリティ - install.el: emacs-lisp パッケージインストールするためのユーティリ - ティー +** install.el: emacs-lisp パッケージインストールするためのユーティリティー - mule-caesar.el: ROT 13-47-48 Caesar 変換のユーティリティー +** mule-caesar.el: ROT 13-47-48 Caesar 変換のユーティリティー - emu.el --- (tm-7.106 に入っていた emu との互換性を保つためのモジュー - ル。poe, poem, mcharset を require する) +** emu.el - emu-mule: MULE 1.*, 2.* 用 +tm-7.106 に入っていた emu との互換性を保つためのモジュール。poe, poem, +mcharset を require する。 - richtext.el --- Emacs 19.29 かそれ以降 - XEmacs 19.14 かそれ以降 - のための text/richtext モジュール - tinyrich.el --- 古い emacs 環境のための text/richtext モジュー - ル + emu-mule: MULE 1.*, 2.* 用 - pcustom.el --- 移植性の高い custom 環境を提供する + richtext.el --- Emacs 19.29 かそれ以降 XEmacs 19.14 かそれ以降のた + めの text/richtext モジュール + tinyrich.el --- 古い emacs 環境のための text/richtext モジュール - tinycustom.el --- custom.el のエミュレーションを行なう +** pcustom.el --- 移植性の高い custom 環境を提供する + tinycustom.el --- custom.el のエミュレーションを行なう -インストール -============ +** time-stamp.el -(a) 展開した場所で実行 +Emacs による編集の際、最終修正時刻を保存するためのユーティリティ。 - 他のディレクトリーにインストールしたくないなら、以下のことだけをやっ - てください (MS-DOS 系の OS のために make.bat が用意されています。 - make.bat の利用については下記 (d) を参照して下さい)。: +** timezone.el - % make +タイムゾーンユーティリティ。2000 年問題対応版。Emacs 18 と GNUS 3.14.4 +でも動作可。 - emacs のコマンド名を指定することができます。例えば、 +** product.el --- プロダクトのバージョン情報のための機能を提供するモジュール。 - % make EMACS=xemacs - `EMACS=...' が省略されると、Emacs=emacs が使われます。 +* インストール -(b) make install +** 展開した場所で実行 - 他のディレクトリーにインストールしたいなら、以下のことをしてください: +他のディレクトリーにインストールしたくないなら、以下のことだけをやって +ください (MS-DOS 系の OS のために make.bat が用意されています。 +make.bat の利用については下記「make.bat を利用する (MS-DOS 系 OS の場 +合)」を参照して下さい)。: - % make install + % make - emacs のコマンド名を指定することができます。例えば、 +emacs のコマンド名を指定することができます。例えば、 - % make install EMACS=xemacs + % make EMACS=xemacs - `EMACS=...' が省略されると、Emacs=emacs が使われます。 +`EMACS=...' が省略されると、Emacs=emacs が使われます。 - Emacs Lisp プログラムとシェルスクリプトのためのディレクトリー木の接 - 頭辞 (prefix) を指定することができます。例えば、 +** make install - % make install PREFIX=~/ +他のディレクトリーにインストールしたいなら、以下のことをしてください: - `PREFIX=...' が省略されると、指定された emacs コマンドのディレクトリー - 木の接頭辞が使用されます (おそらく /usr/local です)。 + % make install - 例えば、PREFIX=/usr/local と Emacs 20.2 が指定されれば、以下のディレ - クトリー木が作成されます。 +emacs のコマンド名を指定することができます。例えば、 - /usr/local/share/emacs/20.2/site-lisp/ --- emu - /usr/local/share/emacs/site-lisp/apel/ --- APEL + % make install EMACS=xemacs - Emacs Lisp プログラムのための lisp ディレクトリーを指定することがで - きます。例えば、: +`EMACS=...' が省略されると、Emacs=emacs が使われます。 - % make install LISPDIR=~/elisp +Emacs Lisp プログラムとシェルスクリプトのためのディレクトリー木の接頭 +辞 (prefix) を指定することができます。例えば、 - emu モジュールがインストールされる、バージョン特有の lisp ディレクト - リーを指定することもできます。例えば、: + % make install PREFIX=~/ - % make install VERSION_SPECIFIC_LISPDIR=~/elisp +`PREFIX=...' が省略されると、指定された emacs コマンドのディレクトリー +木の接頭辞が使用されます (おそらく /usr/local です)。 - どのファイルが emu モジュールか apel モジュールの一部なのか、それら - がどこにインストールされるかを知りたいときは、次のようなコマンドを入 - 力することができます。 +例えば、PREFIX=/usr/local と Emacs 20.2 が指定されれば、以下のディレク +トリー木が作成されます。 - % make what-where LISPDIR=~/elisp VERSION_SPECIFIC_LISPDIR=~/elisp + /usr/local/share/emacs/20.2/site-lisp/ --- emu + /usr/local/share/emacs/site-lisp/apel/ --- APEL - ファイル APEL-CFG を編集することで他の選択自由な設定を指定することが - できます。その中のコメントを読んでください。 +Emacs Lisp プログラムのための lisp ディレクトリーを指定することができ +ます。例えば、: + + % make install LISPDIR=~/elisp + +emu モジュールがインストールされる、バージョン特有の lisp ディレクトリー +を指定することもできます。例えば、: + + % make install VERSION_SPECIFIC_LISPDIR=~/elisp + +どのファイルが emu モジュールか apel モジュールの一部なのか、それらが +どこにインストールされるかを知りたいときは、次のようなコマンドを入力す +ることができます。 + + % make what-where LISPDIR=~/elisp VERSION_SPECIFIC_LISPDIR=~/elisp + +ファイル APEL-CFG を編集することで他の選択自由な設定を指定することがで +きます。その中のコメントを読んでください。 (c) XEmacs のパッケージとしてインストールする - XEmacs のパッケージディレクトリーにインストールする場合は、以下のこ - とをしてください: +XEmacs のパッケージディレクトリーにインストールする場合は、以下のこと +をしてください: + + % make install-package - % make install-package +emacs のコマンド名を指定することができます。例えば、 - emacs のコマンド名を指定することができます。例えば、 + % make install-package XEMACS=xemacs-21 - % make install-package XEMACS=xemacs-21 +`XEMACS=...' が省略されると、XEMACS=xemacs が使用されます。 - `XEMACS=...' が省略されると、XEMACS=xemacs が使用されます。 +パッケージのディレクトリーを指定することができます。例えば: - パッケージのディレクトリーを指定することができます。例えば: + % make install PACKAGEDIR=~/.xemacs - % make install PACKAGEDIR=~/.xemacs +`PACKAGEDIR=...' が省略されると、存在するパッケージディレクトリーの最 +初のものが使われます。 - `PACKAGEDIR=...' が省略されると、存在するパッケージディレクトリーの - 最初のものが使われます。 +XEmacs のパッケージシステムは XEmacs 21.0 かそれ以降を要求することに注 +意してください。 - XEmacs のパッケージシステムは XEmacs 21.0 かそれ以降を要求することに - 注意してください。 +** make.bat を利用する (MS-DOS 系 OS の場合) -(d) make.bat を利用する (MS-DOS 系 OS の場合) +MS-DOS 系の OS のために make.bat が用意されています。make.bat を利用 +するには添付の make.bat を編集することが必要です (cygwin 環境を利用 +している方は make.exe と Makefile を利用することができます)。 - MS-DOS 系の OS のために make.bat が用意されています。make.bat を利用 - するには添付の make.bat を編集することが必要です (cygwin 環境を利用 - している方は make.exe と Makefile を利用することができます)。 +make.bat の中では `rem' が行頭にある行はコメントとして扱われます。必 +要に応じ、`rem' を挿入したり、または削除したりして下さい。 - make.bat の中では `rem' が行頭にある行はコメントとして扱われます。必 - 要に応じ、`rem' を挿入したり、または削除したりして下さい。 +make.bat でディフォルトで有効になっている設定は、 - make.bat でディフォルトで有効になっている設定は、 + set MEADOWVER=1.10 + set PREFIX=c:\usr\meadow + set EMACS=%PREFIX%\%MEADOWVER%\bin\meadow95.exe + set LISPDIR=%PREFIX%\site-lisp + set VLISPDIR=%PREFIX%\%MEADOWVER%\site-lisp - set MEADOWVER=1.10 - set PREFIX=c:\usr\meadow - set EMACS=%PREFIX%\%MEADOWVER%\bin\meadow95.exe - set LISPDIR=%PREFIX%\site-lisp - set VLISPDIR=%PREFIX%\%MEADOWVER%\site-lisp +で、meadow のバイナリが c:\usr\meadow\1.10\bin\meadow95.exe にインス +トールされていることを前提にしています。その前提に基づき、APEL のモ +ジュールのうち、meadow のバージョンに依存しないモジュールを - で、meadow のバイナリが c:\usr\meadow\1.10\bin\meadow95.exe にインス - トールされていることを前提にしています。その前提に基づき、APEL のモ - ジュールのうち、meadow のバージョンに依存しないモジュールを + c:\usr\meadow\site-lisp - c:\usr\meadow\site-lisp +に、バージョンに依存するモジュールを - に、バージョンに依存するモジュールを + c:\usr\meadow\1.10\site-lisp - c:\usr\meadow\1.10\site-lisp +にインストールしようとします。上記の例を参考に、自分の環境用の設定を書 +き込んで make.bat を動かして下さい。 - にインストールしようとします。上記の例を参考に、自分の環境用の設定を書 - き込んで make.bat を動かして下さい。 +19.3x 以前の Emacs (例えば 19.28 ベースの Mule for Windows) にはバージョ +ン依存の site-lisp ディレクトリ (上記の例で言えば +c:\usr\meadow\1.10\site-lisp) が存在せず、ディフォルトでは load-path も +通っていません。この場合は c:\usr\mule\site-lisp などのバージョン非依存 +の site-lisp ディレクトリに APEL の全てのモジュールを入れれば良いでしょ +う。 - 19.3x 以前の Emacs (例えば 19.28 ベースの Mule for Windows) にはバージョ - ン依存の site-lisp ディレクトリ (上記の例で言えば - c:\usr\meadow\1.10\site-lisp) が存在せず、ディフォルトでは load-path も - 通っていません。この場合は c:\usr\mule\site-lisp などのバージョン非依存 - の site-lisp ディレクトリに APEL の全てのモジュールを入れれば良いでしょ - う。 +Demacs の設定例を準備することができませんでした。Demacs に APEL をイン +ストールした方は、設定例を apel-ja@m17n.org に送って下さい (非購読者で +も送信はできます)。 - Demacs の設定例を準備することができませんでした。Demacs に APEL をイン - ストールした方は、設定例を apel-ja@m17n.org に送って下さい (非購読者で - も送信はできます)。 +なお、Windows ネイティブの cvs.exe (not cygwin) を利用して APEL を +checkout した場合は、cvs.exe により行末コードが正規化されて CRCRLF に +なっている可能性があります。このような場合、make.bat は動きませんので +行末コードを CRLF に修正してお使い下さい。この問題について詳しくは、 - なお、Windows ネイティブの cvs.exe (not cygwin) を利用して APEL を - checkout した場合は、cvs.exe により行末コードが正規化されて CRCRLF に - なっている可能性があります。このような場合、make.bat は動きませんので - 行末コードを CRLF に修正してお使い下さい。この問題について詳しくは、 + http://openlab.ring.gr.jp/skk/cvswin-ja.html - http://openlab.ring.gr.jp/skk/cvswin-ja.html +をご参照下さい。 - をご参照下さい。 +* load-path(Emacs と MULE の場合) -load-path(Emacs と MULE の場合) -================================ +もし Emacs もしくは Mule をお使いなら、APEL を install した場所を +load-path に追加してください。もし Emacs 19.29 以降または Emacs 20.1, +20.2 を使って初期設定でインストールしたのなら、次のように subdirs.el +を書くことができます。 - もし Emacs もしくは Mule をお使いなら、APEL を install した場所を - load-path に追加してください。もし Emacs 19.29 以降または Emacs 20.1, - 20.2 を使って初期設定でインストールしたのなら、次のように subdirs.el - を書くことができます。 +-------------------------------------------------------------------- +(normal-top-level-add-to-load-path '("apel")) +-------------------------------------------------------------------- - -------------------------------------------------------------------- - (normal-top-level-add-to-load-path '("apel")) - -------------------------------------------------------------------- +もし Emacs 20.3 以降もしくは XEmacs を使って普通にインストールするの +ならば、load-path を設定する必要はありません。 - もし Emacs 20.3 以降もしくは XEmacs を使って普通にインストールするの - ならば、load-path を設定する必要はありません。 +* Emacs のバージョンに関連した情報 -Emacs のバージョンに関連した情報 -================================ +** 「古い byte-compiler」と「新しい byte-compiler」 -「古い byte-compiler」と「新しい byte-compiler」 Emacs 18 のユーザのみなさんへ: - このパッケージではコンパイル時における条件判断をたくさん行なっていま - す。残念ながら Emacs 18 に付属している byte-compiler には、例えば - `eval-when-compile' や `eval-and-compile' の機能が無いので代用品のマ - クロを用意してありますが、これらはコンパイル時だけでなく load 時また - は実行時にも働いてしまいます! 加えて「古い byte-compiler」はトップ - レベルのマクロをコンパイルしてくれないので、APEL の多くのコードがコ - ンパイルされないままになってしまいます。 +このパッケージではコンパイル時における条件判断をたくさん行なっていま +す。残念ながら Emacs 18 に付属している byte-compiler には、例えば +`eval-when-compile' や `eval-and-compile' の機能が無いので代用品のマ +クロを用意してありますが、これらはコンパイル時だけでなく load 時また +は実行時にも働いてしまいます! 加えて「古い byte-compiler」はトップ +レベルのマクロをコンパイルしてくれないので、APEL の多くのコードがコ +ンパイルされないままになってしまいます。 + +そこで、最適化を行なう「新しい byte-compiler」を使うことをお勧めしま +す。それは Emacs 19 以降に付属している byte-compiler の元になってい +るものです。 + +最適化を行なう byte-compiler は Emacs Lisp Archive およびそれらのミ +ラーから入手することができます。 + +Mule 1.* の時代には Mule 用の「新しい byte-compiler」を含む Mule 1.* +用の "contrib" パッケージが配布されていました。しかし現在ではこのパッ +ケージを手に入れることは難しいでしょう。 - そこで、最適化を行なう「新しい byte-compiler」を使うことをお勧めしま - す。それは Emacs 19 以降に付属している byte-compiler の元になってい - るものです。 +我々の知る限りでは Emacs 18 用の「新しい byte-compiler」は SKK 9.6, +または SKK 10.62a に付属しています。SKK 10.62a は - 最適化を行なう byte-compiler は Emacs Lisp Archive およびそれらのミ - ラーから入手することができます。 + http://openlab.ring.gr.jp/skk/maintrunk - Mule 1.* の時代には Mule 用の「新しい byte-compiler」を含む Mule 1.* - 用の "contrib" パッケージが配布されていました。しかし現在ではこのパッ - ケージを手に入れることは難しいでしょう。 +から入手することができます。これらは Mule 1.* 用のパッチも含んでいます。 - 我々の知る限りでは Emacs 18 用の「新しい byte-compiler」は SKK 9.6, - または SKK 10.62a に付属しています。SKK 10.62a は - http://openlab.ring.gr.jp/skk/maintrunk - から入手することができます。これらは Mule 1.* 用のパッチも含んでいます。 +** 「古い custom」と「新しい custom」 -「古い custom」と「新しい custom」 Emacs 19.34 と XEmacs 19.14 のユーザのみなさんへ: - Emacs 19.32〜19.34、XEmacs 19.14 および Gnus 5.2/5.3 に含まれている - custom ライブラリは「古い」もので、これの API は Emacs 20.1 または - XEmacs 19.15 より新しい Emacsen と Gnus 5.4/5.5 に含まれている - 「新しい custom」とは違っています。 +Emacs 19.32〜19.34、XEmacs 19.14 および Gnus 5.2/5.3 に含まれている +custom ライブラリは「古い」もので、これの API は Emacs 20.1 または +XEmacs 19.15 より新しい Emacsen と Gnus 5.4/5.5 に含まれている +「新しい custom」とは違っています。 - Emacs 19.34 と XEmacs 19.15〜20.2 用の「新しい custom」は、以下の - URL から手に入れることができます。 +Emacs 19.34 と XEmacs 19.15〜20.2 用の「新しい custom」は、以下の +URL から手に入れることができます。 - ftp://ftp.dina.kvl.dk/pub/Staff/Per.Abrahamsen/custom/custom-1.9962.tar.gz +ftp://ftp.dina.kvl.dk/pub/Staff/Per.Abrahamsen/custom/custom-1.9962.tar.gz - (注: XEmacs 19.15〜20.2 と Gnus 5.4/5.5 に含まれている「新しい - custom」はこの版より古いものです。) +(注: XEmacs 19.15〜20.2 と Gnus 5.4/5.5 に含まれている「新しい custom」 +はこの版より古いものです。) - 「新しい custom」をインストールする前に、次の各項目をチェックして下 - さい。 +「新しい custom」をインストールする前に、次の各項目をチェックして下 +さい。 - 1) もしあなたが Gnus 5.2/5.3 (または他の「古い custom」を使うアプ - リケーション) を使うことに固執しているのならば「新しい custom」 - をインストールしてはいけません。 + 1) もしあなたが Gnus 5.2/5.3 (または他の「古い custom」を使うアプ + リケーション) を使うことに固執しているのならば「新しい custom」 + をインストールしてはいけません。 - 2) Emacs 19 を元にした Mule を使うのならば、このパッチを「新しい - custom」に当てる必要があります。 + 2) Emacs 19 を元にした Mule を使うのならば、このパッチを「新しい + custom」に当てる必要があります。 ----8<------8<------8<------8<------8<------8<------8<------8<---- --- custom-1.9962/cus-face.el~ Wed Mar 4 19:52:39 1998 @@ -296,199 +331,191 @@ Emacs 19.34 と XEmacs 19.14 のユーザのみなさんへ: (let* ((frames (frame-list)) ----8<------8<------8<------8<------8<------8<------8<------8<---- - 3) custom を使うコンパイルされたアプリケーションは、それを load す - るときや実行するときに同じバージョンの custom を必要とします。 - したがって、いつも load-path に「新しい custom」を含めておかな - ければなりません。 - これを行なうためのもっとも簡単な方法は subdirs.el を使うことで - す。 - 「新しい custom」が /usr/local/share/emacs/19.34/site-lisp/custom/ - にインストールされているのならば、 - /usr/local/share/emacs/19.34/site-lisp/subdirs.el というファイ - ルに以下の行を書き込んで下さい。 + 3) custom を使うコンパイルされたアプリケーションは、それを load す + るときや実行するときに同じバージョンの custom を必要とします。 + したがって、いつも load-path に「新しい custom」を含めておかな + ければなりません。 + これを行なうためのもっとも簡単な方法は subdirs.el を使うことで + す。 + 「新しい custom」が /usr/local/share/emacs/19.34/site-lisp/custom/ + にインストールされているのならば、 + /usr/local/share/emacs/19.34/site-lisp/subdirs.el というファイ + ルに以下の行を書き込んで下さい。 - (normal-top-level-add-to-load-path '("custom")) + (normal-top-level-add-to-load-path '("custom")) -使い方 -====== +* 使い方 -alist ------ +** alist -関数 put-alist (ITEM VALUE ALIST) +*** 関数 put-alist (ITEM VALUE ALIST) - ALIST を ITEM の値が VALUE になるように修正します。car が ITEM であ - る対が存在すれば、その cdr を VALUE で置き換えます。そのような対がな - ければ、新しい対 (ITEM . VALUE) を作り、car が新しい対で、cdr が - ALIST である新しい連想リストを返します。 +ALIST を ITEM の値が VALUE になるように修正します。car が ITEM であ +る対が存在すれば、その cdr を VALUE で置き換えます。そのような対がな +ければ、新しい対 (ITEM . VALUE) を作り、car が新しい対で、cdr が +ALIST である新しい連想リストを返します。 -関数 del-alist (ITEM ALIST) +*** 関数 del-alist (ITEM ALIST) - 連想リスト ALIST に key が ITEM である対があれば、それを ALIST から取 - り除きます。 +連想リスト ALIST に key が ITEM である対があれば、それを ALIST から取 +り除きます。 -関数 set-alist (SYMBOL ITEM VALUE) +*** 関数 set-alist (SYMBOL ITEM VALUE) - SYMBOL で指定されている連想リストを、ITEM の値が VALUE であるように - 修正します。 +SYMBOL で指定されている連想リストを、ITEM の値が VALUE であるように修 +正します。 例. (set-alist 'auto-mode-alist "\\.pln$" 'text-mode) -関数 modify-alist (MODIFIER DEFAULT) +*** 関数 modify-alist (MODIFIER DEFAULT) - 連想リスト DEFAULT を連想リスト MODIFIER に修正します。 +連想リスト DEFAULT を連想リスト MODIFIER に修正します。 -関数 set-modified-alist (SYMBOL MODIFIER) +*** 関数 set-modified-alist (SYMBOL MODIFIER) - SYMBOL の値を連想リスト MODIFIER に修正します。SYMBOL は連想リストで - ある必要があります。それが束縛されていなければ、その値を nil とみな - します。 +SYMBOL の値を連想リスト MODIFIER に修正します。SYMBOL は連想リストであ +る必要があります。それが束縛されていなければ、その値を nil とみなしま +す。 -path-util ---------- +** path-util -関数 add-path (PATH &rest OPTIONS) +*** 関数 add-path (PATH &rest OPTIONS) - PATH が `default-load-path' のディレクトリーの下に存在して、 - `load-path'に存在しないときに、それを `load-path' に追加します。 +PATH が `default-load-path' のディレクトリーの下に存在して、 +`load-path'に存在しないときに、それを `load-path' に追加します。 - 次のような PATH の様式を使うことができます: +次のような PATH の様式を使うことができます: - load-path からの相対: "PATH" (それは `default-load-path から探 - されます。) + load-path からの相対: "PATH" (それは `default-load-path から探されま + す。) - ホームディレクトリーからの相対: "~/PATH" "~USER/PATH" + ホームディレクトリーからの相対: "~/PATH" "~USER/PATH" - 絶対パス: "/FOO/BAR/BAZ" + 絶対パス: "/FOO/BAR/BAZ" - 次のような OPTIONS を指定することができます: +次のような OPTIONS を指定することができます: - 'all-paths --- `default-load-path の代わり `load-path' から探しま + 'all-paths --- `default-load-path の代わり `load-path' から探しま す。 - 'append --- PATH を `load-path' の最後に追加します。 + 'append --- PATH を `load-path' の最後に追加します。 -関数 add-latest-path (PATTERN &optional ALL-PATHS) +*** 関数 add-latest-path (PATTERN &optional ALL-PATHS) - 正規表現 PATTERN に合致した最新のパスが `default-load-path' の下に存 - 在していて、`load-path' の下に存在していないときにそれを `load-path' - に追加します。 +正規表現 PATTERN に合致した最新のパスが `default-load-path' の下に存在 +していて、`load-path' の下に存在していないときにそれを `load-path' に +追加します。 - 例えば、bbdb-1.50 と bbdb-1.51 が site-lisp の下にあって、bbdb-1.51 - が bbdb-1.50 よりも新しく、site-lisp が - /usr/local/share/emacs/site-lisp であるときは、 +例えば、bbdb-1.50 と bbdb-1.51 が site-lisp の下にあって、bbdb-1.51 が +bbdb-1.50 よりも新しく、site-lisp が /usr/local/share/emacs/site-lisp +であるときは、 - (add-latest-path "bbdb") + (add-latest-path "bbdb") - は "/usr/local/share/emacs/site-lisp/bbdb-1.51" を `load-path' の先 - 頭に追加します。 +は "/usr/local/share/emacs/site-lisp/bbdb-1.51" を `load-path' の先頭 +に追加します。 - 省略可能な引数 ALL-PATHS が指定されると、`default-load-path' のかわ - りに `load-path' から探します。 +省略可能な引数 ALL-PATHS が指定されると、`default-load-path' のかわり +に `load-path' から探します。 -関数 get-latest-path (PATTERN &optional ALL-PATHS) +*** 関数 get-latest-path (PATTERN &optional ALL-PATHS) - 正規表現 PATTERN に合致する default-load-path にある最新のディレクト - リーを返します。省略可能な引数 ALL-PATHS が指定されると、 - default-load-path の代わりに load-path の全てから探します。 +正規表現 PATTERN に合致する default-load-path にある最新のディレクトリー +を返します。省略可能な引数 ALL-PATHS が指定されると、default-load-path +の代わりに load-path の全てから探します。 例. (let ((gnus-path (get-latest-path "gnus"))) (add-path (expand-file-name "lisp" gnus-path)) (add-to-list 'Info-default-directory-list - (expand-file-name "texi" gnus-path)) - ) + (expand-file-name "texi" gnus-path))) -関数 file-installed-p (FILE &optional PATHS) +*** 関数 file-installed-p (FILE &optional PATHS) - FILE が PATHS に存在した場合、FILE の絶対パスを返します。PATHS が省 - 略されると、`load-path' が使われます。 +FILE が PATHS に存在した場合、FILE の絶対パスを返します。PATHS が省略 +されると、`load-path' が使われます。 -関数 exec-installed-p (FILE &optional PATHS SUFFIXES) +*** 関数 exec-installed-p (FILE &optional PATHS SUFFIXES) - FILE が PATHS に存在した場合に FILE の絶対パスを返します。PATHS が省 - 略されると、`exec-path' が使われます。SUFFIXES が省略されると、 - `exec-suffix-list' が使われます。 +FILE が PATHS に存在した場合に FILE の絶対パスを返します。PATHS が省略 +されると、`exec-path' が使われます。SUFFIXES が省略されると、 +`exec-suffix-list' が使われます。 -関数 module-installed-p (MODULE &optional PATHS) +*** 関数 module-installed-p (MODULE &optional PATHS) - MODULE が提供されている (provided) か、PATHS に存在する場合に nil で - ない値を返します。PATHS が省略されると、`load-path' が使われます。 +MODULE が提供されている (provided) か、PATHS に存在する場合に nil で +ない値を返します。PATHS が省略されると、`load-path' が使われます。 -filename --------- +** filename -関数 replace-as-filename (string) +*** 関数 replace-as-filename (string) - STRING から安全なファイル名を返します。 +STRING から安全なファイル名を返します。 - それは変数 'filename-fileters' を参照します。その変数はファイル名の - 選別器のための関数のリストです。初期設定の選別器は以下の変数を参照し - ています。 +それは変数 'filename-fileters' を参照します。その変数はファイル名の選 +別器のための関数のリストです。初期設定の選別器は以下の変数を参照してい +ます。 - 変数 filename-limit-length +**** 変数 filename-limit-length - ファイル名の長さの制限。 +ファイル名の長さの制限。 - 変数 filename-replacement-alist +**** 変数 filename-replacement-alist - 文字と文字列が対になったリストの連想リストです。文字のリスト - はファイル名として許されない文字を現わします。 +文字と文字列が対になったリストの連想リストです。文字のリストはファイル +名として許されない文字を現わします。 -バグ報告 -=========== +* バグ報告 - バグ報告や改善の提案を書いたときは、是非 APEL メーリングリストに送っ - てください: +バグ報告や改善の提案を書いたときは、是非 APEL メーリングリストに送って +ください: - apel-en@m17n.org (英語) - apel-ja@m17n.org (日本語) + apel-en@m17n.org (英語) + apel-ja@m17n.org (日本語) - APEL ML を通して、APEL のバグを報告したり、APEL の最新のリリースを取 - 得したり、APEL の将来の拡張の議論をしたりすることができます。APEL ML - に参加するには、空の電子メールを +APEL ML を通して、APEL のバグを報告したり、APEL の最新のリリースを取得 +したり、APEL の将来の拡張の議論をしたりすることができます。APEL ML に +参加するには、空の電子メールを - apel-en-ctl@m17n.org (英語) - apel-ja-ctl@m17n.org (日本語) + apel-en-ctl@m17n.org (英語) + apel-ja-ctl@m17n.org (日本語) - に送ってください。 +に送ってください。 -Anonymous FTP -============= +* Anonymous FTP - 最新の APEL のリリースは以下の場所から取得できます: +最新の APEL のリリースは以下の場所から取得できます: ftp://ftp.m17n.org/pub/mule/apel/ -CVS -=== +* CVS - APEL の開発は CVS を使っています。最新の開発バージョンを CVS で - 取得できます。 +APEL の開発は CVS を使っています。最新の開発バージョンを CVS で取得で +きます。 -(0) cvs login (一回目だけ) +** cvs login (一回目だけ) - % cvs -d :pserver:anonymous@cvs.m17n.org:/cvs/root login + % cvs -d :pserver:anonymous@cvs.m17n.org:/cvs/root login - CVS password: [CR] # 空文字列 + CVS password: [CR] # 空文字列 -(1) checkout +** checkout - % cvs -d :pserver:anonymous@cvs.m17n.org:/cvs/root checkout apel + % cvs -d :pserver:anonymous@cvs.m17n.org:/cvs/root checkout apel - CVS に基づいた開発に参加したいときは、 +CVS に基づいた開発に参加したいときは、 - cvs@cvs.m17n.org + cvs@cvs.m17n.org - にアカウント名と、ssh の公開鍵を送ってください。ssh 経由では、 - cvsroot は :ext:cvs@cvs.m17n.org:/cvs/root となります。 +にアカウント名と、ssh の公開鍵を送ってください。ssh 経由では、cvsroot +は :ext:cvs@cvs.m17n.org:/cvs/root となります。 - どうしても ssh が使えない場合、pserver 経由でも開発に参加できます。 - この場合、UNIX の /etc/passwd 様式で暗号化されたパスワードを送って下 - さい。この場合 cvsroot は :pserver:<アカウント名>@cvs.m17n.org:/cvs/root - となります。 +どうしても ssh が使えない場合、pserver 経由でも開発に参加できます。こ +の場合、UNIX の /etc/passwd 様式で暗号化されたパスワードを送って下さい。 +この場合 cvsroot は :pserver:<アカウント名>@cvs.m17n.org:/cvs/root と +なります。 - 開かれた開発に参加してくださることを期待します。 +開かれた開発に参加してくださることを期待します。