From: kaoru Date: Wed, 26 Jul 2000 14:27:20 +0000 (+0000) Subject: Remove verbose comments. X-Git-Url: http://git.chise.org/gitweb/?a=commitdiff_plain;h=1f39c3c767044cf7b2f709e4977d847d46aa373c;p=elisp%2Fwanderlust.git Remove verbose comments. @env, @command, @option, @uref markups. --- diff --git a/doc/wl-ja.texi b/doc/wl-ja.texi index 6459569..63cde83 100644 --- a/doc/wl-ja.texi +++ b/doc/wl-ja.texi @@ -109,9 +109,6 @@ into another language, under the above conditions for modified versions. @end titlepage -@c -@c Top -@c @ifinfo @node Top, Introduction, (dir), (dir) @top Wanderlust $B%f!<%6%^%K%e%"%k(B @@ -146,9 +143,6 @@ Kaoru Takahashi $B9b66(B $B0j(B @end menu -@c -@c Introduction -@c @node Introduction, Start Me Up, Top, Top @chapter $B$O$8$a$K(B @cindex Introduction @@ -217,9 +211,6 @@ Wanderlust $B$,@\B3$7$FF0:n$9$k$3$H$,3NG'$5$l$F$$$k(B IMAP $B%5!<%P$O0J2<$NDL @c $B$j$G$9!#(B -@c -@c Start Me Up -@c @node Start Me Up, Folders, Introduction, Top @chapter Wanderlust $B$r5/F0$9$k(B @cindex Start up @@ -252,7 +243,7 @@ Wanderlust $B$r@5>o$KF0:n$5$;$k$K$O!"$^$:!"(BSEMI $B$b$7$/$O(B tm $B$,%$%s% Emacs19.28 $B0JA0$r%Y!<%9$H$7$?(B mule $B$r$*;H$$$N>l9g$O(B SEMI $B$,F0$+$J$$$O$:(B @footnote{Emacs 19.34 $B%Y!<%9$N(B Mule $B$G$O(B SEMI $B$rF0:n$5$;$k$3$H$b2DG=$G$9!#(B@* -@samp{http://www.jpl.org/elips/INSTALL-SEMI-ja.html} $B$,;29M$K$J$j$^$9!#(B} +@uref{http://www.jpl.org/elips/INSTALL-SEMI-ja.html} $B$,;29M$K$J$j$^$9!#(B} $B$J$N$G(B tm $B$r%$%s%9%H!<%k$7$^$9!#(B (tm $B$O%P!<%8%g%s(B 8.7 $B0J9_$r$4MxMQ$/$@$5$$!#(B) @@ -365,13 +356,13 @@ ftp://opaopa.org/pub/mirror/elisp/wl/ Wanderlust $B$G$O!"(BSMTP, IMAP, NNTP, POP $B$N%3%M%/%7%g%s$K$*$$$F!"(B SSL (Secure Socket Layer) $B$rMQ$$$k$3$H$,$G$-$^$9!#(B -SSL $B$NMxMQ7ABV$K$O(B2$Bo$N(B SSL $B$rMxMQ$9$k$K$O(B $BK\%Q%C%1!<%8$N(B @file{utils} $B%G%#%l%/%H%j$K$"$k(B -@file{ssl.el} $B$r%$%s%9%H!<%k$9$kI,MW$,$"$j$^$9!#(B -$B$J$*$+$D!"(BOpenSSL $B$K4^$^$l$k(B @file{openssl} $B$K%Q%9$,DL$C$F$$$kI,MW$,$"$j$^$9!#(B +@file{ssl.el} $B$r%$%s%9%H!<%k$9$kI,MW$,$"$j$^$9!#$J$*$+$D!"(BOpenSSL $B$K4^$^(B +$B$l$k(B @command{openssl} $B$K%Q%9$,DL$C$F$$$kI,MW$,$"$j$^$9!#(B STARTTLS $B$rMxMQ$9$k$K$O!"$5$i$K!"(Bstarttls $B%Q%C%1!<%8$r%$%s%9%H!<%k(B $B$9$kI,MW$,$"$j$^$9!#(B @@ -417,7 +408,7 @@ Cannot open load file: mime-setup @noindent $B$H$$$&%(%i!<$,=P$k$3$H$,$"$j$^$9!#$3$N>l9g$O!"(B -custom, APEL, FLIM, SEMI $B$N%$%s%9%H!<%k@h$r4D6-JQ?t(B @code{EMACSLOADPATH} +custom, APEL, FLIM, SEMI $B$N%$%s%9%H!<%k@h$r4D6-JQ?t(B @env{EMACSLOADPATH} $B$K2C$($k$+!"E83+%G%#%l%/%H%j$N(B @file{WL-CFG} $B$H$$$&%U%!%$%kCf$G(B @code{load-path} $B$rDL$7$F$*$/$H$h$$$G$7$g$&!#(B @@ -428,7 +419,7 @@ custom, APEL, FLIM, SEMI $B$N%$%s%9%H!<%k@h$r4D6-JQ?t(B @code{EMACSLOADPATH} @subsection @file{WL-CFG} @file{WL-CFG} $B$H$$$&%U%!%$%k$,E83+%G%#%l%/%H%j$KB8:_$9$k$H!"(B -$B%$%s%9%H!<%k;~$K(B load $B$5$l$k$h$&$K$J$C$F$$$^$9!#(B +$B%$%s%9%H!<%k;~$KFI$_9~$^$l$k$h$&$K$J$C$F$$$^$9!#(B $B%$%s%9%H!<%k$G(B SEMI $BEy$N(B @code{load-path} $B$N@_Dj$,I,MW$G$"$l$P!"(B @file{WL-CFG} $B$K@_Dj$7$F$/$@$5$$!#(B @@ -734,9 +725,6 @@ M-x wl $B%U%)%k%@$N%A%'%C%/$r>JN,$7$F5/F0$7$^$9!#(B -@c -@c Folders -@c @node Folders, Folder, Start Me Up, Top @chapter Wanderlust $B$G07$($k%U%)%k%@$?$A(B @cindex Folder Type @@ -793,7 +781,7 @@ default $BCM(B: @example $B%f!<%6L>(B -> $BJQ?t(B @code{elmo-default-imap4-user} $B$NCM!#(B - $B=i4|@_Dj$O(B $B4D6-JQ?t(B @code{USER} $B$+!"(B@code{LOGNAME} $B$+!"(B + $B=i4|@_Dj$O(B $B4D6-JQ?t(B @env{USER} $B$+!"(B@env{LOGNAME} $B$+!"(B @code{(user-login-name)} $B$NJV$jCM!#(B $BG'>ZK!(B -> $BJQ?t(B @code{elmo-default-imap4-authenticate-type} $B$NCM!#(B $B=i4|@_Dj$O(B "auth"$B!#(B @@ -814,11 +802,10 @@ SSL$B%3%M%/%7%g%s$rD%$j$^$9!#(B $BJQ?t(B @code{elmo-default-imap4-ssl} $B$NCM$,(B non-nil $B$J$i!"(B@samp{!} $B$rIU$1(B $B$J$/$F$b(B SSL $B$r;H$$$^$9!#(B'starttls $B$J$i(B @samp{!!} $B$r0UL#$7$^$9!#(B -(SSL $B$rMxMQ$9$k$K$O(B $BK\%Q%C%1!<%8$N(B @file{utils/ssl.el} $B$r%$%s%9%H!<%k$9$k(B -$BI,MW$,$"$j$^$9!#$J$*$+$D!"(BOpenSSL$B$K4^$^$l$k(B @file{openssl} $B$K%Q%9$,DL$C$F$$$k(B -$BI,MW$,$"$j$^$9!#(B -STARTTLS $B$rMxMQ$9$k$K$O!"$5$i$K!"(Bstarttls$B%Q%C%1!<%8$r%$%s%9%H!<%k(B -$B$9$kI,MW$,$"$j$^$9!#(B) +(SSL $B$rMxMQ$9$k$K$O(B $BK\%Q%C%1!<%8$N(B @file{utils/ssl.el} $B$r%$%s%9%H!<%k$9(B +$B$kI,MW$,$"$j$^$9!#$J$*$+$D!"(BOpenSSL$B$K4^$^$l$k(B @command{openssl} $B$K%Q%9$,(B +$BDL$C$F$$$kI,MW$,$"$j$^$9!#(BSTARTTLS $B$rMxMQ$9$k$K$O!"$5$i$K!"(Bstarttls$B%Q%C(B +$B%1!<%8$r%$%s%9%H!<%k$9$kI,MW$,$"$j$^$9!#(B) $BG'>ZK!$H$7$F!"(B"auth" $B$b$7$/$O(B "cram-md5" $B$r;XDj$7$?>l9g!"%Q%9%o!<%I$r(B $B%(%s%3!<%I$7$FAw?.$7$^$9!#$?$@$7!"%5!<%PB&$,%Q%9%o!<%I$r%(%s%3!<%I$7$F(B @@ -912,11 +899,11 @@ default $BCM(B: @samp{!!} $B$@$H!"(BSTARTTLS$B$K$h$j(BSSL$B%3%M%/%7%g%s$rD%$j$^$9!#(B $BJQ?t(B @code{elmo-default-nntp-ssl} $B$NCM$,(B non-nil $B$J$i!"(B@samp{!} $B$rIU$1(B $B$J$/$F$b(B SSL $B$r;H$$$^$9!#(B'starttls $B$J$i(B @samp{!!} $B$r0UL#$7$^$9!#(B -(SSL $B$rMxMQ$9$k$K$O(B $BK\%Q%C%1!<%8$N(B @file{utils/ssl.el} $B$r%$%s%9%H!<%k$9$k(B -$BI,MW$,$"$j$^$9!#$J$*$+$D!"(BOpenSSL$B$K4^$^$l$k(B @file{openssl} $B$K%Q%9$,DL$C$F$$$k(B -$BI,MW$,$"$j$^$9!#(B -STARTTLS $B$rMxMQ$9$k$K$O!"$5$i$K!"(Bstarttls$B%Q%C%1!<%8$r%$%s%9%H!<%k(B -$B$9$kI,MW$,$"$j$^$9!#(B) + +(SSL $B$rMxMQ$9$k$K$O(B $BK\%Q%C%1!<%8$N(B @file{utils/ssl.el} $B$r%$%s%9%H!<%k$9(B +$B$kI,MW$,$"$j$^$9!#$J$*$+$D!"(BOpenSSL$B$K4^$^$l$k(B @command{openssl} $B$K%Q%9$,(B +$BDL$C$F$$$kI,MW$,$"$j$^$9!#(BSTARTTLS $B$rMxMQ$9$k$K$O!"$5$i$K!"(Bstarttls$B%Q%C(B +$B%1!<%8$r%$%s%9%H!<%k$9$kI,MW$,$"$j$^$9!#(B) @example @group @@ -976,8 +963,8 @@ Maildir $B$O!"(B@file{cur}, @file{new}, @file{tmp} $B$N%G%#%l%/%H%j$r4^$s$G$$ $B%"%/%;%9;~$K(B @file{cur} $B%G%#%l%/%H%j$X0\F0$5$l$^$9!#(B $B$^$?!"(B@file{tmp} $B%G%#%l%/%H%j$K4^$^$l!"(B36 $B;~4V0J>e%"%/%;%9$,L5$$%a%C%;!<%8%U%!%$%k$O:o=|$5$l$^$9!#(B -$B$3$NF0:n$O(B @samp{http://cr.yp.to/proto/maildir.html} $B$K=>$C$F$$$^$9!#(B@* -($BF|K\8lLu$O(B @samp{http://www.jp.qmail.org/q103/jman5/maildir.html}) +$B$3$NF0:n$O(B @uref{http://cr.yp.to/proto/maildir.html} $B$K=>$C$F$$$^$9!#(B@* +($BF|K\8lLu$O(B @uref{http://www.jp.qmail.org/q103/jman5/maildir.html}) @example @group @@ -1136,8 +1123,8 @@ Win32 $B$G$O(B DOS $BHG$G$J$/!"(BLHa32 $B$G$J$$$HF0$+$J$$$H$N$3$H$G$9!#(B GNU tar $B$O=q8K$+$i$N:o=|$KLdBj$,$"$k$b$N$,B?$$$N$G!"FC$KCm0U$7$F$/$@$5$$!#(B $B=q8K$,GK2u$5$l$k4m81@-$,9b$$$N$G!"%U%k%9%Z%C%/$GFI$_=q$-$9$kA0$K(B -@samp{--delete} @samp{-f} $B$r=e5-$N$b$N$G$O:#$N$H$3$mLdBj$OJs9p$5$l$F$$$^$;$s!#(B +@option{--delete} @option{-f} $B$r=e5-(B +$B$N$b$N$G$O:#$N$H$3$mLdBj$OJs9p$5$l$F$$$^$;$s!#(B @node Archive Tips, Archive Vars, Archiver, Archive Folder @@ -1263,7 +1250,7 @@ RFC 1939 $B$G5,Dj$5$l$?(B POP3 $B$rMxMQ$7$F%a!<%k$rFI$`$?$a$N%U%)%k%@$G$9!#( default $BCM(B: @example $B%f!<%6L>(B -> $BJQ?t(B @code{elmo-default-pop3-user} $B$NCM!#(B - $B=i4|@_Dj$O(B $B4D6-JQ?t(B @code{USER} $B$+!"(B@code{LOGNAME} $B$+!"(B + $B=i4|@_Dj$O(B $B4D6-JQ?t(B @env{USER} $B$+!"(B@env{LOGNAME} $B$+!"(B @code{(user-login-name)} $B$NJV$jCM!#(B $BG'>ZK!(B -> $BJQ?t(B @code{elmo-default-pop3-authenticate-type} $B$NCM!#(B $B=i4|@_Dj$O(B "user"$B!#(B @@ -1519,9 +1506,7 @@ Wanderlust $B$NFbIt$GJ];}$5$l$?%a%C%;!<%8$r1\Mw$9$k$?$a$N%U%)%k%@$G$9!#(B $B%9$9$k$?$a$N%U%)%k%@$G$9!#(B00 $B!A(B 1F $B$K$O!"%-%c%C%7%e%G%#%l%/%H%j(B (@file{~/.elmo/cache})$B$N%5%V%G%#%l%/%H%jL>$r;XDj$7$^$9!#(B -@c -@c Folder -@c + @node Folder, Summary, Folders, Top @chapter $B%U%)%k%@%b!<%I(B @cindex Folder @@ -2245,9 +2230,6 @@ Non-nil $B$J$i%a%C%;!<%8$,:o=|$5$l$?$H$-$K%U%)%k%@%b!<%I$GL$FI?t$r%A%'%C%/(B @end enumerate -@c -@c Summary -@c @node Summary, Message, Folder, Top @chapter $B%5%^%j%b!<%I(B @@ -3036,7 +3018,6 @@ prefix argument $B$D$-$GA[%U%)%k%@$+$iC&=P$7$^$9!#(B @item r y @kindex r y (Summary) $B;XDj%j!<%8%g%s$K$"$k%a%C%;!<%8$rJ]B8$7$^$9!#(B -$B8=:_%+!<%=%k$,$"$k9T$N(B @findex wl-summary-save-region (@code{wl-summary-save-region}) @@ -3451,9 +3432,6 @@ nil $B$K$9$k$H!"$I$s$JBg$-$5$N%a%C%;!<%8$G$b@hFI$_$ruBV$rJ];}$7$ @end table -@c -@c Expire and Archive -@c @node Expire and Archive, Scoring, Disconnected Operations, Top @chapter $B%a%C%;!<%8$N<+F0:o=|$H%"!<%+%$%V(B @cindex Expire and Archive @@ -4949,9 +4918,6 @@ prefix argument $B$rIU$1$F(B @kbd{C-u M-x wl-summary-archive} $B$G} @@ -6259,17 +6221,15 @@ Wanderlust $B$K4X$9$k5DO@$O$3$N%a!<%j%s%0%j%9%H$G9T$o$l$^$9!#(B $B%P%0Js9p$d%Q%C%A$NAwIU$b$3$A$i$N%a!<%j%s%0%j%9%H$XAw$C$F$/$@$5$$!#(B $B%a!<%j%s%0%j%9%H$N%a%s%P$G$J$/$H$b!"Aw?.$G$-$k@_Dj$K$J$C$F$$$^$9!#(B -$B$^$?!"%P%0Js9p$N>l9g$O(BBacktrace$B$rl9g$O(B Backtrace $B$rl$re$2$^$9!#(B -@c -@c Addition -@c + @node Addition, Index, Mailing List, Top @chapter $B$*$^$1(B @@ -6332,7 +6292,7 @@ elmo $B$O!"(B@samp{Elisp Library for Message Orchestration} $B$NN,$G$9!#(B $B3F%P!<%8%g%s$K$O%3!<%I%M!<%`$,$D$$$F$$$^$9(B($B$[$H$s$I>iCL$G$9(B)$B!#(B $B$$$^$N$H$3$m(B 1980 $BG/Be$NJF%S%k%\!<%I;o%H%C%W(B 40 $B%R%C%H(B -(@samp{http://www.summer.com.br/~pfilho/html/top40/index.html}) +(@uref{http://www.summer.com.br/~pfilho/html/top40/index.html}) $B$+$i%"%k%U%!%Y%C%H=g$KE,Ev$K9%$-$J$b$N$r%T%C%/%"%C%W$7$F;H$C$F$$$^$9!#(B diff --git a/doc/wl.texi b/doc/wl.texi index 2873c8a..f4614bb 100644 --- a/doc/wl.texi +++ b/doc/wl.texi @@ -84,9 +84,6 @@ into another language, under the above conditions for modified versions. @end titlepage -@c -@c Top -@c @ifinfo @node Top, Introduction, (dir), (dir) @top Wanderlust User's Manual @@ -123,9 +120,6 @@ This manual is for Wanderlust @value{VERSION}. @end menu -@c -@c Introduction -@c @node Introduction, Start Me Up, Top, Top @chapter Introduction of Wanderlust @cindex Introduction @@ -194,9 +188,6 @@ Wanderlust: @c Wanderlust: -@c -@c Start Me Up -@c @node Start Me Up, Folders, Introduction, Top @chapter Start up Wanderlust @cindex Start up @@ -229,7 +220,7 @@ SEMI or tm must be installed to make Wanderlust work correctly. SEMI does not run on Emacs19.28 or earlier @footnote{SEMI runs on Emacs 19.34. @* -@samp{http://www.jpl.org/elips/INSTALL-SEMI-ja.html} describes how to.}, +@uref{http://www.jpl.org/elips/INSTALL-SEMI-ja.html} describes how to.}, so you must install tm, the predecessor of SEMI. (tm version 8.7 or later is needed.) @@ -343,10 +334,10 @@ the connection establishment (generic way). The other one is to start SSL negotiation by invoking STARTTLS command in the each session. -To use the formar SSL (generic SSL), you must install @file{ssl.el} in the -@file{utils} directory. OpenSSL command @file{openssl} is also required -to use @file{ssl.el}. You must set PATH to the directory that OpenSSL -commands are installed. +To use the formar SSL (generic SSL), you must install @file{ssl.el} in +the @file{utils} directory. OpenSSL command @command{openssl} is also +required to use @file{ssl.el}. You must set PATH to the directory that +OpenSSL commands are installed. To use the latter SSL(STARTTLS), you must install starttls package in addition to above. @@ -391,7 +382,7 @@ Cannot open load file: mime-setup @noindent In this case, either add destination directories of custom, APEL, FLIM -and SEMI to environmental variable @code{EMACSLOADPATH}, or define +and SEMI to environmental variable @env{EMACSLOADPATH}, or define @code{load-path} in @file{WL-CFG} in extracted directory. If you want to use BBDB, then the necessary modules are byte-compiled and @@ -711,9 +702,7 @@ That means the folders you defined in the @file{~/.folders} are listed If you start Wanderlust with prefix argument like @kbd{C-u M-x wl}, you can skip folder checking. -@c -@c Folders -@c + @node Folders, Folder, Start Me Up, Top @chapter Wanderlust's folders @cindex Folder Type @@ -766,8 +755,8 @@ default: @example @var{username} -> The value of @code{elmo-default-imap4-user}. - Initial setting is `USER' environment variable or - `LOGNAME' environment variable or return value of + Initial setting is @env{USER} environment variable or + @env{LOGNAME} environment variable or return value of @code{(user-login-name)}. @var{authenticate-type} -> The value of @code{elmo-default-imap4-authenticate-type}. Initial setting is "auth". @@ -945,7 +934,7 @@ message files in the @file{new} directory are moved to @file{cur} directory when you access to the folder. All message files contained in the @file{tmp} directory and not accessed for 36 hours are deleted. -This behavior conforms to the @samp{http://cr.yp.to/proto/maildir.html}. +This behavior conforms to the @uref{http://cr.yp.to/proto/maildir.html}. @example @group @@ -1101,7 +1090,7 @@ In Win32, LHa32 is only supported (DOS version is no good). You have to take care about GNU tar's version because many version has problem on deleting file from archive. -Please test @samp{--delete} @samp{-f} options work. Otherwise, your +Please test @option{--delete} @option{-f} options work. Otherwise, your archive will be destroyed. No problem is reported on above versions of GNU tar. @@ -1232,8 +1221,8 @@ as @var{authenticate-type}. default: @example @var{username} -> The value of @code{elmo-default-pop3-user}. - Initial setting is @code{USER} environment variable or - @code{LOGNAME} environment variable or return value of + Initial setting is @env{USER} environment variable or + @env{LOGNAME} environment variable or return value of @code{(user-login-name)}. @var{authenticate-type} -> The value of @code{elmo-default-pop3-authenticate-type}. Initial setting is "user". @@ -1490,9 +1479,7 @@ You can access to the cached messages fetched via network by accessing to the folders named 'cache/00 - 1F. 00 - 1F are the name of the subdirectories of the cache directory (@file{~/.elmo/cache}). -@c -@c Folder -@c + @node Folder, Summary, Folders, Top @chapter Folder mode @cindex Folder @@ -2223,9 +2210,6 @@ You cannot put same nickname to the different folders. @end enumerate -@c -@c Summary -@c @node Summary, Message, Folder, Top @chapter Summary Mode @@ -3458,9 +3442,7 @@ The initial setting is t. If non-nil, messages read via POP3 are cached. @end table -@c -@c Message -@c + @node Message, Draft, Summary, Top @chapter Message Buffer @@ -3515,9 +3497,7 @@ its car and cdr value corresponds to the ratio of Summary and Message windows. @end table -@c -@c Draft -@c + @node Draft, Disconnected Operations, Message, Top @chapter Draft Buffer @@ -4175,9 +4155,6 @@ the size specified by this variable. @end table -@c -@c Disconnected Operations -@c @node Disconnected Operations, Expire and Archive, Draft, Top @chapter Off-line Management @cindex Disconnected Operations @@ -4442,9 +4419,7 @@ In other words, they are initialized when Emacs is restarted even if the value is nil. @end table -@c -@c Expire and Archive -@c + @node Expire and Archive, Scoring, Disconnected Operations, Top @chapter Automatic Expiration and Archiving of Messages @cindex Expire and Archive @@ -4993,9 +4968,6 @@ Needless to say, you can use your own function. @end table -@c -@c Scoring -@c @node Scoring, Customization, Expire and Archive, Top @chapter Score of the Messages @cindex Scoring @@ -5487,9 +5459,6 @@ pop3 N E E E @end example -@c -@c Customization -@c @node Customization, Mailing List, Scoring, Top @chapter Customizing Wanderlust @cindex Customization @@ -6291,11 +6260,10 @@ this value, display progress gauge. (Not yet written) -@c -@c Mailing List -@c @node Mailing List, Addition, Customization, Top @chapter Wanderlust Mailing List +@cindex Bug report +@cindex Backtrace @display Wanderlust Mailing List @t{} @@ -6314,15 +6282,12 @@ Please send bug reports or patches to the mailing list. You can post to the mailing list even though you are not a member of it. If you send a bug report, please attach Backtrace with it. -@footnote{@samp{http://www.jpl.org/elips/BUGS-ja.html} describes how to in Japanese.} +@footnote{@uref{http://www.jpl.org/elips/BUGS-ja.html} describes how to in Japanese.} I would like to express my thanks to the members of the mailing list for valuable advice and many pieces of code they contributed. -@c -@c Addition -@c @node Addition, Index, Mailing List, Top @chapter Additional Information @@ -6386,7 +6351,7 @@ Each versions has code names (they are almost jokes). Currently they are picked up alphabetically from the top 40 hits of U.S. Billboard magazines in 1980s. -(@samp{http://www.summer.com.br/~pfilho/html/top40/index.html}) +(@uref{http://www.summer.com.br/~pfilho/html/top40/index.html}) @node Index, , Addition, Top