From mboxrd@z Thu Jan 1 00:00:00 1970 From: pinard@iro.umontreal.ca (=?utf-8?Q?Fran=C3=A7ois?= Pinard) Subject: Re: The reportmode report does not count the running clock Date: Tue, 03 Jan 2012 22:33:43 -0500 Message-ID: <8739bwuoo8.fsf@iro.umontreal.ca> References: <87liqhrt6r.fsf@iro.umontreal.ca> <87pqfsituv.fsf@norang.ca> <87r508d00p.fsf@iro.umontreal.ca> <87hb14ij4h.fsf@norang.ca> <3CF43367-3C9C-4509-8383-90A26C016D2A@gmail.com> <87mxa4u6oe.fsf@iro.umontreal.ca> <878vlont7e.fsf@altern.org> Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable Return-path: Received: from eggs.gnu.org ([140.186.70.92]:41542) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1RiHbl-00058m-Vn for emacs-orgmode@gnu.org; Tue, 03 Jan 2012 22:33:46 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1RiHbk-0008IN-No for emacs-orgmode@gnu.org; Tue, 03 Jan 2012 22:33:45 -0500 Received: from 206-248-137-202.dsl.teksavvy.com ([206.248.137.202]:60705 helo=mercure.epsilon-ti.ca) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1RiHbk-0008IH-Hg for emacs-orgmode@gnu.org; Tue, 03 Jan 2012 22:33:44 -0500 In-Reply-To: <878vlont7e.fsf@altern.org> (Bastien's message of "Wed, 04 Jan 2012 02:37:41 +0100") List-Id: "General discussions about Org-mode." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org Sender: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org To: Bastien Cc: Bernt Hansen , emacs-orgmode@gnu.org, Carsten Dominik Bastien writes: > Hi Fran=C3=A7ois, >> Carsten Dominik writes: >>> Note that there is a million variables which are not referred to >>> in the manual - simply too many to mention them all. >> A million? You *always* exaggerate! :-) > Well, I counted more than 1070 variables... describing 5 of them=20 > per page would take 214 pages. Not something I'd like to read :) That's why I suggested an appendix. We search in them, more than we really read them. On the other hand, it would considerably augment the weight of a printed manual, and so, be more harmful to our forests. > Wrt documentation, Emacs is its own reference, by letting you access > everything with C-h v org-*. Emacs has impressive ways to offer its own documentation. Still a bit uneasy to use C-h v (or C-h f) on everything. M-x apropos org- RET is more handy and searchable, yet the documentation is likely limited to the first line of each docstring (so at least this convention for a complete sentence in the first line of a docstring). > Another point: there is a lot to do to improve the current docstrings > and the manual. This is a matter of 1) pulling from git, 2) modifying > the file, 3) run `C-x v =3D' in the buffer, 4) send the patch. [...] > If you're interested in improving this, please go ahead, I'd be > interested in getting something working along these lines. Oh, the problem is surely not the lack of interest, but the sore lack of free hours in a week, and the quantity of ways to occupy those rare hours already (something Org mode is tremendously helpful at organizing, by the way). Surely that given enough free time, I would just love to contribute. The truth is that I can only offer tiny crumbs. In any case, I'm saving your message and notes (who knows the future!). Fran=C3=A7ois