From e563a4b8dadbef673eb2115492c0f6f59c075d5c Mon Sep 17 00:00:00 2001 From: ueno Date: Tue, 12 Sep 2000 12:38:21 +0000 Subject: [PATCH] Rewrite with DocBook XML 4.1.2. * liece.xml: New file. * liece-ja.texi: Remove. * sample.dot.liece.in: Remove. * .cvsignore: Add `texi_xml' and `xslt'. --- doc/.cvsignore | 3 + doc/Makefile.am | 40 +-- doc/liece-ja.texi | 719 ----------------------------------------------- doc/liece.xml | 197 +++++++++++++ doc/sample.dot.liece.in | 97 ------- 5 files changed, 213 insertions(+), 843 deletions(-) delete mode 100644 doc/liece-ja.texi create mode 100644 doc/liece.xml delete mode 100644 doc/sample.dot.liece.in diff --git a/doc/.cvsignore b/doc/.cvsignore index 3dda729..b1c24a0 100644 --- a/doc/.cvsignore +++ b/doc/.cvsignore @@ -1,2 +1,5 @@ Makefile.in Makefile +liece.info +xslt +texi_xml diff --git a/doc/Makefile.am b/doc/Makefile.am index b01a4b6..cabf449 100644 --- a/doc/Makefile.am +++ b/doc/Makefile.am @@ -1,33 +1,19 @@ -info_TEXINFOS = liece-ja.texi -EXTRA_DIST = sample.dot.liece.in +TEXI_XML = ./texi_xml +EXTRA_DIST = liece.xml liece.info +DISTCLEANFILES = liece.info CLEANFILES = *~ -DISTCLEANFILES = sample.dot.liece liece-ja.info -if USE_PACKAGE -icondir = $(packagedir)/etc/$(PACKAGE)/icons -catalogdir = $(packagedir)/etc/$(PACKAGE)/po -styledir = $(packagedir)/etc/$(PACKAGE)/styles -infodir = $(packagedir)/info -else -icondir = $(pkgdatadir)/icons -catalogdir = $(pkgdatadir)/po -styledir = $(pkgdatadir)/styles -infodir = $(prefix)/info -endif +SUFFIXES = .xml .txml .texi .info -SUFFIXES = .texi .info +DOCBOOK2TEXIXSLT_DIR = xslt/texi +SAXON = java -classpath $(CLASSPATH):$(DOCBOOK2TEXIXSLT_DIR) com.icl.saxon.StyleSheet -all: liece-ja.info sample.dot.liece +all: liece.info -.texi.info: - $(EMACS) -batch -q -no-site-file \ - -l $(top_srcdir)/lisp/liece-make.el \ - -f make-liece-info-files $< - -sample.dot.liece: sample.dot.liece.in - @$(INSTALL_DATA) sample.dot.liece.in sample.dot.liece - @$(EMACS) -batch -q -no-site-file \ - -l $(top_srcdir)/lisp/liece-make.el \ - -f make-liece-sample-files \ - $@ $(bindir)/dcc $(icondir) $(catalogdir) $(styledir) +%.txml: %.xml + $(SAXON) -o $@ $*.xml $(DOCBOOK2TEXIXSLT_DIR)/docbook.xsl +%.texi: %.txml + $(TEXI_XML) $*.txml + -recode -df utf8..texi < $@ > tmp + mv tmp $@ diff --git a/doc/liece-ja.texi b/doc/liece-ja.texi deleted file mode 100644 index 228cdb4..0000000 --- a/doc/liece-ja.texi +++ /dev/null @@ -1,719 +0,0 @@ -\input texinfo @c -*-texinfo -*- coding: iso-2022-jp -*- -@setfilename liece-ja.info -@settitle Liece -- IRC Client On Emacsen -@synindex pg cp -@finalout - -@direntry -* Liece-ja: (liece-ja). IRC Client On Emacsen -@end direntry - -@titlepage -@title Liece 説明書 -@author 上野 乃毅 -@subtitle 2000/04/04 -@end titlepage - -@ifinfo -@node Top, Overview, (dir), (dir) -@top Liece 説明書 - -@ifinfo -この文書では Liece バージョン 1.4 について解説します。 -Liece に関する主要な情報は Liece の公式ホームページ -(http://www.unixuser.org/~ueno/liece/) -に反映されることでしょう。 -@end ifinfo - -@menu -* Overview:: はじめに -* Working environments:: 動作環境 -* Getting source:: 入手方法 -* Installation:: 導入方法 -* Using Liece:: 使用方法 -* Customization:: カスタマイズ -* Appendix:: 付録 -* Concept Index:: 概念索引 -* Function Index:: 関数索引 -* Variable Index:: 変数索引 -@end menu - -@node Overview, Working environments, Top, Top -@chapter はじめに - -Liece は GNU Emacs 上で動作する IRC (Internet Relay Chat, RFC 1459)のク -ライアント実装です。@refill - -Liece の主な特徴は以下の通りです。 - -@itemize @bullet -@item -CHOCOA 1.0 に似た操作感 -@item -各 Emacs 毎に最適化された軽快な動作 -@item -強力なユーザ補助 -@item -簡単な設定と、豊富な API -@item -クライアント - クライアント間の暗号化機能 -@item -動的に変更可能な、スタイルベースのウィンドウ構成機能 -@item -動的に変更された設定の自動保存機能 -@item -自動的に話者の動向を調査する擬似アウェアネス機能 -@item -URL の自動収集機能 -@end itemize - - -@node Working environments, Getting source, Overview, Top -@chapter 動作環境 - -現在のバージョン(1.4)の動作が確認されている環境は以下の通りです。 - -@itemize @bullet -@item -Standard Emacs 20.6 :-) -@item -XEmacs 21.2 (beta32) -@item -Mule 2.3 (based on Emacs 19.34) with new custom package -@end itemize - - -@node Getting source, Installation, Working environments, Top -@chapter 入手方法 - -Liece の開発には CVS (Concurrent Versions System) が用いられています。 -しばしば大規模な変更がなされた場合にのみ、リリースの配布が行われます。 -配布は HTTP により取得することができます。 - -@section リリースの入手方法 - -@itemize @bullet -@item -http://www.unixuser.org/~ueno/liece/liece-VERSION.tar.gz -@end itemize - -@section CVS でのファイルの入手方法 - -@subsection 匿名 CVS サーバへのログイン - -@example -% cvs -d :pserver:anonymous@@cvs.m17n.org:/cvs/root login - -CVS password: [CR] # NULL string -@end example - -@subsection モジュールの checkout - -@example -% cvs -d :pserver:anonymousl@@cvs.m17n.org:/cvs/root checkout liece -@end example - -@node Installation, Using Liece, Getting source, Top -@chapter 導入方法 - -@menu -* Prerequirements:: 準備 -* Compilation:: コンパイル -* Setting .emacs:: .emacs の設定 -* Setting .liece:: .liece/init.el の設定 -@end menu - -@node Prerequirements, Compilation, Installation, Installation -@section 準備 - -@noindent -Liece のインストールには以下の配布が別途必要になります。 - -@table @samp -@item APEL (A Portable Emacs Library) -ftp://ftp.m17n.org/pub/mule/apel/ - -@item custom -http://www.dina.kvl.dk/~abraham/custom/ - -@end table - -custom は、最近の Emacs の配布に含まれています。 -APEL に関しては、最新のバージョンのご利用をお勧めします。 -(リリースの配布には、その時点で対応する最新の APEL が含まれています。) - -@node Compilation, Setting .emacs, Prerequirements, Installation -@section コンパイル - -コンパイルの手順を簡単に説明します。 -詳しくは同梱の @file{INSTALL} を参照してください。 - -@example -% ./configure -% make -% su -Password: ultrasecret -# make install -@end example - - -XEmacs の package としてインストールするには、以下のようにします。 - -@example -% ./configure --enable-package --with-emacs=xemacs -% make -% su -Password: -# make install -@end example - -@noindent -@strong{[コンパイル時の警告について]} -@quotation -コンパイル時に `... not found' や `BROKEN FACILITY DETECTED:' -などの警告が表示される場合がありますが、特に問題はありません。 -@end quotation - -@node Setting .emacs, Setting .liece, Compilation, Installation -@section .emacs の設定 - -(XEmacs の package としてインストールした場合には、 -何も記述する必要はありません。この節は読み飛ばして下さい。) - -Emacs もしくは Mule をお使いなら、APEL 及び Liece を -install した場所を subdirs.el に以下のように指定して下さい。 -@lisp -(normal-top-level-add-to-load-path '("apel" "liece")) -@end lisp - -Emacs 20.3 以降の Emacs、もしくは XEmacs をお使いなら、 -@lisp -(normal-top-level-add-subdirs-to-load-path) -@end lisp - -と書くだけで良いでしょう。 - -Emacs 19 以前のバージョンの Emacs で使用する場合には、 -より直接的なパスの指定が必要になります。 - -最後に、以下の一行を加えて下さい。 -@lisp -(autoload 'liece "liece" nil t) -@end lisp - - -@node Setting .liece, , Setting .emacs, Installation -@section ~/.liece の設定 - -配布中の @file{doc} ディレクトリから -@file{sample.dot.liece} を @file{~/.liece/init.el} -としてコピーして編集します。 - -各種設定の解説はサンプルファイルのコメントを参照してください。 -ほとんどの設定項目は、@kbd{M-x customize} により設定することもできます。 - -コマンドラインオプションにより複数の設定ファイルを使い分けるには、 -以下のようにします。 - -@example -% emacs -f liece ~/.liece.local -@end example - -@node Using Liece, Customization, Installation, Top -@chapter 使用方法 - -既に CHOCOA や liece をお使いになられたことのある方は、 -大体の操作はお分かりだと思います。 - -操作は少しずつ異なりますが、irchat の使い方 -@samp{http://irc.kyoto-u.ac.jp/irchat.html} が参考になるかも知れません。 - -@section 起動と接続 - -Emacs を立ち上げたら、@kbd{M-x liece} とタイプして Liece を起動します。 - -接続先のサーバ、自分のニックネーム、自己紹介などの接続に必要な情報が -@file{.liece}に設定されていなければ、最初にいくつかの質問をされます。 - -@defvar liece-server -接続先サーバ (文字列または plist) Connection types (@ref{Connection types}) -@end defvar - -@defvar liece-service -ディフォルトのポート番号(整数値)またはサービス名(文字列)通常は -@var{liece-server} の設定により上書きされる -@end defvar - -@defvar liece-nickname -ニックネーム(文字列) -@end defvar - -@defvar liece-name -WHOIS で表示されるユーザ名(文字列) (例: "Daiki Ueno") -@end defvar - -@defvar liece-connection-timeout -接続時のタイムアウト。単位は秒。 -@end defvar - -@menu -* Friends:: 挙動を監視する -* Window styles:: ウィンドウスタイル -* Commands:: コマンドの利用方法 -@end menu - -@node Friends, Window styles, Using Liece, Using Liece -@section 挙動を監視する - -ある特定のユーザについてその挙動を監視することができます。@refill - -@table @kbd -@item @key{C-c C-i a (@code{liece-command-activate-friends})} -監視機能を有効にし、同時に対象ユーザ一覧への登録を行う - -@item @key{C-c C-i d (@code{liece-command-deactivate-friends})} -監視機能を無効化する - -@item @key{C-c C-i s (@code{liece-command-display-friends})} -現在の不在状況を表示 - -@end table - -@node Window styles, Commands, Friends, Using Liece -@section ウィンドウスタイル - -Liece ではウィンドウの分割をウィンドウスタイルと呼ばれる機構により柔軟に -カスタマイズできます。@refill - -ウィンドウスタイル自体は -@lisp -liece-window-style-directory -@end lisp - -で指定されるディレクトリ内に含まれるファイルであり、その中身は概ね emacs -lisp で書かれています。@refill - -指定する際には、上述のディレクトリに含まれるファイル名として指定する事に -なります。@refill - -@lisp -(setq liece-window-default-style "middle") -@end lisp - @refill - -@menu -* Writing window styles:: ウィンドウスタイルの記述 -@end menu - -@node Writing window styles, , Window styles, Window styles -@subsection ウィンドウスタイルの記述 - -好みのウィンドウスタイルを作成するには、もとになる適当なウィンドウスタイ -ルを決め、別のファイル名にコピーすることから始めると良いでしょう。(例: -"mystyle")@refill - -このファイルは elisp のマクロを含む構文で書きます。 -マクロ -@lisp -liece-window-add-style -@end lisp - -は新規に状態付きバッファ分割を定義します。@refill - -標準で定義されている状態変数は、以下の 4つです。 -@table @samp -@item command-buffer-mode -チャンネル/プライベート - -@item channel-buffer-mode -チャンネルバッファの表示/非表示 - -@item nick-buffer-mode -ニック一覧バッファの表示/非表示 - -@item channel-list-buffer-mode -チャンネル一覧バッファの表示/非表示 - -@end table - -状態指定の例として以下の設定を示します。 -@lisp -(command-buffer-mode . any) -(channel-buffer-mode . t) -(nick-buffer-mode . t) -(channel-list-buffer-mode . nil) -@end lisp - -この例では、以下の状態でのウィンドウ構成を定義することを -示します。 -@itemize @bullet -@item -プライベートモードの状態は問わず、 -@item -チャンネルバッファを使用し、 -@item -ニック一覧バッファを使用し、 -@item -チャンネル一覧バッファを使用しない -@end itemize - -@menu -* Reconfiguration predicates:: ウィンドウ再編成述語 -* Window configuration:: ウィンドウ構成 -@end menu - -@node Reconfiguration predicates, Window configuration, Writing window styles, Writing window styles -@subsubsection ウィンドウ再編成述語 - -ウィンドウ構成を再計算した結果が現在のウィンドウ構成と全く同じ場合、ウィ -ンドウの再分割には軽視できないコストがかかります。@refill - -そこで、ウィンドウの再編成が必要であるかを調べるガードを -状態変数と同列に指定することができます。 -@lisp -(reconfiguration-predicate . func) -@end lisp - -この例で指定された @code{func}は 0引数の関数であり、 -@code{liece-window-define-reconfiguration-predicate}により定義がなされ -ます。この定義はスタイルファイルに直接書く事ができます。@refill - -@node Window configuration, , Reconfiguration predicates, Writing window styles -@subsubsection ウィンドウ構成 - -例として一番単純な分割 -(ダイアログバッファとコマンドバッファのみ) の -記述を示します。 -@lisp -(configuration (vertical 1.0 (dialogue 1.0) (command 3 point))) -@end lisp - -この例では以下のウィンドウ構成を定義したことになります。 -@enumerate -@item -ウィンドウ全体を垂直に(vertical)2つに分割し、 -@item -ダイアログバッファを上方に作成し、 -command バッファを取り去った残りのサイズを割当てる。 -@item -その下に、3行(実際には2行)のコマンドバッファを用意 -し、最終的にカーソルをそのバッファに移動する(point)。 -@end enumerate - -このウィンドウスタイルを選択すると、 -画面上では以下の構成になります。 -@example -+----------------+ -| | -| ダイアログ | -| | -+----------------+ -| コマンド(3行) | ← カーソル -+----------------+ -@end example - -サイズの指定は以下の3種類で可能です。 -@itemize @bullet -@item -割合 (例: 0.25) -@item -行(桁)数 (例: 3) -@item -変数の参照 (例: liece-command-buffer-rows) -@end itemize - - -便利な数字 1.0 を必ず一度は 使用しなくてはなりません。サイズに 1.0 を指 -定した場合、残りの領域を割り当てる事を意味します。@refill - -以下に BNF によるバッファ分割の文法を載せます。 -@example -split = horizontal | vertical | buffer | form -horizontal = "(horizontal " size *split ")" -vertical = "(vertical " size *split ")" -buffer = "(" buffer-name " " size *[ "point" ] ")" -size = number -buffer-name = command | channel | channel-list | nick ... -@end example - -@node Commands, , Window styles, Using Liece -@section コマンドの利用方法 - -@menu -* Dialogue mode:: ダイアログモード -* Internal naming spaces:: 内部で使われる命名規則 -* Private conversation:: プライベートモード -@end menu - -@node Dialogue mode, Internal naming spaces, Commands, Commands -@subsection ダイアログモード - -ダイアログモードとは、チャンネルでの会話が表示される -バッファ(@code{liece-dialogue-buffer}) -での主モードです。 -Liece は多くの Emacs 上で動作する IRC クライアントと同様に - -@node Internal naming spaces, Private conversation, Dialogue mode, Commands -@subsection 内部で使われる命名規則 - -Liece の挙動を各コマンドに関連付ける前に、内部で用いられる名前空間を簡単 -に解説します。@refill - -チャンネル名の表現にはデータ型としての内部表現とIRC の世界で実際にやりと -りされる外部表現の2つがあります。これらは(現在は)、どちらも文字列表現で -あり、利用者はコマンドの発行を通じて双方にアクセスすることができます。 -@refill - -liece では出会う名前全てを一つの大きな連想リスト -(@code{liece-nick-alist})に保存しています。この方法は非常に効率が悪く、 -補完入力の候補を表示する以外の役割には利用できません。@refill - -これに対し、Liece では複数の小さなハッシュ表を用意しています。@refill - -チャンネルの内部表現は Liece の内部で用いられるハッシュ表のキーでもあり、 -特定のチャンネルに関する情報はシンボルのプロパティとして保存または更新さ -れます。@refill - -@node Private conversation, , Internal naming spaces, Commands -@subsection プライベートモード - -Liece では、チャンネルごとの会話相手と、プライベートモードでの対話相手を -別々の名前空間で管理しています。この方針には反対意見もあり、その一つには -ショートカットにより対話相手を切り替える際に多くのストロークを要すること -が挙げられます。@refill - -しかし、多数のチャンネルに参加している場合に特定のチャンネルへの切り替え -の方がプライベートモードでの対話相手の切り替えより頻繁に生じるというのは -経験的に明らかです。@refill - -また、これらを一元管理した場合に、プライベートモードとチャンネルでの発言 -のミスが起こりやすい点も考慮に入れました。(裏で安全に悪口が言えます。 -^_^;;)@refill - -実際に、IRC以外の実時間会議系ではこれらの名前空間を明示的に分割している -場合が多く、これらとの連携を考えた場合に都合が良いというのもあります。 -@refill - -@menu -* Operations in private conversation:: プライベートモードでの対話の方法 -@end menu - -@node Operations in private conversation, , Private conversation, Private conversation -@subsubsection プライベートモードでの対話の方法 - -プライベートモードに切り換えるには@kbd{C-c P} -(@code{liece-command-toggle-private})をタイプします。事前に対話相手が決 -定しているのであれば@kbd{C-c j} (@code{liece-command-join})で相手を指定 -するだけでも構いません。@refill - -一時的にプライベートモードから通常の会話に戻るには、もう一度 @kbd{C-c P} -とタイプします。@refill - -プライベートモードでの操作はは、チャンネル内での会話とほぼ同様です。 - -@kbd{C-c 数字} (@code{liece-switch-to-channel-no-数字}) - -@defvar liece-default-partner-binding - -対話相手を特定の番号に割当てる -@end defvar - - -@node Customization, Appendix, Using Liece, Top -@chapter カスタマイズ - - -@menu -* Connection types:: 接続方法の指定 -* Timers:: タイマ変数 -* Programming hooks:: -@end menu - -@node Connection types, Timers, Customization, Customization -@section 接続方法の指定 - - -Liece では複数の接続方法をサポートしています。 -"サーバ名:ポート番号:パスワード" といった文字列表現の他に、 -plist を用いた、より詳細な接続パラメタを指定することができます。 -@var{liece-server} に指定できるキーは以下の通りです。 - -@table @samp -@item :host -接続先ホスト名(文字列) - -@item :service -サービスエントリ(整数または文字列) - -@item :password -パスワード(文字列) - -@item :type -接続方法 (network, program, ssl, rlogin のいずれか) - -@item :prescript -接続前処理コマンド (関数または shell command 文字列) - -@item :relay -中継ホスト名 (文字列) - -@end table - - -@menu -* Connect via external program:: 外部プログラムを介した接続 -* Connect via SSL:: SSL を介した接続 -* Connect via rlogin:: rlogin を介した接続 -@end menu - -@node Connect via external program, Connect via SSL, Connection types, Connection types -@subsection 外部プログラムを介した接続 - -IPv6 経由の接続を行いたい、socks 越しに接続したい -などの何らかの理由で Emacs のネットワーク機能を利用したくない場合、 -Liece では外部プログラムによる接続が可能です。 - -この方法で接続を行うためには、外部プログラムとして Liece の配布に附属する -"tcp" が必要となります。 - -@code{liece-server} の :type パラメタに program を指定するか、 -もしくは以下の変数を設定することにより、この方法が用いられます。 - -@defvar liece-tcp-default-connection-type - -ディフォルトの接続方法を指定する -@end defvar - - -@defvar liece-tcp-program-name - -外部プログラムを明示的に指定する -@end defvar - - -@node Connect via SSL, Connect via rlogin, Connect via external program, Connection types -@subsection SSL を介した接続 - - -SSLeay または OpenSSL に附属する s_client を利用して接続を行う方法も用 -意されています。 - -この方法で接続を行うためには、外部ライブラリとして Emacs/W3 に附属する -ssl.el が必要になります。 - -@defvar liece-tcp-ssl-protocol-version - -SSL プロトコルのバージョンを指定します。liece-tcp-ssl-protocol-version -が "2" でないならば、最初に SSL プロトコルのバージョン 3 で接続を試み、 -失敗した場合にはSSL プロトコルのバージョン 2 で接続を試みます。 -@end defvar - - -@node Connect via rlogin, , Connect via SSL, Connection types -@subsection rlogin を介した接続 - - -@defvar liece-tcp-rlogin-program -rlogin (rsh, ssh) を用いたリレー接続時に使用するプログラム -@end defvar - - -@defvar liece-tcp-rlogin-user-name -rlogin (rsh, ssh) を用いたリレー接続時に使用するユーザ名 -@end defvar - - -@node Timers, Programming hooks, Connection types, Customization -@section タイマ変数 - -@defvar liece-keepalive-interval -IRC サーバに対して定期的に PING を送る間隔 -@end defvar - -@defvar liece-poll-names-interval -参加しているチャンネルに対し、定期的に名前一覧を取得する間隔 -@end defvar - -@defvar liece-poll-friends-interval - -@var{liece-friends} に指定したユーザに対し、定期的に存在確認を行う間隔 -@end defvar - - -@node Programming hooks, , Timers, Customization -@section Programming hooks - - -Liece では複雑な hook を書くためのマクロを用意しています。 - -@defun liece-current-nickname -現在の自分のニックネームを取得 -@end defun - -@defun liece-current-channel -現在会話中のチャンネル名を取得 -@end defun - -@defun liece-current-channels -参加しているチャンネルのリストを取得 -@end defun - -@defun liece-current-chat-partner -現在会話中の対話相手を取得 -@end defun - -@defun liece-current-chat-partners -会話中の対話相手のリストを取得 -@end defun - -@defun liece-channel-get-nicks &optional chnl -CHNL のメンバ一覧を取得 -@end defun - -@defun liece-channel-get-operators &optional chnl -CHNL のチャンネル管理者リストを取得 -@end defun - -@defun liece-channel-get-voices &optional chnl -CHNL で発言権のあるメンバのリストを取得 -@end defun - -@defun liece-channel-get-topic &optional chnl -CHNL のトピックを取得 -@end defun - -@defun liece-channel-get-modes &optional chnl -CHNL のモードを取得 -@end defun - -@defun liece-channel-get-bans &optional chnl -CHNL の ban リストを取得 -@end defun - -@defun liece-channel-get-exceptions &optional chnl -CHNL の ban 例外リストを取得 -@end defun - -@defun liece-channel-get-invites &optional chnl -CHNL の招待者リストを取得 -@end defun - -@node Appendix, Concept Index, Customization, Top -@chapter 付録 - -@node Concept Index, Function Index, Appendix, Top -@chapter 概念索引 - -@printindex cp - -@node Function Index, Variable Index, Concept Index, Top -@chapter 関数索引 - -@printindex fn - -@node Variable Index, , Function Index, Top -@chapter 変数索引 - -@summarycontents -@contents -@bye diff --git a/doc/liece.xml b/doc/liece.xml new file mode 100644 index 0000000..bd3e241 --- /dev/null +++ b/doc/liece.xml @@ -0,0 +1,197 @@ + + + +]> + +
+ + Liece + + Emacs IRC client. + + + Daiki + Ueno + +
+ ueno@unixuser.org +
+ + + 2000/09/12 + Version 1.4.4 + + + + This manual documents Liece &liece-version;, + the Emacs IRC client. You may find the latest information from + + Liece official home page. + + + + + + + Summary of Liece features + + + Overview + + + Liece, the Emacs IRC client, + provides a user-friendly interface to access IRC servers. + + Internet Relay Chat: RFC 1459, RFC 2810, RFC 2811, RFC 2812, RFC 2813. + + + Currently Liece has following features: + + + + Clear user interface inspired by + CHOCOA + + + Lightweight operation + Dynamic window configuration + Collect URLs automatically + + + + + + + How to install Liece + + + Installation + + + + + + + The installation procedure depends on the Emacs flavor you are + running. Anyway Liece &liece-version; + should work on: + + + + Emacs 20.7 and up. + XEmacs 21.1.12 and up. + + + + + + Complicated stuff you may have to do. + + + Prerequisites + + Liece &liece-version; uses APEL and FLIM, + you have to install them in this order. + Generally make install will do the job. + + + Package + Author's version + + + APEL (A Portable Emacs Library) + 10.2 or later + + + + FLIM + + 1.12 or later + + + + + Compilation + + In the top level directory of the Liece distribution, + run the script configure as follows: + + + +$ ./configure [CONFIGURATION-NAME] [--OPTION[=VALUE]] ... + + + + If you are using XEmacs and want to install to XEmacs package directory, + specify . + If you wish to build with a specific version of Emacs, + use . + + + When it is done, configure + just creates the files: + + + Makefile + lisp/Makefile + dcc/Makefile + doc/Makefile + etc/Makefile + + + Then run make to finish building + Liece in the standard way. + You can install the package with + make install. + + + + + + + + The various usage possibilities + + + Usage + + + + Finding an IRC server and connecting to it + + + Servers + + Liece comes with a list of servers. + + + + + + + + Copyright and warranty + + + Copying + + This program is free software; you can redistribute it and/or modify + it under the terms of the GNU General Public License as published by + the Free Software Foundation; either version 2 of the License, or + (at your option) any later version. + + + This program is distributed in the hope that it will be useful, + but WITHOUT ANY WARRANTY; without even the implied warranty of + MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + GNU General Public License for more details. + + + You should have received a copy of the GNU General Public License + along with this program; if not, write to the Free Software + Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + + +
diff --git a/doc/sample.dot.liece.in b/doc/sample.dot.liece.in deleted file mode 100644 index eeea090..0000000 --- a/doc/sample.dot.liece.in +++ /dev/null @@ -1,97 +0,0 @@ -;;; -*- mode: emacs-lisp -*- -*- coding: iso-2022-jp -*- - -;; IRC Servers -;(setq liece-server "irc.kyoto.wide.ad.jp") -;(setq liece-server "irc.rcac.tdi.co.jp") -;(setq liece-server "irc.race.u-tokyo.ac.jp") -;(setq liece-server "irc.huie.hokudai.ac.jp") -;(setq liece-server "irc.karrn.ad.jp") -;(setq liece-server "irc.tohoku.ac.jp") -;(setq liece-server "irc.dti.ne.jp") -;(setq liece-server "irc.tokyo.wide.ad.jp") - -;; Port number of IRC Servers (default: 6667) -;(setq liece-service 6667) - -;; Private information of user. -;(setq liece-name "") -;(setq liece-nickname "") - -;; Customization to change Look & Feel. -;; If non-nil, channel buffer would be displayed. -(setq liece-channel-buffer-mode t) -;; If non-nil, nick buffer would be displayed. -(setq liece-nick-buffer-mode t) -;; If non-nil, channel list buffer would be displayed. -(setq liece-channel-list-buffer-mode t) - -;; Window splitting parameters. -(setq liece-nick-window-width-percent 18) -(setq liece-channel-list-window-width-percent 24) - -;; Path settings -;; If you have installed as XEmacs package please set them to nil. -(setq liece-intl-catalogue-directory "@CATALOGDIR@") -(setq liece-window-style-directory "@STYLEDIR@") - -(setq liece-window-default-style "middle") - -;; Highlighten IRC buffers. -(setq liece-highlight-mode t) -;; If `liece-highlight-mode' is non-nil, strings which matches -;; following regular expression would be emphasized by colouring. -;(setq liece-highlight-pattern -; (regexp-opt -; '("foo" "bar" "baz.*"))) - -;; Channels we want to join startup time. -;(setq liece-startup-channel-list -; '("#foo" "#bar")) -;; Channel bindings to its numerical expression. -;; Each element of list are bound to n-th. -;(setq liece-default-channel-binding -; '("#foo" nil "#baz" "#bar")) - -;; DCC external programs. -;; When this is not specified, we search `dcc' executable in exec-path. -(setq liece-dcc-program - (expand-file-name "@DCCPATH@")) -;; Don't receive any files automatically. -(setq liece-dcc-receive-direct nil) - -;;; XEmacs specific features -;; Normal position of toolbar icons. -(setq liece-icon-directory - (expand-file-name "@ICONDIR@")) -;; Default toolbar position. -;(setq liece-toolbar-position 'top) -;; Display smiley mark. -;(setq liece-use-smiley t) - -;;; URL browsing. -;; Specify browser name. To see available browser names, -;; refer docstring of `liece-url-browser-function'. -(setq liece-url-browser-name "netscape") - -;;; Beep notice. -;(setq liece-beep-on-bells 'always) -;(setq liece-beep-when-privmsg t) -;(setq liece-beep-when-invited t) -;(setq liece-beep-words-list '("foo" "bar")) - -;;; Misc. -;(setq liece-insert-environment-version t) -;(setq liece-display-unread-mark t) - -;;; Automatic invisible. -;(add-hook 'liece-after-001-hook -; (function (lambda (prefix rest) -; (liece-send -; "MODE %s +i" liece-real-nickname) -; nil))) - -;;; Converting codings. -;; Detect coding automatically. -;(setq liece-detect-coding-system t) -;; Convert deprecated hankaku kana to zenkaku kana. -;(setq liece-convert-hankaku-katakana t) -- 1.7.10.4