From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp0 ([2001:41d0:2:4a6f::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms0.migadu.com with LMTPS id mNTkML6zdmHcBgAAgWs5BA (envelope-from ) for ; Mon, 25 Oct 2021 15:40:14 +0200 Received: from aspmx1.migadu.com ([2001:41d0:2:4a6f::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp0 with LMTPS id oMujLL6zdmGLQAAA1q6Kng (envelope-from ) for ; Mon, 25 Oct 2021 13:40:14 +0000 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 11C15AF76 for ; Mon, 25 Oct 2021 15:40:14 +0200 (CEST) Received: from localhost ([::1]:51842 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1mf0Cx-00051f-U2 for larch@yhetil.org; Mon, 25 Oct 2021 09:40:11 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:46328) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1mf0CF-000512-4I for emacs-orgmode@gnu.org; Mon, 25 Oct 2021 09:39:27 -0400 Received: from mail-pl1-x62f.google.com ([2607:f8b0:4864:20::62f]:39743) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1mf0CC-0002UI-RT for emacs-orgmode@gnu.org; Mon, 25 Oct 2021 09:39:26 -0400 Received: by mail-pl1-x62f.google.com with SMTP id t21so7955793plr.6 for ; Mon, 25 Oct 2021 06:39:24 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112; h=from:to:cc:subject:in-reply-to:references:date:message-id :mime-version; bh=hATeSSnBVdgD0OULS9g9Gt+x5JI1xcKvIcyPjSzJ1ao=; b=DCQInyUbrRNATxfciXky7KdufbmQ15UM4X5d6maxiHnOpfzQI6zju8Flx1oe0+FpH2 hCjeeMpkdaR/RDZlhlnr7W6TsuYDcBvVN7btzmH2vpoQvVo7nztLvtRKW8B8AgLb1Psp embtfxaCs5r7Q/NGA2jf2+EyRs1N9oi1KKkXYx63V8wDbgmfgfk1CshAbgKoj/YxzMPE RM296C98D0kCvnm5QXQYoZULHzpUZxR90jwRuWEoEohg2Du9vOa7qgS4vLGeiTOzj6p3 hfkIqyUdFFBoy+NE4UC3KG1HKZUUicSdkKF3ewEJV/YMg/A/CORdQqiQSKicjNVMRzFJ fJEA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=x-gm-message-state:from:to:cc:subject:in-reply-to:references:date :message-id:mime-version; bh=hATeSSnBVdgD0OULS9g9Gt+x5JI1xcKvIcyPjSzJ1ao=; b=ovh+SSWXgQOlLqkFHqrE2usf42i4SKd6ZhAfgTtFqXzFlqf6c/mCN4ZpNUfc83xZ40 VzgNcAgBSHG+w+mMRtqop1/VIezreH88pvBvRaPYQExX0NRY7GIpjAqE2MzpRA6LLHRf Wzc/2dSntyREk6sD+P7PQ7txSnY6eL4eNxtKAwaXkhyC7VN2qdQSiqnPwrSTjRMT1yRJ 98nyIirTlV4f43CTaTc9vX0w/k2crPS7mcbu48Lm8Xv1dbsjdI64Zn2q/DT/6H0Ins04 T7pXcjeckce8UD67Ym5EHP3YAUXnmfk0i8ViVu/Y0Z0vV14j2F1a1DcgO7qMYuAOz7PS qDTQ== X-Gm-Message-State: AOAM533hi9WrOYjfCNsdMcnubICrJ0FeYBdQenqmR63b+wMHsrqLG5Tz r47UjVwVswEE8I3tKDBNC0I= X-Google-Smtp-Source: ABdhPJz99JYLXEG0yYw72PWblHDfzbUbrPFD16tIJQnCegGoRTJ4tZQ0p5eLyFwcAOHnOAFv7J/75w== X-Received: by 2002:a17:902:d488:b0:13f:165e:f491 with SMTP id c8-20020a170902d48800b0013f165ef491mr16842087plg.12.1635169163306; Mon, 25 Oct 2021 06:39:23 -0700 (PDT) Received: from localhost ([103.125.234.161]) by smtp.gmail.com with ESMTPSA id c6sm75150pfd.114.2021.10.25.06.39.22 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 25 Oct 2021 06:39:22 -0700 (PDT) From: Ihor Radchenko To: No Wayman Subject: Re: [BUG] [PATCH] org-archive.el: Fix checkdoc warnings [9.5 (9.5-g477f05 @ /home/n/.emacs.d/straight/build/org/)] In-Reply-To: <87lf3a3zaj.fsf@gmail.com> References: <87lf3a3zaj.fsf@gmail.com> Date: Mon, 25 Oct 2021 21:40:48 +0800 Message-ID: <87ilxl9q8v.fsf@localhost> MIME-Version: 1.0 Content-Type: text/plain Received-SPF: pass client-ip=2607:f8b0:4864:20::62f; envelope-from=yantar92@gmail.com; helo=mail-pl1-x62f.google.com X-Spam_score_int: -17 X-Spam_score: -1.8 X-Spam_bar: - X-Spam_report: (-1.8 / 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, FREEMAIL_ENVFROM_END_DIGIT=0.25, FREEMAIL_FROM=0.001, RCVD_IN_DNSWL_NONE=-0.0001, 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.23 Precedence: list List-Id: "General discussions about Org-mode." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Cc: emacs-orgmode@gnu.org Errors-To: emacs-orgmode-bounces+larch=yhetil.org@gnu.org Sender: "Emacs-orgmode" X-Migadu-Flow: FLOW_IN ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=yhetil.org; s=key1; t=1635169214; 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=hATeSSnBVdgD0OULS9g9Gt+x5JI1xcKvIcyPjSzJ1ao=; b=D2KcWoMF+0B2kpU9WUWLMGcgzkQP/2N5Mxo811OUvTUYqmK88MH98WdHRYTJMHJR42JZfS 1rM/jOxirtUuwnyCbF6rwKln1FjjFoCtSeMXxMp74UDriidBNviH9boOZZbXS5r9JtTBTc UiF7EDdCoXPBJbUW01TOztKbcuJvyEKtXZLDrPIpToeKjf0A0UdphqYbL5+uuWjYlwlj16 OYuw0HPyCmJWGSgfbS2j31OC3CR1M8nR5Gv1mOkj3Ygp6UTOs49TsP0yAY24HE0ZKL5E26 UpTG9VyuL9/Zspi9o7sFTJ1V+pWA6V4ctvrUuHOeZPU1hlim+ZBeMQnk/gvBbQ== ARC-Seal: i=1; s=key1; d=yhetil.org; t=1635169214; a=rsa-sha256; cv=none; b=Zaz3rU9AKUC9kbKlYMld2Xb6oHsNNBHAA43sek+wym7mC1x9N6a6IU1SX/zRxuvmbPj9dC +G35YAiRSJwAptDvaxdc3utaWVpLq+cHqVvRmzgNy42Iu+eadt0G+MQ3017CpBIUpybysx 7KH3RuT/olQlZuboWrB0EdlZWHAehK1554mX444+zjPkY0mgOWjaYaPwMKB4OQwVuyRCav idPD8UPx6xLSD4xHs+GDN+WJlFqDxepCY9VshodLlviQXFOLec3CRAQa9LVezNjY6gA2op eDJc37eXoYgVBkGHHrldvF6XrNbwD3UE4MOLQtgQhsbSB8mKruMgUwVFJpUTzQ== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=pass header.d=gmail.com header.s=20210112 header.b=DCQInyUb; dmarc=pass (policy=none) header.from=gmail.com; spf=pass (aspmx1.migadu.com: domain of emacs-orgmode-bounces@gnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom=emacs-orgmode-bounces@gnu.org X-Migadu-Spam-Score: -2.63 Authentication-Results: aspmx1.migadu.com; dkim=pass header.d=gmail.com header.s=20210112 header.b=DCQInyUb; dmarc=pass (policy=none) header.from=gmail.com; spf=pass (aspmx1.migadu.com: domain of emacs-orgmode-bounces@gnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom=emacs-orgmode-bounces@gnu.org X-Migadu-Queue-Id: 11C15AF76 X-Spam-Score: -2.63 X-Migadu-Scanner: scn0.migadu.com X-TUID: FLguqNpasInS No Wayman writes: > -With prefix ARG, check all children of current headline and offer tagging > -the children that do not contain any open TODO items." > +When called interactively with \\[universal-argument], or FIND-DONE is > +non-nil, check current headline's children and offer tagging for > +children which do not contain any open TODO items." This reads more confusing compared to the original version. Probably we can improve this docstring further and explain what prefix arg does better. Best, Ihor