keith
Fork
edit=== Manual Pages: Section 1
{{{ pre
GIT-QAPPLIED(1) Git-MQ Commands GIT-QAPPLIED(1)
NAME
git-qapplied - list applied entries from the patch queue series file
SYNOPSIS
git qapplied [-v | --verbose] [-s | --summary] [-1 | --last]
DESCRIPTION
The git qapplied command displays, in series order, the names of all
patches which have been registered as members of the active Git-MQ
patch series, and which are currently in the applied state, (i.e. all
registered and applied patches, in series order, up to and including
the topmost applied patch, as indicated by the git qtop command).
If the --verbose option is specified, the list is extended to include
any unapplied patches which precede the topmost applied patch, in
series order; each patch name is preceded by its sequence number in the
series, and a single character flag, indicating its status, as
described for the git qseries command.
If the --summary option is specified, the commit summary line, if
available in the patch header, is displayed following each patch name.
If the --last option is specified, the output is reduced to the display
of only the one patch, if any, which is the applied predecessor of the
topmost applied patch; this is effectively equivalent to the output of
the git qprev command.
OPTIONS
-1, --last
Show only the predecessor of the current topmost patch.
-s, --summary
Include summary lines from patch headers.
-v, --verbose
Show patch sequence numbers and status flags.
EXIT STATUS
On successful completion, git qapplied reports an exit status code of
0. Any non‐zero exit status code indicates that an error occurred.
COMPARISON WITH MERCURIAL QUEUES
Inspired by, and for the most part based on behavioural observation of
Mercurial's MQ extension, the git qapplied command exhibits
fundamentally the same behaviour as its hg qapplied counterpart, except
in the case when the --last option is specified, and the patch
immediately the topmost is guarded; (see the CAVEATS AND BUGS section,
below).
CAVEATS AND BUGS
The output, when using the --last option is not particularly useful; as
implemented, it simply mimics the behaviour of the git qprev command,
reporting the most recently applied predecessor of the topmost
currently‐applied patch. This differs from the behaviour of
Mercurial's hg qapplied --last command, which reports information
relating to the immediate predecessor of the topmost applied patch,
regardless of whether that predecessor is applied, unapplied, or
guarded, but (unhelpfully) displays nothing at all, if the --verbose
option is not specified, when the predecessor is either unapplied, or
guarded.
AUTHOR
Copyright (C) 2019, by Keith Marshall
This man page was written by Keith Marshall <keith@users.osdn.me>, to
accompany the Git-MQ program suite. It is published under the terms of
the GNU Free Documentation Licence, version 1.3, (or any later version
published by the Free Software Foundation), with no Invariant Sections,
no Front‐Cover Texts, and no Back‐Cover Texts.
The Git‐MQ program suite itself is distibruted under the terms of the
GNU General Public Licence, version 3, (or any later version published
by the Free Software Foundation).
Copies of the GNU Free Documentation Licence, and of the GNU General
Public Licence, are included within the Git‐MQ source distribution, in
the files FDL-1.3, and LICENCE, respectively.
SEE ALSO
git-qprev(1), git-qseries(1), git-qtop(1), git-qunapplied(1)
Git-MQ 1.0 31-Mar-2022 GIT-QAPPLIED(1)
}}}
A copy of the above, in PDF format, is [https://osdn.net/users/keith/pf/git-mq/wiki/git-qapplied.1.manpage/attach/git-qapplied.1.pdf available here].