From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp12.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 GHfWDQq5VmPijAAAbAwnHQ (envelope-from ) for ; Mon, 24 Oct 2022 18:10:50 +0200 Received: from aspmx1.migadu.com ([2001:41d0:2:bcc0::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp12.migadu.com with LMTPS id +IbwDQq5VmMzJwEAauVa8A (envelope-from ) for ; Mon, 24 Oct 2022 18:10:50 +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 2EEFB13CCE for ; Mon, 24 Oct 2022 18:10:49 +0200 (CEST) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1omyEF-0001IM-4B; Mon, 24 Oct 2022 10:14:59 -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 1omyE0-0001Dl-A7 for emacs-orgmode@gnu.org; Mon, 24 Oct 2022 10:14:46 -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 1omyDx-0003td-LA for emacs-orgmode@gnu.org; Mon, 24 Oct 2022 10:14:43 -0400 Received: by mx.flintfam.org (Postfix, from userid 114) id 282181F585; Mon, 24 Oct 2022 14:14:26 +0000 (UTC) DKIM-Filter: OpenDKIM Filter v2.9.2 mx.flintfam.org 282181F585 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 CC83B1F561; Mon, 24 Oct 2022 14:14:23 +0000 (UTC) DKIM-Filter: OpenDKIM Filter v2.9.2 mx.flintfam.org CC83B1F561 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=flintfam.org; s=mail; t=1666620864; bh=+k5TNYimKba3m5UgQDkQjjd4kjEL0bOY4mBOdqsFhzA=; h=From:To:Cc:Subject:References:Date:In-Reply-To:From; b=osXd8WPnumDKUsltwUlGBZtMPWle67n8gryXvaWcJ3/L5Hs7vE2byzma+qirArcVg d85i7l4o62BZpBPlZ+78HMEpL/F2nr8lJs5JZ4v/yhDQ2PoBsG3+smm7UlDOkJwdxd MmWa3oc0t6Ouj7BAd0ddt1nnseM8NVchIf10mqNnq9H8drjfkkgJhhAGsTL3pXlhz3 UEQzeluDz4VfPU3D7FoOyunmg1LAhkIguVQPsy4HAit7Wde9u6EMuZKBW069Gi+3sT C4mIbNJgOyK6yXQ+Hni9T+G9+4MWpQVLG+fc89ffvnedKWmdeyag/rBnVICa0X2YwW xSnWBzN+nGa2w== From: "Samuel W. Flint" To: Ihor Radchenko Cc: "Samuel W. Flint" , Org-Mode Subject: Re: [PATCH 2/2] doc/org-manual.org: Document org-clock-{in,out}-switch-to-state References: <87r0yzvhi9.fsf@flintfam.org> <87eduxporw.fsf@localhost> Autocrypt: addr=swflint@flintfam.org; prefer-encrypt=mutual; keydata= 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 AMk0tA== Date: Mon, 24 Oct 2022 09:14:23 -0500 In-Reply-To: <87eduxporw.fsf@localhost> (Ihor Radchenko's message of "Mon, 24 Oct 2022 09:13:55 +0000") Message-ID: <874jvtnwao.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=107.191.44.89; envelope-from=swflint@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=1666627850; 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: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references:list-id:list-help: list-unsubscribe:list-subscribe:list-post:dkim-signature:autocrypt:autocrypt; bh=+k5TNYimKba3m5UgQDkQjjd4kjEL0bOY4mBOdqsFhzA=; b=rJFeLroJm7+djsoYm2O0zlBS4HYef2HA9BHmtrxFz7oToGLHV7CWQSr6D2hmP+Mli4IzcP 39nZ9YtqfaibparJDZAZmEh9eNokf82OIav5/GfuMDMP/YsdqXxEZfrHNDrTThV43W/wsa zyGnM51PvEnh6GkA6VeKJJ6CgtebvplsjLmx9FvLRvrMRv/IfKq2ygyxS+RndCqOr3mNl7 OGMgYDa/PT2pmF/EUah5yaRZm6FIA2Y4eQu74n0kpVe1vZogGx3kqRJpseoeSlCsFEJdgL TeK3ik+uyhnWXl8wsET4Zfjzr58Pt3oBEOw2sWL14uprShNGb2PHbED1nQ8Gxg== ARC-Seal: i=1; s=key1; d=yhetil.org; t=1666627850; a=rsa-sha256; cv=none; b=JQ9RYBrJiixOse5OEKd9mKeF+RihSinT5pyFlio1EVvpEWsgmbSIzjAL8acPhVCO6QMRwm xu/gYiTm4/8oV8nTAnx/rwCvvpqscpp+N/th/r+GvGfgaJDwAaj+0j3HP6fCMegs+jxZip 7DLqq2OxFULN7YHG+lRnUBhildciHKNm01MfbX6eIAecUghw69jl4lsyulRDlxOyTRXHTo a7M4j1yM1kKac7bNLYOdBUTL+TpAKl4Gpcndqmwz8Etq5KIreNACvFBw2przAEVQF20y9t GBxeb/N1K8YzND8e6S14aSmNhbEhlhTqSjUtpsaLRc0WIoPHOGNH2ofU7HshnQ== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=pass header.d=flintfam.org header.s=mail header.b=osXd8WPn; 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: -7.41 Authentication-Results: aspmx1.migadu.com; dkim=pass header.d=flintfam.org header.s=mail header.b=osXd8WPn; 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: 2EEFB13CCE X-Spam-Score: -7.41 X-Migadu-Scanner: scn0.migadu.com X-TUID: p+PTR6tditxT >>>>> Ihor Radchenko writes: IR> "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. IR> First of all, thanks for the patch! IR> However, it is not clear for me what is the purpose of this new fea= ture IR> (even after reading the proposed patch to the manual). IR> Could you please explain in simple words when your new feature can = be IR> useful? The variable `org-clock-in-switch-to-state` can be really handy, however, it wasn't documented in the manual which made discovery somewhat difficult. The manual patch documents the variable, as well as a new variable exposed through customize to describe how states should change on clock-in/clock-out. This means that instead of having to write a custom function to do this, it's provided and exposed through customize and thus should be more discoverable and hopefully usable. Patch 1/2 provides the implementation. Consider, for example, the following settings: (setf org-clock-in-switch-to-state 'org-clock-in-next-state-function org-clock-in-next-state '(("TODO" . "WORKING") ("WAITING" . "WORKING"))) And the following heading: * TODO Do a thing When clocking in, it will become: * WORKING Do a thing On the next clock-in, it will stay at "WORKING". Consider instead: * WAITING Waiting to do a thing On clock-in to this heading, it becomes * WORKING Waiting to do a thing This can be applied similarly for org-clock-out, though I'm not sure how useful that will be. hth, Sam --=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