Path: csiph.com!goblin2!goblin1!goblin.stu.neva.ru!usenet.stanford.edu!not-for-mail
From: Robert Elz <kre@munnari.OZ.AU>
Newsgroups: gnu.bash.bug
Subject: Re: [Patch] (tiny problem) bad short_doc for % command
Date: Sun, 22 Sep 2019 00:37:40 +0700
Lines: 31
Approved: bug-bash@gnu.org
Message-ID: <mailman.739.1569087541.2190.bug-bash@gnu.org>
References: <875zllu17s.fsf@igel.home> <f05218ed-a8f4-46f3-948e-46997cef7c5b@www.fastmail.com> <11446.1569087460@jinx.noi.kre.to>
NNTP-Posting-Host: lists.gnu.org
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
X-Trace: usenet.stanford.edu 1569087541 23734 209.51.188.17 (21 Sep 2019 17:39:01 GMT)
X-Complaints-To: action@cs.stanford.edu
Cc: "Christopher Chittleborough" <cchittleborough@cluemail.com>, bug-bash@gnu.org
To: Andreas Schwab <schwab@linux-m68k.org>
Envelope-to: bug-bash@gnu.org
In-Reply-To: <875zllu17s.fsf@igel.home>
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 3.x [generic]
X-Received-From: 2001:3c8:9009:181::2
X-BeenThere: bug-bash@gnu.org
X-Mailman-Version: 2.1.23
Precedence: list
List-Id: Bug reports for the GNU Bourne Again SHell <bug-bash.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/bug-bash>, <mailto:bug-bash-request@gnu.org?subject=unsubscribe>
List-Archive: <https://lists.gnu.org/archive/html/bug-bash>
List-Post: <mailto:bug-bash@gnu.org>
List-Help: <mailto:bug-bash-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/bug-bash>, <mailto:bug-bash-request@gnu.org?subject=subscribe>
X-Mailman-Original-Message-ID: <11446.1569087460@jinx.noi.kre.to>
X-Mailman-Original-References: <875zllu17s.fsf@igel.home> <f05218ed-a8f4-46f3-948e-46997cef7c5b@www.fastmail.com>
Xref: csiph.com gnu.bash.bug:15393

    Date:        Sat, 21 Sep 2019 17:18:47 +0200
    From:        Andreas Schwab <schwab@linux-m68k.org>
    Message-ID:  <875zllu17s.fsf@igel.home>

  | A job spec already starts with %.

That's not what was meant.

In, for example:

	jinx$ help -s wait
	wait: wait [-fn] [id ...]

the command name appears both before and after the ':', as if to
say "The usage for the wait command is "wait" optional 'f' and 'n' flags,
and some number of optional "id" args.

On the other hand:

	jinx$ help -s %
	%: job_spec [&]

whetre the '%' command name is missing.  This is actually something of
a weird case, as a command which consists entirely of a job_spec is
treated the same as the '% job_spec' command (ie: one can use either "%1"
or "% %1") so the help probably needs to be enhanced even more.

kre