man(1)

ΟΝΟΜΑ
man - μορφοποιεί κι εμφανίζει τις ηλεκτρονικές σελίδες εγχειριδίου
manpath - προσδιορίζει τη διαδρομή αναζήτησης σελίδων εγχειριδίου από το χρήστη.

ΣΥΝΟΨΗ
man [-acdfFhkKtwW] [--διαδρομή] [-m σύστημα] [-p συμβολοσειρά] [-C αρχείο_διευθέτησης] [-M λίστα_διαδρομών] [-P σελιδοποιός] [-S λίστα_ενοτήτων] [ενότητα] όνομα ...

ΠΕΡΙΓΡΑΦΗ
Η man μορφοποιεί και εμφανίζει τις ηλεκτρονικές σελίδες εγχειριδίου. Αν ορίσετε την ενότητα η man ψάχνει μόνο σ' αυτή την ενότητα του εγχειριδίου. Το όνομα είναι κανονικά το όνομα της σελίδας εγχειριδίου, που συνήθως είναι το όνομα μιας εντολής, συνάρτησης ή αρχείου. Παρόλα αυτά, αν το όνομα περιέχει μιά (/) τότε η man το θεωρεί ως όνομα αρχείου, οπότε μπορείς να δώσεις man ./foo.5 ή και ακόμη man /cd/foo/bar.1.gz.

Βλέπε παρακάτω μιά περιγραφή για το πού η man ψάχνει για αρχεία σελίδων εγχειριδίου.

ΕΠΙΛΟΓΕΣ

-C  config_file
    Προσδιορίζει το προς χρήση αρχείο διευθέτησης· η προεπιλογή είναι /etc/man.config. (Βλέπε man.conf(5).)

-M  διαδρομή
    Προσδιορίζει τη λίστα των καταλόγων προς αναζήτηση σελίδων εγχειριδίου. Διαχώρισε τους καταλόγους με άνω και κάτω τελείες. Μια κενή λίστα είναι το ίδιο με το να μη βάλεις -M εντελώς. Βλέπε ΔΙΑΔΡΟΜΗ ΑΝΑΖΗΤΗΣΗΣ ΣΕΛΙΔΩΝ ΕΓΧΕΙΡΙΔΙΟΥ.

-P  σελιδοποιός
    Προσδιορίζει ποιός σελιδοποιός να χρησιμοποιηθεί. Αυτή η επιλογή υπερισχύει της μεταβλητής περιβάλλοντος MANPAGER που με τη σειρά της υπερισχύει της μεταβλητής PAGER. Εκ προεπιλογής, η man χρησιμοποιεί τη /bin/less -isr.

-S  λίστα_ενοτήτων
    Είναι μιά λίστα ενοτήτων προς αναζήτηση σελίδων εγχειριδίου· οι ενότητες χωρίζονται από άνω και κάτω τελείες. Αυτή η επιλογή υπερισχύει της μεταβλητής περιβάλλοντος MANSECT.

-a  Εκ προεπιλογής, η man θα τερματιστεί αφού εμφανίσει τη πρώτη σελίδα εγχειριδίου που θα βρεί. Χρησιμοποιώντας αυτή την επιλογή, η man εξαναγκάζεται να εμφανίσει όλες τις σελίδες εγχειριδίου που ταιριάζουν με το όνομα, και όχι μόνο τη πρώτη σελίδα.

-c  Επαναμορφοποιεί τη σελίδα προέλευσης, ακόμη και αν υφίσταται ενημερωμένη σελίδα cat. Αυτό μπορεί να είναι σημαντικό αν η σελίδα cat είχε μορφοποιηθεί για μιά οθόνη με διαφορετικό αριθμό στηλών, ή αν η προμορφοποιημένη σελίδα είναι διαβρωμένη.

-d  Δεν εμφανίζει σελίδες εγχειριδίου, αλλά εμφανίζει πληροφορίες αποσφαλμάτωσης.

