Translated.
authoryamaoka <yamaoka>
Wed, 21 Sep 2005 05:02:55 +0000 (05:02 +0000)
committeryamaoka <yamaoka>
Wed, 21 Sep 2005 05:02:55 +0000 (05:02 +0000)
gnus-coding-ja.texi

index 387fc6a..c85f128 100644 (file)
@@ -6,6 +6,11 @@
 @syncodeindex vr cp
 @syncodeindex pg cp
 
+@dircategory Emacs
+@direntry
+* Gnus-Coding-ja: (gnus-coding-ja).  Gnus Coding Style and Maintainance Guide
+@end direntry
+
 @copying
 Copyright (c) 2004  Free Software Foundation, Inc.
 
@@ -56,8 +61,8 @@ license to the document, as described in section 6 of the license.
 
 @node Top
 
-@section Gnus Coding Style
-@subsection Dependencies
+@section Gnus \e$B$G%3!<%I$r=q$/$H$-$NN.57\e(B
+@subsection \e$B0MB84X78\e(B
 
 @c message / gnus
 @c
@@ -70,7 +75,7 @@ license to the document, as described in section 6 of the license.
 @c tla netrc pop3 dig dns ...
 @c format-spec.el
 
-@subsection Compatibility
+@subsection \e$B8_49@-\e(B
 
 @c Compatibility with XEmacs and older Emacs versions in v5-10 and in the
 @c trunk.
@@ -79,89 +84,96 @@ license to the document, as described in section 6 of the license.
 @c x
 @c @end table
 
-@section Gnus Maintainance Guide
+@section Gnus \e$B$N0];}4IM}$K4X$9$k<j0z\e(B
 
-@subsection Stable and development versions
+@subsection \e$B0BDjHG$H3+H/HG\e(B
 
-The CVS trunk is developed quite actively.
+CVS \e$B$N44$O$+$J$j3hH/$K3+H/$5$l$F$$$^$9!#\e(B
 
 @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
+@subsection \e$BF14|\e(B
 
 @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.
+Emacs \e$B$G9T$J$o$l$?JQ99$r\e(B Gnus \e$B$K<h$j9~$`$3$H$r!";d$OIQHK$K$O9T$J$$$^$;\e(B
+\e$B$s!#\e(BGnus \e$B$G9T$J$o$l$?JQ99$r\e(B Emacs \e$B$K;}$A>e$2$k$h$j$bB?$/$N<j:n6H$rI,MW$H\e(B
+\e$B$9$k798~$,$"$k$+$i$G$9!#\e(B
 
-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).
+\e$B;d$O%G%#%U%)%k%H$G=50l2s$NF14|$r9T$J$C$F$$$^$9!#$5$i$K;d$O\e(B Gnus \e$B%a!<%j%s\e(B
+\e$B%0%j%9%H$N$"$i$f$k%9%l%C%I$rDI$$$+$1$F!"OC$79g$o$l$F$$$k$I$s$JJQ99$G$b!"\e(B
+\e$B$=$l$,$h$j:G?7$K$J$k$h$&$K$7$F$$$^$9\e(B (\e$B$=$N$?$a!"OCBj$K$J$C$F$$$kJQ99$X$N\e(B
+\e$BDI=>$O\e(B 1\e$B!A\e(B2\e$BF|CY$l$^$9\e(B)\e$B!#\e(B
 
 @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}.
+\e$B$D$$$G$K!"F14|$K4X$9$k$h$j>\$7$$@bL@$rIU5-$7$F$*$-$^$7$g$&\e(B:
+
+\e$B4pK\E*$K;d$,M}2r$7$F$$$k$N$O!"\e(BEmacs \e$B$H\e(B Gnus v5-10 \e$B$K$*$1$k$9$Y$F$N6&DL$J\e(B
+\e$B%U%!%$%k$r\e(B Emacs-Gnus \e$B%2!<%H%&%'%$$,F1$8$K$7$F$/$l$k$3$H$G$9!#$?$@$7Hs>o\e(B
+\e$B$K@5Ev$JM}M3$,$"$k\e(B (\e$BNc$($P\e(B Emacs \e$B$G$O\e(B Gnus \e$B$NHG$rI=$9J8;zNs\e(B
+\e$B$,\e(B @samp{5.11} \e$B$G$9$,\e(B v5-10 \e$B;^$G$O\e(B @samp{5.10.\e$B2?$,$7\e(B} \e$B$N$^$^$K$J$C$F$$\e(B
+\e$B$k\e(B) \e$B>l9g$r=|$-$^$9!#$5$i$K\e(B Emacs \e$B$+\e(B v5-10 \e$B;^$N$I$A$i$+$G!"$=$l$i$N%U%!%$\e(B
+\e$B%k$KBP$7$F9T$J$o$l$?$9$Y$F$NJQ99$O!"\e(BGnus \e$B$N\e(B CVS \e$B$N44$K$bH?1G$5$l$^$9!#$?\e(B
+\e$B$@$7!"$3$A$i$b@5Ev$JM}M3$,$"$k>l9g$r=|$-$^$9\e(B (\e$B$3$l$^$G$NE57?E*$JNc30$H$7\e(B
+\e$B$F!"8z2L$OF1$8$@$1$l$I$b0c$&$d$jJ}$G9T$J$o$l$?JQ99$,$9$G$K44$KB8:_$7$F$$\e(B
+\e$B$?$3$H$,$"$j$^$7$?\e(B)\e$B!#$3$l$K$h$C$F!"<!$K\e(B Emacs \e$B$N\e(B Gnus \e$B$r99?7$9$k$H$-$K$J$C\e(B
+\e$B$?$i!"$=$l$OHs>o$K3Z$J$O$:$G$9\e(B---Emacs \e$B$@$1$GJQ99$5$l$?$3$H$,<:$o$l$F$7\e(B
+\e$B$^$&$3$H$r?4G[$;$:$K!"\e(BGnus \e$B$N44$r$=$l$i$N%U%!%$%k$K$I$5$C$HCV$/$@$1$GNI\e(B
+\e$B$$$N$G$9!#\e(B
+
+\e$B$3$N7k2L!"%O%C%+!<$G$"$k$"$J$?$O!"DL>o$O0l$D$N>l=j$GJQ99$r9T$J$&$@$1$G:Q\e(B
+\e$B$`$3$H$K$J$j$^$9\e(B:
+
+@enumerate
+@item
+Gnus \e$B$N30$K$"$k$H8+$J$5$l$k%U%!%$%k\e(B (\e$BNc$($P?7$7$$\e(B @file{encrypt.el}) \e$B$N\e(B
+\e$B>l9g!"$*$=$i$/\e(B Emacs \e$B$GJQ99$r9T$J$&$Y$-$G$9!#$=$l$OFs!A;0F|8e$K\e(B Gnus \e$B$K\e(B
+\e$B8=$o$l$k$G$7$g$&!#\e(B
+
+Emacs \e$B$N\e(B CVS \e$B$X$N=q$-9~$_$,5v$5$l$F$$$J$$\e(B (\e$B$^$?$O$=$l$,ITJX\e(B) \e$B$J$i$P!"\e(B
+v5-10 \e$B;^$GJQ99$r9T$J$($PNI$$$G$7$g$&!#$=$l$O\e(B Emacs \e$B$N\e(B CVS \e$B$KEAHB$5$l$k$O\e(B
+\e$B$:$G$9\e(B---\e$B$7$+$7!"$=$l$,O@Ah$NE*$K$J$k2DG=@-$,$"$C$F!"%a!<%j%s%0%j%9%H$G\e(B
+\e$B5DO@$9$k$3$H$,I,MW$+$I$&$+$rH=CG$9$k$?$a$K!"DI2C$ND4::$,\e(B (\e$B;d$K$h$C$F\e(B) \e$B9T\e(B
+\e$B$J$o$l$k$G$7$g$&!#\e(B[\e$B$7$+$7B?$/$NJQ99$OL@$i$+$J%P%0$N=$@5$J$N$G!"$?$$$F$$\e(B
+\e$B$N>l9g$OLdBj$"$j$^$;$s!#\e(B]
+
+@item
+Gnus \e$B$N%U%!%$%k$X$NJQ99$G!"$=$l$,==J,$K=EMW$J\e(B Emacs \e$B$H\e(B v5-10 \e$B;^$NItJ,$G\e(B
+\e$B$"$k$N$J$i$P!"JQ99$O\e(B v5-10 \e$B;^$G9T$J$($PNI$$$G$7$g$&!#$=$7$F$=$l\e(B
+\e$B$O\e(B Emacs \e$B$N\e(B CVS \e$B$H\e(B Gnus \e$B$N\e(B CVS \e$B$N44$KH?1G$5$l$k$G$7$g$&\e(B (\e$BFs!A;0F|8e$K\e(B)\e$B!#\e(B
+
+(\e$B$*$=$i$/!"BP>]$K$J$k%=!<%9%3!<%I$,\e(B v5-10 \e$B;^$H\e(B Gnus \e$B$N\e(B CVS \e$B$N44$G0[$J$k\e(B
+\e$B$?$a$K\e(B) \e$B>WFM$r@8$8$k$3$H$,$o$+$C$F$$$k>l9g$O!"$"$J$?$NJQ99$rN>J}$N>l=j$K\e(B
+\e$B%$%s%9%H!<%k$7$F2<$5$$!#$=$7$F!";d$,$=$l$i$rF14|$5$;$h$&$H$9$k$H>WFM$9$k\e(B
+\e$B$G$7$g$&\e(B---\e$B$=$&$$$&$[$H$s$I$N>l9g$K\e(B _\e$B$H$K$+$/\e(B_ \e$B>WFM$7$^$9!#$G$b!";d$,Fs\e(B
+\e$B$D$N!VF10l$N!WJQ99$rD4$Y$k>l9g$K!"$=$l$r2r7h$7$F$+$D<B:]$K%3!<%I$r=$@5$7\e(B
+\e$B$J$1$l$P$J$i$J$$$3$H$KHf$Y$l$P!"E,@Z$J$b$N$rA*$V$@$1$G:Q$`J}$,!"B?$/$N>l\e(B
+\e$B9g!";d$K$O$h$j4JC1$G$9!#\e(B
+
+@item
+Gnus \e$B$N3+H/$K$*$1$k;(B?$JJQ99$K$D$$$F$O!"C1$K\e(B Gnus \e$B$N\e(B CVS \e$B$N44$rJQ99$9$l\e(B
+\e$B$P!"$=$l$O\e(B Emacs \e$B$KH?1G$5$l$k$G$7$g$&!#Fs!A;0G/8e$K\e(B@dots{} :-)
+@end enumerate
+
+\e$B$b$A$m$s$I$s$J>l9g$G$b!";d$,F14|$5$;$k:n6H$rBT$F$J$$$N$G$"$l$P!"$"$J$?$N\e(B
+\e$BJQ99$rFs$D0J>e$N>l=j$K%A%'%C%/%$%s$9$k$3$H$O$G$-$k$7!"62$i$/LdBj$K$J$i$J\e(B
+\e$B$$$G$7$g$&!#DL>o!"JQ99$OJ8;z$I$*$j$K$H$K$+$/F10l$G$9$+$i!"MF0W$K<+F0E*$K\e(B
+\e$B2r7h$9$k$3$H$,$G$-$^$9\e(B (\e$B$H$-$I$-;d$O$=$N$h$&$K=EJ#$7$F9T$J$o$l$k%A%'%C%/\e(B
+\e$B%$%s$NCf$G$*4VH4$1$J$b$N!"Nc$($P6uGrJ8;z$N0c$$$K5$$E$$$F!"$=$l$i$rE}0l$7\e(B
+\e$B$^$9$1$l$I$M\e(B ;-)\e$B!#\e(B
+
+@subsection \e$B$$$m$s$J$3$H\e(B
+
+@file{texi/gnus-news.texi} \e$B$r85$K\e(B @file{GNUS-NEWS} \e$B$r@8@.$5$;$k$N$O!"\e(BNo
+Gnus \e$B$+$i;O$^$j$^$7$?!#\e(B@file{GNUS-NEWS} \e$B$OJT=8$7$J$$$G2<$5$$!#\e(B
+@file{texi/gnus-news.texi} \e$B$rJT=8$7!"\e(B@file{texi} \e$B%G%#%l%/%H%j!<\e(B
+\e$B$G\e(B @command{make GNUS-NEWS} \e$B$r%?%$%W$7$F$+$i!"\e(B
+@file{GNUS-NEWS} \e$B$H\e(B @file{texi/gnus-news.texi} \e$B$r%A%'%C%/%$%s$7$F2<$5$$!#\e(B
 
 @c Local Variables:
 @c coding: iso-2022-7bit