svn rev #25712: trunk/doc/rst_source/ krb_admins/ krb_admins/admin_commands/ ...

[ghudson@MIT.EDU]

http://src.mit.edu/fisheye/changelog/krb5/?cs=25712
Commit By: ghudson
Log Message:
Format pass over RST documentation

Without substantially changing the content, reformat RST
documentation sources, normalizing:

* Whitespace: four-space indentation where indentation is arbitrary;
  no trailing whitespace or tabs.  Two spaces after sentence periods.
* 70-column fill where lines can be wrapped (outside tables, mostly)
* Section header underlines: = for page titles, - for sections, ~ and
  then # for subsections.  Underlines exactly as long as titles.  No
  trailing punctuation in titles.
* Bullet lists: * for top-level bullets, - for sub-bullets.  No
  indentation of the list bullets relative to the surrounding content.
* Inline markup: italics for words representing variable text,
  boldface for config keywords and command option names, monospaced
  text for examples, pathnames.  No adornment for command names and
  filenames.
* Man page subcommands: subsection header for the subcommand, indented
  command synposis, then non-indented description and option list.
* Man page command synopses: newline in source before each option.  All
  parts of synopsis at same indentation level.  (Ideally we'd want a
  hanging indent to the length of the command name, but RST doesn't
  seem to support that.)
* Feedback links: in a separate section at the end.  (This will need
  to be revisited as it affects some multi-level tables of contents.)