-D  Εμφανίζει και σελίδες και πληροφορίες αποσφαλμάτωσης.

-f  Ισοδύναμη με την whatis.

-F ή --preformat
    Μορφοποιεί μόνο - δεν εμφανίζει.

-h  Εμφάνιση μηνύματος βοήθειας σε μιά γραμμή και έξοδος.

-k  Ισοδύναμη με την apropos.

-K  Ερευνά για την ορισμένη συμβολοσειρά σε *όλες* τις σελίδες εγχειριδίου. Προειδοποίηση: αυτό πιθανώς να τραβήξει σε μάκρος! Αν ορίσεις ενότητα όμως σίγουρα θα βοηθήσει. (Για να δώσω μίαν ιδέα, στο μηχάνημά μου αυτό παίρνει ένα λεπτό ανά 500 σελίδες εγχειριδίου.)

-m  σύστημα
    Ορίζει προς έρευνα, ένα εναλλακτικό σύνολο σελίδων εγχειριδίου που βρίσκονται στο σύστημα με το δεδομένο όνομα.

-p  συμβολοσειρά
    Ορίζει την ακολουθία των προεπεξεργαστών που θα τρέξουν πριν το nroff ή troff. Όλες οι εγκαταστάσεις δεν διαθέτουν ένα πλήρες σύνολο προεπεξεργαστών. Μερικοί προεπεξεργαστές και τα γράμματα που τους χαρακτηρίζουν είναι: eqn (e), grap (g), pic (p), tbl (t), vgrind (v), refer (r). Αυτή η επιλογή υπερισχύει της μεταβλητής περιβάλλοντος MANROFFSEQ.

-t  Χρήση της /build/jenkins/v2016.12/machine/sama5d3-xplained/build/tmp-angstrom-glibc/sysroots/x86_64-linux/usr/bin/groff -Tps -mandoc -c προς μορφοποίηση της σελίδας εγχειριδίου, οδηγώντας την έξοδο στην τυπική έξοδο. Η έξοδος από τη /build/jenkins/v2016.12/machine/sama5d3-xplained/build/tmp-angstrom-glibc/sysroots/x86_64-linux/usr/bin/groff -Tps -mandoc -c μπορεί να πρέπει να περάσει δια μέσου κάποιου φίλτρου πριν εμφανιστεί.

-w ή --διαδρομή
    Δεν εμφανίζει τις σελίδες εγχειριδίου, αλλά εμφανίζει τη(τις) τοποθεσία(ες) των αρχείων που θα μορφοποιηθούν ή εμφανιστούν. Αν δε δοθεί όρισμα: εμφανίζει (στη τυπική έξοδο) τη λίστα των καταλόγων που ερευνώνται από τη man για σελίδες εγχειριδίου. Αν η manpath είναι δεσμός προς τη man, τότε «manpath» ισοδυναμεί με «man --διαδρομή».

-W  Όπως η -w, αλλά εμφάνιση ονομάτων αρχείων, ένα ανά γραμμή, χωρίς συμπληρωματική πληροφόρηση. Αυτό είναι χρήσιμο σε εντολές κελύφους όπως η man -aW man | xargs ls -l

ΣΕΛΙΔΕΣ CAT
Η man θα προσπαθήσει να διασώσει τις μορφοποιημένες σελίδες εγχειριδίου, ούτως ώστε να εξοικονομήσει χρόνο μορφοποίησης για την επόμενη φορά που θα χρειαστούν αυτές οι σελίδες. Παραδοσιακώς, μορφοποιημένες εκδόσεις σελίδων στον DIR/manX διασώζονται στον DIR/catX, ενώ άλλες απεικονίσεις από man dir σε cat dir μπορούν να προδιαγραφούν στο αρχείο /etc/man.config. Όταν ο απαιτούμενος κατάλογος cat δεν υφίσταται, τότε δεν διασώζονται οι σελίδες cat. Όταν οι σελίδες cat είναι μορφοποιημένες για μήκος γραμμής διαφορετικό από το 80, τότε επίσης δεν διασώζονται. Ουδεμία σελίδα cat διασώζεται αν το αρχείο man.conf περιέχει τη γραμμή NOCACHE.

