使用 Homebrew 安装 texi2mdoc

项目链接

• 主页

命令和别名

• texi2mdoc

项目历史

The mandoc development history records work on texi2mdoc beginning on 2015-02-16, credited to Kristaps Dzonsons, as a converter from texinfo(5) to mdoc(7). The mandoc homepage later listed texi2mdoc alongside pod2mdoc and docbook2mdoc as companion utilities for translating non-mdoc documentation formats into native BSD manual markup.

采用历史

texi2mdoc has remained a niche tool rather than a broad application platform. Its adoption is most visible in source-based packaging and documentation maintenance contexts where maintainers prefer checked-in mdoc manuals over generated Info files or heavier documentation build chains.

使用方式

Package maintainers use texi2mdoc when upstream documentation is written in Texinfo but the target distribution wants mdoc(7) manual pages that can be rendered and checked by mandoc. It sits in the same workflow family as pod2mdoc and docbook2mdoc: conversion first, then manual review and packaging.

为什么软件包爱好者会关心

For package nerds, texi2mdoc matters because it bridges GNU-style Texinfo documentation and BSD-style manual-page culture. It is small, single-purpose, and useful when a port wants native manpages without carrying a large Texinfo runtime path.

时间线

• 2015: mandoc development history records the start of texi2mdoc work as a texinfo(5) to mdoc(7) converter.
• 2015 onward: texi2mdoc is distributed as a mandoc companion utility for documentation conversion.

Related projects

• mandoc provides the mdoc/man compiler and documentation-tooling context for texi2mdoc.
• GNU Texinfo is the source documentation format texi2mdoc converts from.
• pod2mdoc and docbook2mdoc are sibling conversion utilities in the mandoc ecosystem.

来源

• https://mandoc.bsd.lv/ - lists texi2mdoc as a utility to convert GNU Texinfo documents to mdoc(7).
• https://mandoc.bsd.lv/devhistory.html - records 2015-02-16 start of texi2mdoc work as a texinfo(5) to mdoc(7) converter.