docs: improve some cli docs

License: MIT
Signed-off-by: Henrique Dias <hacdias@gmail.com>

cmd/config_export.go

@@ -10,7 +10,8 @@ func init() {
 
 var configExportCmd = &cobra.Command{
 	Use:   "export <filename>",
-	Short: "Export the configuration to a file.",
+	Short: "Export the configuration to a file",
+	Long:  "Export the configuration to a file.",
 	Args:  jsonYamlArg,
 	Run: python(func(cmd *cobra.Command, args []string, d pythonData) {
 		settings, err := d.store.Settings.Get()

cmd/config_import.go

@@ -23,7 +23,8 @@ type settingsFile struct {
 
 var configImportCmd = &cobra.Command{
 	Use: "import <filename>",
-	Short: `Import a configuration file. This will replace all the existing
+	Short: "Import a configuration file",
+	Long: `Import a configuration file. This will replace all the existing
 configuration. Can be used with or without unexisting databases.
 If used with a nonexisting database, a key will be generated
 automatically. Otherwise the key will be kept the same as in the

cmd/root.go

@@ -119,6 +119,7 @@ The precedence of the configuration values are as follows:
 - flag
 - environment variable
 - configuration file
+- database values
 - defaults
 
 The environment variables are prefixed by "FB_" followed by the option

cmd/users_export.go

@@ -10,8 +10,10 @@ func init() {
 
 var usersExportCmd = &cobra.Command{
 	Use:   "export <filename>",
-	Short: "Export all users.",
+	Short: "Export all users to a file.",
-	Args:  jsonYamlArg,
+	Long: `Export all users to a json or yaml file. Please indicate the
+path to the file where you want to write the users.`,
+	Args: jsonYamlArg,
 	Run: python(func(cmd *cobra.Command, args []string, d pythonData) {
 		list, err := d.store.Users.Gets("")
 		checkErr(err)

cmd/users_import.go

@@ -17,7 +17,8 @@ func init() {
 
 var usersImportCmd = &cobra.Command{
 	Use:   "import <filename>",
-	Short: "Import users from a file.",
+	Short: "Import users from a file",
+	Long:  "Import users from a file.",
 	Args:  jsonYamlArg,
 	Run: python(func(cmd *cobra.Command, args []string, d pythonData) {
 		fd, err := os.Open(args[0])
@@ -36,16 +37,16 @@ var usersImportCmd = &cobra.Command{
 		if mustGetBool(cmd.Flags(), "replace") {
 			oldUsers, err := d.store.Users.Gets("")
 			checkErr(err)
-			
+
 			err = marshal("users.backup.json", list)
 			checkErr(err)
-			
+
 			for _, user := range oldUsers {
 				err = d.store.Users.Delete(user.ID)
 				checkErr(err)
 			}
 		}
-		
+
 		overwrite := mustGetBool(cmd.Flags(), "overwrite")
 
 		for _, user := range list {