CLI: Improve help for cp, mv, thumbs, status, and optimize commands

cmd/photoprism/photoprism.go

@@ -55,6 +55,7 @@ func main() {
 	app.Commands = []cli.Command{
 		commands.StartCommand,
 		commands.StopCommand,
+		commands.StatusCommand,
 		commands.IndexCommand,
 		commands.ImportCommand,
 		commands.CopyCommand,
@@ -63,9 +64,9 @@ func main() {
 		commands.PasswdCommand,
 		commands.PurgeCommand,
 		commands.CleanUpCommand,
+		commands.OptimizeCommand,
 		commands.ConvertCommand,
 		commands.ThumbsCommand,
-		commands.OptimizeCommand,
 		commands.MomentsCommand,
 		commands.MigrateCommand,
 		commands.BackupCommand,
@@ -73,7 +74,6 @@ func main() {
 		commands.ResetCommand,
 		commands.ConfigCommand,
 		commands.VersionCommand,
-		commands.StatusCommand,
 	}
 
 	if err := app.Run(os.Args); err != nil {

internal/commands/convert.go

@@ -16,8 +16,8 @@ import (
 // ConvertCommand registers the convert cli command.
 var ConvertCommand = cli.Command{
 	Name:      "convert",
-	Usage:     "Converts media files to JPEG and AVC as needed",
+	Usage:     "Converts media files in other formats to JPEG / AVC",
-	UsageText: `To limit scope, a PATH may be passed as first argument.`,
+	ArgsUsage: "[path]",
 	Action:    convertAction,
 }
 

internal/commands/copy.go

@@ -16,10 +16,11 @@ import (
 
 // CopyCommand registers the copy cli command.
 var CopyCommand = cli.Command{
-	Name:    "cp",
+	Name:      "cp",
-	Aliases: []string{"copy"},
+	Aliases:   []string{"copy"},
-	Usage:   "Copies media files to originals",
+	Usage:     "Copies media files to originals",
-	Action:  copyAction,
+	ArgsUsage: "[path]",
+	Action:    copyAction,
 }
 
 // copyAction copies photos to originals path. Default import path is used if no path argument provided

internal/commands/import.go

@@ -16,10 +16,11 @@ import (
 
 // ImportCommand registers the import cli command.
 var ImportCommand = cli.Command{
-	Name:    "mv",
+	Name:      "mv",
-	Aliases: []string{"import"},
+	Aliases:   []string{"import"},
-	Usage:   "Moves media files to originals",
+	Usage:     "Moves media files to originals",
-	Action:  importAction,
+	ArgsUsage: "[path]",
+	Action:    importAction,
 }
 
 // importAction moves photos to originals path. Default import path is used if no path argument provided

internal/commands/optimize.go

@@ -14,7 +14,7 @@ import (
 // OptimizeCommand registers the index cli command.
 var OptimizeCommand = cli.Command{
 	Name:   "optimize",
-	Usage:  "Verifies and optimizes metadata",
+	Usage:  "Performs index metadata maintenance",
 	Action: optimizeAction,
 }
 

internal/commands/status.go

@@ -12,14 +12,14 @@ import (
 	"github.com/photoprism/photoprism/internal/config"
 )
 
-// StatusCommand performs a server health check.
+// StatusCommand registers the status command.
 var StatusCommand = cli.Command{
 	Name:   "status",
-	Usage:  "Performs a server health check",
+	Usage:  "Checks if the web server is running",
 	Action: statusAction,
 }
 
-// statusAction shows the server health status
+// statusAction checks if the web server is running.
 func statusAction(ctx *cli.Context) error {
 	conf := config.NewConfig(ctx)
 	client := &http.Client{Timeout: 10 * time.Second}

internal/commands/thumbs.go

@@ -12,9 +12,8 @@ import (
 
 // ThumbsCommand registers the resample cli command.
 var ThumbsCommand = cli.Command{
-	Name:    "thumbs",
+	Name:  "thumbs",
-	Aliases: []string{"resample"},
+	Usage: "Pre-renders thumbnail images based on config options",
-	Usage:   "Pre-renders thumbnail images",
 	Flags: []cli.Flag{
 		cli.BoolFlag{
 			Name:  "force, f",