diff options
author | Felix Fontein <felix@fontein.de> | 2023-03-28 20:06:33 +0200 |
---|---|---|
committer | GitHub <noreply@github.com> | 2023-03-28 11:06:33 -0700 |
commit | 08297ce0dbde9668841dc0949bf6445b75bea7f4 (patch) | |
tree | e7e63ed60c4b30853ef3e834e09850307d1f447a /lib | |
parent | 17ca4169da98e53aaa885a5953b8bafc8e57d88a (diff) | |
download | ansible-08297ce0dbde9668841dc0949bf6445b75bea7f4.tar.gz |
[2.14] ansible-doc: fix broken seealso links in text output (#80285)
* ansible-doc: fix broken seealso links in text output (#80280)
* Fix broken URLs.
* Also remove auto-generated description for modules outside ansible.builtin.
(cherry picked from commit fafb23094e77a619066a92a7fa99a7045292e473)
* Fix URL processing. (#80295)
(cherry picked from commit 086ae4220957cdb66eee8aa060c151a071f3b9bd)
Diffstat (limited to 'lib')
-rwxr-xr-x | lib/ansible/cli/doc.py | 14 |
1 files changed, 10 insertions, 4 deletions
diff --git a/lib/ansible/cli/doc.py b/lib/ansible/cli/doc.py index 803653038a..9f560bcbc6 100755 --- a/lib/ansible/cli/doc.py +++ b/lib/ansible/cli/doc.py @@ -1241,10 +1241,16 @@ class DocCLI(CLI, RoleMixin): if 'module' in item: text.append(textwrap.fill(DocCLI.tty_ify('Module %s' % item['module']), limit - 6, initial_indent=opt_indent[:-2] + "* ", subsequent_indent=opt_indent)) - description = item.get('description', 'The official documentation on the %s module.' % item['module']) - text.append(textwrap.fill(DocCLI.tty_ify(description), limit - 6, initial_indent=opt_indent + ' ', subsequent_indent=opt_indent + ' ')) - text.append(textwrap.fill(DocCLI.tty_ify(get_versioned_doclink('modules/%s_module.html' % item['module'])), - limit - 6, initial_indent=opt_indent + ' ', subsequent_indent=opt_indent)) + description = item.get('description') + if description is None and item['module'].startswith('ansible.builtin.'): + description = 'The official documentation on the %s module.' % item['module'] + if description is not None: + text.append(textwrap.fill(DocCLI.tty_ify(description), + limit - 6, initial_indent=opt_indent + ' ', subsequent_indent=opt_indent + ' ')) + if item['module'].startswith('ansible.builtin.'): + relative_url = 'collections/%s_module.html' % item['module'].replace('.', '/', 2) + text.append(textwrap.fill(DocCLI.tty_ify(get_versioned_doclink(relative_url)), + limit - 6, initial_indent=opt_indent + ' ', subsequent_indent=opt_indent)) elif 'name' in item and 'link' in item and 'description' in item: text.append(textwrap.fill(DocCLI.tty_ify(item['name']), limit - 6, initial_indent=opt_indent[:-2] + "* ", subsequent_indent=opt_indent)) |