updated readme and help texts

README.md

@@ -58,13 +58,24 @@ You can also add the `--value` option to show just the value in the output (migh
 
 ## plist2profile
 
-This tool is a modern re-interpretation of [Tim Sutton's mcxToProfile](https://github.com/timsutton/mcxToProfile).
+This tool is a re-interpretation in Swift of [Tim Sutton's mcxToProfile](https://github.com/timsutton/mcxToProfile).
 
 It will convert a normal flat plist file into a custom mobileconfig/configuration profile that can be used for manual installation or with an MDM server.
 
-In the simplest form, you use it like this:
+In the simplest form, use it like this:
 
 ```
-% plist2profile --plist settings.plist --identifier com.example.settings
+% plist2profile --identifier example.settings com.example.settings.plist
 ```
 
+This will generate a file named `example.settings.mobileconfig` in the current working directory which manages the preference keys in the `com.example.settings.plist` in the `com.example.settings` preference domain. You can add multiple plist files.
+
+The preference domain for the settings is determined from the file name of each plist file given (removing the `plist` file extension).
+
+You can add a display and organization name that will be used in the respective fields using the `--displayname` and `--organization` options.
+
+By default, the profile is created with a `System` scope. you can change it to `User` with the `--user` flag.
+
+There are two ways to assemble custom preference profile, the 'traditional' mcx format and a more modern format, which [Bob Gendler described in this post](https://boberito.medium.com/config-profile-and-manage-all-the-things-just-about-cafea8627d4b). This tool creates the modern format by default, but can also create the traditional format when you set the `--mcx` key.
+
+

Sources/plist2profile/Plist2Profile.swift

@@ -17,51 +17,51 @@ struct Plist2Profile: ParsableCommand {
  version: "0.1"
  )
 
- // MARK: arguments,options, flags
+ // MARK: arguments, options, flags
  @Option(
  name: .shortAndLong,
  help: ArgumentHelp(
- "the identifier for the profile",
+ "The identifier for the profile.",
  valueName: "identifier"
  )
  )
  var identifier: String
 
  @Argument(
  help: ArgumentHelp(
- "Path to a plist to be added as a profile payload. Can be specified multiple times.",
+ "Path to a plist file to be added as a profile payload. Can be given more than once.",
  valueName: "plist"
  )
  )
  var plistPaths: [String]
 
+ @Option(
+ name: [.customShort("d"), .customLong("displayname")],
+ help: "Display name for the profile. (default: 'plist2profile: <identifier>')"
+ )
+ var displayName = ""
+
  @Option(
  name: [.customShort("g"), .customLong("organization")],
- help: "Cosmetic name for the organization deploying the profile."
+ help: "Organization field for the profile."
  )
  var organization = ""
 
  @Option(
  name: [.customShort("o"), .customLong("output")],
- help: "Output path for profile. Defaults to 'identifier.mobileconfig' in the current working directory."
+ help: "Output path for profile. (default: '<identifier>.mobileconfig')"
  )
  var outputPath = ""
 
- @Option(
- name: [.customShort("d"), .customLong("displayname")],
- help: "Display name for profile. Defaults to 'plist2profile: <first domain>'."
- )
- var displayName = ""
-
  @Flag(
  name: .customLong("user"),
- help: "sets the scope for the profile to 'User' (otherwise scope is 'System')"
+ help: "Sets the scope for the profile to 'User'. (default is 'System')"
  )
  var userScope = false
 
  @Flag(
  name: .customLong("mcx"),
- help: "creates the profile in macx format (default: modern)"
+ help: "Creates the profile in the traditional mcx format. (default: modern)"
  )
  var mcx = false
 
@@ -111,7 +111,7 @@ struct Plist2Profile: ParsableCommand {
 
  // if output is empty, generate file name
  if outputPath.isEmpty {
- outputPath = identifier.appending(".mobileConfig")
+ outputPath = identifier.appending(".mobileconfig")
  }
 
  if userScope {