Escape single quotes in fish shell completion

Single quotes can break the generated fish shell completion and should
be escaped correctly.

Signed-off-by: Sascha Grunert <sgrunert@suse.com>

docs_test.go

@@ -11,7 +11,7 @@ func testApp() *App {
 	app.Flags = []Flag{
 		StringFlag{
 			Name:  "socket, s",
-			Usage: "some usage text",
+			Usage: "some 'usage' text",
 			Value: "value",
 		},
 		StringFlag{Name: "flag, fl, f"},

fish.go

@@ -82,7 +82,8 @@ func (a *App) prepareFishCommands(
 		))
 
 		if command.Usage != "" {
-			completion.WriteString(fmt.Sprintf(" -d '%s'", command.Usage))
+			completion.WriteString(fmt.Sprintf(" -d '%s'",
+				escapeSingleQuotes(command.Usage)))
 		}
 
 		if !command.HideHelp {
@@ -149,7 +150,8 @@ func (a *App) prepareFishFlags(
 		}
 
 		if flag.GetUsage() != "" {
-			completion.WriteString(fmt.Sprintf(" -d '%s'", flag.GetUsage()))
+			completion.WriteString(fmt.Sprintf(" -d '%s'",
+				escapeSingleQuotes(flag.GetUsage())))
 		}
 
 		completions = append(completions, completion.String())
@@ -169,3 +171,7 @@ func (a *App) fishSubcommandHelper(allCommands []string) string {
 	return fishHelper
 
 }
+
+func escapeSingleQuotes(input string) string {
+	return strings.Replace(input, `'`, `\'`, -1)
+}

testdata/expected-doc-full.man

@@ -1,5 +1,5 @@
 .nh
-.TH greet(8) 
+.TH greet(8)
 
 .SH Harrison
 
@@ -49,7 +49,7 @@ greet [GLOBAL OPTIONS] command [COMMAND OPTIONS] [ARGUMENTS...]
 \fB\-\-flag, \-\-fl, \-f\fP="":
 
 .PP
-\fB\-\-socket, \-s\fP="": some usage text (default: value)
+\fB\-\-socket, \-s\fP="": some 'usage' text (default: value)
 
 
 .SH COMMANDS
@@ -77,4 +77,4 @@ another usage test
 .PP
 retrieve generic information
 
-.SH some\-command
+.SH some\-command

testdata/expected-doc-full.md

@@ -32,7 +32,7 @@ greet [GLOBAL OPTIONS] command [COMMAND OPTIONS] [ARGUMENTS...]
 
 **--flag, --fl, -f**="": 
 
-**--socket, -s**="": some usage text (default: value)
+**--socket, -s**="": some 'usage' text (default: value)
 
 
 # COMMANDS

testdata/expected-doc-no-commands.md

@@ -32,5 +32,5 @@ greet [GLOBAL OPTIONS] command [COMMAND OPTIONS] [ARGUMENTS...]
 
 **--flag, --fl, -f**="": 
 
-**--socket, -s**="": some usage text (default: value)
+**--socket, -s**="": some 'usage' text (default: value)
 

testdata/expected-fish-full.fish

@@ -9,7 +9,7 @@ function __fish_greet_no_subcommand --description 'Test if there has been any su
     return 0
 end
 
-complete -c greet -f -n '__fish_greet_no_subcommand' -l socket -s s -r -d 'some usage text'
+complete -c greet -f -n '__fish_greet_no_subcommand' -l socket -s s -r -d 'some \'usage\' text'
 complete -c greet -f -n '__fish_greet_no_subcommand' -l flag -s fl -s f -r
 complete -c greet -f -n '__fish_greet_no_subcommand' -l another-flag -s b -d 'another usage text'
 complete -c greet -f -n '__fish_greet_no_subcommand' -l help -s h -d 'show help'