doc: remove module suffix from descriptions

Until now, the listings of all kinds of modules looked quite
inconsistent like this:
- salt.states.smtp
- salt.states.snapper module
- salt.states.solrcloud module
- salt.states.splunk

The `module` suffix is redundant anyways, so let's remove it and do some
further cleanup (adjusting overline/underline usage, underline length)
using the following bash script:

```bash

sed -i 's|\s\+module$||g' doc/ref/*/all/*.*.rst

for rst in doc/ref/*/all/*.*.rst;
do
  # enforce consistent overline/underline usage, remove all overlines
  if [[ $(head -n1 "${rst}") =~ ^=+$ ]];
  then
      sed -i -e 1d "${rst}"
  fi

  # adjust the length of the underline to the length of the module name
  module_name=$(head -n1 "${rst}")
  underline=$(for i in $(seq ${#module_name}); do echo -n "="; done)
  sed -i '2s|^=\+$|'"${underline}"'|g' "${rst}"
done
```
This commit is contained in:
Elias Probst 2020-11-29 20:48:37 +00:00 committed by Megan Wilhite
parent 215e4e2dfb
commit a9fda57b73
1246 changed files with 691 additions and 1614 deletions

View file

@ -1,4 +1,3 @@
==============
salt.auth.auto
==============

View file

@ -1,4 +1,3 @@
================
salt.auth.django
================

View file

@ -1,4 +1,3 @@
==============
salt.auth.file
==============

View file

@ -1,4 +1,3 @@
==================
salt.auth.keystone
==================

View file

@ -1,4 +1,3 @@
==============
salt.auth.ldap
==============

View file

@ -1,4 +1,3 @@
===============
salt.auth.mysql
===============

View file

@ -1,4 +1,3 @@
=============
salt.auth.pam
=============

View file

@ -1,4 +1,3 @@
=============
salt.auth.pki
=============

View file

@ -1,4 +1,3 @@
==============
salt.auth.rest
==============

View file

@ -1,4 +1,3 @@
======================
salt.auth.sharedsecret
======================

View file

@ -1,4 +1,3 @@
================
salt.auth.yubico
================

View file

@ -1,5 +1,5 @@
salt.beacons.adb module
=======================
salt.beacons.adb
================
.. automodule:: salt.beacons.adb
:members:

View file

@ -1,5 +1,5 @@
salt.beacons.aix_account module
===============================
salt.beacons.aix_account
========================
.. automodule:: salt.beacons.aix_account
:members:

View file

@ -1,5 +1,5 @@
salt.beacons.avahi_announce module
====================================
salt.beacons.avahi_announce
===========================
.. automodule:: salt.beacons.avahi_announce
:members:

View file

@ -1,5 +1,5 @@
salt.beacons.bonjour_announce module
====================================
salt.beacons.bonjour_announce
=============================
.. automodule:: salt.beacons.bonjour_announce
:members:

View file

@ -1,4 +1,3 @@
=================
salt.beacons.btmp
=================

View file

@ -1,4 +1,3 @@
======================
salt.beacons.cert_info
======================

View file

@ -1,4 +1,3 @@
======================
salt.beacons.diskusage
======================

View file

@ -1,5 +1,5 @@
salt.beacons.glxinfo module
===========================
salt.beacons.glxinfo
====================
.. automodule:: salt.beacons.glxinfo
:members:

View file

@ -1,5 +1,5 @@
salt.beacons.haproxy module
===========================
salt.beacons.haproxy
====================
.. automodule:: salt.beacons.haproxy
:members:

View file

@ -1,4 +1,3 @@
====================
salt.beacons.inotify
====================

View file

@ -1,4 +1,3 @@
=====================
salt.beacons.journald
=====================

View file

@ -1,5 +1,5 @@
salt.beacons.junos_rre_keys module
====================================
salt.beacons.junos_rre_keys
===========================
.. automodule:: salt.beacons.junos_rre_keys
:members:

View file

@ -1,4 +1,3 @@
=================
salt.beacons.load
=================

View file

@ -1,6 +1,6 @@
==============================
salt.beacons.log_beacon module
==============================
salt.beacons.log_beacon
=======================
>>>>>>> doc: remove `module` suffix from descriptions
.. automodule:: salt.beacons.log_beacon
:members:

View file

@ -1,5 +1,5 @@
salt.beacons.memusage module
============================
salt.beacons.memusage
=====================
.. automodule:: salt.beacons.memusage
:members:

View file

@ -1,4 +1,3 @@
==========================
salt.beacons.napalm_beacon
==========================

View file

