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 OPnrD6coVmN1rQAAbAwnHQ (envelope-from ) for ; Mon, 24 Oct 2022 07:54:47 +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 CNfyD6coVmO0VwAA9RJhRA (envelope-from ) for ; Mon, 24 Oct 2022 07:54:47 +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 09D7738143 for ; Mon, 24 Oct 2022 07:54:47 +0200 (CEST) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1omivk-0008FP-7C for larch@yhetil.org; Sun, 23 Oct 2022 17:54:52 -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 1omJFs-0005Vo-KK for emacs-orgmode@gnu.org; Sat, 22 Oct 2022 14:29:56 -0400 Received: from mx.flintfam.org ([2001:19f0:6401:1c4:5400:ff:fe4b:c898]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1omJFr-000825-1D for emacs-orgmode@gnu.org; Sat, 22 Oct 2022 14:29:56 -0400 Received: by mx.flintfam.org (Postfix, from userid 114) id 72C981F594; Sat, 22 Oct 2022 18:29:53 +0000 (UTC) DKIM-Filter: OpenDKIM Filter v2.9.2 mx.flintfam.org 72C981F594 Received: from landau.flintfam.org (162-210-5-149.lnk.ne.static.allophone.net [162.210.5.149]) (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 605941F561 for ; Sat, 22 Oct 2022 18:29:51 +0000 (UTC) DKIM-Filter: OpenDKIM Filter v2.9.2 mx.flintfam.org 605941F561 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=flintfam.org; s=mail; t=1666463391; bh=UgTN7/qB+U7LYSWWkf8N/J2g/kV+BB5cyn51ulOFDEo=; h=From:To:Subject:Date:From; b=Ok3is1M+4i7hYXKd0n6simeG71UAnkROPhsujyLBh0nFuc9VzrZVlV89nVJCkx+29 eRycA8TNlenopSIXJ283zfBuD05nvC8d5C24KOHwOpLjHG2Y852MqGtjuFGFULKGm6 GV3nsGzuP5KTfKddieCHkRhEQEtFMNCGq76hHaCcc0ErxcnWYs10i7f6XmUw9yMTNB IzHT+hth4kcLSsXaiBnGYs3Bc/F5uvpqKiceFF9sHoCqv6FS3VqZFiAupixUK1VZWc RLZOpp5cDIIhxyo0hM01KblgqjG5mR3Rd6aHuxcD2ytrCfuvUho4RoI5SgI6ewWzTQ pTAQn6bAxUXgA== From: "Samuel W. Flint" To: "Org-Mode" Subject: [PATCH 2/2] doc/org-manual.org: Document org-clock-{in,out}-switch-to-state Date: Sat, 22 Oct 2022 13:29:50 -0500 Message-ID: <87r0yzvhi9.fsf@flintfam.org> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/28.2 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable Received-SPF: pass client-ip=2001:19f0:6401:1c4:5400:ff:fe4b:c898; envelope-from=swflint+orgmode@flintfam.org; helo=mx.flintfam.org X-Spam_score_int: 12 X-Spam_score: 1.2 X-Spam_bar: + X-Spam_report: (1.2 / 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, RCVD_IN_SBL_CSS=3.335, SPF_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=no 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: , Errors-To: emacs-orgmode-bounces+larch=yhetil.org@gnu.org Sender: "Emacs-orgmode" 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=1666590887; 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=UgTN7/qB+U7LYSWWkf8N/J2g/kV+BB5cyn51ulOFDEo=; b=UvCsOsN1YE1vkj4IBJgVOSCmDOZlBvYwj+pImfT9Q7rF1Rz9tt/MX41AujWcso95d1ryLQ qkVp2xmUWOlMpeb/Wd+/ZqNUAZUQBE6xieZ500/jerLgOsK54T1UAW33pH7s8ftHrHm9b1 XjLoaAGOSG/dU05IwiXQQB/L+8L1VwdM9a9XZoTFIxGzH4t9iHWgsN/Iu5Vrjv+K2wZ0vn wxp70hOGRVY0x2SXaHCEa7rFzhIPR+6QcDSZR/577F0k5UH45V+39+uSLQVUpj1LzB4UNc rUK7JJ4HXpBVWYqdQY/2JgAtkayjihdk/Iy+QRtpNThvktu69woD45od0bA7Jw== ARC-Seal: i=1; s=key1; d=yhetil.org; t=1666590887; a=rsa-sha256; cv=none; b=QbVtBSxX+N5LBD+Y7hbXWJQjJPYzGDN8D2uLgknpmEAstEItAc02EIRWCJCr/LbCcKqBMS T2sNWoStQd9jJzbn2QgFBv3OUUkfWrE4qq/6wetybz8ln+VA7TdQa315rWggFuZ4hhQ99K SDuko67idGd4afVx6SD0NaLjqHwkiFyb05hoIWx+uMh5WafNsQNDDauHPONzxy5Oj9y5Hu supCu8fYqcDF/hYlPRlER4eZ6y27pXF7FapCgP4I5rAI2amzTSrTUsTugE8Pm2f55kJbRF 6cTlCkbC7CVI3pBFOO9FkrtpYAUCw4HKg2A2NL4AQcKn1vaXj4Dmp5I/QPjyTg== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=pass header.d=flintfam.org header.s=mail header.b=Ok3is1M+; 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.20 Authentication-Results: aspmx1.migadu.com; dkim=pass header.d=flintfam.org header.s=mail header.b=Ok3is1M+; 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: 09D7738143 X-Spam-Score: -6.20 X-Migadu-Scanner: scn0.migadu.com X-TUID: nc6nJtDOKPQ6 * doc/org-manual.org (Clocking commands): Document operation of org-clock-{in,out}-switch-to-state, org-clock-{in,out}-next-state, and org-clock-{in,out}-next-state-function. --- doc/org-manual.org | 22 ++++++++++++++++++++++ 1 file changed, 22 insertions(+) diff --git a/doc/org-manual.org b/doc/org-manual.org index ad584d7a5..600690da2 100644 --- a/doc/org-manual.org +++ b/doc/org-manual.org @@ -6583,6 +6583,17 @@ 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 + #+vindex: org-clock-in-next-state + #+findex: org-clock-in-next-state-function + The variable ~org-clock-in-switch-to-state~ controls if and how a + current task's TODO state is changed. No change (a ~nil~) is the + default. A specific state may be forced with a string value. 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 +6629,17 @@ 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 + #+vindex: org-clock-out-next-state + #+findex: org-clock-out-next-state-function + The variable ~org-clock-out-switch-to-state~ controls if and how a + current task's TODO state is changed. No change (a ~nil~) is the + default. A specific state may be forced with a string value. The + ~org-clock-out-next-state~ alist may be utilized by setting it to + ~org-clock-out-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. + - {{{kbd(C-c C-x C-x)}}} (~org-clock-in-last~) :: =20 #+kindex: C-c C-x C-x --=20 2.37.3 --=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