Changed Files:
U   trunk/doc/rst_source/index.rst
U   trunk/doc/rst_source/krb_admins/admin_commands/index.rst
U   trunk/doc/rst_source/krb_admins/admin_commands/k5srvutil.rst
U   trunk/doc/rst_source/krb_admins/admin_commands/kadmin_local.rst
U   trunk/doc/rst_source/krb_admins/admin_commands/kadmind.rst
U   trunk/doc/rst_source/krb_admins/admin_commands/kdb5_ldap_util.rst
U   trunk/doc/rst_source/krb_admins/admin_commands/kdb5_util.rst
U   trunk/doc/rst_source/krb_admins/admin_commands/kprop.rst
U   trunk/doc/rst_source/krb_admins/admin_commands/kpropd.rst
U   trunk/doc/rst_source/krb_admins/admin_commands/kproplog.rst
U   trunk/doc/rst_source/krb_admins/admin_commands/krb5kdc.rst
U   trunk/doc/rst_source/krb_admins/admin_commands/ktutil.rst
U   trunk/doc/rst_source/krb_admins/admin_commands/sserver.rst
U   trunk/doc/rst_source/krb_admins/advanced/index.rst
U   trunk/doc/rst_source/krb_admins/advanced/ldapbackend.rst
U   trunk/doc/rst_source/krb_admins/advanced/plugins.rst
U   trunk/doc/rst_source/krb_admins/appl_servers/clock_skew.rst
U   trunk/doc/rst_source/krb_admins/appl_servers/conf_firewall.rst
U   trunk/doc/rst_source/krb_admins/appl_servers/dns_info.rst
U   trunk/doc/rst_source/krb_admins/appl_servers/index.rst
U   trunk/doc/rst_source/krb_admins/appl_servers/keytabs.rst
U   trunk/doc/rst_source/krb_admins/backup_host.rst
U   trunk/doc/rst_source/krb_admins/conf_files/enc_types.rst
U   trunk/doc/rst_source/krb_admins/conf_files/index.rst
U   trunk/doc/rst_source/krb_admins/conf_files/kdc_conf.rst
U   trunk/doc/rst_source/krb_admins/conf_files/krb5_conf.rst
U   trunk/doc/rst_source/krb_admins/conf_ldap.rst
U   trunk/doc/rst_source/krb_admins/database/change_tgtkey.rst
U   trunk/doc/rst_source/krb_admins/database/date_format.rst
U   trunk/doc/rst_source/krb_admins/database/db_operations/create_destroy_db.rst
U   trunk/doc/rst_source/krb_admins/database/db_operations/create_stash.rst
U   trunk/doc/rst_source/krb_admins/database/db_operations/db2file.rst
U   trunk/doc/rst_source/krb_admins/database/db_operations/file2db.rst
U   trunk/doc/rst_source/krb_admins/database/db_operations/index.rst
U   trunk/doc/rst_source/krb_admins/database/db_options.rst
U   trunk/doc/rst_source/krb_admins/database/db_policies/index.rst
U   trunk/doc/rst_source/krb_admins/database/db_policies/mod_pol.rst
U   trunk/doc/rst_source/krb_admins/database/db_policies/retr_pol.rst
U   trunk/doc/rst_source/krb_admins/database/db_policies/update_histkey.rst
U   trunk/doc/rst_source/krb_admins/database/db_princs/index.rst
U   trunk/doc/rst_source/krb_admins/database/db_princs/info_princ.rst
U   trunk/doc/rst_source/krb_admins/database/db_princs/modify_princ.rst
U   trunk/doc/rst_source/krb_admins/database/db_princs/pass_princ.rst
U   trunk/doc/rst_source/krb_admins/database/db_princs/priv_princ.rst
U   trunk/doc/rst_source/krb_admins/database/incr_db_prop.rst
U   trunk/doc/rst_source/krb_admins/database/index.rst
U   trunk/doc/rst_source/krb_admins/database/ldap_operations/edir_create_realm.rst
U   trunk/doc/rst_source/krb_admins/database/ldap_operations/edir_create_so.rst
U   trunk/doc/rst_source/krb_admins/database/ldap_operations/index.rst
U   trunk/doc/rst_source/krb_admins/database/ldap_operations/ldap_create_realm.rst
U   trunk/doc/rst_source/krb_admins/database/ldap_operations/ldap_del_realm.rst
U   trunk/doc/rst_source/krb_admins/database/ldap_operations/ldap_mod_realm.rst
U   trunk/doc/rst_source/krb_admins/database/ldap_operations/ldap_realm_info.rst
U   trunk/doc/rst_source/krb_admins/database/ldap_operations/ldap_realm_list.rst
U   trunk/doc/rst_source/krb_admins/database/ldap_operations/ldap_stash_pass.rst
U   trunk/doc/rst_source/krb_admins/database/ldap_operations/ldap_tkt_pol.rst
U   trunk/doc/rst_source/krb_admins/database/xrealm_authn.rst
U   trunk/doc/rst_source/krb_admins/dns.rst
U   trunk/doc/rst_source/krb_admins/env_variables.rst
U   trunk/doc/rst_source/krb_admins/index.rst
U   trunk/doc/rst_source/krb_admins/install.rst
U   trunk/doc/rst_source/krb_admins/install_appl_srv.rst
U   trunk/doc/rst_source/krb_admins/install_clients/cl_config.rst
U   trunk/doc/rst_source/krb_admins/install_clients/index.rst
U   trunk/doc/rst_source/krb_admins/install_clients/mac_osX_config.rst
U   trunk/doc/rst_source/krb_admins/install_kdc/admins_to_acl.rst
U   trunk/doc/rst_source/krb_admins/install_kdc/admins_to_db.rst
U   trunk/doc/rst_source/krb_admins/install_kdc/create_db.rst
U   trunk/doc/rst_source/krb_admins/install_kdc/index.rst
U   trunk/doc/rst_source/krb_admins/install_kdc/kadmind_kt.rst
U   trunk/doc/rst_source/krb_admins/install_kdc/kdc_prop_slave.rst
U   trunk/doc/rst_source/krb_admins/install_kdc/krb_daemon.rst
U   trunk/doc/rst_source/krb_admins/install_kdc/mod_conf.rst
U   trunk/doc/rst_source/krb_admins/install_kdc/slave_install.rst
U   trunk/doc/rst_source/krb_admins/install_kdc/switch_master_slave.rst
U   trunk/doc/rst_source/krb_admins/realm_config/db_prop.rst
U   trunk/doc/rst_source/krb_admins/realm_config/index.rst
U   trunk/doc/rst_source/krb_admins/realm_config/kdc_hn.rst
U   trunk/doc/rst_source/krb_admins/realm_config/kdc_ports.rst
U   trunk/doc/rst_source/krb_admins/realm_config/mapping_hn.rst
U   trunk/doc/rst_source/krb_admins/realm_config/realm_name.rst
U   trunk/doc/rst_source/krb_admins/realm_config/slave_kdc.rst
U   trunk/doc/rst_source/krb_admins/troubleshoot.rst
U   trunk/doc/rst_source/krb_admins/various_envs.rst
U   trunk/doc/rst_source/krb_appldev/h5l_mit_apidiff.rst
U   trunk/doc/rst_source/krb_appldev/index.rst
U   trunk/doc/rst_source/krb_appldev/princ_handle.rst
U   trunk/doc/rst_source/krb_build/directory_org.rst
U   trunk/doc/rst_source/krb_build/doing_build.rst
U   trunk/doc/rst_source/krb_build/index.rst
U   trunk/doc/rst_source/krb_build/options2configure.rst
U   trunk/doc/rst_source/krb_build/osconf.rst
U   trunk/doc/rst_source/krb_build/test_cov.rst
U   trunk/doc/rst_source/krb_users/index.rst
U   trunk/doc/rst_source/krb_users/pwd_mgmt/grant_access.rst
U   trunk/doc/rst_source/krb_users/pwd_mgmt/index.rst
U   trunk/doc/rst_source/krb_users/pwd_mgmt/pwd_management.rst
U   trunk/doc/rst_source/krb_users/pwd_mgmt/pwd_quality.rst
U   trunk/doc/rst_source/krb_users/tkt_mgmt/destroy_tkt.rst
U   trunk/doc/rst_source/krb_users/tkt_mgmt/index.rst
U   trunk/doc/rst_source/krb_users/tkt_mgmt/obtain_kinit.rst
U   trunk/doc/rst_source/krb_users/tkt_mgmt/tkt_management.rst
U   trunk/doc/rst_source/krb_users/tkt_mgmt/view_klist.rst
U   trunk/doc/rst_source/krb_users/user_appl/ftp.rst
U   trunk/doc/rst_source/krb_users/user_appl/index.rst
U   trunk/doc/rst_source/krb_users/user_appl/ksu.rst
U   trunk/doc/rst_source/krb_users/user_appl/rcp.rst
U   trunk/doc/rst_source/krb_users/user_appl/rlogin.rst
U   trunk/doc/rst_source/krb_users/user_appl/rsh.rst
U   trunk/doc/rst_source/krb_users/user_appl/ssh.rst
U   trunk/doc/rst_source/krb_users/user_appl/telnet.rst
U   trunk/doc/rst_source/krb_users/user_commands/index.rst
U   trunk/doc/rst_source/krb_users/user_commands/k5identity.rst
U   trunk/doc/rst_source/krb_users/user_commands/k5login.rst
U   trunk/doc/rst_source/krb_users/user_commands/kdestroy.rst
U   trunk/doc/rst_source/krb_users/user_commands/kinit.rst
U   trunk/doc/rst_source/krb_users/user_commands/klist.rst
U   trunk/doc/rst_source/krb_users/user_commands/kpasswd.rst
U   trunk/doc/rst_source/krb_users/user_commands/ksu.rst
U   trunk/doc/rst_source/krb_users/user_commands/kswitch.rst
U   trunk/doc/rst_source/krb_users/user_commands/kvno.rst
U   trunk/doc/rst_source/krb_users/user_commands/sclient.rst
U   trunk/doc/rst_source/krb_users/user_commands/send-pr.rst
U   trunk/doc/rst_source/mitK5defaults.rst
U   trunk/doc/rst_source/mitK5features.rst
U   trunk/doc/rst_source/mitK5license.rst
U   trunk/doc/rst_source/relay/build_this.rst
U   trunk/doc/rst_source/relay/index.rst
U   trunk/doc/rst_source/relay/philosophy.rst
Diff larger than 5000 lines; suppressing.