v7: Update help text for create-route

Add details about the `--port` flag and distinguish between HTTP and TCP
domain use-cases.

[Finishes #172510259]

Authored-by: Reid Mitchell <[email protected]>

Author: reidmit

command/v7/create_route_command.go

@@ -11,7 +11,7 @@ type CreateRouteCommand struct {
 	BaseCommand
 
 	RequiredArgs    flag.Domain      `positional-args:"yes"`
-	usage           interface{}      `usage:"CF_NAME create-route DOMAIN [--hostname HOSTNAME] [--path PATH]\n\nEXAMPLES:\n   CF_NAME create-route example.com                             # example.com\n   CF_NAME create-route example.com --hostname myapp            # myapp.example.com\n   CF_NAME create-route example.com --hostname myapp --path foo # myapp.example.com/foo"`
+	usage           interface{}      `usage:"Create an HTTP route:\n      CF_NAME create-route DOMAIN [--hostname HOSTNAME] [--path PATH]\n\n   Create a TCP route:\n      CF_NAME create-route DOMAIN [--port PORT]\n\nEXAMPLES:\n   CF_NAME create-route example.com                             # example.com\n   CF_NAME create-route example.com --hostname myapp            # myapp.example.com\n   CF_NAME create-route example.com --hostname myapp --path foo # myapp.example.com/foo\n   CF_NAME create-route example.com --port 5000                 # example.com:5000"`
 	Hostname        string           `long:"hostname" short:"n" description:"Hostname for the HTTP route (required for shared domains)"`
 	Path            flag.V7RoutePath `long:"path" description:"Path for the HTTP route"`
 	Port            int              `long:"port" description:"Port for the TCP route (default: random port)"`

integration/v7/isolated/create_route_command_test.go

@@ -26,18 +26,23 @@ var _ = Describe("create-route command", func() {
 			Eventually(session).Should(Say(`\n`))
 
 			Eventually(session).Should(Say(`USAGE:`))
+			Eventually(session).Should(Say(`Create an HTTP route:\n`))
 			Eventually(session).Should(Say(`cf create-route DOMAIN \[--hostname HOSTNAME\] \[--path PATH\]\n`))
+			Eventually(session).Should(Say(`Create a TCP route:\n`))
+			Eventually(session).Should(Say(`cf create-route DOMAIN \[--port PORT\]\n`))
 			Eventually(session).Should(Say(`\n`))
 
 			Eventually(session).Should(Say(`EXAMPLES:`))
 			Eventually(session).Should(Say(`cf create-route example.com\s+# example.com`))
 			Eventually(session).Should(Say(`cf create-route example.com --hostname myapp\s+# myapp.example.com`))
 			Eventually(session).Should(Say(`cf create-route example.com --hostname myapp --path foo\s+# myapp.example.com/foo`))
+			Eventually(session).Should(Say(`cf create-route example.com --port 5000\s+# example.com:5000`))
 			Eventually(session).Should(Say(`\n`))
 
 			Eventually(session).Should(Say(`OPTIONS:`))
 			Eventually(session).Should(Say(`--hostname, -n\s+Hostname for the HTTP route \(required for shared domains\)`))
 			Eventually(session).Should(Say(`--path\s+Path for the HTTP route`))
+			Eventually(session).Should(Say(`--port\s+Port for the TCP route \(default: random port\)`))
 			Eventually(session).Should(Say(`\n`))
 
 			Eventually(session).Should(Say(`SEE ALSO:`))