From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.devel Subject: Re: Trunk still not open Date: Mon, 17 Mar 2014 19:25:39 +0200 Message-ID: <83zjkoaga4.fsf@gnu.org> References: <6xwqfxhl88.fsf@fencepost.gnu.org> <83txb1mcsy.fsf@gnu.org> <87siqlku0i.fsf@uwakimon.sk.tsukuba.ac.jp> <87wqfxari2.fsf@yandex.ru> <87ha70kyy3.fsf@uwakimon.sk.tsukuba.ac.jp> <5323B66B.5070405@yandex.ru> <837g7vdg70.fsf@gnu.org> <768us8u6yb.fsf@fencepost.gnu.org> Reply-To: Eli Zaretskii NNTP-Posting-Host: plane.gmane.org X-Trace: ger.gmane.org 1395077141 27832 80.91.229.3 (17 Mar 2014 17:25:41 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Mon, 17 Mar 2014 17:25:41 +0000 (UTC) Cc: stephen@xemacs.org, dgutov@yandex.ru, emacs-devel@gnu.org To: Juanma Barranquero Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Mon Mar 17 18:25:49 2014 Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by plane.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1WPbIK-0006IV-Cg for ged-emacs-devel@m.gmane.org; Mon, 17 Mar 2014 18:25:48 +0100 Original-Received: from localhost ([::1]:59319 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1WPbIJ-0000TR-Tz for ged-emacs-devel@m.gmane.org; Mon, 17 Mar 2014 13:25:47 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:51615) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1WPbIC-0000TJ-S9 for emacs-devel@gnu.org; Mon, 17 Mar 2014 13:25:45 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1WPbI7-0003dn-QA for emacs-devel@gnu.org; Mon, 17 Mar 2014 13:25:40 -0400 Original-Received: from mtaout22.012.net.il ([80.179.55.172]:38223) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1WPbI7-0003cr-HG; Mon, 17 Mar 2014 13:25:35 -0400 Original-Received: from conversion-daemon.a-mtaout22.012.net.il by a-mtaout22.012.net.il (HyperSendmail v2007.08) id <0N2L00400C78GJ00@a-mtaout22.012.net.il>; Mon, 17 Mar 2014 19:25:34 +0200 (IST) Original-Received: from HOME-C4E4A596F7 ([87.69.4.28]) by a-mtaout22.012.net.il (HyperSendmail v2007.08) with ESMTPA id <0N2L004HBCELC040@a-mtaout22.012.net.il>; Mon, 17 Mar 2014 19:25:34 +0200 (IST) In-reply-to: X-012-Sender: halo1@inter.net.il X-detected-operating-system: by eggs.gnu.org: Solaris 10 X-Received-From: 80.179.55.172 X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Original-Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.devel:170453 Archived-At: > From: Juanma Barranquero > Date: Mon, 17 Mar 2014 18:03:33 +0100 > Cc: Eli Zaretskii , Stephen Turnbull , > Emacs developers , Dmitry Gutov > > > Well it does. This just seems obvious to me, if you want people to > > actually use it. > > Well, framesets aren't documented in the elisp reference, but they are > hardly undocumented. In fact, once I start writing the info docs for > it, I don't think I'm going to say much, if anything, that isn't > already in the docstrings or the comments. frameset.el has a bit more > of 1100 non-empty lines, and ~56% of that is comments or docstrings. Try not to document the commands at all, and none of the user-level facets of the feature. Only document the functions and variables that can be used as infrastructure for other similar features. Then you won't need to repeat so much of the doc strings.