From mboxrd@z Thu Jan 1 00:00:00 1970 X-Msuck: nntp://news.gmane.io/gmane.emacs.gnus.general/65263 Path: news.gmane.org!not-for-mail From: Juri Linkov Newsgroups: gmane.emacs.devel,gmane.emacs.gnus.general Subject: Re: Splitting gnus.texi Date: Wed, 26 Sep 2007 11:55:52 +0300 Organization: JURTA Message-ID: <87bqbpsqc7.fsf@jurta.org> References: <87fy1v36be.fsf@neutrino.caeruleus.net> <87fy1ut4hp.fsf@jurta.org> NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Trace: sea.gmane.org 1190801287 21754 80.91.229.12 (26 Sep 2007 10:08:07 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Wed, 26 Sep 2007 10:08:07 +0000 (UTC) Cc: ding@gnus.org, rms@gnu.org, Reiner.Steib@gmx.de, emacs-devel@gnu.org To: Katsumi Yamaoka Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Wed Sep 26 12:08:02 2007 Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([199.232.76.165]) by lo.gmane.org with esmtp (Exim 4.50) id 1IaToB-0001Mk-M2 for ged-emacs-devel@m.gmane.org; Wed, 26 Sep 2007 12:07:56 +0200 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1IaTo7-0002sI-BZ for ged-emacs-devel@m.gmane.org; Wed, 26 Sep 2007 06:07:51 -0400 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1IaThF-0001QE-1E for emacs-devel@gnu.org; Wed, 26 Sep 2007 06:00:45 -0400 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1IaThA-0001Ov-KH for emacs-devel@gnu.org; Wed, 26 Sep 2007 06:00:44 -0400 Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1IaThA-0001OY-46 for emacs-devel@gnu.org; Wed, 26 Sep 2007 06:00:40 -0400 Original-Received: from mx20.gnu.org ([199.232.41.8]) by monty-python.gnu.org with esmtps (TLS-1.0:RSA_AES_256_CBC_SHA1:32) (Exim 4.60) (envelope-from ) id 1IaTh6-0002b6-02; Wed, 26 Sep 2007 06:00:36 -0400 Original-Received: from relay02.kiev.sovam.com ([62.64.120.197]) by mx20.gnu.org with esmtp (Exim 4.60) (envelope-from ) id 1IaTh5-0005dp-8C; Wed, 26 Sep 2007 06:00:35 -0400 Original-Received: from [83.170.232.243] (helo=smtp.svitonline.com) by relay02.kiev.sovam.com with esmtp (Exim 4.67) (envelope-from ) id 1IaTfp-000GSX-EX; Wed, 26 Sep 2007 12:59:18 +0300 In-Reply-To: (Katsumi Yamaoka's message of "Wed\, 26 Sep 2007 09\:23\:18 +0900") User-Agent: Gnus/5.11 (Gnus v5.11) Emacs/23.0.50 (gnu/linux) X-Scanner-Signature: 5bcd58edb95cdacf596e852bfe0375ec X-DrWeb-checked: yes X-SpamTest-Envelope-From: juri@jurta.org X-SpamTest-Group-ID: 00000000 X-SpamTest-Header: Not Detected X-SpamTest-Info: Profiles 1517 [September 25 2007] X-SpamTest-Info: helo_type=3 X-SpamTest-Info: {HEADERS: header Content-Type found without required header Content-Transfer-Encoding} X-SpamTest-Method: none X-SpamTest-Rate: 25 X-SpamTest-Status: Not detected X-SpamTest-Status-Extended: not_detected X-SpamTest-Version: SMTP-Filter Version 3.0.0 [0255], KAS30/Release X-detected-kernel: FreeBSD 4.8-5.1 (or MacOS X 10.2-10.3) X-Detected-Kernel: Linux 2.6, seldom 2.4 (older, 4) X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Original-Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.devel:79897 gmane.emacs.gnus.general:65263 Archived-At: > At least for gnus.texi, I don't see the benefit of splitting. > It's indeed big, but is not too big to edit with Emacs. Rather, > I cannot ignore a disadvantage of splitting it. I sometimes > write in it. Since various Gnus functions are related mutually, > I frequently check other items concerned when I write something. > For example, when I write description about nntp, I have to check > whether my writing does not conflict with descriptions of other > sections. When I hesitate whether I should add @vindex for the > nntp-foo-bar variable, I scan the whole gnus.texi. I do also it > when I examine it should be @acronym{NNTP}, @code{nntp}, or NNTP. > Now I only need to type `C-s nntp' for them. But if gnus.texi is > split into 10 to 15 files, it will be quite troublesome. We can improve C-s to search a collection of files, but this is not implemented yet. > I can agree with splitting if it is very useful to users, though. This is intended for developers. So if developers think this is not useful then there is no need to split it. I proposed splitting only because source files for the Emacs manual are split into several texi files. However, I see no clear benefits of splitting. Rather we could take the suggestion of Reiner and put gnus-coding, gnus-news, gnus-faq, gnus, message, sasl, emacs-mime, pgg and sieve into a new `gnus' subdirectory. -- Juri Linkov http://www.jurta.org/emacs/