Είναι δυνατόν να γίνει η man suid σε ένα χρήστη man. Τότε, αν ένας κατάλογος cat έχει ιδιοκτήτη τον man και άδειες 0755 (εγγραφές μόνο από τον man), και τα αρχεία cat έχουν ιδιοκτήτη τον man και άδειες 0644 ή 0444 (εγγραφές μόνο από τον man, ή ουδεμία δυνατότητα εγγραφής), τότε ουδείς κανονικός χρήστης μπορεί να αλλάξει τις σελίδες cat ή να τοποθετήσει άλλα αρχεία στον κατάλογο cat. Αν η man δεν έχει γίνει suid, τότε πρέπει ένας κατάλογος cat να έχει άδειες 0777, προκειμένου όλοι οι χρήστες να έχουν τη δυνατότητα να εναποθέτουν εκεί σελίδες cat.

Η επιλογή -c υποχρεώνει την επαναμορφοποίηση μιάς σελίδας, ακόμη και αν υφίσταται πρόσφατη σελίδα cat.

ΔΙΑΔΡΟΜΗ ΑΝΑΖΗΤΗΣΗΣ ΣΕΛΙΔΩΝ ΕΓΧΕΙΡΙΔΙΟΥ
Η man χρησιμοποιεί μιά εξελιγμένη μέθοδο εντοπισμού αρχείων σελίδων εγχειριδίου, βασισμένη στις επιλογές κλήσης και στις μεταβλητές περιβάλλοντος, στο αρχείο διευθέτησης /etc/man.config και σε ορισμένες ενσωματωμένες συμβάσεις και ιδιοκατασκευές.

Κατ' αρχήν, όταν το όρισμα όνομα στη man περιέχει μία (/), τότε η man υποθέτει ότι είναι ένα όνομα αρχείου, και ως εκ τούτου δεν υπάρχει λόγος αναζήτησης.

Αλλά στη κανονική περίπτωση όπου το όνομα δεν περιέχει μία (/), τότε η man αναζητεί σε μιά ποικιλία καταλόγων, ένα αρχείο που θα μπορούσε να είναι μιά σελίδα εγχειριδίου με το συγκεκριμένο όνομα.

Αν δώσεις την επιλογή -M λίστα_διαδρομών τότε λίστα_διαδρομών είναι μια λίστα καταλόγων χωρισμένων από άνω και κάτω τελείες που ερευνά η man.

Αν δεν χρησιμοποιήσεις την επιλογή -M αλλά ορίσεις τη μεταβλητή περιβάλλοντος MANPATH τότε η τιμή αυτής της μεταβλητής είναι η λίστα των καταλόγων που η man ερευνά.

Αν δεν προσδιορίσεις μιά συγκεκριμένη λίστα διαδρομών με την επιλογή -M ή MANPATH, τότε η man παράγει τις δικές της λίστες βασιζόμενη στο περιεχόμενο του αρχείου διευθέτησης /etc/man.config. Η δήλωση MANPATH στο αρχείο διευθέτησης προσδιορίζει συγκεκριμένους καταλόγους για να συμπεριληφθούν στη διαδρομή αναζήτησης.

Επιπλέον, οι δηλώσεις MANPATH_MAP προσθέτουν στη διαδρομή αναζήτησης ανάλογα με τη διαδρομή σου αναζήτησης εντολών (δηλ. τη μεταβλητή περιβάλλοντός σου) PATH. Για κάθε κατάλογο που μπορεί να βρίσκεται στη διαδρομή αναζήτησης εντολών, μιά δήλωση MANPATH_MAP προσδιορίζει ένα κατάλογο που θα πρέπει να προστεθεί στη διαδρομή αναζήτησης για αρχεία σελίδων εγχειριδίου. Η man ψάχνει στη μεταβλητή PATH και προσθέτει τους αντίστοιχους καταλόγους στη διαδρομή αναζήτησης αρχείων σελίδων εγχειριδίου. Έτσι, με τη σωστή χρήση της MANPATH_MAP, όταν δίνεις την εντολή man xyz, παίρνεις μιά σελίδα εγχειριδίου για το πρόγραμμα που θα έτρεχε αν έδινες την εντολή xyz.

