Jak zainstalować niestandardowe strony (manualne) na Mac OS X

Question

Próbuję zainstalować stronę man dla skryptu bash na Mac OS X 10.9.5. Procedura, którą próbowałem wykonać, została podsumowana tutaj: man page tutorial. I podsumowuje również kroki, które próbowałem poniżej:

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

Gdy próbuje man custom_command uzyskać wyjście No manual entry for custom_command. Próbowałem również inne metody instalacji wymienione w man page tutorial bez powodzenia.

Warto zauważyć, że powyższe kroki działały dla konsoli emacs, tj. Otrzymałem prawidłową instrukcję, gdy wpisuję man custom_command. Jednak polecenie nie jest rozpoznawane przez autouzupełnianie i otrzymuję następujące ostrzeżenie, zanim będę mógł przeczytać instrukcję: WARNING: terminal is not fully functional.

Wszelkie porady dotyczące sposobu rozwiązania powyższych problemów (tj. Zarówno z terminalem systemowym, jak i konsolą emacs) byłyby mile widziane.

---

Uwaga 1

Dla odniesienia, skrypt człowiek który próbuję zainstalować została podjęta z tutorial i przekształconym poniżej dla odniesienia:

.\" 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) 

---

Uwaga 2

Jedną z sugestii, którą widziałem na forach Linux-a, było uruchomienie polecenia mandb po instalacji nowego polecenia: man. Jednak to polecenie nie jest dostępne w moim systemie operacyjnym.

Answer 1

Przede wszystkim warto sprawdzić, czy strona człowiek swój próbują zainstalować prawidłowo sformatowany i można otworzyć za pomocą polecenia man. W tym celu należy podać ścieżkę do pliku man do polecenia man. Musi ona zawierać ukośnik, aby być uznane jako ścieżki, na przykład:

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

Następnie należy upewnić się, że ścieżka instalujesz swoją stronę podręcznika do znajduje się na liście wyszukiwania dowodzenia man.W celu znalezienia strony człowieka jego droga musi być:

• określony z -M opcją komendy man
• ustawić w zmiennej środowiskowej MANPATH
• wymienionego w pliku konfiguracyjnym (/private/etc/man.conf na OS X) pod instrukcją MANPATH lub pod MANPATH_MAP oświadczeniem (dotyczy tylko lokalizacji w zmiennej środowiskowej)
• zlokalizowanej w miejscu, w którym zainstalowany jest plik binarny, tj .: jeśli plik binarny jest zainstalowany w path/bin strony człowiek jest poszukiwany w path/man, path/cat i path/bin/man, path/bin/cat
• wymienione w plikach dodawanych w /private/etc/manpaths.d/ katalogu

Nazwa widoku pliku człowiek musi być taka sama jak nazwa polecenia z dowolnej liczby sekcji. Może być spakowany gzipem.

Aby zobaczyć, gdzie człowiek będzie szukał swojej stronie biegu custom_command człowieka

man -d custom_command 

Answer 2

OS X polecenia użytkownika strony man są zwykle tworzone w:

/usr/local/share/man/man1 

Jeśli wolisz, aby tworzyć strony podręcznika w innej edycji katalogu:

/private/etc/man.conf 

Następnie dodać nową ścieżkę do MANPATH_MAP dla Przykład:

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

Aby człowiek szukać non-domyślną ścieżkę z domyślnym awaryjnej (/usr/local/share/man):

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

Answer 3

miałem zainstalowanych pakietów poprzez brew, ale polecenie człowiek rysunek pusty bo miałem zainstalowany napar do innego katalogu. Aby obejść ten nadal łączenie pakietów (które związane zawartość się kilka katalogów), mogłem wtedy dodać do manpath w moim bash_profile, tak jak ...

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