From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp12.migadu.com ([2001:41d0:8:6d80::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms5.migadu.com with LMTPS id KG3yInVfVmNgXwAAbAwnHQ (envelope-from ) for ; Mon, 24 Oct 2022 11:48:37 +0200 Received: from aspmx1.migadu.com ([2001:41d0:8:6d80::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp12.migadu.com with LMTPS id WDzkInVfVmNlFwEAauVa8A (envelope-from ) for ; Mon, 24 Oct 2022 11:48:37 +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 087378ACA for ; Mon, 24 Oct 2022 11:48:37 +0200 (CEST) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1omtWP-0000sk-B9; Mon, 24 Oct 2022 05:13:25 -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 1omtWK-0000pk-UO for emacs-orgmode@gnu.org; Mon, 24 Oct 2022 05:13:22 -0400 Received: from mout02.posteo.de ([185.67.36.66]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1omtWJ-0000I4-28 for emacs-orgmode@gnu.org; Mon, 24 Oct 2022 05:13:20 -0400 Received: from submission (posteo.de [185.67.36.169]) by mout02.posteo.de (Postfix) with ESMTPS id 15F66240106 for ; Mon, 24 Oct 2022 11:13:14 +0200 (CEST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=posteo.net; s=2017; t=1666602797; bh=NwZG0GQrEZE1epB9WbQjSgrgj9PGxBJjAcMD3GZsa2Y=; h=From:To:Cc:Subject:Date:From; b=iA4BVWkn5GgJ1usrMNPbWmpf53qkzKAvuQVmcYeJtxRLS36XsnFgJ7ZQ0COS2bEHz OQfn5BBYjwNZgIWy0wBTe9mXC1vvjo1W9Moq8r9WDPwgsI6zjAqY9KWb1xwZ94Tvyk bxdv/zhr84yJUUUYFAveULSozHizLBrEWU5kUrHnxLkEtHQrolJY1x3k5eIDcFltWQ ZxAY4fn3X4KgYL0Z6Qcag5KiprveCICcIiKO/xFQ+XYM20iKaLuLGwvgFtxj4q2aIF h9l+/fdEj7k2hAKsHsw4xpeiN7b0y8Ps2/NBlTR1yoq7ap70bPAJGJMOpWD6fxWXld x2974rPzwwMgg== Received: from customer (localhost [127.0.0.1]) by submission (posteo.de) with ESMTPSA id 4Mwq9j0Kt3z9rxS; Mon, 24 Oct 2022 11:13:12 +0200 (CEST) From: Ihor Radchenko To: "Samuel W. Flint" Cc: Org-Mode Subject: Re: [PATCH 2/2] doc/org-manual.org: Document org-clock-{in,out}-switch-to-state In-Reply-To: <87r0yzvhi9.fsf@flintfam.org> References: <87r0yzvhi9.fsf@flintfam.org> Date: Mon, 24 Oct 2022 09:13:55 +0000 Message-ID: <87eduxporw.fsf@localhost> MIME-Version: 1.0 Content-Type: text/plain Received-SPF: pass client-ip=185.67.36.66; envelope-from=yantar92@posteo.net; helo=mout02.posteo.de X-Spam_score_int: -43 X-Spam_score: -4.4 X-Spam_bar: ---- X-Spam_report: (-4.4 / 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_DNSWL_MED=-2.3, RCVD_IN_MSPIKE_H2=-0.001, 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=1666604917; h=from:from:sender:sender:reply-to:subject:subject:date:date: message-id:message-id:to:to:cc:cc:mime-version:mime-version: content-type:content-type:in-reply-to:in-reply-to: references:references:list-id:list-help:list-unsubscribe: list-subscribe:list-post:dkim-signature; bh=M1N0FHLjzO5QZYuTFLzpqALyv7Ka3xWcJoFW6HxnXLU=; b=Q8R7JL3VjfvrVp/tyOPG5z+hPjE88BzWPyFNn6H+4+NTQ5PF5sdrYRIUBjJxeD266qvGAT HRFU+S4TDF3b/CLyqE5AgMbSgwpl+5cLY7Y5ieFS293unN5mJPBv1LOl6P81KV0yyQZTTV 57kMOe9hdP6u4KHHBs/D+K5Lp/S7qoLFHqQovFnAUCtYkkW0G7qdeIFUaYJMGtJtw20hY0 l9NgiywQy2I0JxB2J64HQPhywMOCn8wfMQmybw4XHJrskIvZVmF8k5zOIzE85wZDBOROfl G7PRgh2Gi0HTEeAvumKAJj8g7df9cY6W0SgfbVHEtrNnmh/ajfav9JiHLlynjw== ARC-Seal: i=1; s=key1; d=yhetil.org; t=1666604917; a=rsa-sha256; cv=none; b=hcXst1i9dm7elQ71+n422Y3q+wdrBVlzhmW5ISg2JoV7OifUephE88obLF3rBGJKOZOTWD r6s/jdDJH5CbCDTYwPSpODchspnLNse0nTjzfRsjYv3OdqLK2K4D2Wx4NaVGCxwQFRY9uM 8caiCUk9U6OOJm2+YRJ96WD8GP7H3/GwgTXfvb4eNs2f0dv2Kmviye3nm6J64dcSlxxJVK WA18eEnvUmdihwDMhuMutda/PWuFopFxdJFCtmPUxjPcioyFN9QjCXT4D9OPo07XGqzV90 NB8ffcGKXYnwKhKVSQzYM8StNMjw4uy9jLx8bFmnMiZt1jQH/Ex1HEIiDp4Bmg== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=pass header.d=posteo.net header.s=2017 header.b=iA4BVWkn; dmarc=pass (policy=none) header.from=posteo.net; 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: -1.90 Authentication-Results: aspmx1.migadu.com; dkim=pass header.d=posteo.net header.s=2017 header.b=iA4BVWkn; dmarc=pass (policy=none) header.from=posteo.net; 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: 087378ACA X-Spam-Score: -1.90 X-Migadu-Scanner: scn1.migadu.com X-TUID: FAEzaiXR61Ns "Samuel W. Flint" writes: > + #+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. First of all, thanks for the patch! However, it is not clear for me what is the purpose of this new feature (even after reading the proposed patch to the manual). Could you please explain in simple words when your new feature can be useful? -- Ihor Radchenko // yantar92, Org mode contributor, Learn more about Org mode at . Support Org development at , or support my work at