Various work on --os-version support and better filtering for --breed

1 files changed, 6 insertions, 1 deletions

diff --git a/docs/cobbler.pod b/docs/cobbler.pod
index 9444add1..52bb5966 100644
--- a/docs/cobbler.pod
+++ b/docs/cobbler.pod
@@ -106,13 +106,18 @@ See the section on "Kickstart Templating" for further information.
 
 =item breed
 
-Controls how kernel arguments for automatic installation are to be treated.  Defaults to "redhat", which is a suitable value for Fedora and Centos as well.  It means anything redhat based.
+Controls how various physical and virtual parameters, including kernel arguments for automatic installation, are to be treated.  Defaults to "redhat", which is a suitable value for Fedora and CentOS as well.  It means anything redhat based.
 
 There is limited experimental support for specifying "debian" or "suse", which treats the kickstart file as a different format and changes the kernel
 arguments appropriately.   Support for other types of distributions is possible in the future.  
 
 The file used for the answer file, regardless of the breed setting, is the value used for --kickstart when creating the profile.  
 
+=item os-version
+
+Generally this is a comment field, but it can affect some hardware setup for virtualized instances when
+provisioning guests with koan.  The valid options for --os-version vary depending on what is specified for --breed.  If you specify an invalid option, the error message will contain a list of valid os versions that can be used.  If you do not know the os version or it does not appear in the list, omitting this argument or using "other" should be perfectly fine.  Largely this is needed to support older distributions in virtualized settings, such as "rhel2.1", one of the OS choices if the breed is set to "redhat".
+
 =item owners
 
 Users with small sites and a limited number of admins can probably ignore this option.  All cobbler objects (distros, profiles, systems, and repos) can take a --owners parameter to specify what cobbler users can edit particular objects.  This only applies to the Cobbler WebUI and XMLRPC interface, not the "cobbler" command line tool run from the shell.  Furthermore, this is only respected by the "authz_ownership" module which must be enabled in /etc/cobbler/modules.conf.  The value for --owners is a comma seperated list of users and groups as specified in /etc/cobbler/users.conf.  For more information see the users.conf file as well as the Cobbler Wiki.  In the default Cobbler configuration, this value is completely ignored, as is users.conf.