`man`无法访问自定义联机帮助页

Question

我跟着these instructions在我的计算机上添加了一些联机帮助页，但我仍然无法使用man打开它。

我将$MANPATH设置为/usr/local/man（我export MANPATH=/usr/local/man中的~/.zshrc，并将其获取）并将我的联机帮助页文件复制到/usr/local/man/man3。但是man找不到我想要访问的页面：

$ echo $MANPATH
/usr/local/man
$ tree /usr/local/man
/usr/local/man
└── man3
    ├── mlx.1
    ├── mlx_loop.1
    ├── mlx_new_image.1
    ├── mlx_new_window.1
    └── mlx_pixel_put.1

1 directory, 5 files
$ man mlx
No manual entry for mlx
$ man 3 mlx
No manual entry for mlx in section 3

为什么我会收到此错误，我该怎么办？

Answer 1

似乎文件位于错误的目录中或扩展名不正确。 目录名称表示它包含第3部分（库调用）的联机帮助页，但文件扩展名表明联机帮助页属于第1部分（可执行程序或shell命令）。

你应该能够检查是哪种情况 - 例如mlx.1 - 使用以下命令

man /usr/local/man/man3/mlx.1

这应该显示联机帮助页的名称（可能是大写），后面是括号中的章节编号。

如果显示MLX(1)将文件mlx.1移动到目录/usr/local/man/man1中（如果所有文件都属于第1部分，则只需重命名man3）。如果显示MLX(3)，只需将文件重命名为mlx.3。