--- /dev/null
+\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.
+
+\e$B$3$NJ8=q$r!"%U%j!<%=%U%H%&%'%":bCDH/9T$N\e(B GNU \e$B%U%j!<J8=qMxMQ5vBz7@Ls=q\e(B
+\e$BBh\e(B 1.2 \e$BHG$^$?$O$=$l0J9_$NHG$,Dj$a$k>r7o$N2<$GJ#@=!"G[I[!"$"$k$$$OJQ99$9\e(B
+\e$B$k$3$H$r5v2D$7$^$9!#JQ99IT2DItJ,$O;XDj$7$^$;$s!#!V\e(BA GNU Manual\e$B!W$OI=I=;f\e(B
+\e$B%F%-%9%H!"0J2<$N\e(B (a) \e$B$ON"I=;f%F%-%9%H$G$9!#$3$NMxMQ5vBz7@Ls=q$NJ#<L$O\e(B
+\e$B!V\e(BEmacs manual\e$B!W$N!V\e(BGNU \e$B%U%j!<J8=qMxMQ5vBz7@Ls=q!W$H$$$&>O$K4^$^$l$F$$$^\e(B
+\e$B$9!#\e(B
+
+(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 \e$B$NN"I=;f%F%-%9%H\e(B:\e$B!V$"$J$?$K$O$3$N\e(B GNU Manual \e$B$r\e(B GNU \e$B%=%U%H%&%'%"\e(B
+\e$B$N$h$&$KJ#@=$7$?$jJQ99$9$k<+M3$,$"$j$^$9!#J#@=$O%U%j!<%=%U%H%&%'%":bCD$K\e(B
+\e$B$h$C$F=PHG$5$l$^$7$?!#\e(B(\e$B%U%j!<%=%U%H%&%'%":bCD$O\e(B) GNU \e$B$N3+H/$N$?$a$KI,MW\e(B
+\e$B$J;q6b$r=8$a$F$$$^$9!#!W\e(B
+
+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.
+
+\e$B$3$NJ8=q$O!V\e(BGNU \e$B%U%j!<J8=qMxMQ5vBz7@Ls=q!W$K4p$E$$$FG[I[$5$l$?<}=8Cx:nJ*\e(B
+\e$B$N0lIt$G$9!#$b$7$"$J$?$,$3$NJ8=q$r<}=8Cx:nJ*$+$iJ,N%$7$FG[I[$7$?$$$H$-$O!"\e(B
+\e$B7@Ls=q$NBh\e(B 6 \e$B9`$K5-=R$5$l$F$$$k$h$&$K!"J8=q$K7@Ls=q$NJ#<L$rIU2C$9$k$3$H\e(B
+\e$B$K$h$C$F!"9T$J$&$3$H$,$G$-$^$9!#\e(B
+@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 <v9eklyke6b.fsf@marauder.physik.uni-ulm.de>
+@c <buovfd71nkk.fsf@mctpc71.ucom.lsi.nec.co.jp>
+
+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 <buovfd71nkk.fsf@mctpc71.ucom.lsi.nec.co.jp>
+
+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:
@cindex attachments
@cindex viewing attachments
-\e$B0J2<$N%3%^%s%I$O$9$Y$F?tCM@\F,0z?t$rM}2r$7$^$9!#Nc$($P\e(B @kbd{3 b} \e$B$O!V;0\e(B
-\e$BHVL\$N\e(B @acronym{MIME} \e$B%Q!<%H$rI=<($9$k!W$H$$$&0UL#$G$9!#\e(B
+\e$B0J2<$N%3%^%s%I$O$9$Y$F?tCM@\F,0z?t$rM}2r$7$^$9!#Nc$($P\e(B @kbd{3 K v} \e$B$O\e(B
+\e$B!V;0HVL\$N\e(B @acronym{MIME} \e$B%Q!<%H$rI=<($9$k!W$H$$$&0UL#$G$9!#\e(B
@table @kbd
@item b
@kindex K o (\e$B35N,\e(B)
@acronym{MIME} \e$B%Q!<%H$rJ]B8$7$^$9!#\e(B
+@item K O
+@kindex K O (\e$B35N,\e(B)
+\e$B%U%!%$%kL>$NF~NO$r5a$a$F$+$i\e(B @acronym{MIME} \e$B%Q!<%H$rJ]B8$7!"$=$l$r5-;v$+\e(B
+\e$B$i<h$j=|$-$^$9!#<h$j=|$+$l$?\e(B @acronym{MIME} \e$B%*%V%8%'%/%H\e(B
+\e$B$O\e(B message/external-body \e$B7?$N\e(B @acronym{MIME} \e$B7A<0$H$7$F;2>H$5$l$k$h$&$K\e(B
+\e$B$J$j$^$9!#\e(B
+
+@item K r
+@kindex K r (\e$B35N,\e(B)
+@acronym{MIME} \e$B%Q!<%H$r30It$K$"$kK\BN$GCV$-49$($^$9!#\e(B
+
+@item K d
+@kindex K d (\e$B35N,\e(B)
+@acronym{MIME} \e$B%Q!<%H$r:o=|$7$F!":o=|$7$?$3$H$N0FFb$rDI2C$7$^$9!#\e(B
+
@item K c
@kindex K c (\e$B35N,\e(B)
@acronym{MIME} \e$B%Q!<%H$r%3%T!<$7$^$9!#\e(B
\e$B%$%W$H$7$F;2>H$5$l$k$h$&$K$J$j$^\e(B
\e$B$9\e(B (@code{gnus-mime-save-part-and-strip})\e$B!#\e(B
+@findex gnus-mime-replace-part
+@item r (\e$B5-;v\e(B)
+@kindex r (\e$B5-;v\e(B)
+\e$B%U%!%$%kL>$NF~NO$r5a$a$F!"\e(B@acronym{MIME} \e$B%*%V%8%'%/%H\e(B
+\e$B$r\e(B message/external-body \e$B7?$N\e(B @acronym{MIME} \e$B7A<0$N%U%!%$%k$H$7$F;2>H$5\e(B
+\e$B$l$k30It$K$"$kK\BN$GCV$-49$($^$9!#\e(B(@code{gnus-mime-replace-part})\e$B!#\e(B
+
@findex gnus-mime-delete-part
@item d (\e$B5-;v\e(B)
@kindex d (\e$B5-;v\e(B)
\e$B5-;v$+$i\e(B @acronym{MIME} \e$B%*%V%8%'%/%H$r<h$j30$7!"<h$j30$7$?$3$H$rI=$99pCN\e(B
\e$B$GCV$-49$($^$9\e(B (@code{gnus-mime-delete-part})\e$B!#\e(B
+@c FIXME: gnus-auto-select-part \e$B$O$3$3$G@bL@$5$l$k$Y$-$G$9!#\e(B
+
@findex gnus-mime-copy-part
@item c (\e$B5-;v\e(B)
@kindex c (\e$B5-;v\e(B)
@item
Picon \e$B$O%F%-%9%H$N%"%I%l%9$+$i@5$7$/I=<($5$l$^$9!#\e(B
-@code{gnus-picon-style} \e$B$r8+$F$/$@$5$$!#\e(B@ref{Picons}.
+@code{gnus-picon-style} \e$B$r8+$F$/$@$5$$!#\e(B@xref{Picons}.
@item
@acronym{OPML} \e$B$N%U%!%$%k$G\e(B @acronym{RSS} \e$B9XFI>pJs$r%$%s%]!<%H$"$k$$$O%(\e(B
@item Gnus \e$B$O!"%5%^%j%P%C%U%!$G?7$7$$@)8B%3%^%s%I\e(B @kbd{/ r}
(@code{gnus-summary-limit-to-replied}) \e$B$H\e(B @kbd{/ R}
(@code{gnus-summary-limit-to-recipient}) \e$B$r%5%]!<%H$7$^$9!#\e(B
-@ref{Limiting}.
+@xref{Limiting}.
@item Gnus \e$B$O!"%5%^%j%P%C%U%!$G?7$7$$JB$YBX$(%3%^%s%I\e(B @kbd{C-c C-s C-t}
(@code{gnus-summary-sort-by-recipient}) \e$B$r%5%]!<%H$7$^$9!#\e(B
-@ref{Summary Sorting}.
+@xref{Summary Sorting}.
@item @code{nnrss} \e$B%P%C%/%(%s%I$O!"B?8@8l%F%-%9%H$r%5%]!<%H$7$^$9!#\e(B
@code{nnrss} \e$B%0%k!<%W$GHs\e(B ASCII \e$BJ8;zNs$r;H$C$?%0%k!<%WL>$b%5%]!<%H$5$l$^\e(B
@item @code{gnus-decay-scores} \e$B$r%9%3%"%U%!%$%k$K%^%C%A$9$k@55,I=8=$K$G\e(B
\e$B$-$^$9!#$3$l$K$h$C$F!"E,9g$9$k%9%3%"%U%!%$%k$@$1$K8:$i$9$3$H$,$G$-$^$9!#\e(B
-@ref{Score Decays}.
+@xref{Score Decays}.
@item @acronym{S/MIME} \e$B$,\e(B @acronym{LDAP} \e$B$G$N%f!<%6>ZL@$N8!:w$K;H$($k$h\e(B
\e$B$&$K$J$j$^$7$?!#\e(B@code{smime-ldap-host-list} \e$B$G%5!<%P!<$r@_Dj$9$kI,MW$,$"\e(B
@item @code{gnus-ignored-from-addresses} \e$B$r;H$&$H$-!"\e(B
\e$B%5%^%j9T$G$N\e(B @code{To} \e$B$*$h$S\e(B @code{Newsgroup} \e$B%X%C%@$K$D$1$kJ8;zNs$r\e(B
@code{gnus-summary-to-prefix} \e$B$H\e(B @code{gnus-summary-newsgroup-prefix} \e$B$G\e(B
-\e$B%+%9%?%^%$%:$9$k$3$H$,$G$-$^$9!#\e(B@ref{To From Newsgroups}.
+\e$B%+%9%?%^%$%:$9$k$3$H$,$G$-$^$9!#\e(B@xref{To From Newsgroups}.
+
+@item @acronym{MIME} \e$B%Q!<%H$r30It$K$"$kK\BN$GCV$-49$($k$3$H$,$G$-$^$9!#\e(B
+@code{gnus-mime-replace-part} \e$B$H\e(B @code{gnus-article-replace-part} \e$B$r8+$F\e(B
+\e$B$/$@$5$$!#\e(B@xref{MIME Commands}, @ref{Using MIME}.
@end itemize
projects / elisp / gnus-doc-ja.git / commitdiff