`man` не может получить доступ к пользовательским страницам

Question

Я следовал этим инструкциям, чтобы добавить некоторые man-страницы на мой компьютер, но все еще не могу открыть его 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

Кажется, что файлы находятся в неправильном каталоге или имеют неправильное расширение. Имя каталога указывает, что оно содержит man-страницы для раздела 3 (вызовы библиотеки), но расширения имени файла предполагают, что man-страницы относятся к разделу 1 (исполняемые программы или команды оболочки).

Вы должны быть в состоянии проверить, в каком случае - например, для mlx.1 - с помощью следующей команды

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

Это должно показать название man-страницы (вероятно, в верхнем регистре), за которым следует номер раздела в скобках в самом начале.

Если это показывает MLX(1) переместить файл mlx.1 в каталог /usr/local/man/man1 (или просто переименовать man3 если все файлы принадлежат разделу 1). Если это показывает MLX(3)просто переименуйте файл в mlx.3,