From 623f60844478a3cfc60d697f5e5d804254c01c50 Mon Sep 17 00:00:00 2001 From: Teddy Wing Date: Sun, 23 Aug 2020 20:55:08 +0200 Subject: Rename `git-sugpatch` to `git-sugdiff` The word "patch" reminds me more of the `patch` Unix command, which is what `git-sugapply` does. Since this command outputs diffs, it makes more sense to call it `sugdiff`. That also brings these closer to the native Git commands, `git-diff` and `git-apply`. I had chosen "patch" originally because the command generated a unified diff that could be used as a patch file to apply to the repo. --- doc/git-sugpatch.1 | 128 ----------------------------------------------------- 1 file changed, 128 deletions(-) delete mode 100644 doc/git-sugpatch.1 (limited to 'doc/git-sugpatch.1') diff --git a/doc/git-sugpatch.1 b/doc/git-sugpatch.1 deleted file mode 100644 index 6f5ad15..0000000 --- a/doc/git-sugpatch.1 +++ /dev/null @@ -1,128 +0,0 @@ -'\" t -.\" Title: git-sugpatch -.\" Author: [FIXME: author] [see http://docbook.sf.net/el/author] -.\" Generator: DocBook XSL Stylesheets v1.79.1 -.\" Date: 08/06/2020 -.\" Manual: \ \& -.\" Source: \ \& -.\" Language: English -.\" -.TH "GIT\-SUGPATCH" "1" "08/06/2020" "\ \&" "\ \&" -.\" ----------------------------------------------------------------- -.\" * Define some portability stuff -.\" ----------------------------------------------------------------- -.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -.\" http://bugs.debian.org/507673 -.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html -.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -.ie \n(.g .ds Aq \(aq -.el .ds Aq ' -.\" ----------------------------------------------------------------- -.\" * set default formatting -.\" ----------------------------------------------------------------- -.\" disable hyphenation -.nh -.\" disable justification (adjust text to left margin only) -.ad l -.\" ----------------------------------------------------------------- -.\" * MAIN CONTENT STARTS HERE * -.\" ----------------------------------------------------------------- -.SH "NAME" -git-sugpatch \- Show diffs for GitHub suggestions -.SH "SYNOPSIS" -.sp -\fIgit sugpatch\fR [options] \&... -.SH "DESCRIPTION" -.sp -Show the diffs of the given GitHub suggestion references\&. -.sp -A suggestion reference is either a URL to the comment, or its ID\&. -.SH "OPTIONS" -.PP -\-\-github\-token= -.RS 4 -A GitHub API token with the \(lqrepo\(rq permission\&. This can also be set with -\fBgithubSuggestion\&.githubToken\fR -or the -\fBGITHUB_TOKEN\fR -environment variable\&. -.RE -.PP -\-h, \-\-help -.RS 4 -Print usage help\&. -.RE -.PP -\-\-remote= -.RS 4 -The remote to use to fetch the suggestion from when passing a suggestion ID\&. This can also be set with -\fBgithubSuggestion\&.remote\fR\&. Defaults to -\fBorigin\fR\&. -.RE -.PP -\-V, \-\-version -.RS 4 -Print the program version\&. -.RE -.SH "CONFIGURATION" -.sp -Configuration options can be specified either as command line options, or in the Git config\&. Command line options take precedence\&. -.PP -githubSuggestion\&.githubToken -.RS 4 -A GitHub API token with the \(lqrepo\(rq permission\&. This will override the -\fBGITHUB_TOKEN\fR -environment variable\&. -.RE -.PP -githubSuggestion\&.remote -.RS 4 -The remote to use to fetch the suggestion from when passing a suggestion ID\&. Defaults to -\fBorigin\fR\&. -.RE -.SH "ENVIRONMENT VARIABLES" -.PP -GITHUB_TOKEN -.RS 4 -A GitHub API token with the \(lqrepo\(rq permission\&. -.RE -.SH "EXAMPLES" -.sp -Suggestion references can be specified either as URLs: -.sp -.if n \{\ -.RS 4 -.\} -.nf -$ git sugpatch https://github\&.com/teddywing/git\-suggestion/pull/1#discussion_r459691747 -.fi -.if n \{\ -.RE -.\} -.sp -or as comment IDs: -.sp -.if n \{\ -.RS 4 -.\} -.nf -$ git sugpatch 459691747 -.fi -.if n \{\ -.RE -.\} -.sp -They can also be mixed: -.sp -.if n \{\ -.RS 4 -.\} -.nf -$ git sugpatch 459692838 https://github\&.com/teddywing/git\-suggestion/pull/1#discussion_r459691747 -.fi -.if n \{\ -.RE -.\} -.SH "SEE ALSO" -.sp -git\-sugapply(1) -- cgit v1.2.3