Sync documentation

Author: dspinellis

git-issue.1

@@ -1,4 +1,4 @@
-.TH GIT-ISSUE 1 "17 April 2018"
+.TH GIT-ISSUE 1 "11 October 2019"
 .\"
 .\" (C) Copyright 2016-2018 Diomidis Spinellis
 .\"
@@ -49,6 +49,7 @@ Clone the specified remote repository.
 .RS 4
 Create a new issues repository in the current directory.
   The \fC-e\fP option uses an existing Git project repository.
+
 .RE
 .PP
 \fBgit issue new\fP
@@ -142,7 +143,7 @@ List open issues (or all with \fC-a\fP).
 .RS 4
 This will list issues in the specified format, given as an argument to \fC-l\fP.
    The following escape sequences can be used:
-   
+
    - \fC%n\fP : newline
    - \fC%i\fP : issue ID
    - \fC%c\fP : creation date
@@ -156,23 +157,23 @@ This will list issues in the specified format, given as an argument to \fC-l\fP.
    - \fC%D\fP : Description(first line)
 
    If the format string is one of: (\fConeline\fP, \fCshort\fP or `full`) it will interpreted as the corresponding preset.
-   
+
    Optionally, one of the above given with \fC-o\fP will order based on this field(reverse order with \fC-r\fP).
-   
+
 .RE
 .PP
 \fBgit issue filter-apply command\fP
 .RS 4
-Run \fCcommand\fP in every issue directory. The following environment variables will be set: 
+Run \fCcommand\fP in every issue directory. The following environment variables will be set:
   - \fCGI_SHA\fP : Sha of the current issue
   - \fCGI_IMPORTS\fP : The imports directories for current issue(one on each line)
   - \fCGI_AUTHOR\fP : Author of current issue
   - \fCGI_DATE\fP : Creation date of current issue
-  
+
   The command can read, add/remove or edit any of the issue's attributes.
   Some potentially useful scripts to be used with this command are in the scripts/ directory.
   Remember to inspect the results (e.g \fCgi git diff\fP) and commit them with \fCgi git commit -a\fP.
-  
+
 .RE
 .PP
 \fBgit issue push\fP
@@ -193,9 +194,7 @@ Import/update GitHub/GitLab issues from the specified project.
   For example, run the following command: \fCexport GH_CURL_AUTH="Authorization: token badf00ddead9bfee8f3c19afc3c97c6db55fcfde"\fP
   You can create the authorization token through
   GitHub settings <https://github.com/settings/tokens/new>, with the \fCrepo\fP and \fCdelete_repo\fP(only for running the tests) permissions.
-  
-  For GitLab: \fCexport GL_CURL_AUTH="PRIVATE-TOKEN: JvHLsdnDmD7rjUXzT-Ea"\fP
-  The \fCapi\fP permission is required.
+  For GitLab: \fCexport GL_CURL_AUTH="PRIVATE-TOKEN: JvHLsdnDmD7rjUXzT-Ea"\fP. The \fCapi\fP permission is required.
   Use the GitLab settings <https://gitlab.com/profile/personal\fIaccess\fPtokens> to create the token.
   In case the repository is part of a GitLab group, specify repository as groupname/reponame.
 .RE
@@ -312,8 +311,8 @@ The command terminates with a non zero exit code on errors.
 .\" Auto-generated content from README.md; do not edit this section
 You can also view a video of the following session on YouTube <https://youtu.be/9aKHTjtTbFs>.
 
-.ft P
 .fi
+.ft R
 .PP
 Initialize issue repository
 .ft C
@@ -323,17 +322,17 @@ Initialized empty Issues repository in /home/dds/src/gi/.issues
 $ git issue new -s 'New issue entered from the command line'
 Added issue e6a95c9
 
-.ft P
 .fi
+.ft R
 .PP
 Create a new issue (opens editor window)
 .ft C
 .nf
 $ git issue new
 Added issue 7dfa5b7
 
-.ft P
 .fi
+.ft R
 .PP
 List open issues
 .ft C
@@ -342,53 +341,53 @@ $ git issue list
 7dfa5b7 An issue entered from the editor
 e6a95c9 New issue entered from the command line
 
-.ft P
 .fi
+.ft R
 .PP
 Add an issue comment (opens editor window)
 .ft C
 .nf
 $ git issue comment e6a95c9
 Added comment 8c0d5b3
 
-.ft P
 .fi
+.ft R
 .PP
 Add a due date for the issue
-\fC\fP\fC.ft C
+.ft C
 .nf
 $ git issue duedate "next Tuesday" e6a95c9
 Added duedate 2019-08-13T00:00:00+03:00
 
-.ft P
 .fi
+.ft R
 .PP
 Keep track of time spent on the issue
-\fC\fP\fC.ft C
+.ft C
 .nf
 $ git issue timespent "2hours" e6a95c9
 Added timespent 7200
 
-.ft P
 .fi
+.ft R
 .PP
 Log additional time spent working on it
-\fC\fP\fC.ft C
+.ft C
 .nf
 $ git issue timespent -a "4 hours" e6a95c9
 Added timespent 21600
 
-.ft P
 .fi
+.ft R
 .PP
 Add tag to an issue
 .ft C
 .nf
 $ git issue tag e6a9 urgent
 Added tag urgent
 
-.ft P
 .fi
+.ft R
 .PP
 Add two more tags
 .ft C
@@ -397,44 +396,44 @@ $ git issue tag e6a9 gui crash
 Added tag gui
 Added tag crash
 
-.ft P
 .fi
