From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp11.migadu.com ([2001:41d0:2:bcc0::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms5.migadu.com with LMTPS id KA7nIwBLWWNKLQAAbAwnHQ (envelope-from ) for ; Wed, 26 Oct 2022 16:58:08 +0200 Received: from aspmx1.migadu.com ([2001:41d0:2:bcc0::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp11.migadu.com with LMTPS id GEbsIwBLWWOsFgEA9RJhRA (envelope-from ) for ; Wed, 26 Oct 2022 16:58:08 +0200 Received: from lists.gnu.org (lists.gnu.org [209.51.188.17]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by aspmx1.migadu.com (Postfix) with ESMTPS id 01F4212726 for ; Wed, 26 Oct 2022 16:58:08 +0200 (CEST) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1onhnx-0003x1-Iz; Wed, 26 Oct 2022 10:54:53 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1onhnv-0003tz-F1 for emacs-orgmode@gnu.org; Wed, 26 Oct 2022 10:54:52 -0400 Received: from mx.flintfam.org ([107.191.44.89]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1onhnq-0006xY-5B for emacs-orgmode@gnu.org; Wed, 26 Oct 2022 10:54:51 -0400 Received: by mx.flintfam.org (Postfix, from userid 114) id 150441F594; Wed, 26 Oct 2022 14:54:45 +0000 (UTC) DKIM-Filter: OpenDKIM Filter v2.9.2 mx.flintfam.org 150441F594 Received: from hilbert.flintfam.org (unknown [129.93.161.217]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mx.flintfam.org (Postfix) with ESMTPSA id E12C01F54C for ; Wed, 26 Oct 2022 14:54:42 +0000 (UTC) DKIM-Filter: OpenDKIM Filter v2.9.2 mx.flintfam.org E12C01F54C DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=flintfam.org; s=mail; t=1666796083; bh=LFCZYPi37jVCCo2TppOZw1dUxwheUaYzVo3vtZKFyIc=; h=From:To:Subject:Date:From; b=SmsCjj2XeCrcl1oqDmU9nYtd9cJwexsxMNBKNhsP4zNzNdj8hMlF+doocMHnn+zbk 6B2tu6mmc+nxKC/rAoegnHhOhvognrGU/siZZ0JvG8ZgsdgFm6DtckLGkGfqILpxSp JvU7AtsbO2a3zJW/uvCP+3RS0rnSW3aJvMlEkmyY7jneLC1HAr1zY329YhORSw1Qk2 UIqvNGNQuGoBTTR0KK4MKQXO/Q/EBHdqy6WwxdoF5HiUHfW3rjELsPRIJTIC4V5Fe4 BJfq/DgnaRB8UxLIOY3nCnbFBMN1eJCTXxwo6/N+e/CLybrg8qtpMwthji3eeiCT6V X+vDn/llgvgCw== From: "Samuel W. Flint" To: "Org-Mode" Subject: [PATCH v2 2/2] doc/org-manual.org: Document org-clock-{in,out}-switch-to-state Date: Wed, 26 Oct 2022 09:54:42 -0500 Message-ID: <87czaed499.fsf@flintfam.org> MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable Received-SPF: pass client-ip=107.191.44.89; envelope-from=swflint+orgmode@flintfam.org; helo=mx.flintfam.org X-Spam_score_int: -20 X-Spam_score: -2.1 X-Spam_bar: -- X-Spam_report: (-2.1 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, SPF_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: emacs-orgmode@gnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: "General discussions about Org-mode." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: "Emacs-orgmode" Errors-To: emacs-orgmode-bounces+larch=yhetil.org@gnu.org X-Migadu-Flow: FLOW_IN X-Migadu-Country: US ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=yhetil.org; s=key1; t=1666796288; h=from:from:sender:sender:reply-to:subject:subject:date:date: message-id:message-id:to:to:cc:mime-version:mime-version: content-type:content-type: content-transfer-encoding:content-transfer-encoding:list-id:list-help: list-unsubscribe:list-subscribe:list-post:dkim-signature; bh=LFCZYPi37jVCCo2TppOZw1dUxwheUaYzVo3vtZKFyIc=; b=C5svnPXmWGVQp2KAyNfYPGBoswwJ0TzQ6PtlFOBIZV5FG6bbrk8tfmM+PpddwVVstZCHDn 76/XkBTTw2NIkV3UVXXOa1Ogu9UKASmmd/8LX5FZhFts1GpLUTgZD04vLG9lFJ1nXvv2It SdankZMklBnxWqgG7U+p0IL8eOfOkPF/zNop+VTnHRR9X4t37azvho+EROgmdIomqT0SbL Cx16bUaAsh9JBZMRm/0SxHJmMKGEnKlXHPFI9xZJnTYdVzuzzwZMEeLIp/IDUZDArMZUTC y/sBBPJTT1iLOXDbUWjQPpOGOiUanJuYFzcilW92+SyWCyvOkpaeewlz/DOyTA== ARC-Seal: i=1; s=key1; d=yhetil.org; t=1666796288; a=rsa-sha256; cv=none; b=CeaU16f5RJ1TvoaHZ1Ewy87k3B9M8cW/aj9ccvE4vQc0iNTs1MB+e0x/yk6TEdUhKYxTIk HkO/vSKEfy1pPCXvrPmkshas0VotY8wkKMNyU+JFC1AfwMD65oo27UDmrJ7EUqRV7CdhRc Mz6ylg3UvsMHOUIiEMkzJj6jkO8aTG/qH8QsEuO8R04ZEpQ99SVej7cVf2a/6q2j7yQI2W W0M8QMzCAShenz1xc9FnL7vjmBdVqi0zJ4EgbLk5sWx5hubqOPClIzArguko7bXjV4FbSN ixbVbLHZW6D1slrfb2s8Nv0JQRQITT6oi2mleE+G0zN7IktK1Yxkc3pyvH4XQg== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=pass header.d=flintfam.org header.s=mail header.b=SmsCjj2X; dmarc=none; spf=pass (aspmx1.migadu.com: domain of "emacs-orgmode-bounces+larch=yhetil.org@gnu.org" designates 209.51.188.17 as permitted sender) smtp.mailfrom="emacs-orgmode-bounces+larch=yhetil.org@gnu.org" X-Migadu-Spam-Score: -6.92 Authentication-Results: aspmx1.migadu.com; dkim=pass header.d=flintfam.org header.s=mail header.b=SmsCjj2X; dmarc=none; spf=pass (aspmx1.migadu.com: domain of "emacs-orgmode-bounces+larch=yhetil.org@gnu.org" designates 209.51.188.17 as permitted sender) smtp.mailfrom="emacs-orgmode-bounces+larch=yhetil.org@gnu.org" X-Migadu-Queue-Id: 01F4212726 X-Spam-Score: -6.92 X-Migadu-Scanner: scn0.migadu.com X-TUID: eDhMJt8TYMsr * doc/org-manual.org (Clocking commands): Document operation of org-clock-{in,out}-switch-to-state. --- doc/org-manual.org | 25 +++++++++++++++++++++++++ 1 file changed, 25 insertions(+) diff --git a/doc/org-manual.org b/doc/org-manual.org index ad584d7a5..95acf9170 100644 --- a/doc/org-manual.org +++ b/doc/org-manual.org @@ -6583,6 +6583,27 @@ about what to do with it. C-u C-u)}}} prefixes, force continuous clocking by starting the clock when the last clock stopped. =20 + #+vindex: org-clock-in-switch-to-state + The variable ~org-clock-in-switch-to-state~ controls how a current + task's TODO state is changed on clock-in. No change (a ~nil~) is + the default. A specific state may be forced with a string value. + Additionally, a function which takes a current state and returns + either a new state or ~nil~ for no change may be used. Finally, an + alist may be used to provide a mapping from state to state. + Consider the following example, where ~TODO~ becomes ~WORKING~, and + ~WAITING~ becomes ~WORKING~ on clock-in. + + #+begin_src emacs-lisp + (setf org-clock-in-switch-to-state '(("TODO" . "WORKING") + ("WAITING" . "WORKING"))) + #+end_src + + The + ~org-clock-in-next-state~ alist may be utilized by setting it to + ~org-clock-in-next-state-function~, or a custom function may be + used. This custom function should take the current state, and + return either a new state or ~nil~ to keep the current state. + #+cindex: @samp{CLOCK_MODELINE_TOTAL}, property #+cindex: @samp{LAST_REPEAT}, property #+vindex: org-clock-mode-line-total @@ -6618,6 +6639,10 @@ about what to do with it. timestamp[fn:: The corresponding in-buffer setting is: =3D#+STARTUP: lognoteclock-out=3D.]. =20 + #+vindex: org-clock-out-switch-to-state + The variable ~org-clock-out-switch-to-state~ may be configured + similarly to ~org-clock-in-switch-to-state~. +=20=20 - {{{kbd(C-c C-x C-x)}}} (~org-clock-in-last~) :: =20 #+kindex: C-c C-x C-x --=20 2.37.0 --=20 Samuel W. Flint 4096R/FA13D704 (F50D 862B 4F65 5943 A8C2 EF0E 86C9 3E7A FA13 D704) =CE=BBs.(s s) =CE=BBs.(s s) O< ascii ribbon campaign - stop html mail - www.asciiribbon.org