stdman for Mac 版
来自 cppreference.com 的格式化 C 标准库手册页
stdman 是什么
stdman 是一个把 cppreference 归档 HTML 文件解析并转换成 groff 格式手册页的工具,面向 Unix 系统,目标是为 C++ 标准库文档提供排版良好、易于阅读的 man 页面。它已在 Linux 和 OS X 上测试过。
对使用者来说,最直接的价值是不用编译就能安装手册页,解决在终端里查 `std::foo` 时没有条目、或只看到 libstdc++ 那一大串 typedef 的问题。如果系统默认 manpath 不包含 `/usr/local`,可以把手册页装到 `/usr/share`,或在 `~/.bashrc` 里管理 `MANPATH`。输出没有颜色时,可以配置 `less` 或改用 `most` 来给 man 页面着色。
需要修改源码或自行生成手册页的人才需要构建,依赖 C++11 编译器、elinks 和 gzip;生成过程未在 Windows/cygwin 上测试。适合经常在终端查阅 C++ 标准库、又希望获得清晰排版文档的开发者。
对使用者来说,最直接的价值是不用编译就能安装手册页,解决在终端里查 `std::foo` 时没有条目、或只看到 libstdc++ 那一大串 typedef 的问题。如果系统默认 manpath 不包含 `/usr/local`,可以把手册页装到 `/usr/share`,或在 `~/.bashrc` 里管理 `MANPATH`。输出没有颜色时,可以配置 `less` 或改用 `most` 来给 man 页面着色。
需要修改源码或自行生成手册页的人才需要构建,依赖 C++11 编译器、elinks 和 gzip;生成过程未在 Windows/cygwin 上测试。适合经常在终端查阅 C++ 标准库、又希望获得清晰排版文档的开发者。
如何安装 stdman
- 打开 终端(按 ⌘ + 空格,输入“终端”)。
- 如果还没安装 Homebrew,先运行下面这条安装命令。
- 运行下面这条命令:
最近 10 个版本记录
最近一次更新为 2018-03-28,当前版本 2018.03.11,共记录最近 1 个版本。
| 版本 | 发布日期 | 类型 | 大小 | macOS | Windows | Linux |
|---|---|---|---|---|---|---|
| 2018.03.11 | 2018-03-28 | 稳定版 | — | — | — | — |
数据来自 GitHub Releases,稳定版优先,同类按发布时间排序。
二进制包支持平台
Homebrew 官方提供的预编译包(bottle)覆盖:
- all
⚠️ 未提供 Intel Mac 的预编译包,Intel 机型需要通过 brew install --build-from-source 从源码编译。
与同类应用对比
只对比公开元数据,不做主观推荐;需要逐项对比时见对比页。
| 应用 | 版本 | 许可证 | 架构 | 近 30 天安装 |
|---|---|---|---|---|
| stdman | 2018.03.11 | MIT | 命令行 | 7 |
| ronn-ng | v0.10.1 | MIT | 命令行 | 8 |
| um | 4.2.0 | MIT | 命令行 | 6 |
| openssl@4 | openssl-4.1.0 | Apache-2.0 | 命令行 | 494,798 |
命令行工具中的类似应用
ronn-ng
Ronn-NG 是已停止维护的原始 Ronn 项目的一个新分支,目前仍在持续维护。um
um 是一个命令行工具,用来创建和维护属于你自己的、类似 man page 的帮助文档。openssl@4
OpenSSL 是一套开源、商用级、功能完整的加密工具箱,主要服务于 TLS(早期称 SSL)、DTLS 和 QUIC 协议。xz
XZ Utils 是一个通用数据压缩库,同时附带命令行工具。它的原生格式是 .xz,也兼容旧的 .lzma 格式。pkgconf
pkgconf 是一个用于配置开发库编译器和链接器标志的程序,功能上是 freedesktop.org 的 pkg-config 的超集,但不追求与原版 p…node
Node.js 是一个开源、跨平台的 JavaScript 运行时环境,让开发者能在浏览器之外运行 JavaScript。所属分类:命令行工具