From 26b33e239543cd56aaae7f62199d62adf1dcc1c6 Mon Sep 17 00:00:00 2001 From: yamaoka Date: Tue, 20 Sep 2005 22:53:46 +0000 Subject: [PATCH] Synch to No Gnus 200509201349. --- ChangeLog | 6 ++ Makefile.in | 4 +- gnus-coding-ja.texi | 172 +++++++++++++++++++++++++++++++++++++++++++++++++++ gnus-ja.texi | 28 ++++++++- gnus-news-ja.texi | 14 +++-- 5 files changed, 215 insertions(+), 9 deletions(-) create mode 100644 gnus-coding-ja.texi diff --git a/ChangeLog b/ChangeLog index 05597bf..fa29bd3 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,9 @@ +2005-09-20 Katsumi Yamaoka + + * gnus-coding-ja.texi: New file. + + * Makefile.in: Add it. + 2005-09-02 TAKAHASHI Kaoru * ptexinfmt.el: Support @frenchspacing, @euro, @sansserif. diff --git a/Makefile.in b/Makefile.in index 4dd86a5..db90656 100644 --- a/Makefile.in +++ b/Makefile.in @@ -1,7 +1,7 @@ EMACS=@EMACS@ EMACSINFO=$(EMACS) -batch -q -no-site-file -l infohack.el -f batch-makeinfo INFO_DEPS=gnus-ja.info message-ja.info emacs-mime-ja.info\ - pgg-ja.info sasl-ja.info sieve-ja.info + pgg-ja.info sasl-ja.info sieve-ja.info gnus-coding-ja.info INSTALL=@INSTALL@ INSTALL_DATA=@INSTALL_DATA@ INSTALL_INFO=install-info @@ -42,7 +42,7 @@ install: all else : ; fi dvi: gnus-ja.dvi message-ja.dvi emacs-mime-ja.dvi\ - pgg-ja.dvi sasl-ja.dvi sieve-ja.dvi + pgg-ja.dvi sasl-ja.dvi sieve-ja.dvi gnus-coding-ja.dvi .texi.dvi: sed -e '/@iflatex/,/@end iflatex/d' $< > gnustmp.texi diff --git a/gnus-coding-ja.texi b/gnus-coding-ja.texi new file mode 100644 index 0000000..387fc6a --- /dev/null +++ b/gnus-coding-ja.texi @@ -0,0 +1,172 @@ +\input texinfo + +@setfilename gnus-coding-ja +@settitle Gnus Coding Style and Maintainance Guide +@syncodeindex fn cp +@syncodeindex vr cp +@syncodeindex pg cp + +@copying +Copyright (c) 2004 Free Software Foundation, Inc. + +@quotation +Permission is granted to copy, distribute and/or modify this document +under the terms of the GNU Free Documentation License, Version 1.2 or +any later version published by the Free Software Foundation; with no +Invariant Sections, with the Front-Cover texts being ``A GNU +Manual'', and with the Back-Cover Texts as in (a) below. A copy of the +license is included in the section entitled ``GNU Free Documentation +License'' in the Emacs manual. + +この文書を、フリーソフトウェア財団発行の GNU フリー文書利用許諾契約書 +第 1.2 版またはそれ以降の版が定める条件の下で複製、配布、あるいは変更す +ることを許可します。変更不可部分は指定しません。「A GNU Manual」は表表紙 +テキスト、以下の (a) は裏表紙テキストです。この利用許諾契約書の複写は +「Emacs manual」の「GNU フリー文書利用許諾契約書」という章に含まれていま +す。 + +(a) The FSF's Back-Cover Text is: ``You have freedom to copy and modify +this GNU Manual, like GNU software. Copies published by the Free +Software Foundation raise funds for GNU development.'' + +(a) FSF の裏表紙テキスト:「あなたにはこの GNU Manual を GNU ソフトウェア +のように複製したり変更する自由があります。複製はフリーソフトウェア財団に +よって出版されました。(フリーソフトウェア財団は) GNU の開発のために必要 +な資金を集めています。」 + +This document is part of a collection distributed under the GNU Free +Documentation License. If you want to distribute this document +separately from the collection, you can do so by adding a copy of the +license to the document, as described in section 6 of the license. + +この文書は「GNU フリー文書利用許諾契約書」に基づいて配布された収集著作物 +の一部です。もしあなたがこの文書を収集著作物から分離して配布したいときは、 +契約書の第 6 項に記述されているように、文書に契約書の複写を付加すること +によって、行なうことができます。 +@end quotation +@end copying + +@titlepage +@title Gnus Coding Style and Maintainance Guide + +@c @author by + +@insertcopying +@end titlepage + +@node Top + +@section Gnus Coding Style +@subsection Dependencies + +@c message / gnus +@c +@c nn* +@c +@c mm* +@c +@c rfc* +@c +@c tla netrc pop3 dig dns ... +@c format-spec.el + +@subsection Compatibility + +@c Compatibility with XEmacs and older Emacs versions in v5-10 and in the +@c trunk. + +@c @table +@c x +@c @end table + +@section Gnus Maintainance Guide + +@subsection Stable and development versions + +The CVS trunk is developed quite actively. + +@c Most of the time Gnus is developed on the trunk. + +@c Exeption: several month of feature freeze after a release, +@c e.g. 5.10.1 + +@subsection Syncing + +@c +@c + +I do Emacs->Gnus less often (than Gnus->Emacs) because it tends to +require more manual work. + +By default I sync about once a week. I also try to follow any Gnus +threads on the mailing lists and make sure any changes being discussed +are kept more up-to-date (so say 1-2 days delay for "topical" changes). + +@c + +BTW, just to add even more verbose explanation about the syncing thing: + +Basically my idea is that the Emacs-Gnus gateway will cause all common +files in Emacs and Gnus v5-10 to be identical except when there's a very +good reason (e.g., the Gnus version string in Emacs says "5.11", but the +v5-10 version string remains "5.10.whatever"). Furthermore, all changes +in these files in either Emacs or the v5-10 branch will be installed +into the Gnus CVS trunk, again except where there's a good reason +(typically so far the only exception has been that the changes already +exist in the trunk in modified form). Because of this, when the next +Emacs Gnus upgrade comes, it should be very easy -- just plonk in the +files from the Gnus trunk without worrying about lost changes from the +Emacs tree. + +The effect of this is that as hacker, you should generally only have to +make changes in one place: + + 1) If it's a file which is thought of as being outside of Gnus (e.g., + the new "encrypt.el"), you should probably make the change in the + Emacs tree, and it will show up in the Gnus tree a few days later. + + If you don't have Emacs CVS access (or it's inconvenient), you can + change such a file in the v5-10 branch, and it should propagate to + Emacs CVS -- however, it will get some extra scrutiny (by me) to see + if the changes are possibly controversial and need discussion on the + mailing list. [Many changes are obvious bug-fixes however, so often + there won't be any problem.] + + 2) If it's to a Gnus file, and it's important enough that it should be + part of Emacs/v5-10, then you can make the change on the v5-10 + branch, and it will go into Emacs CVS and the Gnus CVS trunk (a few + days later). + + If you know that there will be conflicts (perhaps because the + affected source code is different in v5-10 and the Gnus CVS trunk), + then you can install your change in both places, and when I try to + sync them, there will be a conflict -- however, since in most such + cases there would be a conflict _anyway_, it's often easier for me + to resolve it simply if I see two "identical" changes, and can just + choose the proper one, rather than having to actually fix the code. + + 3) For general Gnus development changes, of course you just make the + change on the Gnus CVS trunk and it goes into Emacs a few years + later... :-) + +Of course in any case, if you just can't wait for me to sync your +change, you can commit it in more than one place and probably there will +be no problem; usually the changes are textually identical anyway, so +can be easily resolved automatically (sometimes I notice silly things in +such multiple commits, like whitespace differences, and unify those ;-). + +@subsection Miscellanea + +Starting from No Gnus, the @file{GNUS-NEWS} is created from +@file{texi/gnus-news.texi}. Don't edit @file{GNUS-NEWS}. Edit +@file{texi/gnus-news.texi}, type @command{make GNUS-NEWS} in the +@file{texi} directory and commit @file{GNUS-NEWS} and +@file{texi/gnus-news.texi}. + +@c Local Variables: +@c coding: iso-2022-7bit +@c fill-column: 72 +@c mode: texinfo +@c use-kuten-for-period: t +@c use-touten-for-comma: t +@c End: diff --git a/gnus-ja.texi b/gnus-ja.texi index 4e67fc6..9c15fc1 100644 --- a/gnus-ja.texi +++ b/gnus-ja.texi @@ -8976,8 +8976,8 @@ Gnus でメールを読むことの利点は、それが単純なバグを素晴らしい不条理に置 @cindex attachments @cindex viewing attachments -以下のコマンドはすべて数値接頭引数を理解します。例えば @kbd{3 b} は「三 -番目の @acronym{MIME} パートを表示する」という意味です。 +以下のコマンドはすべて数値接頭引数を理解します。例えば @kbd{3 K v} は +「三番目の @acronym{MIME} パートを表示する」という意味です。 @table @kbd @item b @@ -8990,6 +8990,21 @@ Gnus でメールを読むことの利点は、それが単純なバグを素晴らしい不条理に置 @kindex K o (概略) @acronym{MIME} パートを保存します。 +@item K O +@kindex K O (概略) +ファイル名の入力を求めてから @acronym{MIME} パートを保存し、それを記事か +ら取り除きます。取り除かれた @acronym{MIME} オブジェクト +は message/external-body 型の @acronym{MIME} 形式として参照されるように +なります。 + +@item K r +@kindex K r (概略) +@acronym{MIME} パートを外部にある本体で置き換えます。 + +@item K d +@kindex K d (概略) +@acronym{MIME} パートを削除して、削除したことの案内を追加します。 + @item K c @kindex K c (概略) @acronym{MIME} パートをコピーします。 @@ -10827,12 +10842,21 @@ Gnus は @acronym{MIME} パートを表示するために、 イプとして参照されるようになりま す (@code{gnus-mime-save-part-and-strip})。 +@findex gnus-mime-replace-part +@item r (記事) +@kindex r (記事) +ファイル名の入力を求めて、@acronym{MIME} オブジェクト +を message/external-body 型の @acronym{MIME} 形式のファイルとして参照さ +れる外部にある本体で置き換えます。(@code{gnus-mime-replace-part})。 + @findex gnus-mime-delete-part @item d (記事) @kindex d (記事) 記事から @acronym{MIME} オブジェクトを取り外し、取り外したことを表す告知 で置き換えます (@code{gnus-mime-delete-part})。 +@c FIXME: gnus-auto-select-part はここで説明されるべきです。 + @findex gnus-mime-copy-part @item c (記事) @kindex c (記事) diff --git a/gnus-news-ja.texi b/gnus-news-ja.texi index 1b65372..1fa7797 100644 --- a/gnus-news-ja.texi +++ b/gnus-news-ja.texi @@ -42,7 +42,7 @@ nntp marks については、以降の項目でさらに詳しい情報を得ることができます。 @item Picon はテキストのアドレスから正しく表示されます。 -@code{gnus-picon-style} を見てください。@ref{Picons}. +@code{gnus-picon-style} を見てください。@xref{Picons}. @item @acronym{OPML} のファイルで @acronym{RSS} 購読情報をインポートあるいはエ @@ -117,11 +117,11 @@ ManageSieve 接続のパスワードは、ユーザにそのようにしてよいか尋ねたあと、 @item Gnus は、サマリバッファで新しい制限コマンド @kbd{/ r} (@code{gnus-summary-limit-to-replied}) と @kbd{/ R} (@code{gnus-summary-limit-to-recipient}) をサポートします。 -@ref{Limiting}. +@xref{Limiting}. @item Gnus は、サマリバッファで新しい並べ替えコマンド @kbd{C-c C-s C-t} (@code{gnus-summary-sort-by-recipient}) をサポートします。 -@ref{Summary Sorting}. +@xref{Summary Sorting}. @item @code{nnrss} バックエンドは、多言語テキストをサポートします。 @code{nnrss} グループで非 ASCII 文字列を使ったグループ名もサポートされま @@ -137,7 +137,7 @@ ManageSieve 接続のパスワードは、ユーザにそのようにしてよいか尋ねたあと、 @item @code{gnus-decay-scores} をスコアファイルにマッチする正規表現にで きます。これによって、適合するスコアファイルだけに減らすことができます。 -@ref{Score Decays}. +@xref{Score Decays}. @item @acronym{S/MIME} が @acronym{LDAP} でのユーザ証明の検索に使えるよ うになりました。@code{smime-ldap-host-list} でサーバーを設定する必要があ @@ -146,7 +146,11 @@ ManageSieve 接続のパスワードは、ユーザにそのようにしてよいか尋ねたあと、 @item @code{gnus-ignored-from-addresses} を使うとき、 サマリ行での @code{To} および @code{Newsgroup} ヘッダにつける文字列を @code{gnus-summary-to-prefix} と @code{gnus-summary-newsgroup-prefix} で -カスタマイズすることができます。@ref{To From Newsgroups}. +カスタマイズすることができます。@xref{To From Newsgroups}. + +@item @acronym{MIME} パートを外部にある本体で置き換えることができます。 +@code{gnus-mime-replace-part} と @code{gnus-article-replace-part} を見て +ください。@xref{MIME Commands}, @ref{Using MIME}. @end itemize -- 1.7.10.4