From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Glenn Morris Newsgroups: gmane.emacs.devel Subject: Re: contribution of ruby-mode.el Date: Fri, 05 Oct 2007 15:29:53 -0400 Message-ID: <4xzlyx1hse.fsf@fencepost.gnu.org> References: <200706021912.l52JC7DD018615@sharui.nakada.kanuma.tochigi.jp> NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Trace: sea.gmane.org 1191612668 8069 80.91.229.12 (5 Oct 2007 19:31:08 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Fri, 5 Oct 2007 19:31:08 +0000 (UTC) Cc: Nobuyoshi Nakada , emacs-devel@gnu.org To: rms@gnu.org Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Fri Oct 05 21:31:05 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 1Idst2-0001GQ-8T for ged-emacs-devel@m.gmane.org; Fri, 05 Oct 2007 21:31:00 +0200 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1Idssx-0008RL-8t for ged-emacs-devel@m.gmane.org; Fri, 05 Oct 2007 15:30:55 -0400 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1Idsst-0008O3-CX for emacs-devel@gnu.org; Fri, 05 Oct 2007 15:30:51 -0400 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1Idsss-0008Kg-0T for emacs-devel@gnu.org; Fri, 05 Oct 2007 15:30:51 -0400 Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1Idssr-0008Ib-Bq for emacs-devel@gnu.org; Fri, 05 Oct 2007 15:30:49 -0400 Original-Received: from fencepost.gnu.org ([140.186.70.10]) by monty-python.gnu.org with esmtp (Exim 4.60) (envelope-from ) id 1Idssq-0007lk-Bd for emacs-devel@gnu.org; Fri, 05 Oct 2007 15:30:48 -0400 Original-Received: from rgm by fencepost.gnu.org with local (Exim 4.60) (envelope-from ) id 1Idsrx-0008Gj-AE; Fri, 05 Oct 2007 15:29:53 -0400 X-Spook: Cohiba M-14 Geraldton CID NWO ICE Capricorn Reno X-Ran: 6D{`M8Y12XE3lxl,tWtb6}1c=eZo>1e.lM}&+$4^%3>(lgT/Z%kk.3Vq6<)0[GmQ2"_s]0 X-Hue: black X-Attribution: GM In-Reply-To: (Richard Stallman's message of "Sun, 03 Jun 2007 17:27:50 -0400") User-Agent: Gnus (www.gnus.org), GNU Emacs (www.gnu.org/software/emacs/) 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:80307 Archived-At: Richard Stallman wrote: > To make this program understandable and maintainable, please give > every defconst and every defun a doc string that explains what jobs > they do. Large functions such as ruby-calculate-indent need a > comment to explain every group of lines. Maintaining Emacs is hard > already, and if we don't want to make it harder, we need to ensure > that new files are really clear. > > It would also be good to add comments at the top of the file > decribing the features that the mode provides. Hi, Has there been any progress on this? Whilst I am not a Ruby user myself, I think it would be good to include ruby-mode in Emacs.