Method _convert_doc_content

awscli/help.py:241–258

(self, contents)

    """

    def _convert_doc_content(self, contents):
        settings_overrides = self._DEFAULT_DOCUTILS_SETTINGS_OVERRIDES.copy()
        settings_overrides["report_level"] = 3
        man_contents = publish_string(
            contents,
            writer=manpage.Writer(),
            settings_overrides=self._DEFAULT_DOCUTILS_SETTINGS_OVERRIDES,
        )
        if self._exists_on_path('groff'):
            cmdline = ['groff', '-m', 'man', '-T', 'ascii']
        elif self._exists_on_path('mandoc'):
            cmdline = ['mandoc', '-T', 'ascii']
        else:
            raise ExecutableNotFoundError('groff or mandoc')
        LOG.debug("Running command: %s", cmdline)
        p3 = self._popen(cmdline, stdin=PIPE, stdout=PIPE, stderr=PIPE)
        output = p3.communicate(input=man_contents)[0]
        return output


class PosixBrowserHelpRenderer(BrowserHelpRenderer):