From mboxrd@z Thu Jan 1 00:00:00 1970 From: Carsten Dominik Subject: Re: [Bug] Doc string for org-clock-into-drawer truncated? Date: Tue, 21 Jun 2011 09:49:53 +0200 Message-ID: <875E1ACA-B404-4783-95B3-3EAE52759E0C@gmail.com> References: <87sjr470yn.fsf@Rainer.invalid> Mime-Version: 1.0 (Apple Message framework v1084) Content-Type: text/plain; charset=windows-1252 Content-Transfer-Encoding: quoted-printable Return-path: Received: from eggs.gnu.org ([140.186.70.92]:36766) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1QYvih-0006SA-MB for emacs-orgmode@gnu.org; Tue, 21 Jun 2011 03:50:01 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1QYvig-0003A5-B3 for emacs-orgmode@gnu.org; Tue, 21 Jun 2011 03:49:59 -0400 Received: from mail-ew0-f41.google.com ([209.85.215.41]:60059) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1QYvif-00039h-TC for emacs-orgmode@gnu.org; Tue, 21 Jun 2011 03:49:58 -0400 Received: by ewy9 with SMTP id 9so1090917ewy.0 for ; Tue, 21 Jun 2011 00:49:56 -0700 (PDT) In-Reply-To: <87sjr470yn.fsf@Rainer.invalid> 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: Achim Gratz Cc: emacs-orgmode@gnu.org On Jun 20, 2011, at 9:32 PM, Achim Gratz wrote: >=20 > In org-clock.el, the following definition is found: >=20 > (defcustom org-clock-into-drawer org-log-into-drawer > "Should clocking info be wrapped into a drawer? > When t, clocking info will always be inserted into a :LOGBOOK: drawer. > If necessary, the drawer will be created. > When nil, the drawer will not be created, but used when present. > When an integer and the number of clocking entries in an item > reaches or exceeds this number, a drawer will be created. > When a string, it names the drawer to be used. >=20 > The default for this variable is the value of `org-log-into-drawer', > which see." > =85 >=20 > I can't make much sense of the last sentence which looks truncated. It means, please look at the variable org-log-into-drawer for more information. I have seen this idiom in Emacs in a number of places, so I assumed it is OK. >=20 > As an aside, while the value for org-log-into-drawer can be changed = for > a subtree by setting a property, this setting is not honored for > clocking in the same subtree, which will still use the value of > org-log-into-drawer in global or local scope or the LOGBOOK drawer, if > present. In org-clock.el: >=20 > (if org-clock-into-drawer > (let ((logbook > (if (stringp org-clock-into-drawer) > (concat ":" org-clock-into-drawer ":") > ":LOGBOOK:"))) >=20 > But no defun to check a property like that used for logging in org.el: >=20 > (defun org-log-into-drawer () > "Return the value of `org-log-into-drawer', but let properties = overrule. > If the current entry has or inherits a LOG_INTO_DRAWER property, it = will be > used instead of the default value." > (let ((p (org-entry-get nil "LOG_INTO_DRAWER" 'inherit))) > (cond > ((or (not p) (equal p "nil")) org-log-into-drawer) > ((equal p "t") "LOGBOOK") > (t p)))) >=20 > For symmetry it seems that one should be able to specify a property > CLOCK_INTO_DRAWER specifically for clocking or fall back onto LOG_INTO > DRAWER, just like the customization variables allow one to do. This does make sense, can you make a patch? - Carsten