From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Stefan Kangas Newsgroups: gmane.emacs.bugs Subject: bug#55408: Explain the word "interactively" in the Emacs Manual Date: Sat, 14 May 2022 10:16:06 +0200 Message-ID: Mime-Version: 1.0 Content-Type: text/plain; charset="UTF-8" Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="25199"; mail-complaints-to="usenet@ciao.gmane.io" To: 55408@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Sat May 14 10:17:15 2022 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane-mx.org Original-Received: from lists.gnu.org ([209.51.188.17]) by ciao.gmane.io with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1npmxf-0006Oa-1I for geb-bug-gnu-emacs@m.gmane-mx.org; Sat, 14 May 2022 10:17:15 +0200 Original-Received: from localhost ([::1]:54500 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1npmxd-0007o7-Ep for geb-bug-gnu-emacs@m.gmane-mx.org; Sat, 14 May 2022 04:17:13 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:46052) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1npmxS-0007nx-V1 for bug-gnu-emacs@gnu.org; Sat, 14 May 2022 04:17:02 -0400 Original-Received: from debbugs.gnu.org ([209.51.188.43]:51802) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1npmxS-0003IY-MR for bug-gnu-emacs@gnu.org; Sat, 14 May 2022 04:17:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1npmxS-0005ZB-Fz for bug-gnu-emacs@gnu.org; Sat, 14 May 2022 04:17:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Stefan Kangas Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sat, 14 May 2022 08:17:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 55408 X-GNU-PR-Package: emacs X-Debbugs-Original-To: bug-gnu-emacs@gnu.org Original-Received: via spool by submit@debbugs.gnu.org id=B.165251618821340 (code B ref -1); Sat, 14 May 2022 08:17:02 +0000 Original-Received: (at submit) by debbugs.gnu.org; 14 May 2022 08:16:28 +0000 Original-Received: from localhost ([127.0.0.1]:45698 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1npmwt-0005Y8-UW for submit@debbugs.gnu.org; Sat, 14 May 2022 04:16:28 -0400 Original-Received: from lists.gnu.org ([209.51.188.17]:35108) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1npmwq-0005Xv-62 for submit@debbugs.gnu.org; Sat, 14 May 2022 04:16:26 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:45962) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1npmwm-0007XG-LR for bug-gnu-emacs@gnu.org; Sat, 14 May 2022 04:16:23 -0400 Original-Received: from mail-pj1-f51.google.com ([209.85.216.51]:39589) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1npmwl-00039p-18 for bug-gnu-emacs@gnu.org; Sat, 14 May 2022 04:16:20 -0400 Original-Received: by mail-pj1-f51.google.com with SMTP id a15-20020a17090ad80f00b001dc2e23ad84so12799161pjv.4 for ; Sat, 14 May 2022 01:16:18 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=x-gm-message-state:mime-version:from:date:message-id:subject:to; bh=YtfvRFYIgb28IYgg34+jbizblexbXHasr9+Xj1/BHU0=; b=sgmqhJbxWvEsqqAw9nTzpvfrLfuHRWrFJ04hw1GYqyueFtTCyY2i0XMjJ8QvqHov1D LfBt7Q6qUGvocthKpdngdOD4aZCROsfzdlliG8kANw1fIBElhpuMOgQ6KmiW2JgBPCdP U639dfy0sIwaopu8ZlYdXBeqA0MLakCLNe1SmF7UXcbE3YpfdzQ40O1nPGkFL7+n/OcU ss597zVCh6DWDxTgWeMNWEdfmqC82dd4zda9F6hh302hrkDaRO8JxD4CeXa8uoyu1NSY EGy3JVmPAJdkYa6xVFKr3Ad4iqJUfqyB4fjMpmnpCqnZcse1FzVvvAv5NgD80lxbal2N dJRQ== X-Gm-Message-State: AOAM532ugGV3+XJNZ4VndYp1I/ZAvDebhvzGiHXciHsYBQtivAQD1IjR YF4CFMSaWgA+oyiUgYWzI/18gaqleJNabfon82+TxR76FcI= X-Google-Smtp-Source: ABdhPJx9NrSwlP2NIHuIqxExHg+Rn+Z0jU/Tnn7FsdByWYJyYcgrnCItujlj12X/yOOetHSHFAuv1MPGVIW6J6njM4w= X-Received: by 2002:a17:90a:ba15:b0:1cb:be7d:bbca with SMTP id s21-20020a17090aba1500b001cbbe7dbbcamr19832630pjr.143.1652516177674; Sat, 14 May 2022 01:16:17 -0700 (PDT) Received-SPF: pass client-ip=209.85.216.51; envelope-from=stefankangas@gmail.com; helo=mail-pj1-f51.google.com X-Spam_score_int: -13 X-Spam_score: -1.4 X-Spam_bar: - X-Spam_report: (-1.4 / 5.0 requ) BAYES_00=-1.9, FREEMAIL_FORGED_FROMDOMAIN=0.249, FREEMAIL_FROM=0.001, HEADER_FROM_DIFFERENT_DOMAINS=0.249, RCVD_IN_DNSWL_NONE=-0.0001, RCVD_IN_MSPIKE_H3=0.001, RCVD_IN_MSPIKE_WL=0.001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001, T_SCC_BODY_TEXT_LINE=-0.01 autolearn=no autolearn_force=no X-Spam_action: no action X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-BeenThere: bug-gnu-emacs@gnu.org List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Original-Sender: "bug-gnu-emacs" Xref: news.gmane.io gmane.emacs.bugs:232221 Archived-At: Severity: wishlist It would be useful if the word "interactively" was explained in the Emacs manual, and if there was an index entry for it. Otherwise, it might be hard to understand a docstring like this one for a new user: (defun package-update-all (&optional query) "Upgrade all packages. If QUERY, ask the user before updating packages. Interactively, QUERY is always true." Perhaps it should be explained in `(emacs) Commands' and/or in the Glossary?