@ -1,4 +1,3 @@
=========================
salt.beacons.network_info
=========================

View file

@ -1,4 +1,3 @@
=============================
salt.beacons.network_settings
=============================

View file

@ -1,4 +1,3 @@
================
salt.beacons.pkg
================

View file

@ -1,5 +1,5 @@
salt.beacons.proxy_example module
=================================
salt.beacons.proxy_example
==========================
.. automodule:: salt.beacons.proxy_example
:members:

View file

@ -1,5 +1,5 @@
salt.beacons.ps module
======================
salt.beacons.ps
===============
.. automodule:: salt.beacons.ps
:members:

View file

@ -1,5 +1,5 @@
salt.beacons.salt_proxy module
==============================
salt.beacons.salt_proxy
=======================
.. automodule:: salt.beacons.salt_proxy
:members:

View file

@ -1,4 +1,3 @@
====================
salt.beacons.service
====================

View file

@ -1,4 +1,3 @@
===============
salt.beacons.sh
===============

View file

@ -1,5 +1,5 @@
salt.beacons.smartos_imgadm module
==================================
salt.beacons.smartos_imgadm
===========================
.. automodule:: salt.beacons.smartos_imgadm
:members:

View file

@ -1,5 +1,5 @@
salt.beacons.smartos_vmadm module
=================================
salt.beacons.smartos_vmadm
==========================
.. automodule:: salt.beacons.smartos_vmadm
:members:

View file

@ -1,5 +1,5 @@
salt.beacons.status module
==========================
salt.beacons.status
===================
.. automodule:: salt.beacons.status
:members:

View file

@ -1,5 +1,5 @@
salt.beacons.swapusage module
=============================
salt.beacons.swapusage
======================
.. automodule:: salt.beacons.swapusage
:members:

View file

@ -1,4 +1,3 @@
=============================
salt.beacons.telegram_bot_msg
=============================

View file

@ -1,4 +1,3 @@
===========================
salt.beacons.twilio_txt_msg
===========================

View file

@ -1,5 +1,5 @@
salt.beacons.watchdog module
============================
salt.beacons.watchdog
=====================
.. automodule:: salt.beacons.watchdog
:members:

View file

@ -1,4 +1,3 @@
=================
salt.beacons.wtmp
=================

View file

@ -1,4 +1,3 @@
========================
salt.cloud.clouds.aliyun
========================

View file

@ -1,4 +1,3 @@
==========================
salt.cloud.clouds.azurearm
==========================

View file

@ -1,4 +1,3 @@
=====================
salt.cloud.clouds.clc
=====================

View file

@ -1,4 +1,3 @@
============================
salt.cloud.clouds.cloudstack
============================

View file

@ -1,4 +1,3 @@
==============================
salt.cloud.clouds.digitalocean
==============================

View file

@ -1,4 +1,3 @@
===============================
salt.cloud.clouds.dimensiondata
===============================

View file

@ -1,4 +1,3 @@
=====================
salt.cloud.clouds.ec2
=====================

View file

@ -1,4 +1,3 @@
=====================
salt.cloud.clouds.gce
=====================

View file

@ -1,4 +1,3 @@
========================
salt.cloud.clouds.gogrid
========================

View file

@ -1,4 +1,3 @@
=========================
salt.cloud.clouds.hetzner
=========================

View file

@ -1,4 +1,3 @@
========================
salt.cloud.clouds.joyent
========================

View file

@ -1,4 +1,3 @@
=========================
salt.cloud.clouds.libvirt
=========================

View file

@ -1,4 +1,3 @@
========================
salt.cloud.clouds.linode
========================

View file

@ -1,4 +1,3 @@
=====================
salt.cloud.clouds.lxc
=====================

View file

@ -1,4 +1,3 @@
=========================
salt.cloud.clouds.msazure
=========================

View file

@ -1,4 +1,3 @@
===========================
salt.cloud.clouds.oneandone
===========================

View file

@ -1,4 +1,3 @@
============================
salt.cloud.clouds.opennebula
============================

View file

@ -1,4 +1,3 @@
===========================
salt.cloud.clouds.openstack
===========================

View file

@ -1,4 +1,3 @@
========================
salt.cloud.clouds.packet
========================

View file

@ -1,4 +1,3 @@
===========================
salt.cloud.clouds.parallels
===========================

View file

@ -1,4 +1,3 @@
==============================
salt.cloud.clouds.profitbricks
==============================

View file

@ -1,4 +1,3 @@
=========================
salt.cloud.clouds.proxmox
=========================

View file

@ -1,4 +1,3 @@
=======================
salt.cloud.clouds.pyrax
=======================

