Closes#12419.
The command used to search the docs for state examples is below. This
generates a file in Vim's quickfix format that can be loaded with the -q
flag.
find . -type f \( -name '*.rst' -o -name '*.py' \) -print0
| xargs -0 -P10 -n1 awk '
BEGIN { RS=""; FS="\n" }
{ linenr = linect; linect += (NF + 1) }
/^\s+[a-zA-Z0-9'\''_-]+:\n\s+[a-zA-Z0-9'\''_-]+:\n\s+- / {
print FILENAME "|" linenr + 2 "|", $1
}
' > ./salt-states.quickfix
This commit modifes a number of files which have command-line examples
so that the code-block directive is used. This provides more
visually-appealing syntax highlighting.
More commits like this will follow, this commit is part of an overall
documentation audit that I am performing.
This fixes#5827 by specifying the proper name for the software package
which provides add-apt-repository. It may have at one point been called
software-properties-common, but Ubuntu's package search page has
packages going back to 10.04 LTS showing add-apt-repository in the
python-software-properties package.
@h3, thanks for the docs update, we greatly appreciate it! I just
changed the tense (we try to keep the docs third person - I know,
it still needs work). Keep it comming!