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: Sun, 15 May 2022 17:00:25 +0200 Message-ID: References: <83pmkglcw3.fsf@gnu.org> <87a6bij4vx.fsf@gnus.org> 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="4914"; mail-complaints-to="usenet@ciao.gmane.io" Cc: Eli Zaretskii , 55408-done@debbugs.gnu.org To: Lars Ingebrigtsen Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Sun May 15 17:01:16 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 1nqFkA-000178-Eo for geb-bug-gnu-emacs@m.gmane-mx.org; Sun, 15 May 2022 17:01:14 +0200 Original-Received: from localhost ([::1]:44126 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1nqFk9-00042Y-Dg for geb-bug-gnu-emacs@m.gmane-mx.org; Sun, 15 May 2022 11:01:13 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:40888) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1nqFjy-00042G-LP for bug-gnu-emacs@gnu.org; Sun, 15 May 2022 11:01:02 -0400 Original-Received: from debbugs.gnu.org ([209.51.188.43]:56510) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1nqFjy-0004RY-Bp for bug-gnu-emacs@gnu.org; Sun, 15 May 2022 11:01:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1nqFjy-0007Qr-AR for bug-gnu-emacs@gnu.org; Sun, 15 May 2022 11:01:02 -0400 Resent-From: Stefan Kangas Original-Sender: "Debbugs-submit" Resent-To: bug-gnu-emacs@gnu.org Resent-Date: Sun, 15 May 2022 15:01:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: cc-closed 55408 X-GNU-PR-Package: emacs Mail-Followup-To: 55408@debbugs.gnu.org, stefan@marxist.se, stefan@marxist.se Original-Received: via spool by 55408-done@debbugs.gnu.org id=D55408.165262684428533 (code D ref 55408); Sun, 15 May 2022 15:01:02 +0000 Original-Received: (at 55408-done) by debbugs.gnu.org; 15 May 2022 15:00:44 +0000 Original-Received: from localhost ([127.0.0.1]:50407 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1nqFjf-0007Q9-VJ for submit@debbugs.gnu.org; Sun, 15 May 2022 11:00:44 -0400 Original-Received: from mail-pf1-f180.google.com ([209.85.210.180]:46602) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1nqFje-0007Pw-PG for 55408-done@debbugs.gnu.org; Sun, 15 May 2022 11:00:43 -0400 Original-Received: by mail-pf1-f180.google.com with SMTP id j6so11831011pfe.13 for <55408-done@debbugs.gnu.org>; Sun, 15 May 2022 08:00:42 -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:references:in-reply-to:from:date :message-id:subject:to:cc; bh=3vn4hTEd4+BnVQ0/4qKp/1hMTo9ANhqgpNkbcQnuq0I=; b=SfvdPTLj4A3xSFQ1biQdDPivPjS3VLJJ4aHIU69wslpyJm7tBoESzq6WbUzqFiz4+Y NRiHVgwj9MzxTi6Kie4kl3n16zN0pf9PpJ2GmUfIjztT+C7Tq/izra7SwspKIQg/VGRb EHEXm/m7wTXk/vfk0P5vGOvsdKQscz+/gaGa97aSmOTft4Sh7xAS5PDNVW4KvsixFOX4 1SHFc7DtAWiqeRHOuXW8xdRj6xhoU6Ez+FqJOx3H5SxADo2O3biuOhFgn6sCAWdXSlBW KV7BP88f12RbBbCknTR10JLvAJgtNjrc+fSRifpRe3Rxi/FKVc33c586QWrcp49miVM8 Cv7g== X-Gm-Message-State: AOAM532ziuBPl6XXfLQHB2lXCwptUPM8KfQfNvYokqOPRe1qGqD20u4e SgypW59FpfQ++m/9hfOTSK/ffqovK1x4Q9Dk3LkmiMuM X-Google-Smtp-Source: ABdhPJyt59IulGNIr9h+ZJ1xTKwW7jSE6gacF6MV63SWrALYUz6jNhYO0i3c4fmn6IunPdTKMwnLgzmSA1F3N7gCiB0= X-Received: by 2002:a05:6a00:2405:b0:4e1:5008:adcc with SMTP id z5-20020a056a00240500b004e15008adccmr13459362pfh.35.1652626836721; Sun, 15 May 2022 08:00:36 -0700 (PDT) In-Reply-To: <87a6bij4vx.fsf@gnus.org> 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:232320 Archived-At: Lars Ingebrigtsen writes: > Stefan Kangas writes: > > > The docstring of `package-update-all' currently says: "Interactively, > > QUERY is always true." AFAIU, this is short for "When called > > interactively," which is more clear but still not as clear as it could > > be. > > Yes, that could be clearer; please go ahead and alter. Done. > > In general, perhaps docstrings should prefer something like "When > > used as a command," instead of "When called interactively,". > > I'm not sure that's an improvement. Yes, we do use "command" with a > clear meaning in some parts (like in `describe-command'), but I think > "called interactively" is probably more immediately understandable to > most people who've used Emacs a bit. OK, I guess since neither you or Eli are too enthusiastic, we can just leave this as is. I'm therefore closing this bug. Thanks for considering the proposal.