Επιπλέον, για κάθε κατάλογο στη διαδρομή αναζήτησης εντολών (που θα τον ονομάσουμε «κατάλογο εντολών») για τον οποίο δεν έχεις μιά δήλωση MANPATH_MAP η man αυτομάτως ψάχνει για ένα κατάλογο σελίδων εγχειριδίου «στα πέριξ» δηλαδή σ' ένα υποκατάλογο του ίδιου του καταλόγου εντολών ή στο γονικό κατάλογο του καταλόγου εντολών.

Μπορείς ν' απενεργοποιήσεις τις αυτόματες αναζητήσεις «στα πέριξ» συμπεριλαμβάνοντας τη δήλωση NOAUTOPATH στο αρχείο /etc/man.config.

Σε κάθε κατάλογο, στη διαδρομή αναζήτησης όπως περιγράφηκε παραπάνω, η man ερευνά για ένα αρχείο με όνομα θέμα.ενότητα, με μιά προαιρετική επέκταση στον αριθμό ενότητας και πιθανώς με μιά επέκταση συμπίεσης. Αν δε βρει τέτοια αρχεία, τότε ψάχνει σε κάθε υποκατάλογο με όνομα manN ή catN όπου N είναι ο αριθμός ενότητας του εγχειριδίου. Αν το αρχείο βρίσκεται σ' ένα υποκατάλογο catN, τότε η man υποθέτει ότι πρόκειται για αρχείο μορφοποιημένης σελίδας εγχειριδίου (σελίδα cat). Ειδάλλως η man υποθέτει ότι είναι αμορφοποίητο. Εν πάσει περιπτώσει, αν το όνομα του αρχείου περιέχει μιά γνωστή επέκταση συμπίεσης (όπως η .gz), τότε η man υποθέτει ότι είναι συμπιεσμένο με το πρόγραμμα gzip.

Αν θέλεις να δεις το πού (ή αν) η man θα θα βρεί τη σελίδα εγχειριδίου για ένα ορισμένο θέμα, τότε χρησιμοποίησε την επιλογή --διαδρομή (-w).

ΠΕΡΙΒΑΛΛΟΝ

MANPATH
    Εάν έχει οριστεί η μεταβλητή MANPATH τότε η man τη χρησιμοποιεί ως τη διαδρομή προς αναζήτηση αρχείων σελίδων εγχειριδίου. Η μεταβλητή αυτή υπερισχύει του αρχείου διευθέτησης και της διαδρομής αυτόματης αναζήτησης, ενώ αγνοείται από την επιλογή -M Βλέπε ΔΙΑΔΡΟΜΗ ΑΝΑΖΗΤΗΣΗΣ ΣΕΛΙΔΩΝ ΕΓΧΕΙΡΙΔΙΟΥ.

MANPL
    Εάν έχει οριστεί η μεταβλητή MANPL τότε χρησιμοποιείται η τιμή της ως μήκος της εμφανιζόμενης σελίδας. Ειδάλλως, ολόκληρη η σελίδα εγχειριδίου θα καταλάβει μιά (επιμήκη) σελίδα.

MANROFFSEQ
    Εάν έχει οριστεί η μεταβλητή MANROFFSEQ η τιμή της χρησιμοποιείται για να ορίσει το σύνολο των προεπεξεργαστών που θα τρέξουν πριν από το nroff ή troff. Εκ προεπιλογής, οι σελίδες περνούν δια μέσου του προεπεξεργαστή tbl πριν από το nroff.

