X-Git-Url: http://cgit.sxemacs.org/?p=riece;a=blobdiff_plain;f=doc%2Friece-en.texi;h=695154cd15f6b9358640afca51fce4f6c4871659;hp=af66a524d8b0ba3c2591c7e7b1b344133b36a21d;hb=e792415b5a25218c1929dc8c3194996be51f2784;hpb=1bbf5fceebe20770f13240a7cc24e69ca865d328 diff --git a/doc/riece-en.texi b/doc/riece-en.texi index af66a52..695154c 100644 --- a/doc/riece-en.texi +++ b/doc/riece-en.texi @@ -1,9 +1,9 @@ -\input texinfo @c -*- mode: texinfo; coding: iso-2022-jp -*- +\input texinfo @c -*- mode: texinfo -*- @c %**start of header @setfilename riece-en.info @settitle Riece -- An IRC client for Emacsen -- @c %**end of header -@set VERSION 1.0.6 +@set VERSION 3.1.1 @c @documentlanguage en @dircategory GNU Emacs Lisp @@ -14,7 +14,7 @@ @ifinfo This file describes Riece. -Copyright (C) 2003,2004 Daiki Ueno. +Copyright (C) 2003,2004,2005 Daiki Ueno. Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.1 or @@ -33,7 +33,7 @@ Free Documentation License". @page @vskip 0pt plus 1filll -Copyright @copyright{} 2003 Daiki Ueno. +Copyright @copyright{} 2003,2004,2005 Daiki Ueno. Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.1 or @@ -49,12 +49,14 @@ Free Documentation License". @node Top, Overview, (dir), (dir) @top Riece user's manual -Riece is a program to participate in IRC (Internet Relay Chat) from Emacs. +This manual documents Riece version @value{VERSION}. In addition to this +manual, you may find useful information about Riece from Riece's official +home page @uref{http://www.nongnu.org/riece/}. @menu -* Overview:: What's Riece? -* Getting started:: -* Basic usage:: Let's talk with other people. +* Overview:: Read me first. +* Getting started:: Let's talk with other people. +* Basic usage:: * Index:: * Function Index:: * Variable Index:: @@ -63,20 +65,18 @@ Riece is a program to participate in IRC (Internet Relay Chat) from Emacs. @node Overview, Getting started, Top, Top @chapter Overview -Riece is a full rewrite of the predecessor product "Liece" (whose code -has been unmaintainable for a long time), while providing a user -interface (mostly) compatible with Liece. +Riece is a user interface for IRC (Internet Relay Chat). You should +spell it with the first letter capitalized and pronounce it as /ri:s/. -For now it does not have rich functions as an IRC client, but there are -noteworthy improvements as compared with Liece: +The features of Riece are as follows: @itemize @bullet @item Several IRC servers may be used at the same time. @item -Essential features can be built upon the extension framework (called -"add-on") capable of dependency tracking. +Many features built upon the extension mechanism called add-on. +Currently 30 such add-ons are available. @item Installation is easy. Riece doesn't depend on other packages. @@ -91,89 +91,68 @@ Step-by-step instructions are included. Mostly compliant with the latest IRC client protocol (RFC 2812). @end itemize -For more details, please look at the following pages: - -@itemize @bullet -@item http://www.nongnu.org/riece/ -@item http://wiliki.designflaw.org/index.cgi?Riece&l=jp -@item http://www.unixuser.org/~ueno/liece/ -@end itemize - @node Getting started, Basic usage, Overview, Top @chapter Getting started -@menu -* Required Environments:: -* Installation:: -* Startup File:: -@end menu - -@node Required Environments, Installation, Getting started, Getting started -@section Required Environments +To start Riece, follow the instruction below: -We checked this version working on the following environments. +@enumerate +@item +@kbd{M-x load-library riece} -@itemize @bullet -@item Emacs 20.7 or later -@item XEmacs 21.4 or later -@end itemize +@item +@kbd{M-x riece} +@end enumerate -@node Installation, Startup File, Required Environments, Getting started -@section Installation +In case that @samp{Cannot open load file: riece} is signalled in (1), +you should probably have an installation problem. If you installed +Riece from source tarball, please read README again. If you are +trying to use a package distribution, check out the documentation. -The latest version of Riece can be obtained from -@uref{http://wiliki.designflaw.org/riece.cgi}. After unpacking the -tarball, you can install with the following commands: +Once Riece started successfully, you will be asked the name of the IRC +server to connect. IRC servers publicly available are taken from the +Web pages of IRC networks: -@example -./configure -make -make install -@end example +@itemize @bullet +@item http://irc.kyoto-u.ac.jp +@item http://freenode.net +@end itemize -If you want to install Riece as an XEmacs package, use the following -commands instead of the above: +You may see the following message: @example -./configure --with-xemacs[=xemacs-21.4.15] -make package -make install-package +Nickname "ueno" already in use. Choose a new one: @end example -If you do not so, it is necessery to add autoload setting to your Emacs -startup file (probably @file{~/.emacs}) to be able to start Riece by -typing @kbd{M-x riece}. +In IRC, users are identified by @emph{nicknames}. If the nickname you +selected has already used by another person, you must select the new one. -@lisp -(autoload 'riece "riece" "Start Riece" t) -@end lisp +In IRC, users join the @emph{channels} to start multi user +conversation. To join a channel, type @kbd{C-c j}. On IRCnet, there +is a channel named @samp{#Riece} where you can do some tests to get +experienced with Riece. -@node Startup File, , Installation, Getting started -@section Startup file +After you joined a channel, the layout of windows are changed to the +following: -In this section we describe Riece's startup files. - -If you are attempting to use Riece by way of trial, nothing needed to be -written in startup files. Thus you can skip this section. - -Riece reads startup files under the directory pointed by the variable -@code{riece-directory} (by default, it has @file{~/.riece/} as the -value). There are two kinds of startup files in the directory: - -@table @code -@item riece-saved-variables-file -@vindex riece-saved-variables-file -Variables changed during the last session are automatically saved in this file. -(by default, it is located at @file{~/.riece/save}) -@item riece-variables-file -@vindex riece-variables-file -Users can edit this file to configure their own settings (by default, it -is located at @file{~/.riece/init}) -@end table +@example ++-----+-----------------+ +| | | +| | | +| (1) | (2) | +| | | +| | | ++-----+-----------------+ +| | (4) | +| +-----------------+ +| (3) | | +| | (5) | +| | | ++-----+-----------------+ +@end example -At startup, Riece will first read @code{riece-saved-variables-file}, -and then @code{riece-variables-file}. That is to say, automatically -saved variables may be refered/modified by user configuration. +You can send messages by entering messages in (4). Messages from +other persons are shown in (2). @node Basic usage, Index, Getting started, Top @chapter Basic usage @@ -260,7 +239,7 @@ Indicators are characters which indicate your status. Usually they are put on the left side of the modeline like: @example -Riece: --- ueno #Liece [n] +Riece: --- ueno #Riece [n] @end example In this case, @samp{---} are indicators. From left to right their