Function get_manpage_text

explainshell/extraction/llm/text.py:45–60

Run patched ``mandoc -T markdown `` to get markdown directly.

(gz_path: str)

def get_manpage_text(gz_path: str) -> str:
    """Run patched ``mandoc -T markdown <gz_path>`` to get markdown directly."""
    if not os.path.isfile(gz_path):
        raise FileNotFoundError(f"manpage file not found: {gz_path}")
    result = subprocess.run(
        [config.MANDOC_PATH, "-T", "markdown", gz_path],
        capture_output=True,
        text=True,
        timeout=60,
    )
    if result.returncode != 0 or not result.stdout.strip():
        raise ExtractionError(
            f"mandoc failed for {gz_path}: {result.stderr}",
            reason_class=FailureReason.MANDOC_FAILED,
        )
    return result.stdout.strip()


def _split_sections(text: str) -> list[tuple[int, str]]: