Cách cài đặt các trang tùy chỉnh (thủ công) trên mac os x

Question

Tôi đang cố gắng cài đặt một trang hướng dẫn cho một tập lệnh bash trên Mac OS X 10.9.5. Thủ tục mà tôi đã cố gắng theo dõi được tóm tắt tại đây: man page tutorial. Tôi cũng tóm tắt các bước mà tôi đã cố gắng dưới đây:

cp custom_command.1 /usr/local/man/man1/custom_command.1 
gzip /usr/local/man/man1/custom_command.1 

Khi cố gắng man custom_command tôi nhận được đầu ra No manual entry for custom_command. Tôi cũng đã thử các phương pháp cài đặt khác được đề cập trong man page tutorial mà không thành công.

Thật thú vị khi lưu ý rằng các bước ở trên đã hoạt động đối với bảng điều khiển emacs, tức là tôi có được hướng dẫn chính xác khi tôi nhập man custom_command. Tuy nhiên, lệnh này không được tự động hoàn thành và tôi nhận được cảnh báo sau trước khi tôi có thể đọc hướng dẫn sử dụng: WARNING: terminal is not fully functional.

Bất kỳ lời khuyên nào về cách giải quyết các vấn đề ở trên (tức là cả với thiết bị đầu cuối hệ thống và bảng điều khiển emacs) sẽ được đánh giá cao.

---

Ghi chú 1

Đối với một tài liệu tham khảo, người đàn ông kịch bản mà tôi đang cố gắng để cài đặt được lấy từ tutorial và được trình bày lại dưới đây để tham khảo:

.\" Manpage for nuseradd. 
.\" Contact vivek@nixcraft.net.in to correct errors or typos. 
.TH man 8 "06 May 2010" "1.0" "nuseradd man page" 
.SH NAME 
nuseradd \- create a new LDAP user 
.SH SYNOPSIS 
nuseradd [USERNAME] 
.SH DESCRIPTION 
nuseradd is high level shell program for adding users to LDAP server. On Debian, administrators should usually use nuseradd.debian(8) instead. 
.SH OPTIONS 
The nuseradd does not take any options. However, you can supply username. 
.SH SEE ALSO 
useradd(8), passwd(5), nuseradd.debian(8) 
.SH BUGS 
No known bugs. 
.SH AUTHOR 
Vivek Gite (vivek@nixcraft.net.in) 

---

Ghi chú 2

Một trong những gợi ý mà tôi đã thấy trong diễn đàn Linux là chạy lệnh mandb sau khi cài đặt lệnh mới man. Tuy nhiên, lệnh này không có sẵn trên hệ điều hành của tôi.

Answer 1

Trước hết bạn có thể muốn kiểm tra xem man page của bạn đang cố gắng để cài đặt được định dạng đúng cách và có thể được mở bằng man lệnh. Để thực hiện điều này, hãy chuyển đường dẫn đến tệp man tới lệnh man. Nó phải chứa một dấu gạch chéo để được công nhận là một con đường, ví dụ:

man /usr/local/man/man1/custom_command.1 

Sau đó, bạn nên chắc chắn rằng con đường bạn đang cài đặt trang người đàn ông của bạn để nằm trong danh sách tìm kiếm của man lệnh.Để tìm man page đường đi của nó phải là:

• định với -M tùy chọn để lệnh man
• bộ trong biến môi trường MANPATH
• liệt kê trong tập tin cấu hình của nó (/private/etc/man.conf trên OS X) theo tuyên bố MANPATH hoặc theo tuyên bố MANPATH_MAP (chỉ áp dụng cho các vị trí trong biến số môi trường PATH)
• của bạn ở vị trí tương đối với nơi cài đặt nhị phân, nghĩa là: nếu nhị phân được cài đặt trong path/bin man page được tìm kiếm trong path/man, path/cat và path/bin/man, path/bin/cat
• được liệt kê trong các tập tin được thêm vào trong thư mục /private/etc/manpaths.d/

Tên của tập tin trang người đàn ông phải giống như tên lệnh với số phần tùy chọn. Nó có thể được gzipped.

Để xem nơi người đàn ông sẽ tìm kiếm cho chạy trang custom_command người đàn ông của bạn

man -d custom_command 

Answer 2

OS X lệnh sử dụng các trang người đàn ông thường được tạo ra trong:

/usr/local/share/man/man1 

Nếu bạn thích để tạo ra các trang người đàn ông trong một chỉnh sửa thư mục khác nhau:

/private/etc/man.conf 

Sau đó, thêm con đường mới để MANPATH_MAP, cho ví dụ:

MANPATH_MAP  /usr/local/bin   /usr/local/man 

Để người đàn ông tìm kiếm đường dẫn không mặc định với một dự phòng mặc định (/usr/local/share/man):

MANPATH   /usr/local/man  
MANPATH   /usr/local/share/man 
MANPATH_MAP  /usr/local/bin   /usr/local/share/man 

Answer 3

Tôi đã cài đặt gói qua brew, nhưng lệnh người đàn ông đã vẽ một trống vì tôi đã cài đặt bia vào một thư mục khác nhau. Để làm tròn điều này, vẫn liên kết các gói (liên kết nội dung lên một vài thư mục), sau đó tôi có thể thêm vào MANPATH trong ... bash_profile, như vậy ...

MANPATH="/Users/me/Developer/share/man:$MANPATH"