From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: "Richard M. Stallman" Newsgroups: gmane.emacs.devel Subject: Re: Overlong nodes in the Emacs Lisp Manual Date: Thu, 11 Aug 2005 16:42:21 -0400 Message-ID: References: <200508091911.j79JBjD01662@raven.dms.auburn.edu> <87oe852x47.fsf@jurta.org> Reply-To: rms@gnu.org NNTP-Posting-Host: main.gmane.org Content-Type: text/plain; charset=ISO-8859-15 X-Trace: sea.gmane.org 1123793959 25263 80.91.229.2 (11 Aug 2005 20:59:19 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Thu, 11 Aug 2005 20:59:19 +0000 (UTC) Cc: teirllm@dms.auburn.edu, emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Thu Aug 11 22:59:18 2005 Return-path: Original-Received: from lists.gnu.org ([199.232.76.165]) by ciao.gmane.org with esmtp (Exim 4.43) id 1E3K7w-0008K5-Dn for ged-emacs-devel@m.gmane.org; Thu, 11 Aug 2005 22:58:12 +0200 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1E3KB7-0005hE-Jw for ged-emacs-devel@m.gmane.org; Thu, 11 Aug 2005 17:01:29 -0400 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1E3K7r-0004qn-AI for emacs-devel@gnu.org; Thu, 11 Aug 2005 16:58:07 -0400 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1E3K7c-0004ge-2v for emacs-devel@gnu.org; Thu, 11 Aug 2005 16:57:52 -0400 Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1E3K7b-0004d1-QJ for emacs-devel@gnu.org; Thu, 11 Aug 2005 16:57:51 -0400 Original-Received: from [199.232.76.164] (helo=fencepost.gnu.org) by monty-python.gnu.org with esmtp (Exim 4.34) id 1E3K9G-0001aJ-RN for emacs-devel@gnu.org; Thu, 11 Aug 2005 16:59:34 -0400 Original-Received: from rms by fencepost.gnu.org with local (Exim 4.34) id 1E3Jsb-00022U-Cu; Thu, 11 Aug 2005 16:42:21 -0400 Original-To: Juri Linkov In-reply-to: <87oe852x47.fsf@jurta.org> (message from Juri Linkov on Thu, 11 Aug 2005 03:27:12 +0300) 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:41927 X-Report-Spam: http://spam.gmane.org/gmane.emacs.devel:41927 I think not only long nodes should be checked, but also the shortest nodes too. For example, the node `(elisp)Inverse Video' has 11 lines and documents a semi-obsolete option `inverse-video'. Its menu item description in its upper node is too general: * Inverse Video Specifying how the screen looks. I think you are right. In this case, I simply deleted the node, since the variable it documented is basically obsolete. Could you take a look the remaining nodes that are 14 lines or less, and see if you can find good places to merge them into? Ignore these 14 (info "(elisp)Window Configuration Type") 14 (info "(elisp)Hash Table Type") 14 (info "(elisp)Frame Configuration Type") 13 (info "(elisp)Keymap Type") which probably should not be combined, and don't try desperately hard.