“man`无法访问自定义手册页

Question

我跟随these instructions在我的电脑上添加了一些手册页，但我仍然无法用man打开它。

我将$MANPATH设置为/usr/local/man (我的~/.zshrc中的export MANPATH=/usr/local/man，并提供了源代码)，并将我的手册页文件复制到/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。