docs(completions): add @since markers to xfuncs

Author: scop

completions/apt-cache

@@ -2,13 +2,15 @@
 
 # List APT binary packages
 # TODO:API: rework to use vars rather than outputting
+# @since 2.12
 _comp_xfunc_apt_cache_packages()
 {
     apt-cache --no-generate pkgnames "$cur" 2>/dev/null || :
 }
 
 # List APT source packages
 # TODO:API: rework to use vars rather than outputting
+# @since 2.12
 _comp_xfunc_apt_cache_sources()
 {
     compgen -W "$(apt-cache dumpavail |
@@ -17,6 +19,7 @@ _comp_xfunc_apt_cache_sources()
 
 # List APT source packages
 # TODO:API: rework to use vars rather than outputting
+# @since 2.12
 _comp_xfunc_apt_cache_src_packages()
 {
     compgen -W '$(_comp_xfunc_apt_cache_sources "$cur")' -- "$cur"

completions/apt-get

@@ -1,5 +1,6 @@
 # Debian apt-get(8) completion                             -*- shell-script -*-
 
+# @since 2.12
 _comp_xfunc_apt_get_installed_packages()
 {
     if [[ -f /etc/debian_version ]]; then

completions/asciidoc

@@ -1,5 +1,6 @@
 # asciidoc(1) completion                                   -*- shell-script -*-
 
+# @since 2.12
 _comp_xfunc_asciidoc_doctype()
 {
     _comp_compgen -a -- -W 'article book manpage'

completions/cvs

@@ -36,6 +36,7 @@ _comp_cmd_cvs__kflags()
     _comp_compgen -- -W 'kv kvl k o b v'
 }
 
+# @since 2.12
 _comp_xfunc_cvs_roots()
 {
     local -a cvsroots=()

completions/iconv

@@ -1,5 +1,6 @@
 # iconv(1) completion                                      -*- shell-script -*-
 
+# @since 2.12
 _comp_xfunc_iconv_charsets()
 {
     COMPREPLY+=($(compgen -X ... -W '$("${1:-iconv}" -l | \

completions/list_lists

@@ -1,5 +1,6 @@
 # mailman list_lists completion                            -*- shell-script -*-
 
+# @since 2.12
 _comp_xfunc_list_lists_mailman_lists()
 {
     COMPREPLY=($(compgen -W '$(list_lists -b 2>/dev/null)' -- "$cur"))

completions/mysql

@@ -1,5 +1,6 @@
 # mysql(1) completion                                      -*- shell-script -*-
 
+# @since 2.12
 _comp_xfunc_mysql_character_sets()
 {
     local -a charsets

completions/python

@@ -1,12 +1,14 @@
 # bash completion for python                               -*- shell-script -*-
 
+# @since 2.12
 _comp_xfunc_python_modules()
 {
     COMPREPLY+=($(compgen -W \
         "$("${1:-python}" "${BASH_SOURCE[0]%/*}/../helpers/python" "$cur" \
             2>/dev/null)" -- "$cur"))
 }
 
+# @since 2.12
 _comp_xfunc_python_warning_actions()
 {
     COMPREPLY+=($(compgen -W "ignore default all module once error" \

completions/rpm

@@ -2,6 +2,7 @@
 
 # helper functions
 
+# @since 2.12
 _comp_xfunc_rpm_installed_packages()
 {
     if [[ -r /var/log/rpmpkgs &&

completions/ssh

@@ -10,6 +10,7 @@ _comp_cmd_ssh__queries()
     _comp_compgen -ac "${cur,,}" -- -W "$queries help"
 }
 
+# @since 2.12
 # TODO:API:rework to use vars rather than outputting
 _comp_xfunc_ssh_query()
 {
@@ -35,6 +36,7 @@ _comp_cmd_ssh__macs()
     _comp_compgen -a -- -W "$macs"
 }
 
+# @since 2.12
 _comp_xfunc_ssh_options()
 {
     # curl --silent https://raw.githubusercontent.com/openssh/openssh-portable/master/ssh_config.5 | awk '$1==".It" && $2=="Cm" && $3!="Host" && $3!="Match" {print "        "$3}' | sort
@@ -215,6 +217,7 @@ _comp_cmd_ssh__suboption()
 # Try to complete -o SubOptions=
 #
 # Returns 0 if the completion was handled or non-zero otherwise.
+# @since 2.12
 _comp_xfunc_ssh_suboption_check()
 {
     # Get prev and cur words without splitting on =
@@ -250,6 +253,7 @@ _comp_cmd_ssh__configfile()
 }
 
 # With $1 set, look for public key files, else private
+# @since 2.12
 # shellcheck disable=SC2120
 _comp_xfunc_ssh_identityfile()
 {
@@ -432,6 +436,7 @@ _comp_cmd_scp__path_esc='[][(){}<>"'"'"',:;^&!$=?`\\|[:space:]]'
 
 # Complete remote files with ssh.  If the first arg is -d, complete on dirs
 # only.  Returns paths escaped with three backslashes.
+# @since 2.12
 # shellcheck disable=SC2120
 _comp_xfunc_ssh_scp_remote_files()
 {
@@ -475,6 +480,7 @@ _comp_deprecate_func _scp_remote_files _comp_xfunc_ssh_scp_remote_files
 # appended after local file/dir completions, and -o nospace retained for
 # others.  If first arg is -d, complete on directory names only.  The next arg
 # is an optional prefix to add to returned completions.
+# @since 2.12
 _comp_xfunc_ssh_scp_local_files()
 {
     local IFS=$'\n'