+.ft R
 .PP
 Remove a tag
 .ft C
 .nf
 $ git issue tag -r e6a9 urgent
 Removed tag urgent
 
-.ft P
 .fi
+.ft R
 .PP
 Assign issue
 .ft C
 .nf
 $ git issue assign e6a9 joe@example.com
 Assigned to joe@example.com
 
-.ft P
 .fi
+.ft R
 .PP
 Add issue watcher
 .ft C
 .nf
 $ git issue watcher e6a9 jane@example.com
 Added watcher jane@example.com
 
-.ft P
 .fi
+.ft R
 .PP
 List issues tagged as gui
 .ft C
 .nf
 $ git issue list gui
 e6a95c9 New issue entered from the command line
 
-.ft P
 .fi
+.ft R
 .PP
 Push issues repository to a server
 .ft C
@@ -449,8 +448,8 @@ To git@github.com:dspinellis/gi-example.git
  * [new branch]      master -> master
 Branch master set up to track remote branch master from origin.
 
-.ft P
 .fi
+.ft R
 .PP
 Clone issues repository from server
 .ft C
@@ -465,8 +464,8 @@ Resolving deltas: 100% (8/8), done.
 Checking connectivity... done.
 Cloned git@github.com:dspinellis/gi-example.git into my-issues
 
-.ft P
 .fi
+.ft R
 .PP
 List open issues
 .ft C
@@ -475,17 +474,17 @@ $ git issue list
 7dfa5b7 An issue entered from the editor
 e6a95c9 New issue entered from the command line
 
-.ft P
 .fi
+.ft R
 .PP
 Create new issue
 .ft C
 .nf
 $ git issue new -s 'Issue added on another host'
 Added issue abc9adc
 
-.ft P
 .fi
+.ft R
 .PP
 Push changes to server
 .ft C
@@ -498,8 +497,8 @@ Total 7 (delta 0), reused 0 (delta 0)
 To git@github.com:dspinellis/gi-example.git
    d6be890..740f9a0  master -> master
 
-.ft P
 .fi
+.ft R
 .PP
 Show issue added on the other host
 .ft C
@@ -514,8 +513,8 @@ Tags:   open
 
     Here is a longer description.
 
-.ft P
 .fi
+.ft R
 .PP
 Show issue and comments
 .ft C
@@ -536,8 +535,8 @@ Date:   Fri, 29 Jan 2016 01:03:57 +0200
 
     First comment regarding the issue.
 
-.ft P
 .fi
+.ft R
 .PP
 Pull in remote changes (on the original host)
 .ft C
@@ -557,8 +556,8 @@ Fast-forward
  create mode 100644 issues/ab/c9adc61025a3cb73b0c67470b65cefc133a8d0/description
  create mode 100644 issues/ab/c9adc61025a3cb73b0c67470b65cefc133a8d0/tags
 
-.ft P
 .fi
+.ft R
 .PP
 List open issues
 .ft C
@@ -568,8 +567,8 @@ $ git issue list
 abc9adc Issue added on another host
 e6a95c9 New issue entered from the command line
 
-.ft P
 .fi
+.ft R
 .PP
 Import issues from GitHub
 .ft C
@@ -608,8 +607,8 @@ Thu, 30 Aug 2018 20:59:59 +0000 by dspinellis
 .IP "" 4
 <dspinellis@users.noreply.github.com>
 
-.ft P
 .fi
+.ft R
 .PP
 Export all issues to GitHub
 .ft C
@@ -625,8 +624,8 @@ Creating comment 6966d4d718c80cf8635e9276d6f391de70c22f93...
 Creating comment 85293a6904d0fbd6238fbb2e1c36fc65af9ffc60...
 Creating comment aea83723c0414ff135afcfb5165d64f8a7ad687c...
 
-.ft P
 .fi
+.ft R
 .PP
 Make changes
 .ft C
@@ -638,8 +637,8 @@ $ git issue edit -c d72c6
 Opening editor...
 Edited comment d72c68d
 
-.ft P
 .fi
+.ft R
 .PP
 Export modified issues back to GitHub
 .ft C
@@ -654,8 +653,8 @@ Comment 6966d4d718c80cf8635e9276d6f391de70c22f93 hasn't been modified, skipping.
 Comment 85293a6904d0fbd6238fbb2e1c36fc65af9ffc60 hasn't been modified, skipping...
 Comment aea83723c0414ff135afcfb5165d64f8a7ad687c hasn't been modified, skipping...
 
-.ft P
 .fi
+.ft R
 .PP
 Sub-command auto-completion
 .ft C
@@ -664,8 +663,8 @@ $ git issue [Tab]
 assign   clone    comment  git      init     log      pull     show     watcher
 attach   close    edit     help     list     new      push     tag
 
-.ft P
 .fi
+.ft R
 .PP
 Issue SHA auto-completion
 .ft C

git-issue.sh

@@ -27,7 +27,7 @@
 # User agent string
 # shellcheck disable=SC2034
 # SC2034 : USER_AGENT appears unused. Verify use (or export if used externally)
-USER_AGENT=https://github.com/dspinellis/git-issue/tree/3565b3b
+USER_AGENT=https://github.com/dspinellis/git-issue/tree/ea66152
 
 # Determine our script library path
 my_IFS=$IFS
@@ -1391,7 +1391,7 @@ Show multiple issues
 * list -l formatstring: This will list issues in the specified format, given as an argument to -l
 
 Work with multiple issues
-* filter-apply command: Run command in every issue directory The following environment variables will be set: 
+* filter-apply command: Run command in every issue directory The following environment variables will be set:
 
 Synchronize with remote repositories
    push       Update remote Git repository with local changes