From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED.blaine.gmane.org!not-for-mail From: Nicholas Drozd Newsgroups: gmane.emacs.bugs Subject: bug#34274: [PATCH] * src/callproc.c (call-process/region): Fix docstring arg formatting Date: Mon, 4 Feb 2019 17:55:51 -0600 Message-ID: References: <83bm3vy207.fsf@gnu.org> Mime-Version: 1.0 Content-Type: text/plain; charset="UTF-8" Injection-Info: blaine.gmane.org; posting-host="blaine.gmane.org:195.159.176.226"; logging-data="10036"; mail-complaints-to="usenet@blaine.gmane.org" Cc: 34274@debbugs.gnu.org To: Eli Zaretskii Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Tue Feb 05 00:57:16 2019 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([209.51.188.17]) by blaine.gmane.org with esmtps (TLS1.0:RSA_AES_256_CBC_SHA1:256) (Exim 4.89) (envelope-from ) id 1gqo71-0002Wa-Rw for geb-bug-gnu-emacs@m.gmane.org; Tue, 05 Feb 2019 00:57:15 +0100 Original-Received: from localhost ([127.0.0.1]:51453 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1gqo6x-00031q-Re for geb-bug-gnu-emacs@m.gmane.org; Mon, 04 Feb 2019 18:57:11 -0500 Original-Received: from eggs.gnu.org ([209.51.188.92]:59958) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1gqo6p-00030p-B9 for bug-gnu-emacs@gnu.org; Mon, 04 Feb 2019 18:57:03 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1gqo6o-0000Dc-Jo for bug-gnu-emacs@gnu.org; Mon, 04 Feb 2019 18:57:03 -0500 Original-Received: from debbugs.gnu.org ([209.51.188.43]:60636) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1gqo6o-0000DV-GH for bug-gnu-emacs@gnu.org; Mon, 04 Feb 2019 18:57:02 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1gqo6o-0006Hv-EL for bug-gnu-emacs@gnu.org; Mon, 04 Feb 2019 18:57:02 -0500 X-Loop: help-debbugs@gnu.org Resent-From: Nicholas Drozd Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Mon, 04 Feb 2019 23:57:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 34274 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: patch Original-Received: via spool by 34274-submit@debbugs.gnu.org id=B34274.154932457424111 (code B ref 34274); Mon, 04 Feb 2019 23:57:02 +0000 Original-Received: (at 34274) by debbugs.gnu.org; 4 Feb 2019 23:56:14 +0000 Original-Received: from localhost ([127.0.0.1]:59917 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1gqo61-0006Go-SD for submit@debbugs.gnu.org; Mon, 04 Feb 2019 18:56:14 -0500 Original-Received: from mail-lj1-f179.google.com ([209.85.208.179]:37095) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1gqo60-0006Gb-6A for 34274@debbugs.gnu.org; Mon, 04 Feb 2019 18:56:12 -0500 Original-Received: by mail-lj1-f179.google.com with SMTP id t18-v6so1439765ljd.4 for <34274@debbugs.gnu.org>; Mon, 04 Feb 2019 15:56:12 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=mime-version:references:in-reply-to:from:date:message-id:subject:to :cc; bh=4ZbupGPj04a+S5dKCTUxaQ4NaR/itcCJJWpUT2YjUgw=; b=fiMorQ42tPSXLeYNpxEEiEcA/Wf+SWZLzgaP43quVf4PG1EsOnDFpHEBjESqPoOlCT q6iulkIewuG1ecMb8o4Uqa6IR2Ie+jCStQxQjI9iLT6MgpJ/YGTojrnZM0Enbk3MXbRN rdoc+oOLP2HHGz+ZatjFWLN5jTd0vLtM60ENou0dyzG4kiTG2pp97/tDNwgw2RjA2OZl tD5M32JxZ3fW0H7BVfvL16eMKQeDXhIDRMdJ2eR0G4YqPaFotoE4VhdcHXmUf/oToco+ gPGcFAzxvJc3/hb2q8bJxpfxZMCyYNgCoT6uDqNRkqO4XMIntxwUlOVbKFuinr3kU7fu R4vw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:mime-version:references:in-reply-to:from:date :message-id:subject:to:cc; bh=4ZbupGPj04a+S5dKCTUxaQ4NaR/itcCJJWpUT2YjUgw=; b=R2aDQdIHUbUXfCDh+kwl51QZMtaxbfOcNKrjEyVc+5D5V6VmILQCVahqzHORyLtaHf +4sFsZwM3G2MZ5+k2nbcqImaIGj0Y1VnZpUSmgwPgwXpGXhLvAg8hwo85q9NRjW+JC94 UHGJW+11BB+q/LRr8dIxbSfiVbhRINeYVyd0XBE0msXF5XJ3qPext0Q/hIVEg5cFjXWE fw3To/TNMfxpik1mpz0x+1OkUO3vIDwO8LZXj260DJekfgvvMWp1DdDUgReVfp2NF+fR VceFcF4il8T44xm9qnxZScsZFTvD0LxeQO/0oBsyA2ipMvl0FdYvA7U77Ur5mMko2ISM Zryg== X-Gm-Message-State: AHQUAuaYbIg7+qcdO2rUPBkHWLmA1fB+y6i5qckzn09E1qNwgmpNWRRP WunyVCRvd1oWzDbD680i8PYFRblqMPooJoa0RwU= X-Google-Smtp-Source: AHgI3IYiEAvDyif2e54dwuk5dgvMZO53wEBBqfwlQJ9cMhS5e87rI4RPXmCqjtV9QX/Lxe2UCgHZqcfc1yiLrQDEdf4= X-Received: by 2002:a2e:6503:: with SMTP id z3-v6mr1129226ljb.153.1549324565712; Mon, 04 Feb 2019 15:56:05 -0800 (PST) In-Reply-To: <83bm3vy207.fsf@gnu.org> X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 209.51.188.43 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.org@gnu.org Original-Sender: "bug-gnu-emacs" Xref: news.gmane.org gmane.emacs.bugs:155103 Archived-At: The usual docstring convention is to put arg names in CAPS, making it easier to find mentions of the arguments, especially by text search. Right now if you search the docstring of call-process for ARGS, you won't find anything. There's "remaining arguments", but it's up to the reader to figure out that that refers to ARGS. This change just makes it easier to navigate. In the second case I also changed "command args" to "command arguments". This change is unimportant; I just thought it looks nicer.