View file

@ -1,4 +1,3 @@
===========================
salt.cloud.clouds.qingcloud
===========================

View file

@ -1,4 +1,3 @@
=========================
salt.cloud.clouds.saltify
=========================

View file

@ -1,4 +1,3 @@
==========================
salt.cloud.clouds.scaleway
==========================

View file

@ -1,4 +1,3 @@
===========================
salt.cloud.clouds.softlayer
===========================

View file

@ -1,4 +1,3 @@
==============================
salt.cloud.clouds.softlayer_hw
==============================

View file

@ -1,4 +1,3 @@
==============================
salt.cloud.clouds.tencentcloud
==============================

View file

@ -1,4 +1,3 @@
=========================
salt.cloud.clouds.vagrant
=========================

View file

@ -1,4 +1,3 @@
============================
salt.cloud.clouds.virtualbox
============================

View file

@ -1,4 +1,3 @@
========================
salt.cloud.clouds.vmware
========================

View file

@ -1,4 +1,3 @@
=========================
salt.cloud.clouds.vultrpy
=========================

View file

@ -1,4 +1,3 @@
=====================
salt.cloud.clouds.xen
=====================

View file

@ -1,5 +1,5 @@
salt.engines.docker_events module
=================================
salt.engines.docker_events
==========================
.. automodule:: salt.engines.docker_events
:members:

View file

@ -1,6 +1,5 @@
============================
salt.engines.fluent
============================
===================
.. automodule:: salt.engines.fluent
:members:

View file

@ -1,4 +1,3 @@
==========================
salt.engines.http_logstash
==========================

View file

@ -1,6 +1,5 @@
==========================
salt.engines.ircbot
==========================
===================
.. automodule:: salt.engines.ircbot
:members:

View file

@ -1,5 +1,5 @@
salt.engines.junos_syslog module
================================
salt.engines.junos_syslog
=========================
.. automodule:: salt.engines.junos_syslog
:members:

View file

@ -1,5 +1,5 @@
salt.engines.libvirt_events module
==================================
salt.engines.libvirt_events
===========================
.. automodule:: salt.engines.libvirt_events
:members:

View file

@ -1,4 +1,3 @@
=======================
salt.engines.logentries
=======================

View file

@ -1,4 +1,3 @@
============================
salt.engines.logstash_engine
============================

View file

@ -1,4 +1,3 @@
==========================
salt.engines.napalm_syslog
==========================

View file

@ -1,5 +1,5 @@
salt.engines.reactor module
===========================
salt.engines.reactor
====================
.. automodule:: salt.engines.reactor
:members:

View file

@ -1,5 +1,5 @@
salt.engines.redis_sentinel module
==================================
salt.engines.redis_sentinel
===========================
.. automodule:: salt.engines.redis_sentinel
:members:

View file

@ -1,5 +1,5 @@
salt.engines.script module
==========================
salt.engines.script
===================
.. automodule:: salt.engines.script
:members:

View file

@ -1,5 +1,5 @@
salt.engines.slack module
=========================
salt.engines.slack
==================
.. automodule:: salt.engines.slack
:members:

View file

@ -1,4 +1,3 @@
=======================
salt.engines.sqs_events
=======================

View file

@ -1,5 +1,5 @@
salt.engines.stalekey module
============================
salt.engines.stalekey
=====================
.. automodule:: salt.engines.stalekey
:members:

View file

@ -1,4 +1,3 @@
=================
salt.engines.test
=================

View file

@ -1,5 +1,5 @@
salt.engines.thorium module
===========================
salt.engines.thorium
====================
.. automodule:: salt.engines.thorium
:members:

View file

@ -1,6 +1,5 @@
==========================
salt.engines.webhook
==========================
====================
.. automodule:: salt.engines.webhook
:members:

View file

@ -1,5 +1,5 @@
salt.executors.direct_call module
=================================
salt.executors.direct_call
==========================
.. automodule:: salt.executors.direct_call
:members:

View file

@ -1,5 +1,5 @@
salt.executors.docker module
============================
salt.executors.docker
=====================
.. automodule:: salt.executors.docker
:members:

View file

@ -1,5 +1,5 @@
salt.executors.splay module
===========================
salt.executors.splay
====================
.. automodule:: salt.executors.splay
:members:

View file

@ -1,5 +1,5 @@
salt.executors.sudo module
==========================
salt.executors.sudo
===================
.. automodule:: salt.executors.sudo
:members:

View file

@ -1,4 +1,3 @@
=======================
salt.fileserver.azurefs
=======================

Some files were not shown because too many files have changed in this diff Show more