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#30085: 25.2: Documentation for cua-rectangle-mark-mode Date: Mon, 26 Oct 2020 18:39:53 -0700 Message-ID: References: <831rv98chu.fsf@gnu.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="22681"; mail-complaints-to="usenet@ciao.gmane.io" User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/28.0.50 (gnu/linux) Cc: 30085@debbugs.gnu.org, boruch_baum@gmx.com, storm@cua.dk To: Eli Zaretskii Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Tue Oct 27 02:41:10 2020 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 1kXDz3-0005mC-En for geb-bug-gnu-emacs@m.gmane-mx.org; Tue, 27 Oct 2020 02:41:09 +0100 Original-Received: from localhost ([::1]:41584 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1kXDz2-0007rN-0e for geb-bug-gnu-emacs@m.gmane-mx.org; Mon, 26 Oct 2020 21:41:08 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:54166) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1kXDyw-0007r2-RC for bug-gnu-emacs@gnu.org; Mon, 26 Oct 2020 21:41:02 -0400 Original-Received: from debbugs.gnu.org ([209.51.188.43]:58886) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1kXDyw-0007NV-I0 for bug-gnu-emacs@gnu.org; Mon, 26 Oct 2020 21:41:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1kXDyw-00078n-FN for bug-gnu-emacs@gnu.org; Mon, 26 Oct 2020 21:41: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: Tue, 27 Oct 2020 01:41:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 30085 X-GNU-PR-Package: emacs Original-Received: via spool by 30085-submit@debbugs.gnu.org id=B30085.160376280227354 (code B ref 30085); Tue, 27 Oct 2020 01:41:02 +0000 Original-Received: (at 30085) by debbugs.gnu.org; 27 Oct 2020 01:40:02 +0000 Original-Received: from localhost ([127.0.0.1]:42199 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1kXDxx-000774-TN for submit@debbugs.gnu.org; Mon, 26 Oct 2020 21:40:02 -0400 Original-Received: from mail-ed1-f52.google.com ([209.85.208.52]:45048) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1kXDxv-00076l-Ga for 30085@debbugs.gnu.org; Mon, 26 Oct 2020 21:39:59 -0400 Original-Received: by mail-ed1-f52.google.com with SMTP id t20so11965008edr.11 for <30085@debbugs.gnu.org>; Mon, 26 Oct 2020 18:39:59 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:in-reply-to:references:user-agent :mime-version:date:message-id:subject:to:cc; bh=nqGi49PtSvPlak4yov8tuQ8pQBsQ8ikEwfDfzQtQUaI=; b=npW+B+Qa/wFAK6wLPSWgyMrQ5+UYHciIl0+QVObSWj/KP2FfIOkmEwRNsUDCob+lNU 4l8XxpplZNqdcxi5/v1wSC4dtQcydx9utUXzWV2Q9P091HeZXIEQSQT9KpkubqBFEwWV lpklUfwo48718xoOdNfpyzdhOcB/6PllQU2/aXhJW2o8fXyrgiXbniNZkSJZp0JUORlJ k3IEKUBBA4IF4pE12a+HlSLpOcw2/ZKRVzUQ1dDkRz+rUkJ9GVUGgGvkR0R5ecJgQlJY bickzRpfma9vcJ16hZYhxfRYzDvE3EtDda1XZuQoII2Uvo574ECUusDnHZT1SRqLGN5Y OYRg== X-Gm-Message-State: AOAM5315bIXhC3vmTHoP0YgiI9/IUwKbsAhqz4TFqkJKLL/F6oAzNNVa xTfSxhFYuRzBd0o9jXJ31/XkdPwBfDErE4wY64c= X-Google-Smtp-Source: ABdhPJxuG4aHCMIMp1v6Nm8ofTvK3mAdzKN2QN/xkfk8vpF6vd9Udl8w6PSgKYuZJKWitzbXk49Qo2dYjbPcIRJQb2E= X-Received: by 2002:a05:6402:1201:: with SMTP id c1mr18943229edw.210.1603762793768; Mon, 26 Oct 2020 18:39:53 -0700 (PDT) Original-Received: from 753933720722 named unknown by gmailapi.google.com with HTTPREST; Mon, 26 Oct 2020 18:39:53 -0700 In-Reply-To: <831rv98chu.fsf@gnu.org> (Eli Zaretskii's message of "Sat, 19 Oct 2019 09:39:57 +0300") 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:191694 Archived-At: Eli Zaretskii writes: > If Kim doesn't respond, as he didn't back then, I suggest you use your > best judgment to retain whatever seems useful from this patch. > > Internal functions indeed don't need to be documented, but if the doc > string makes a significant difference in how easy it is to understand > what the function does, including a doc string can only help future > maintenance. So I finally had a look and pushed the relevant documentation changes. In effect large parts of the patch was converting existing comments into docstrings. They aren't the most beautiful in all cases, but definitely better than nothing.