From bb1e5b50e930b7c9618387cc43634e6050eb3481 Mon Sep 17 00:00:00 2001
From: Michael DeHaan <mdehaan@mdehaan.rdu.redhat.com>
Date: Fri, 20 Apr 2007 17:57:02 -0400
Subject: This commit overhauls the main cobbler CLI module and adds support
 for object renaming, copying, and editing -- previously only addition and
 removal were supported.  This frees uses (hopefully) from the need to hack
 YAML and risk damaging their configurations by rendering the config
 unparseable.  It also makes "cobbler list" print out a simple tree
 representation that shows the association between objects.

This also relaxes the requirements for what constitutes a kernel and initrd
filename, just in case they are named something different.  They still have
to exist.
---
 docs/cobbler.pod | 32 ++++++++++++++++++++++++++------
 1 file changed, 26 insertions(+), 6 deletions(-)

(limited to 'docs')

diff --git a/docs/cobbler.pod b/docs/cobbler.pod
index 3d7d4da..f586f5f 100644
--- a/docs/cobbler.pod
+++ b/docs/cobbler.pod
@@ -246,16 +246,17 @@ mirror types, such as local paths and rsync:// mirrors.  This option requires yu
 
 =head2 DISPLAYING CONFIGURATION ENTRIES
 
-This is a rather simple command, usable regardless of how you are using cobbler.
+The following commands are usable regardless of how you are using cobbler.
+"report" gives detailed configuration info. "list" just lists the names of items in the configuration.
+Run these commands to check how you have cobbler configured.
 
-B<cobbler report [--settings] [--profiles] [--distros] [--systems] [--repos]>
+B<cobbler report>
 
-Prints the current cobbler configuration for systems, profiles, and groups. If one of the switches is given, only information for those is printed.
+B<cobbler distro|profile|system|repo report>
 
-The list command gives an abbreviated version of what "report" gives.
-It only returns the names of each item.
+B<cobbler list>
 
-B<cobbler list [--settings] [--profiles] [--distros] [--systems] [--repos]>
+B<cobbler distro|profile|system|repo list>
 
 Alternatively, you could look at the configuration files in /var/lib/cobbler to see the same information.  
 
@@ -271,6 +272,25 @@ B<cobbler system remove --name=string>
 
 B<cobbler remove repo --name=string>
 
+=head2 EDITING
+
+If you want to change a particular setting without doing an "add" again, use the "edit" command, using
+the same name you gave when you added the item.
+
+B<cobbler distro|profile|system|repo edit --name=string [parameterlist]>
+
+=head2 COPYING
+
+Objects can also be copied:
+
+B<cobbler distro|profile|system|repo copy --name=oldname --newname=newname>
+
+=head2 RENAMING
+
+Objects can also be renamed, as long as other objects don't reference them.
+
+B<cobbler distro|profile|system|repo rename --name=oldname --newname=newname>
+
 =head2 REBUILDING CONFIGURATIONS
 
 B<cobbler sync>
-- 
cgit