From mboxrd@z Thu Jan 1 00:00:00 1970 From: Achim Gratz Subject: [Bug] Doc string for org-clock-into-drawer truncated? Date: Mon, 20 Jun 2011 21:32:48 +0200 Message-ID: <87sjr470yn.fsf@Rainer.invalid> Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit Return-path: Received: from eggs.gnu.org ([140.186.70.92]:47153) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1QYkDZ-0006Nm-Kw for emacs-orgmode@gnu.org; Mon, 20 Jun 2011 15:33:06 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1QYkDX-0004lE-C6 for emacs-orgmode@gnu.org; Mon, 20 Jun 2011 15:33:05 -0400 Received: from lo.gmane.org ([80.91.229.12]:50763) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1QYkDW-0004lA-Sa for emacs-orgmode@gnu.org; Mon, 20 Jun 2011 15:33:03 -0400 Received: from list by lo.gmane.org with local (Exim 4.69) (envelope-from ) id 1QYkDV-00038i-EN for emacs-orgmode@gnu.org; Mon, 20 Jun 2011 21:33:01 +0200 Received: from p57aadce8.dip.t-dialin.net ([87.170.220.232]) by main.gmane.org with esmtp (Gmexim 0.1 (Debian)) id 1AlnuQ-0007hv-00 for ; Mon, 20 Jun 2011 21:33:01 +0200 Received: from Stromeko by p57aadce8.dip.t-dialin.net with local (Gmexim 0.1 (Debian)) id 1AlnuQ-0007hv-00 for ; Mon, 20 Jun 2011 21:33:01 +0200 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: emacs-orgmode@gnu.org In org-clock.el, the following definition is found: (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. The default for this variable is the value of `org-log-into-drawer', which see." … I can't make much sense of the last sentence which looks truncated. 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: (if org-clock-into-drawer (let ((logbook (if (stringp org-clock-into-drawer) (concat ":" org-clock-into-drawer ":") ":LOGBOOK:"))) But no defun to check a property like that used for logging in org.el: (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)))) 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. Regards, Achim. -- +<[Q+ Matrix-12 WAVE#46+305 Neuron microQkb Andromeda XTk Blofeld]>+ Wavetables for the Waldorf Blofeld: http://Synth.Stromeko.net/Downloads.html#BlofeldUserWavetables