manpage: Add separate manpages for each command

Using docker as a model, this update creates separate manpages
for each OSTree command, such that the main manpage is not
cluttered and the separate pages can provide more in-depth detail
and exanples that might be useful to a user.  Each page includes
synopsis, description, example, and a list of options if needd.
This update also alphabetizes the usage error output for ostree
and ostree admin so that it matches the list on the manpage.

src/ostree/main.c

@@ -35,23 +35,23 @@
 static OstreeCommand commands[] = {
   { "admin", ostree_builtin_admin, OSTREE_BUILTIN_FLAG_NO_REPO },
   { "cat", ostree_builtin_cat, 0 },
-  { "commit", ostree_builtin_commit, 0 },
-  { "config", ostree_builtin_config, 0 },
   { "checkout", ostree_builtin_checkout, 0 },
   { "checksum", ostree_builtin_checksum, OSTREE_BUILTIN_FLAG_NO_REPO },
+  { "commit", ostree_builtin_commit, 0 },
+  { "config", ostree_builtin_config, 0 },
   { "diff", ostree_builtin_diff, 0 },
   { "fsck", ostree_builtin_fsck, 0 },
   { "init", ostree_builtin_init, OSTREE_BUILTIN_FLAG_NO_CHECK },
   { "log", ostree_builtin_log, 0 },
   { "ls", ostree_builtin_ls, 0 },
-  { "refs", ostree_builtin_refs, 0 },
-  { "reset", ostree_builtin_reset, 0 },
   { "prune", ostree_builtin_prune, 0 },
+  { "pull-local", ostree_builtin_pull_local, 0 },
 #ifdef HAVE_LIBSOUP 
   { "pull", ostree_builtin_pull, 0 },
 #endif
-  { "pull-local", ostree_builtin_pull_local, 0 },
+  { "refs", ostree_builtin_refs, 0 },
   { "remote", ostree_builtin_remote, 0 },
+  { "reset", ostree_builtin_reset, 0 },
   { "rev-parse", ostree_builtin_rev_parse, 0 },
   { "show", ostree_builtin_show, 0 },
   { "static-delta", ostree_builtin_static_delta, 0 },

src/ostree/ot-builtin-admin.c

@@ -38,16 +38,16 @@ typedef struct {
 } OstreeAdminCommand;
 
 static OstreeAdminCommand admin_subcommands[] = {
-  { "os-init", ot_admin_builtin_os_init },
+  { "cleanup", ot_admin_builtin_cleanup },
+  { "config-diff", ot_admin_builtin_diff },
+  { "deploy", ot_admin_builtin_deploy }, 
   { "init-fs", ot_admin_builtin_init_fs },
   { "instutil", ot_admin_builtin_instutil },
-  { "deploy", ot_admin_builtin_deploy },
-  { "undeploy", ot_admin_builtin_undeploy },
-  { "upgrade", ot_admin_builtin_upgrade },
-  { "cleanup", ot_admin_builtin_cleanup },
+  { "os-init", ot_admin_builtin_os_init },
   { "status", ot_admin_builtin_status },
   { "switch", ot_admin_builtin_switch },
-  { "config-diff", ot_admin_builtin_diff },
+  { "undeploy", ot_admin_builtin_undeploy },
+  { "upgrade", ot_admin_builtin_upgrade },
   { NULL, NULL }
 };