Docs formatting issues

commands/commands.go

@@ -107,7 +107,9 @@ func (c *Command) Synopsis() string {
 }
 
 func (c *Command) HelpText() string {
-	return fmt.Sprintf("%s\n\n%s", c.Synopsis(), strings.Replace(c.Long, "'", "`", -1))
+	return fmt.Sprintf("%s\n\n%s",
+		strings.Replace(c.Synopsis(), "-^", "`-^`", 1),
+		strings.Replace(c.Long, "'", "`", -1))
 }
 
 func (c *Command) Name() string {

commands/pull_request.go

@@ -48,10 +48,10 @@ pull-request -i <ISSUE>
 	-i, --issue=<ISSUE>
 		Convert an issue to a pull request. <ISSUE> may be an issue number or a URL.
 
-		You can only convert issues that you've opened or that which you have admin
-		rights over. In most workflows it isn't necessary to convert issues to pull
-		requests; you can simply reference the original issue in the body of the new
-		pull request.
+		You can only convert issues authored by you or that which you have admin
+		rights over. In most workflows it is not necessary to convert issues to
+		pull requests; you can simply reference the original issue in the body of
+		the new pull request.
 
 	-o, --browse
 		Open the new pull request in a web browser.
@@ -85,7 +85,7 @@ pull-request -i <ISSUE>
 
 	-l, --labels=<LABELS>
 		Add a comma-separated list of labels to this pull request. Labels will be
-		created if they don't already exist.
+		created if they do not already exist.
 
 ## Examples:
 		$ hub pull-request
@@ -103,7 +103,7 @@ pull-request -i <ISSUE>
 
 ## Configuration:
 
-	HUB_RETRY_TIMEOUT=<SECONDS>
+	* 'HUB_RETRY_TIMEOUT':
 		The maximum time to keep retrying after HTTP 422 on '--push' (default: 9).
 
 ## See also:

commands/release.go

@@ -40,7 +40,7 @@ With '--exclude-prereleases', exclude non-stable releases from the listing.
 
 	* _create_:
 		Create a GitHub release for the specified <TAG> name. If git tag <TAG>
-		doesn't exist, it will be created at <TARGET> (default: current branch).
+		does not exist, it will be created at <TARGET> (default: current branch).
 
 	* _edit_:
 		Edit the GitHub release for the specified <TAG> name. Accepts the same
@@ -93,7 +93,7 @@ With '--exclude-prereleases', exclude non-stable releases from the listing.
 
 	-t, --commitish=<TARGET>
 		A commit SHA or branch name to attach the release to, only used if <TAG>
-		doesn't already exist (default: main branch).
+		does not already exist (default: main branch).
 
 	-f, --format=<FORMAT>
 		Pretty print releases using <FORMAT> (default: "%T%n"). See the "PRETTY

commands/sync.go

@@ -21,7 +21,7 @@ var cmdSync = &Command{
 - If the local branch contains unpushed work, warn about it;
 - If the branch seems merged and its upstream branch was deleted, delete it.
 
-If a local branch doesn't have any upstream configuration, but has a
+If a local branch does not have any upstream configuration, but has a
 same-named branch on the remote, treat that as its upstream branch.
 
 ## See also: