From unknown Fri Jun 20 07:09:52 2025 Content-Disposition: inline Content-Transfer-Encoding: quoted-printable MIME-Version: 1.0 X-Mailer: MIME-tools 5.509 (Entity 5.509) Content-Type: text/plain; charset=utf-8 From: bug#35019 <35019@debbugs.gnu.org> To: bug#35019 <35019@debbugs.gnu.org> Subject: Status: 27.0.50; Incomplete docstring for vc-version-diff and vc-version-ediff Reply-To: bug#35019 <35019@debbugs.gnu.org> Date: Fri, 20 Jun 2025 14:09:52 +0000 retitle 35019 27.0.50; Incomplete docstring for vc-version-diff and vc-vers= ion-ediff reassign 35019 emacs submitter 35019 Philipp Stephani severity 35019 minor thanks From debbugs-submit-bounces@debbugs.gnu.org Wed Mar 27 08:15:23 2019 Received: (at submit) by debbugs.gnu.org; 27 Mar 2019 12:15:23 +0000 Received: from localhost ([127.0.0.1]:60934 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1h97Sl-0001dp-0c for submit@debbugs.gnu.org; Wed, 27 Mar 2019 08:15:23 -0400 Received: from eggs.gnu.org ([209.51.188.92]:50984) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1h97Sj-0001dc-3V for submit@debbugs.gnu.org; Wed, 27 Mar 2019 08:15:21 -0400 Received: from lists.gnu.org ([209.51.188.17]:38655) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1h97Sc-00071V-6d for submit@debbugs.gnu.org; Wed, 27 Mar 2019 08:15:14 -0400 Received: from eggs.gnu.org ([209.51.188.92]:37131) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1h97Sa-0001do-MN for bug-gnu-emacs@gnu.org; Wed, 27 Mar 2019 08:15:13 -0400 X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on eggs.gnu.org X-Spam-Level: * X-Spam-Status: No, score=1.1 required=5.0 tests=BAYES_50, FREEMAIL_ENVFROM_END_DIGIT,FREEMAIL_FROM,URIBL_BLOCKED autolearn=disabled version=3.3.2 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1h97SZ-0006x2-BR for bug-gnu-emacs@gnu.org; Wed, 27 Mar 2019 08:15:12 -0400 Received: from mail-wr1-x42d.google.com ([2a00:1450:4864:20::42d]:35982) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1h97SY-0006sl-Uv for bug-gnu-emacs@gnu.org; Wed, 27 Mar 2019 08:15:11 -0400 Received: by mail-wr1-x42d.google.com with SMTP id y13so600238wrd.3 for ; Wed, 27 Mar 2019 05:15:10 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=from:to:subject:date:message-id:mime-version :content-transfer-encoding; bh=0k5In72WW64776/QNv66nZ+J0PeYCYSLJxEPBTkA5yY=; b=dzhLnM6Rd2ogvbYpuW/7Rr56R93SdIJK980Puy7AfQhu56vAHvLVF9NnWiZkH65dfh 4iWX48JyMdGwnLWgkW3E3d+tSxDasBkZ/aAhzb/wYP1dQe98iMAeM/h8aTiSzsGZpBLg O6kG5jpnM61smTHAyPNu/rCU/dJ1nwCk5JdZXwdRozf3m5fRAKn/ZRofclAUNcL2aTWk hdLyv3/LMDsfScKBWguZPd4K0WIig5ouzFD/+OPf6WMOEh6eLsDhZCYevWuIa84/U6wv /lACc82JfpMiP3xjfPDPwn868ExXnNbpwZQhG94FfIdkj+CiJQ0H1CvEcYJOaDIsxr+Q ARIA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:subject:date:message-id:mime-version :content-transfer-encoding; bh=0k5In72WW64776/QNv66nZ+J0PeYCYSLJxEPBTkA5yY=; b=eqFmSC4x1+tuRrsbKOR/CThvlg7ZTOc3UeCErOWmz0wiugStS30kipi7DvsT8H5fKA LnYEd4Yirgi9OLlipWL+nff7znbeGE1gero5EkLDCXYyXi9VjbEf4cQ9tAyV7Hi8NIKX jxFyHfS6jtUeI/QnMTm/n1YO6+1eeHfajV0SsiAxT8RMqqS+z6axGy9wHMTqOv0BHpGu uj/DNG0Y/etwtEKedPBnYAMklqfso/KHwjHrpGQsarRQeZ6RvoJ9GsPYK/XRj9IVMnM4 aOV66+KT4X3GegF0lVOjONQwVGnUaqiGHvP3hWxqI9oxiYesKC85WVtKfuK2Ed/YRQ57 CctA== X-Gm-Message-State: APjAAAXrRxkBov8yOs9Wo9RMzHrerXelPPchVngvvdDsNlVESfbanC1T 8sVCFXBuXRhmMlS/U3WX2lfPRLIC X-Google-Smtp-Source: APXvYqwGaMJRtqJWqL4sNzzIeqfd8Yj/67lQFPoUCMvme8HvYcFF1Jq3ZPM3osrwMKh4IPQ0vBLy4w== X-Received: by 2002:adf:cc85:: with SMTP id p5mr2686940wrj.101.1553688908822; Wed, 27 Mar 2019 05:15:08 -0700 (PDT) Received: from phst-desktop.muc.corp.google.com ([2a00:79e0:15:10:da73:c08c:d5e2:512d]) by smtp.gmail.com with ESMTPSA id v190sm2937546wme.18.2019.03.27.05.15.07 for (version=TLS1_2 cipher=ECDHE-RSA-CHACHA20-POLY1305 bits=256/256); Wed, 27 Mar 2019 05:15:08 -0700 (PDT) From: Philipp Stephani To: bug-gnu-emacs@gnu.org Subject: 27.0.50; Incomplete docstring for vc-version-diff and vc-version-ediff Date: Wed, 27 Mar 2019 13:15:07 +0100 Message-ID: MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-detected-operating-system: by eggs.gnu.org: Genre and OS details not recognized. X-Received-From: 2a00:1450:4864:20::42d X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6.x X-Spam-Score: 1.2 (+) X-Spam-Report: Spam detection software, running on the system "debbugs.gnu.org", has NOT identified this incoming email as spam. The original message has been attached to this so you can view it or label similar future email. If you have any questions, see the administrator of that system for details. Content preview: The docstrings of the commands vc-version-diff and vc-version-ediff don't describe what their arguments mean. They also don't describe the special cases for revisions that are nil or the empty string. Content analysis details: (1.2 points, 10.0 required) pts rule name description ---- ---------------------- -------------------------------------------------- 0.0 URIBL_BLOCKED ADMINISTRATOR NOTICE: The query to URIBL was blocked. See http://wiki.apache.org/spamassassin/DnsBlocklists#dnsbl-block for more information. [URIs: x.org] 0.0 FREEMAIL_FROM Sender email is commonly abused enduser mail provider (p.stephani2[at]gmail.com) 0.2 FREEMAIL_ENVFROM_END_DIGIT Envelope-from freemail username ends in digit (p.stephani2[at]gmail.com) 1.0 SPF_SOFTFAIL SPF: sender does not match SPF record (softfail) X-Debbugs-Envelope-To: submit X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: 0.2 (/) The docstrings of the commands vc-version-diff and vc-version-ediff don't describe what their arguments mean. They also don't describe the special cases for revisions that are nil or the empty string. In GNU Emacs 27.0.50 (build 59, x86_64-pc-linux-gnu, GTK+ Version 3.24.2) of 2019-03-27 Repository revision: c26704483726d454cd554406d41dd7bfde537454 Repository branch: master Windowing system distributor 'The X.Org Foundation', version 11.0.11906000 System Description: Debian GNU/Linux buster/sid Recent messages: For information about GNU Emacs and the GNU system, type C-h C-a. Configured using: 'configure --enable-gcc-warnings=3Dwarn-only --enable-gtk-deprecation-warnings --without-pop --with-mailutils --enable-checking --enable-check-lisp-object-type --with-modules 'CFLAGS=3D-O0 -ggdb3'' Configured features: XPM JPEG TIFF GIF PNG SOUND DBUS GSETTINGS GLIB NOTIFY INOTIFY GNUTLS FREETYPE XFT ZLIB TOOLKIT_SCROLL_BARS GTK3 X11 XDBE XIM MODULES THREADS LIBSYSTEMD JSON PDUMPER GMP Important settings: value of $LANG: en_US.UTF-8 locale-coding-system: utf-8-unix Major mode: Lisp Interaction Minor modes in effect: tooltip-mode: t global-eldoc-mode: t eldoc-mode: t electric-indent-mode: t mouse-wheel-mode: t tool-bar-mode: t menu-bar-mode: t file-name-shadow-mode: t global-font-lock-mode: t font-lock-mode: t blink-cursor-mode: t auto-composition-mode: t auto-encryption-mode: t auto-compression-mode: t line-number-mode: t transient-mark-mode: t Load-path shadows: None found. Features: (shadow sort mail-extr emacsbug message rmc dired dired-loaddefs format-spec rfc822 mml easymenu mml-sec epa epg epg-config gnus-util rmail rmail-loaddefs text-property-search time-date mm-decode mm-bodies mm-encode mail-parse rfc2231 mailabbrev gmm-utils mailheader sendmail rfc2047 rfc2045 ietf-drums mm-util mail-prsvr mail-utils phst skeleton derived edmacro kmacro pcase ffap thingatpt url-parse auth-source cl-seq eieio eieio-core cl-macs eieio-loaddefs password-cache json map url-vars subr-x rx gnutls puny seq byte-opt gv bytecomp byte-compile cconv dbus xml cl-loaddefs cl-lib elec-pair mule-util tooltip eldoc electric uniquify ediff-hook vc-hooks lisp-float-type mwheel term/x-win x-win term/common-win x-dnd tool-bar dnd fontset image regexp-opt fringe tabulated-list replace newcomment text-mode elisp-mode lisp-mode prog-mode register page menu-bar rfn-eshadow isearch timer select scroll-bar mouse jit-lock font-lock syntax facemenu font-core term/tty-colors frame cl-generic cham georgian utf-8-lang misc-lang vietnamese tibetan thai tai-viet lao korean japanese eucjp-ms cp51932 hebrew greek romanian slovak czech european ethiopic indian cyrillic chinese composite charscript charprop case-table epa-hook jka-cmpr-hook help simple abbrev obarray minibuffer cl-preloaded nadvice loaddefs button faces cus-face macroexp files text-properties overlay sha1 md5 base64 format env code-pages mule custom widget hashtable-print-readable backquote threads dbusbind inotify dynamic-setting system-font-setting font-render-setting move-toolbar gtk x-toolkit x multi-tty make-network-process emacs) Memory information: ((conses 16 59335 6430) (symbols 48 7796 1) (strings 32 20029 2322) (string-bytes 1 658199) (vectors 16 11309) (vector-slots 8 146848 4964) (floats 8 23 16) (intervals 56 211 0) (buffers 992 12)) --=20 Google Germany GmbH Erika-Mann-Stra=C3=9Fe 33 80636 M=C3=BCnchen Registergericht und -nummer: Hamburg, HRB 86891 Sitz der Gesellschaft: Hamburg Gesch=C3=A4ftsf=C3=BChrer: Paul Manicle, Halimah DeLaine Prado If you received this communication by mistake, please don=E2=80=99t forward= it to anyone else (it may contain confidential or privileged information), please erase all copies of it, including all attachments, and please let the sender know it went to the wrong person. Thanks. From debbugs-submit-bounces@debbugs.gnu.org Sat Apr 06 04:50:43 2019 Received: (at 35019-done) by debbugs.gnu.org; 6 Apr 2019 08:50:43 +0000 Received: from localhost ([127.0.0.1]:46539 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hCh2B-0005uY-3H for submit@debbugs.gnu.org; Sat, 06 Apr 2019 04:50:43 -0400 Received: from eggs.gnu.org ([209.51.188.92]:36480) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hCh28-0005uJ-TV for 35019-done@debbugs.gnu.org; Sat, 06 Apr 2019 04:50:41 -0400 Received: from fencepost.gnu.org ([2001:470:142:3::e]:38086) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1hCh23-0001n3-Hv; Sat, 06 Apr 2019 04:50:35 -0400 Received: from [176.228.60.248] (port=4730 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_256_CBC_SHA1:256) (Exim 4.82) (envelope-from ) id 1hCh22-00063r-Mt; Sat, 06 Apr 2019 04:50:35 -0400 Date: Sat, 06 Apr 2019 11:50:23 +0300 Message-Id: <83tvfba568.fsf@gnu.org> From: Eli Zaretskii To: Philipp Stephani In-reply-to: (message from Philipp Stephani on Wed, 27 Mar 2019 13:15:07 +0100) Subject: Re: bug#35019: 27.0.50; Incomplete docstring for vc-version-diff and vc-version-ediff References: X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Spam-Score: -0.0 (/) X-Debbugs-Envelope-To: 35019-done Cc: 35019-done@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -1.0 (-) > From: Philipp Stephani > Date: Wed, 27 Mar 2019 13:15:07 +0100 > > The docstrings of the commands vc-version-diff and vc-version-ediff > don't describe what their arguments mean. They also don't describe the > special cases for revisions that are nil or the empty string. Thanks, fixed on the emacs-26 branch. (I didn't see the need to document the empty string case, it looks like an internal implementation detail to me.) From unknown Fri Jun 20 07:09:52 2025 Received: (at fakecontrol) by fakecontrolmessage; To: internal_control@debbugs.gnu.org From: Debbugs Internal Request Subject: Internal Control Message-Id: bug archived. Date: Sat, 04 May 2019 11:24:08 +0000 User-Agent: Fakemail v42.6.9 # This is a fake control message. # # The action: # bug archived. thanks # This fakemail brought to you by your local debbugs # administrator