Non ho idea di come rendere disponibili i miei script specializzati in casa (scritti principalmente in Bash e Perl) tramite man pagine.
Quale procedura dovrei seguire e c'è un formato particolare in cui la documentazione deve essere scritta per poterlo fare?
Risposta accettata:
Ho scoperto che usare il POD di Perl è molto più semplice che scrivere direttamente le pagine man e puoi creare una pagina man dal file POD con pod2man utility (parte del pacchetto Perl di base). Poiché alcuni dei tuoi eseguibili sono già scritti in Perl, puoi aggiungere la formattazione POD direttamente ai tuoi script e possono essere trasformati direttamente in file POD. Ho anche visto diversi progetti utilizzare il formato POD anche se il loro codice è scritto in altre lingue, grazie alla semplicità di POD.
Per aggiungere una directory aggiuntiva di pagine man, puoi impostare il $MANPATH variabile d'ambiente. Prefisso $MANPATH con un : per averlo aggiunto alla lista dei percorsi man già configurati. Usa il manpath comando per vedere i percorsi man attualmente definiti.