diff options
author | Wesley Wiedenmeier <wesley.wiedenmeier@gmail.com> | 2016-08-28 17:56:17 -0500 |
---|---|---|
committer | Scott Moser <smoser@brickies.net> | 2016-09-30 13:21:00 -0400 |
commit | 1071b9940b4e114cd2eabf290b739f92fbab33de (patch) | |
tree | a8fbef15c5be9510df93b4544e3bca1f74e2f29a /cloudinit/config/cc_byobu.py | |
parent | 02f6c4bb8cef17b3fe04ef4dc1ef199e20aeb4d9 (diff) | |
download | vyos-cloud-init-1071b9940b4e114cd2eabf290b739f92fbab33de.tar.gz vyos-cloud-init-1071b9940b4e114cd2eabf290b739f92fbab33de.zip |
Improve module documentation and doc cleanup.
This adds lots of config module documentation in a standard format.
It will greatly improve the content at readthedocs.
Additionally:
* Add a 'doc' env to tox.ini
* Changed default highlight language for sphinx conf from python to yaml
most examples in documentation are yaml configs
* Updated datasource examples to highlight sh code properly
Diffstat (limited to 'cloudinit/config/cc_byobu.py')
-rw-r--r-- | cloudinit/config/cc_byobu.py | 33 |
1 files changed, 33 insertions, 0 deletions
diff --git a/cloudinit/config/cc_byobu.py b/cloudinit/config/cc_byobu.py index ef0ce7ab..1f00dd90 100644 --- a/cloudinit/config/cc_byobu.py +++ b/cloudinit/config/cc_byobu.py @@ -18,6 +18,39 @@ # You should have received a copy of the GNU General Public License # along with this program. If not, see <http://www.gnu.org/licenses/>. +""" +Byobu +----- +**Summary:** enable/disable byobu system wide and for default user + +This module controls whether byobu is enabled or disabled system wide and for +the default system user. If byobu is to be enabled, this module will ensure it +is installed. Likewise, if it is to be disabled, it will be removed if +installed. + +Valid configuration options for this module are: + + - ``enable-system``: enable byobu system wide + - ``enable-user``: enable byobu for the default user + - ``disable-system``: disable byobu system wide + - ``disable-user``: disable byobu for the default user + - ``enable``: enable byobu both system wide and for default user + - ``disable``: disable byobu for all users + - ``user``: alias for ``enable-user`` + - ``system``: alias for ``enable-system`` + +**Internal name:** ``cc_byobu`` + +**Module frequency:** per instance + +**Supported distros:** ubuntu, debian + +**Config keys**:: + + byobu_by_default: <user/system> +""" + + # Ensure this is aliased to a name not 'distros' # since the module attribute 'distros' # is a list of distros that are supported, not a sub-module |