MANSECT
    Εάν έχει οριστεί η μεταβλητή MANSECT η τιμή της χρησιμοποείται για να ορίσει ποιές ενότητες του εγχειριδίου να ερευνηθούν.

MANWIDTH
    Εάν έχει οριστεί η μεταβλητή MANWIDTH η τιμή της χρησιμοποιείται για να ορίσει το πλάτος εμφάνισης των σελίδων εγχειριδίου. Ειδάλλως οι σελίδες μπορεί να εμφανιστούν σ' όλο το πλάτος της οθόνης σου.

MANPAGER
    Εάν έχει οριστεί η μεταβλητή MANPAGER η τιμή της χρησιμοποιείται ως το όνομα του προγράμματος που θα χρησιμοποιηθεί για την εμφάνιση των σελίδων εγχειριδίου. Εάν δεν έχει οριστεί, τότε χρησιμοποιείται η PAGER. Εάν και αυτή δεν έχει τιμή τότε χρησιμοποιείται η /bin/less-isr.

LANG
    Εάν έχει οριστεί η μεταβλητή LANG η τιμή της προσδιορίζει το όνομα των υποκαταλόγων όπου η man ψάχνει κατ' αρχήν για σελίδες εγχειριδίου. Έτσι, η εντολή «LANG=dk man 1 foo» θα υποχρεώσει τη man να ψάξει για τη σελίδα εγχειριδίου foo στο .../dk/man1/foo.1, και αν δεν μπορεί να βρει τέτοιο αρχείο, τότε στο .../man1/foo.1, όπου ... είναι ένας κατάλογος στη διαδρομή αναζήτησης.

NLSPATH,  LC_MESSAGES,  LANG
    Οι μεταβλητές περιβάλλοντος NLSPATH και LC_MESSAGES (ή LANG όταν η δεύτερη δεν υφίσταται) παίζουν ρόλο στον εντοπισμό του καταλόγου μηνυμάτων. (Αντιθέτως τα μηνύματα στην αγγλική είναι προεγκατεστημένα, και για τα αγγλικά δεν απαιτείται κατάλογος.) Σημείωσε ότι προγράμματα όπως το col(1) που καλούνται από τη man κάνουν επίσης χρήση του LC_CTYPE.

PATH
    Η μεταβλητή PATH βοηθά στον ορισμό της διαδρομής αναζήτησης για αρχεία σελίδων εγχειριδίου. Βλέπε ΔΙΑΔΡΟΜΗ ΑΝΑΖΗΤΗΣΗΣ ΣΕΛΙΔΩΝ ΕΓΧΕΙΡΙΔΙΟΥ.

SYSTEM
    Η μεταβλητή SYSTEM χρησιμοποιείται για να πάρεις το προεπιλεγμένο εναλλακτικό σύστημα (χρήση με την επιλογή -m ) .

ΒΛΕΠΕ ΕΠΙΣΗΣ
apropos(1), whatis(1), less(1), groff(1), man.conf(5).

ΣΦΑΛΜΑΤΑ
Η επιλογή -t δουλεύει μόνο αν έχει εγκασταθεί ένα πρόγραμμα όπως το troff.
Αν βλέπεις φωτεινά \255 ή <AD> αντί για ενωτικά σημεία, βάλε «LESSCHARSET=latin1» στο περιβάλλον σου.

ΚΟΛΠΑ
Αν προσθέσεις τη γραμμή

(global-set-key [(f1)] (lambda () (interactive) (manual-entry (current-word))))

στο αρχείο σου .emacs τότε πατώντας F1 θα πάρεις τη σελίδα εγχειριδίου για τη κλήση βιβλιοθήκης που υπάρχει στη τρέχουσα θέση του δρομέα.

Για να πάρεις ένα απλό κείμενο μιάς σελίδας εγχειριδίου, χωρίς έντονa γράμματα ή υπογραμμίσεις, δοκίμασε με

  # man foo | col -b > foo.mantxt