man - μια διεπαφή προς τα εγχειρίδια αναφοράς του συστήματος
ΣΥΝΤΑΞΗ
man [επιλογές man] [[ενότητα] σελίδα ...] ...
man -k [επιλογές apropos] κανονική έκφραση ...
man -K [επιλογές man] [ενότητα] όρος ...
man -f [επιλογές whatis] σελίδα ...
man -l [επιλογές man] αρχείο ...
man -w|-W [επιλογές man] σελίδα ...
ΠΕΡΙΓΡΑΦΗ
Το man είναι ο οριστής σελίδων του συστήματος. Κάθε όρισμα σελίδας που δίνεται στο man είναι συνήθως το όνομα ενός προγράμματος, βοηθητικού προγράμματος ή συνάρτησης. Η σελίδα εγχειριδίου που σχετίζεται με καθένα από αυτά τα ορίσματα βρίσκεται και εμφανίζεται. Μια ενότητα, εάν παρέχεται, θα κατευθύνει το man να αναζητήσει μόνο σε αυτήν την ενότητα του εγχειριδίου. Η προεπιλεγμένη ενέργεια είναι να αναζητήσει σε όλες τις διαθέσιμες ενότητες ακολουθώντας μια προκαθορισμένη σειρά (δείτε ΠΡΟΕΠΙΛΕΓΜΕΝΑ) και να εμφανίσει μόνο την πρώτη σελίδα που βρέθηκε, ακόμη και αν η σελίδα υπάρχει σε πολλές ενότητες.
Ο παρακάτω πίνακας δείχνει τους αριθμούς των ενοτήτων του εγχειριδίου που ακολουθούνται από τους τύπους σελίδων που περιέχουν.
1 Εκτελέσιμα προγράμματα ή εντολές κελύφους
2 Κλήσεις συστήματος (συναρτήσεις που παρέχονται από τον πυρήνα)
3 Κλήσεις βιβλιοθήκης (συναρτήσεις εντός των βιβλιοθηκών προγραμμάτων)
4 Ειδικά αρχεία (συνήθως βρίσκονται στο /dev)
5 Μορφές αρχείων και συμβάσεις, π.χ. /etc/passwd
6 Παιχνίδια
7 Διάφορα (συμπεριλαμβανομένων των πακέτων μακροεντολών και των συμβάσεων), π.χ. man(7), groff(7), man-pages(7) 8 Εντολές διαχείρισης συστήματος (συνήθως μόνο για τον χρήστη root) 9 Ρουτίνες πυρήνα [Μη τυπικές]
Μια σελίδα εγχειριδίου αποτελείται από διάφορες ενότητες.
Οι συμβατικές ονομασίες ενότητας περιλαμβάνουν NAME, SYNOPSIS, CONFIGURATION, DESCRIPTION, OPTIONS, EXIT STATUS, RETURN VALUE, ERRORS, ENVIRONMENT, FILES, VERSIONS, STANDARDS, NOTES, BUGS, EXAMPLE, AUTHORS και SEE ALSO.
Οι ακόλουθες συμβάσεις ισχύουν για την ενότητα SYNOPSIS και μπορούν να χρησιμοποιηθούν ως οδηγός σε άλλες ενότητες.
έντονο κείμενο ακριβώς όπως εμφανίζεται.
πλάγιο κείμενο αντικαταστήστε το με το κατάλληλο όρισμα.
[-abc] οποιαδήποτε ή όλα τα ορίσματα εντός [ ] είναι προαιρετικά.
-a|-b οι επιλογές που ορίζονται με | δεν μπορούν να χρησιμοποιηθούν μαζί.
όρισμα ... το όρισμα είναι επαναλήψιμο.
[έκφραση] ... ολόκληρη η έκφραση εντός [ ] είναι επαναλήψιμη.
Η ακριβής απόδοση μπορεί να διαφέρει ανάλογα με τη συσκευή εξόδου. Για παράδειγμα, το man συνήθως δεν θα μπορεί να αποδώσει πλάγια γράμματα κατά την εκτέλεση σε ένα τερματικό και συνήθως θα χρησιμοποιεί υπογράμμιση ή έγχρωμο κείμενο.
Η απεικόνιση της εντολής ή της συνάρτησης είναι ένα μοτίβο που θα πρέπει να ταιριάζει με όλες τις πιθανές προσκλήσεις. Σε ορισμένες περιπτώσεις, είναι σκόπιμο να απεικονιστούν πολλές αποκλειστικές προσκλήσεις, όπως φαίνεται στην ενότητα SYNOPSIS αυτής της σελίδας εγχειριδίου.
ΠΑΡΑΔΕΙΓΜΑΤΑ
man ls
Εμφάνιση της σελίδας εγχειριδίου για το στοιχείο (πρόγραμμα) ls.
man man.7
Εμφανίζει τη σελίδα εγχειριδίου για το πακέτο μακροεντολών man από την ενότητα 7. (Αυτή είναι μια εναλλακτική ορθογραφία του "man 7 man".)
man 'man(7)'
Εμφανίζει τη σελίδα εγχειριδίου για το πακέτο μακροεντολών man από την ενότητα 7. (Αυτή είναι μια άλλη εναλλακτική ορθογραφία του "man 7 man". Μπορεί να είναι πιο βολική κατά την αντιγραφή και επικόλληση διασταυρούμενων αναφορών σε σελίδες εγχειριδίων. Σημειώστε ότι οι παρενθέσεις πρέπει κανονικά να περικλείονται σε εισαγωγικά για να προστατεύονται από το κέλυφος.)
man -a intro
Εμφανίζει διαδοχικά όλες τις διαθέσιμες σελίδες εγχειριδίων intro που περιέχονται στο εγχειρίδιο. Είναι δυνατό να διακόψετε την εμφάνιση μεταξύ των διαδοχικών σελίδων ή να παραλείψετε οποιαδήποτε από αυτές.
man -t bash | lpr -Pps
Μορφοποιεί τη σελίδα εγχειριδίου για το bash στην προεπιλεγμένη μορφή troff ή groff και την διοχετεύει στον εκτυπωτή με όνομα ps. Η προεπιλεγμένη έξοδος για το groff είναι συνήθως PostScript. Το man --help θα σας ενημερώσει σχετικά με το ποιος επεξεργαστής είναι συνδεδεμένος με την επιλογή -t.
man -l -Tdvi ./foo.1x.gz > ./foo.1x.dvi
Αυτή η εντολή θα αποσυμπιέσει και θα μορφοποιήσει τη σελίδα εγχειριδίου nroff ./foo.1x.gz σε ένα αρχείο ανεξάρτητο από συσκευή (dvi). Η ανακατεύθυνση είναι απαραίτητη, καθώς η σημαία -T προκαλεί την αποστολή της εξόδου στην τυπική έξοδο (stdout) χωρίς σελιδοδείκτη. Η έξοδος μπορεί να προβληθεί με ένα πρόγραμμα όπως το xdvi ή να υποστεί περαιτέρω επεξεργασία σε PostScript χρησιμοποιώντας ένα πρόγραμμα όπως το dvips.
man -k printf
Αναζητά στις σύντομες περιγραφές και στα ονόματα των σελίδων εγχειριδίων για τη λέξη-κλειδί printf ως κανονική έκφραση. Εκτυπώνει τυχόν αντιστοιχίες. Ισοδύναμο με το apropos printf.
man -f smail
Αναζητά τις σελίδες εγχειριδίων στις οποίες αναφέρεται το smail και εκτυπώνει τις σύντομες περιγραφές των σελίδων που βρέθηκαν. Ισοδύναμο με το whatis smail.
ΕΠΙΣΚΌΠΗΣΗ
Πολλές επιλογές είναι διαθέσιμες στο man, προκειμένου να παρέχουν στον χρήστη τη μέγιστη δυνατή ευελιξία. Μπορούν να γίνουν αλλαγές στη διαδρομή αναζήτησης, στη σειρά των ενοτήτων, στον επεξεργαστή εξόδου και σε άλλες συμπεριφορές και λειτουργίες που περιγράφονται παρακάτω.
Όταν έχει οριστεί, διάφορες μεταβλητές περιβάλλοντος ανακρίνονται για τον προσδιορισμό της λειτουργίας του man. Είναι δυνατό να οριστεί η μεταβλητή "catch-all" $MANOPT σε οποιαδήποτε συμβολοσειρά σε μορφή γραμμής εντολών, με την εξαίρεση ότι τυχόν κενά που χρησιμοποιούνται ως μέρος ενός ορίσματος μιας επιλογής πρέπει να μεταφραστούν (να προστεθεί μια ανάστροφη κάθετος μπροστά από αυτά). Το man θα αναλύσει το $MANOPT πριν αναλύσει τη δική του γραμμή εντολών. Οι επιλογές που απαιτούν όρισμα θα αντικατασταθούν από τις ίδιες επιλογές που βρέθηκαν στη γραμμή εντολών. Για να επαναφέρετε όλες τις επιλογές που έχουν οριστεί στο $MANOPT, μπορεί να καθοριστεί το -D ως η αρχική επιλογή της γραμμής εντολών. Αυτό θα επιτρέψει στο man να "ξεχάσει" τις επιλογές που καθορίζονται στο $MANOPT, αν και αυτές θα πρέπει να ήταν έγκυρες.
Οι σελίδες εγχειριδίων αποθηκεύονται συνήθως σε μορφή nroff(1) σε έναν κατάλογο όπως το /usr/share/man. Σε ορισμένες εγκαταστάσεις, μπορεί να υπάρχουν επίσης προμορφοποιημένες σελίδες cat για τη βελτίωση της απόδοσης. Δείτε το manpath(5) για λεπτομέρειες σχετικά με το πού αποθηκεύονται αυτά τα αρχεία.
Αυτό το πακέτο υποστηρίζει σελίδες εγχειριδίων σε πολλές γλώσσες, οι οποίες ελέγχονται από την τοπική σας ρύθμιση. Εάν το σύστημά σας δεν έχει ρυθμίσει αυτόματα, ίσως χρειαστεί να ορίσετε τις μεταβλητές περιβάλλοντος $LC_MESSAGES, $LANG ή μια άλλη μεταβλητή περιβάλλοντος που εξαρτάται από το σύστημα, ώστε να υποδεικνύει την προτιμώμενη τοπική σας ρύθμιση, συνήθως καθορισμένη στη μορφή POSIX:
<language>[_<territory>[.<character-set>[,<version>]]]
Εάν η επιθυμητή σελίδα είναι διαθέσιμη στην τοπική σας γλώσσα, θα εμφανίζεται αντί για την τυπική (συνήθως Αμερικανική Αγγλική) σελίδα.
Εάν διαπιστώσετε ότι οι μεταφράσεις που παρέχονται με αυτό το πακέτο δεν είναι διαθέσιμες στην μητρική σας γλώσσα και θα θέλατε να τις παράσχετε, επικοινωνήστε με τον υπεύθυνο, ο οποίος θα συντονίζει αυτή τη δραστηριότητα.
Οι μεμονωμένες σελίδες εγχειριδίου συνήθως γράφονται και συντηρούνται από τους υπεύθυνους του προγράμματος, της συνάρτησης ή άλλου θέματος για το οποίο παρέχουν τεκμηρίωση και δεν περιλαμβάνονται σε αυτό το πακέτο. Εάν διαπιστώσετε ότι μια σελίδα εγχειριδίου λείπει ή είναι ανεπαρκής, παρακαλούμε να το αναφέρετε στους υπεύθυνους του σχετικού πακέτου.
Για πληροφορίες σχετικά με άλλες δυνατότητες και επεκτάσεις που είναι διαθέσιμες με αυτό το πρόγραμμα προβολής εγχειριδίων, διαβάστε τα έγγραφα που παρέχονται με το πακέτο.
ΠΡΟΕΠΙΛΟΓΕΣ
Η σειρά των τμημάτων για αναζήτηση μπορεί να αντικατασταθεί από τη μεταβλητή περιβάλλοντος $MANSECT ή από την οδηγία SECTION στο /etc/manpath.config. Από προεπιλογή, είναι η εξής:
1n l 8 3 0 2 3type 3posix 3pm 3perl 3am 5 4 9 6 7
Η μορφοποιημένη σελίδα εγχειριδίου εμφανίζεται χρησιμοποιώντας ένα πρόγραμμα προβολής. Αυτό μπορεί να καθοριστεί με διάφορους τρόπους ή θα χρησιμοποιηθεί μια προεπιλεγμένη ρύθμιση (δείτε την επιλογή -P για λεπτομέρειες).
Τα φίλτρα αποκωδικοποιούνται με διάφορους τρόπους. Πρώτα, εξετάζεται η επιλογή γραμμής εντολών -p ή η μεταβλητή περιβάλλοντος $MANROFFSEQ. Εάν η -p δεν χρησιμοποιήθηκε και η μεταβλητή περιβάλλοντος δεν ορίστηκε, η πρώτη γραμμή του αρχείου nroff αναλύεται για μια συμβολοσειρά προεπεξεργαστή. Για να περιέχει μια έγκυρη συμβολοσειρά προεπεξεργαστή, η πρώτη γραμμή πρέπει να μοιάζει με:
'\" <συμβολοσειρά>
όπου η συμβολοσειρά μπορεί να είναι οποιοσδήποτε συνδυασμός γραμμάτων όπως περιγράφεται στην επιλογή -p
παρακάτω.
Εάν καμία από τις παραπάνω μεθόδους δεν παρέχει πληροφορίες φίλτρου, χρησιμοποιείται μια προεπιλεγμένη συλλογή.
Μια μορφοποιημένη αλυσίδα δημιουργείται από τα φίλτρα και τον κύριο μορφοποιητή (nroff ή [tg]roff με -t) και εκτελείται. Εναλλακτικά, εάν υπάρχει ένα εκτελέσιμο πρόγραμμα mandb_nfmt (ή mandb_tfmt με -t) στη ρίζα του δέντρου man, εκτελείται αντί αυτού. Λαμβάνει ως όρισμα το αρχείο πηγής του εγχειριδίου, τη συμβολοσειρά προεπεξεργαστή και, προαιρετικά, τη συσκευή που καθορίζεται με τις -T ή -E.
ΕΠΙΛΟΓΕΣ
Οι μη παραμετρικές επιλογές που διπλασιάζονται είτε στη γραμμή εντολών είτε στο $MANOPT ή και στα δύο, δεν προκαλούν πρόβλημα. Για τις επιλογές που απαιτούν ένα όρισμα, κάθε διπλασιασμός θα αντικαθιστά την προηγούμενη τιμή ορίσματος.
Γενικές επιλογές
-C file, --config-file=file
Χρησιμοποιήστε αυτό το αρχείο διαμόρφωσης χρήστη αντί για το προεπιλεγμένο \~/.manpath.
-d, --debug
Εκτυπώστε πληροφορίες εντοπισμού σφαλμάτων.
-D, --default
Αυτή η επιλογή συνήθως εκτελείται ως η πρώτη επιλογή και επαναφέρει τη συμπεριφορά του man στις
προεπιλογές της. Χρησιμοποιείται για την επαναφορά των επιλογών που μπορεί να έχουν οριστεί στο $MANOPT.
Οποιεσδήποτε επιλογές που ακολουθούν την -D θα έχουν την κανονική τους επίδραση.
--warnings[=warnings]
Ενεργοποιεί τις προειδοποιήσεις του groff. Αυτό μπορεί να χρησιμοποιηθεί για να εκτελέσει ελέγχους ορθότητας στο αρχείο πηγής των σελίδων εγχειριδίου. Το warnings είναι μια λίστα προειδοποιήσεων χωρισμένων με κόμμα· εάν δεν παρέχεται, η προεπιλογή είναι "mac". Για να απενεργοποιήσετε μια προειδοποίηση groff, προσθέστε το πρόθεμα "!": για παράδειγμα, --warnings=mac,!break ενεργοποιεί τις προειδοποιήσεις στην κατηγορία "mac" και απενεργοποιεί τις προειδοποιήσεις στην κατηγορία "break". Δείτε την ενότητα "Warnings" στο info groff για μια λίστα διαθέσιμων ονομάτων προειδοποιήσεων.
Κύριοι τρόποι λειτουργίας
-f, --whatis
Προσφέρει λειτουργικότητα παρόμοια με αυτή του whatis. Εμφανίζει μια σύντομη περιγραφή από τη σελίδα εγχειριδίου, εάν είναι διαθέσιμη. Δείτε το whatis(1) για λεπτομέρειες.
-k, --apropos
Προσφέρει λειτουργικότητα παρόμοια με αυτή του apropos. Αναζητά στις σύντομες περιγραφές των σελίδων εγχειριδίου λέξεις-κλειδιά και εμφανίζει τυχόν αποτελέσματα. Δείτε το apropos(1) για λεπτομέρειες.
-K, --global-apropos
Αναζητά κείμενο σε όλες τις σελίδες εγχειριδίου. Αυτή είναι μια αναζήτηση με ακατέργαστη δύναμη και είναι πιθανό να διαρκέσει αρκετό χρόνο· εάν μπορείτε, θα πρέπει να καθορίσετε μια ενότητα για να μειώσετε τον αριθμό των σελίδων που πρέπει να αναζητηθούν. Οι όροι αναζήτησης μπορούν να είναι απλές συμβολοσειρές (η προεπιλογή) ή κανονικές εκφράσεις εάν χρησιμοποιηθεί η επιλογή --regex.
Σημειώστε ότι αυτό αναζητά τις πηγές των σελίδων εγχειριδίου και όχι το παραγόμενο κείμενο, επομένως ενδέχεται να περιλαμβάνει ψευδώς θετικά αποτελέσματα λόγω πραγμάτων όπως σχόλια στα αρχεία πηγής ή ψευδώς αρνητικά αποτελέσματα λόγω πραγμάτων όπως οι παύλες που γράφονται ως "-" στα αρχεία πηγής. Η αναζήτηση στο παραγόμενο κείμενο θα ήταν πολύ πιο αργή.
-l, --local-file
Ενεργοποιεί τη "τοπική" λειτουργία. Μορφοποιεί και εμφανίζει τοπικά αρχεία εγχειριδίου αντί να πραγματοποιεί αναζήτηση στη συλλογή εγχειριδίων του συστήματος. Κάθε όρισμα σελίδας εγχειριδίου θα ερμηνευτεί ως αρχείο πηγής nroff στη σωστή μορφή. Δεν παράγεται αρχείο cat. Εάν το '-' αναφέρεται ως ένα από τα ορίσματα, η είσοδος θα ληφθεί από την τυπική είσοδο.
Εάν αυτή η επιλογή δεν χρησιμοποιηθεί, τότε το man θα ερμηνεύσει επίσης τα ορίσματα της σελίδας εγχειριδίου ως τοπικά ονόματα αρχείων εάν το όρισμα περιέχει έναν χαρακτήρα "/", επειδή αυτό είναι μια καλή ένδειξη ότι το όρισμα αναφέρεται σε μια διαδρομή στο σύστημα αρχείων.
-w, --where, --path, --location
Μην εμφανίσετε πραγματικά τη σελίδα εγχειριδίου, αλλά εκτυπώστε τη θέση του αρχείου πηγής nroff που θα μορφοποιηθεί. Εάν χρησιμοποιηθεί επίσης η επιλογή -a, τότε εκτυπώστε τις θέσεις όλων των αρχείων πηγής που ταιριάζουν με τα κριτήρια αναζήτησης.
-W, --where-cat, --location-cat
Μην εμφανίσετε πραγματικά τη σελίδα εγχειριδίου, αλλά εκτυπώστε τη θέση του προδιαμορφωμένου αρχείου cat που θα εμφανιζόταν. Εάν χρησιμοποιηθεί επίσης η επιλογή -a, τότε εκτυπώστε τις θέσεις όλων των προδιαμορφωμένων αρχείων cat που ταιριάζουν με τα κριτήρια αναζήτησης.
Εάν χρησιμοποιηθούν τόσο οι -w όσο και οι -W, τότε εκτυπώστε και το αρχείο πηγής και το αρχείο cat χωρισμένα με ένα κενό. Εάν χρησιμοποιηθούν όλες οι -w, -W και -a, τότε κάντε το για κάθε πιθανό αποτέλεσμα.
-c, --catman
Αυτή η επιλογή δεν προορίζεται για γενική χρήση και θα πρέπει να χρησιμοποιείται μόνο από το πρόγραμμα catman.
-R encoding, --recode=encoding
Αντί να μορφοποιήσετε τη σελίδα εγχειριδίου με τον συνηθισμένο τρόπο, εξάγετε την πηγή της μετατρέποντάς την στην καθορισμένη κωδικοποίηση. Εάν γνωρίζετε ήδη την κωδικοποίηση του αρχείου πηγής, μπορείτε επίσης να χρησιμοποιήσετε απευθείας το manconv(1). Ωστόσο, αυτή η επιλογή σάς επιτρέπει να μετατρέψετε πολλές σελίδες εγχειριδίου σε μια μόνο κωδικοποίηση χωρίς να χρειάζεται να δηλώσετε ρητά την κωδικοποίηση κάθε σελίδας, υπό την προϋπόθεση ότι έχουν εγκατασταθεί σε μια δομή παρόμοια με μια ιεραρχία σελίδων εγχειριδίου.
Σκεφτείτε να χρησιμοποιήσετε το man-recode(1) για τη μετατροπή πολλαπλών σελίδων εγχειριδίου, καθώς διαθέτει μια διεπαφή σχεδιασμένη για μαζική μετατροπή και επομένως μπορεί να είναι πολύ πιο γρήγορη.
Εύρεση σελίδων εγχειριδίου
-L locale, --locale=locale
Το man συνήθως καθορίζει την τρέχουσα τοπική ρύθμιση μέσω μιας κλήσης στη συνάρτηση C setlocale(3), η οποία ελέγχει διάφορες μεταβλητές περιβάλλοντος, συμπεριλαμβανομένων ενδεχομένως των $LC_MESSAGES και $LANG. Για να παρακάμψετε προσωρινά την καθορισμένη τιμή, χρησιμοποιήστε αυτήν την επιλογή για να παρέχετε μια συμβολοσειρά τοπικής ρύθμισης απευθείας στο man. Σημειώστε ότι δεν θα τεθεί σε ισχύ μέχρι να ξεκινήσει η αναζήτηση σελίδων. Η έξοδος, όπως το μήνυμα βοήθειας, θα εμφανίζεται πάντα στην αρχικά καθορισμένη τοπική ρύθμιση.
-m system[,...], --systems=system[,...]
Εάν αυτό το σύστημα έχει πρόσβαση σε σελίδες εγχειριδίου άλλων λειτουργικών συστημάτων, μπορούν να προσπελαστούν χρησιμοποιώντας αυτήν την επιλογή. Για να αναζητήσετε μια σελίδα εγχειριδίου από τη συλλογή σελίδων εγχειριδίου του NewOS, χρησιμοποιήστε την επιλογή -m NewOS.
Το καθορισμένο σύστημα μπορεί να είναι ένας συνδυασμός από ονόματα λειτουργικών συστημάτων που χωρίζονται με κόμμα. Για να συμπεριλάβετε μια αναζήτηση στις σελίδες εγχειριδίου του εγγενούς λειτουργικού συστήματος, συμπεριλάβετε το όνομα του συστήματος man στην συμβολοσειρά ορισμάτων. Αυτή η επιλογή θα αντικαταστήσει τη μεταβλητή περιβάλλοντος $SYSTEM.
-M path, --manpath=path
Καθορίστε μια εναλλακτική διαδρομή manpath για χρήση. Από προεπιλογή, το man χρησιμοποιεί κώδικα που προέρχεται από την manpath για να καθορίσει τη διαδρομή προς αναζήτηση. Αυτή η επιλογή αντικαθιστά τη μεταβλητή περιβάλλοντος $MANPATH και προκαλεί την αγνόηση της επιλογής -m.
Μια διαδρομή που καθορίζεται ως manpath πρέπει να είναι η ρίζα μιας ιεραρχίας σελίδων εγχειριδίου, δομημένη σε ενότητες όπως περιγράφεται στο εγχειρίδιο man-db (υπό το θέμα "Το σύστημα σελίδων εγχειριδίου"). Για να προβάλετε σελίδες εγχειριδίου εκτός αυτών των ιεραρχιών, δείτε την επιλογή -l.
-S list, -s list, --sections=list
Η παρεχόμενη λίστα είναι μια λίστα τμημάτων που χωρίζονται με κόλον ή κόμμα, η οποία χρησιμοποιείται για τον προσδιορισμό των τμημάτων εγχειριδίου στα οποία θα γίνει αναζήτηση και με ποια σειρά. Αυτή η επιλογή αντικαθιστά τη μεταβλητή περιβάλλοντος $MANSECT. (Η ορθογραφία -s είναι για συμβατότητα με το System V).
-e sub-extension, --extension=sub-extension
Ορισμένα συστήματα ενσωματώνουν μεγάλα πακέτα σελίδων εγχειριδίου, όπως αυτά που συνοδεύουν το πακέτο Tcl, στην κύρια ιεραρχία σελίδων εγχειριδίου. Για να ξεπεραστεί το πρόβλημα ύπαρξης δύο σελίδων εγχειριδίου με το ίδιο όνομα, όπως το exit(3), στις σελίδες Tcl συνήθως αντιστοιχούνταν όλες στην ενότητα l. Δεδομένου ότι αυτό είναι δυσάρεστο, είναι πλέον δυνατό να τοποθετηθούν οι σελίδες στην κατάλληλη ενότητα και να τους εκχωρηθεί μια συγκεκριμένη "επέκταση", στην περίπτωση αυτή, το exit(3tcl). Σε κανονική λειτουργία, το man θα εμφανίζει το exit(3) αντί για το exit(3tcl). Για να αντιμετωπιστεί αυτή η κατάσταση και για να αποφευχθεί η ανάγκη να γνωρίζετε σε ποια ενότητα βρίσκεται η σελίδα που χρειάζεστε, είναι πλέον δυνατό να δώσετε στο man μια συμβολοσειρά υπο-επεκτάσεων, η οποία υποδεικνύει σε ποιο πακέτο πρέπει να ανήκει η σελίδα. Χρησιμοποιώντας το παραπάνω παράδειγμα, η παροχή της επιλογής -e tcl στο man θα περιορίσει την αναζήτηση σε σελίδες που έχουν επέκταση *tcl.
-i, --ignore-case
Αγνοεί την διάκριση πεζών-κεφαλαίων κατά την αναζήτηση σελίδων εγχειριδίου. Αυτή είναι η προεπιλογή.
-I, --match-case
Εκτελεί αναζήτηση σε σελίδες εγχειριδίου με διάκριση πεζών-κεφαλαίων.
--regex
Εμφανίζει όλες τις σελίδες των οποίων τα ονόματα ή οι περιγραφές ταιριάζουν με κάθε όρισμα σελίδας ως κανονική έκφραση, όπως με το apropos(1). Δεδομένου ότι συνήθως δεν υπάρχει εύλογος τρόπος για να επιλεγεί η "καλύτερη" σελίδα κατά την αναζήτηση μιας κανονικής έκφρασης, αυτή η επιλογή συνεπάγεται το -a.
--wildcard
Εμφανίζει όλες τις σελίδες των οποίων τα ονόματα ή οι περιγραφές ταιριάζουν με κάθε όρισμα σελίδας χρησιμοποιώντας χαρακτήρες wildcard τύπου shell, όπως με το apropos(1) --wildcard. Το όρισμα σελίδας πρέπει να ταιριάζει με ολόκληρο το όνομα ή την περιγραφή, ή να ταιριάζει στα όρια των λέξεων στην περιγραφή. Δεδομένου ότι συνήθως δεν υπάρχει εύλογος τρόπος για να επιλεγεί η "καλύτερη" σελίδα κατά την αναζήτηση ενός wildcard, αυτή η επιλογή συνεπάγεται το -a.
--names-only
Εάν χρησιμοποιηθεί η επιλογή --regex ή --wildcard, ταιριάζει μόνο με τα ονόματα των σελίδων, όχι με τις περιγραφές τους, όπως με το whatis(1). Διαφορετικά, δεν έχει καμία επίδραση.
-a, --all
Από προεπιλογή, το man θα τερματίσει μετά την εμφάνιση της πιο κατάλληλης σελίδας εγχειριδίου που θα βρει. Χρησιμοποιώντας αυτή την επιλογή, το man αναγκάζεται να εμφανίσει όλες τις σελίδες εγχειριδίου των οποίων τα ονόματα ταιριάζουν με τα κριτήρια αναζήτησης.
-u, --update
Αυτή η επιλογή προκαλεί την ενημέρωση του man στις βάσεις δεδομένων που χρησιμοποιεί για τις εγκατεστημένες σελίδες εγχειριδίου. Αυτό χρειάζεται μόνο σε σπάνιες περιπτώσεις και είναι συνήθως καλύτερο να εκτελέσετε το mandb(8) αντί αυτού.
--no-subpages
Από προεπιλογή, το man θα προσπαθήσει να ερμηνεύσει ζεύγη ονομάτων σελίδων εγχειριδίου που δίνονται στη γραμμή εντολών ως ισοδύναμα με ένα μόνο όνομα σελίδας εγχειριδίου που περιέχει μια παύλα ή μια υπογράμμιση. Αυτό υποστηρίζει το κοινό μοτίβο των προγραμμάτων που εφαρμόζουν μια σειρά από υποεντολές, επιτρέποντας τη δημιουργία σελίδων εγχειριδίου για καθεμία, οι οποίες μπορούν να προσπελαστούν χρησιμοποιώντας παρόμοια σύνταξη με αυτή που θα χρησιμοποιούσατε για να καλέσετε τις ίδιες τις υποεντολές. Για παράδειγμα:
$ man -aw git diff
/usr/share/man/man1/git-diff.1.gz
Για να απενεργοποιήσετε αυτήν τη συμπεριφορά, χρησιμοποιήστε την επιλογή --no-subpages.
$ man -aw --no-subpages git diff
/usr/share/man/man1/git.1.gz
/usr/share/man/man3/Git.3pm.gz
/usr/share/man/man1/diff.1.gz
Έλεγχος της μορφοποιημένης εξόδου
-P pager, --pager=pager
Καθορίστε ποιο πρόγραμμα ανάγνωσης εξόδου θα χρησιμοποιηθεί. Από προεπιλογή, το man χρησιμοποιεί το pager, επιστρέφοντας στο cat εάν το pager δεν βρεθεί ή δεν είναι εκτελέσιμο. Αυτή η επιλογή αντικαθιστά τη μεταβλητή περιβάλλοντος $MANPAGER, η οποία με τη σειρά της αντικαθιστά τη μεταβλητή περιβάλλοντος $PAGER. Δεν χρησιμοποιείται σε συνδυασμό με τις επιλογές -f ή -k.
Η τιμή μπορεί να είναι ένα απλό όνομα εντολής ή μια εντολή με ορίσματα και μπορεί να χρησιμοποιεί εισαγωγικά του shell (αντίστροφοι χαρακτήρες, απλά εισαγωγικά ή διπλά εισαγωγικά). Δεν μπορεί να χρησιμοποιεί σωλήνες για τη σύνδεση πολλαπλών εντολών. Εάν χρειάζεστε αυτό, χρησιμοποιήστε ένα σενάριο περιτύλιξης, το οποίο μπορεί να λαμβάνει το αρχείο που θα εμφανιστεί είτε ως όρισμα είτε στην τυπική είσοδο.
-r prompt, --prompt=prompt
Εάν χρησιμοποιείται μια πρόσφατη έκδοση του `less` ως σελιδοδείκτης, η εντολή `man` θα προσπαθήσει να ορίσει την προτροπή του και μερικές λογικές επιλογές. Η προεπιλεγμένη προτροπή έχει την εξής μορφή:
Όνομα σελίδας εγχειριδίου(ενότητα) γραμμή x
όπου το `name` υποδεικνύει το όνομα της σελίδας εγχειριδίου, το `sec` υποδεικνύει την ενότητα στην οποία βρέθηκε και το `x` ο τρέχων αριθμός γραμμής. Αυτό επιτυγχάνεται με τη χρήση της μεταβλητής περιβάλλοντος `$LESS`.
Η παροχή του `-r` με μια συμβολοσειρά θα αντικαταστήσει αυτήν την προεπιλεγμένη τιμή. Η συμβολοσειρά μπορεί να περιέχει το κείμενο `$MAN_PN`, το οποίο θα αντικατασταθεί με το όνομα της τρέχουσας σελίδας εγχειριδίου και το όνομα της ενότητάς της, περικλειόμενα σε παρενθέσεις. Η συμβολοσειρά που χρησιμοποιείται για την παραγωγή της προεπιλογής μπορεί να εκφραστεί ως εξής:
\ Manual\ page\ \$MAN_PN\ ?ltline\ %lt?L/%L.:
byte\ %bB?s/%s..?\ (END):?pB\ %pB\\%..
(πατήστε h για βοήθεια ή q για έξοδο)
Εδώ, έχει χωριστεί σε τρεις γραμμές για λόγους ευκολίας ανάγνωσης. Για την έννοιά της, δείτε τη σελίδα εγχειριδίου [less]({filename}../../less)(1). Η συμβολοσειρά της προτροπής αξιολογείται πρώτα από το κέλυφος. Όλα τα διπλά εισαγωγικά, τα αντίστροφα εισαγωγικά και οι ανάστροφες κάθετοι στην προτροπή πρέπει να ξεκινούν με μια ανάστροφη κάθετο. Η συμβολοσειρά της προτροπής μπορεί να τελειώνει με μια αποσυνδεδεμένη `$`, ακολουθούμενη από περαιτέρω επιλογές για το `less`. Από προεπιλογή, η εντολή `man` ορίζει τις επιλογές `-ix8`.
Η μεταβλητή περιβάλλοντος `$MANLESS`, που περιγράφεται παρακάτω, μπορεί να χρησιμοποιηθεί για να οριστεί μια προεπιλεγμένη συμβολοσειρά προτροπής εάν δεν παρέχεται καμία στην γραμμή εντολών.
-7, --ascii
Όταν προβάλλεται μια καθαρή σελίδα εγχειριδίου ASCII(7) σε ένα τερματικό 7 bit ή έναν εξομοιωτή τερματικού, ορισμένοι χαρακτήρες ενδέχεται να μην εμφανίζονται σωστά κατά τη χρήση της περιγραφής συσκευής latin1(7) με το GNU nroff. Αυτή η επιλογή επιτρέπει την εμφάνιση καθαρών σελίδων εγχειριδίου ASCII σε ASCII με την περιγραφή συσκευής latin1. Δεν θα μεταφράσει κανένα κείμενο latin1. Ο παρακάτω πίνακας δείχνει τις μεταφράσεις που εκτελούνται: ορισμένα μέρη αυτού μπορεί να εμφανίζονται σωστά μόνο όταν χρησιμοποιείται η περιγραφή συσκευής latin1 του GNU nroff.
Περιγραφή Octal latin1 ascii
συνέχιση παύλα 255 ‐ σημείο (κεντρική τελεία) 267 • o
οξεία έμφαση 264 ´ '
σύμβολο πολλαπλασιασμού 327 × x
Εάν η στήλη latin1 εμφανίζεται σωστά, το τερματικό σας μπορεί να έχει ρυθμιστεί για χαρακτήρες latin1 και αυτή η επιλογή δεν είναι απαραίτητη. Εάν οι στήλες latin1 και ascii είναι πανομοιότυπες, διαβάζετε αυτήν τη σελίδα χρησιμοποιώντας αυτήν την επιλογή ή η εντολή `man` δεν μορφοποίησε αυτήν τη σελίδα χρησιμοποιώντας την περιγραφή συσκευής latin1. Εάν η στήλη latin1 λείπει ή έχει καταστραφεί, ίσως χρειαστεί να προβάλλετε τις σελίδες εγχειριδίου με αυτήν την επιλογή.
Αυτή η επιλογή αγνοείται κατά τη χρήση των επιλογών -t, -H, -T ή -Z και ενδέχεται να είναι άχρηστη για οποιοδήποτε άλλο nroff εκτός από το GNU.
-E encoding, --encoding=encoding
Δημιουργήστε έξοδο για μια άλλη κωδικοποίηση χαρακτήρων από την προεπιλεγμένη. Για λόγους συμβατότητας με προηγούμενες εκδόσεις, η κωδικοποίηση μπορεί να είναι μια συσκευή nroff, όπως οι ascii, latin1 ή utf8, καθώς και μια πραγματική κωδικοποίηση χαρακτήρων, όπως η UTF-8.
--no-hyphenation, --nh
Κανονικά, το nroff θα υποδηλώνει αυτόματα λέξεις στα διαλείμματα γραμμής, ακόμη και σε λέξεις που δεν περιέχουν υποδηλώσεις, εάν είναι απαραίτητο για να διατάξει τις λέξεις σε μια γραμμή χωρίς υπερβολικό κενό. Αυτή η επιλογή απενεργοποιεί την αυτόματη υποδήλωση, έτσι ώστε οι λέξεις να υποδηλώνονται μόνο εάν περιέχουν ήδη υποδηλώσεις.
Εάν γράφετε μια σελίδα εγχειριδίου και απλώς θέλετε να αποτρέψετε το nroff από το να υποδηλώσει μια λέξη σε ένα ακατάλληλο σημείο, μην χρησιμοποιήσετε αυτήν την επιλογή, αλλά συμβουλευτείτε την τεκμηρίωση του nroff· για παράδειγμα, μπορείτε να τοποθετήσετε το "\%" μέσα σε μια λέξη για να υποδείξετε ότι μπορεί να υποδηλωθεί σε αυτό το σημείο, ή να τοποθετήσετε το "\%" στην αρχή μιας λέξης για να αποτρέψετε την υποδήλωσή της.
--no-justification, --nj
Κανονικά, το nroff θα υποδηλώνει αυτόματα το κείμενο και στις δύο περιθωριακές ζώνες. Αυτή η επιλογή απενεργοποιεί την πλήρη στοίχιση, αφήνοντας μόνο στοίχιση στο αριστερό περιθώριο, που ονομάζεται μερικές φορές κείμενο "αριστερόστροφα".
Εάν γράφετε μια σελίδα εγχειριδίου και απλώς θέλετε να αποτρέψετε το nroff από το να στοιχίσει συγκεκριμένες παραγράφους, μην χρησιμοποιήσετε αυτήν την επιλογή, αλλά συμβουλευτείτε την τεκμηρίωση του nroff· για παράδειγμα, μπορείτε να χρησιμοποιήσετε τις εντολές ".na", ".nf", ".fi" και ".ad" για να απενεργοποιήσετε προσωρινά τη στοίχιση και τη συμπλήρωση.
-p string, --preprocessor=string
Καθορίστε την ακολουθία προεπεξεργαστών που θα εκτελεστούν πριν από το nroff ή το troff/groff. Δεν θα έχουν όλες οι εγκαταστάσεις ένα πλήρες σύνολο προεπεξεργαστών. Μερικοί από τους προεπεξεργαστές και τα γράμματα που χρησιμοποιούνται για να τους ορίσουν είναι: eqn (e), grap (g), pic (p), tbl (t), vgrind (v), refer (r). Αυτή η επιλογή αντικαθιστά τη μεταβλητή περιβάλλοντος $MANROFFSEQ. Το zsoelim εκτελείται πάντα ως ο πρώτος προεπεξεργαστής.
-t, --troff
Χρησιμοποιήστε το groff -mandoc για να μορφοποιήσετε τη σελίδα εγχειριδίου στην τυπική έξοδο. Αυτή η επιλογή δεν απαιτείται σε συνδυασμό με τις -H, -T ή -Z.
-T[device], --troff-device[=device]
Αυτή η επιλογή χρησιμοποιείται για να αλλάξει την έξοδο του groff (ή πιθανώς του troff) ώστε να είναι κατάλληλη για μια συσκευή διαφορετική από την προεπιλεγμένη. Υπονοεί την -t. Παραδείγματα (όπως της έκδοσης groff 1.23.0) περιλαμβάνουν τα dvi, latin1, pdf, ps, utf8, X75 και X100.
-H[browser], --html[=browser]
Αυτή η επιλογή θα κάνει το groff να παράγει έξοδο HTML και θα εμφανίζει αυτήν την έξοδο σε ένα πρόγραμμα περιήγησης ιστού. Η επιλογή του προγράμματος περιήγησης καθορίζεται από την προαιρετική παράμετρο browser, εάν παρέχεται, από τη μεταβλητή περιβάλλοντος $BROWSER ή από μια προκαθορισμένη τιμή κατά τη μεταγλώττιση, εάν αυτή δεν έχει οριστεί (συνήθως lynx). Αυτή η επιλογή υπονοεί την -t και θα λειτουργήσει μόνο με το GNU troff.
-X[dpi], --gxditview[=dpi]
Αυτή η επιλογή εμφανίζει την έξοδο του groff σε ένα γραφικό παράθυρο χρησιμοποιώντας το πρόγραμμα gxditview. Η τιμή dpi (κουκκίδες ανά ίντσα) μπορεί να είναι 75, 75-12, 100 ή 100-12, με προεπιλογή το 75· οι παραλλαγές -12 χρησιμοποιούν μια γραμματοσειρά βάσης 12 σημείων. Αυτή η επιλογή υπονοεί την -T με τη συσκευή X75, X75-12, X100 ή X100-12, αντίστοιχα.
-Z, --ditroff
Το groff θα εκτελέσει το troff και στη συνέχεια θα χρησιμοποιήσει έναν κατάλληλο μεταεπεξεργαστή για να παράγει έξοδο κατάλληλη για τη στοχευόμενη συσκευή. Εάν το groff -mandoc είναι groff, αυτή η επιλογή περνιέται στο groff και θα καταστείλει τη χρήση ενός μεταεπεξεργαστή. Υπονοεί την -t.
Λήψη βοήθειας
-?, --help
Εμφάνιση ενός μηνύματος βοήθειας και έξοδος.
--usage
Εμφάνιση ενός σύντομου μηνύματος χρήσης και έξοδος.
-V, --version
Εμφάνιση πληροφοριών έκδοσης.
ΚΑΤΑΣΤΑΣΗ ΕΞΟΔΟΥ
0 Επιτυχής εκτέλεση προγράμματος.
1 Σφάλμα χρήσης, σύνταξης ή αρχείου διαμόρφωσης.
2 Λειτουργικό σφάλμα.
3 Μια θυγατρική διαδικασία επέστρεψε μη μηδενική κατάσταση εξόδου.
16 Τουλάχιστον μία από τις σελίδες/αρχεία/λέξεις-κλειδιά δεν υπήρχε ή δεν ταιριάζει.
ΠΕΡΙΒΑΛΛΟΝ
MANPATH
Εάν έχει οριστεί η μεταβλητή $MANPATH, η τιμή της χρησιμοποιείται ως η διαδρομή για αναζήτηση σελίδων εγχειριδίου.
Δείτε την ενότητα ΔΙΑΔΡΟΜΗ ΑΝΑΖΗΤΗΣΗΣ του manpath(5) για τη συμπεριφορά από προεπιλογή και λεπτομέρειες σχετικά με τον τρόπο με τον οποίο αυτή η μεταβλητή περιβάλλοντος διαχειρίζεται.
MANROFFOPT
Κάθε φορά που το man καλεί τον μορφοποιητή (nroff, troff ή groff), προσθέτει το περιεχόμενο του $MANROFFOPT στην εντολή του μορφοποιητή.
Για παράδειγμα, το MANROFFOPT=-P-i λέει στον μορφοποιητή να χρησιμοποιεί πλάγια γραφή (η οποία υποστηρίζεται μόνο από ορισμένα τερματικά) αντί για υπογράμμιση.
MANROFFSEQ
Εάν έχει οριστεί η μεταβλητή $MANROFFSEQ, η τιμή της χρησιμοποιείται για να καθοριστεί η σειρά των προεπεξεργαστών που θα περάσουν κάθε σελίδα εγχειριδίου. Η προεπιλεγμένη λίστα προεπεξεργαστών είναι διαφορετική ανάλογα με το σύστημα.
MANSECT
Εάν έχει οριστεί η μεταβλητή $MANSECT, η τιμή της είναι μια λίστα που ορίζεται με άνω και κάτω τελείες, η οποία χρησιμοποιείται για να καθοριστούν οι ενότητες εγχειριδίου που θα αναζητηθούν και με ποια σειρά. Η προεπιλογή είναι "1 n l 8 3 0 2 3ype 3posix 3pm 3perl 3am 5 4 9 6 7", εκτός εάν αντικατασταθεί από την οδηγία SECTION στο /etc/manpath.config.
MANPAGER, PAGER
Εάν έχει οριστεί η μεταβλητή $MANPAGER ή η μεταβλητή $PAGER (η $MANPAGER χρησιμοποιείται κατά προτεραιότητα), η τιμή τους χρησιμοποιείται ως το όνομα του προγράμματος που χρησιμοποιείται για την εμφάνιση της σελίδας εγχειριδίου. Από προεπιλογή, χρησιμοποιείται το pager, το οποίο επιστρέφει στο cat εάν το pager δεν βρεθεί ή δεν είναι εκτελέσιμο.
Η τιμή μπορεί να είναι ένα απλό όνομα εντολής ή μια εντολή με ορίσματα και μπορεί να χρησιμοποιεί εισαγωγικά (αντίστροφοι, απλοί ή διπλοί χαρακτήρες). Δεν μπορεί να χρησιμοποιεί σωλήνες για τη σύνδεση πολλαπλών εντολών. Εάν χρειάζεστε αυτό, χρησιμοποιήστε ένα περιβάλλον σενάριο, το οποίο μπορεί να λαμβάνει το αρχείο που θα εμφανιστεί είτε ως όρισμα είτε στην τυπική είσοδο.
MANLESS
Εάν έχει οριστεί η μεταβλητή $MANLESS, η τιμή της θα χρησιμοποιηθεί ως η προεπιλεγμένη συμβολοσειρά προτροπής για το pager less, σαν να είχε περαστεί χρησιμοποιώντας την επιλογή -r (έτσι ώστε τυχόν εμφανίσεις του κειμένου $MAN_PN να επεκτείνονται με τον ίδιο τρόπο). Για παράδειγμα, εάν θέλετε να ορίσετε τη συμβολοσειρά προτροπής άνευ όρων σε "η δική μου συμβολοσειρά προτροπής", ορίστε τη μεταβλητή $MANLESS σε ' -Psmy prompt string'. Η χρήση της επιλογής -r υπερισχύει αυτής της μεταβλητής περιβάλλοντος.
BROWSER
Εάν έχει οριστεί η μεταβλητή $BROWSER, η τιμή της είναι μια λίστα που ορίζεται με άνω και κάτω τελείες, η οποία περιέχει εντολές, καθεμία από τις οποίες χρησιμοποιείται με τη σειρά για να δοκιμάσει την εκκίνηση ενός προγράμματος περιήγησης ιστού για το man --html. Σε κάθε εντολή, το %s αντικαθίσταται από ένα όνομα αρχείου που περιέχει την έξοδο HTML από το groff, το %% αντικαθίσταται από ένα μόνο σύμβολο ποσοστού (%) και το %c αντικαθίσταται από άνω και κάτω τελείες (:).
ΣΥΣΤΗΜΑ Εάν έχει οριστεί η μεταβλητή $SYSTEM, θα έχει το ίδιο αποτέλεσμα σαν να είχε καθοριστεί ως όρισμα στην επιλογή -m.
MANOPT Εάν έχει οριστεί η μεταβλητή $MANOPT, θα αναλυθεί πριν από τη γραμμή εντολών του man και αναμένεται να είναι σε παρόμοια μορφή. Δεδομένου ότι όλες οι άλλες μεταβλητές περιβάλλοντος που είναι ειδικές για το man μπορούν να εκφραστούν ως επιλογές γραμμής εντολών και, επομένως, είναι υποψήφιες για να συμπεριληφθούν στο $MANOPT, αναμένεται ότι θα καταργηθούν. Σημείωση: Όλα τα κενά που πρέπει να ερμηνευτούν ως μέρος του ορίσματος μιας επιλογής πρέπει να αντικατασταθούν με χαρακτήρα διαφυγής.
MANWIDTH
Εάν έχει οριστεί η μεταβλητή $MANWIDTH, η τιμή της χρησιμοποιείται ως το μήκος γραμμής για το οποίο οι σελίδες εγχειριδίου πρέπει να μορφοποιηθούν. Εάν δεν έχει οριστεί, οι σελίδες εγχειριδίου θα μορφοποιηθούν με ένα μήκος γραμμής κατάλληλο για το τρέχον τερματικό (χρησιμοποιώντας την τιμή της μεταβλητής $COLUMNS και το ioctl(2) εάν είναι διαθέσιμο, ή επιστρέφοντας σε 80 χαρακτήρες εάν κανένα από αυτά δεν είναι διαθέσιμο). Οι σελίδες Cat θα αποθηκευτούν μόνο όταν μπορεί να χρησιμοποιηθεί η προεπιλεγμένη μορφοποίηση, δηλαδή όταν το μήκος γραμμής του τερματικού είναι μεταξύ 66 και 80 χαρακτήρων.
MAN_KEEP_FORMATTING
Συνήθως, όταν η έξοδος δεν κατευθύνεται σε ένα τερματικό (όπως σε ένα αρχείο ή μια σωλήνωση), οι χαρακτήρες μορφοποίησης απορρίπτονται για να διευκολυνθεί η ανάγνωση του αποτελέσματος χωρίς ειδικά εργαλεία. Ωστόσο, εάν η μεταβλητή $MAN_KEEP_FORMATTING έχει οριστεί σε οποιαδήποτε μη κενή τιμή, αυτοί οι χαρακτήρες μορφοποίησης διατηρούνται. Αυτό μπορεί να είναι χρήσιμο για περιβάλλοντα εργασίας γύρω από το man που μπορούν να ερμηνεύσουν τους χαρακτήρες μορφοποίησης.
MAN_KEEP_STDERR
Συνήθως, όταν η έξοδος κατευθύνεται σε ένα τερματικό (συνήθως σε ένα πρόγραμμα σελιδοποίησης), οποιαδήποτε έξοδος σφάλματος από την εντολή που χρησιμοποιείται για την παραγωγή μορφοποιημένων εκδόσεων των σελίδων εγχειριδίου απορρίπτεται για να αποφευχθεί η παρεμβολή στην εμφάνιση του προγράμματος σελιδοποίησης. Προγράμματα όπως το groff παράγουν συχνά σχετικά μικρά μηνύματα σφάλματος σχετικά με τυπογραφικά προβλήματα, όπως κακή στοίχιση, τα οποία είναι αντιαισθητικά και γενικά προκαλούν σύγχυση όταν εμφανίζονται μαζί με τη σελίδα εγχειριδίου. Ωστόσο, ορισμένοι χρήστες θέλουν να τα βλέπουν ούτως ή άλλως, επομένως, εάν η μεταβλητή $MAN_KEEP_STDERR έχει οριστεί σε οποιαδήποτε μη κενή τιμή, η έξοδος σφάλματος θα εμφανίζεται κανονικά.
MAN_DISABLE_SECCOMP
Στο Linux, το man περιορίζει συνήθως τις υποδιεργασίες που χειρίζονται μη αξιόπιστα δεδομένα χρησιμοποιώντας ένα seccomp(2) sandbox. Αυτό το καθιστά ασφαλέστερο για την εκτέλεση πολύπλοκου κώδικα ανάλυσης σε αυθαίρετες σελίδες εγχειριδίου. Εάν αυτό αποτύχει για κάποιο λόγο που δεν σχετίζεται με το περιεχόμενο της σελίδας που εμφανίζεται, μπορείτε να ορίσετε την μεταβλητή $MAN_DISABLE_SECCOMP σε οποιαδήποτε μη κενή τιμή για να απενεργοποιήσετε το sandbox.
PIPELINE_DEBUG
Εάν η μεταβλητή περιβάλλοντος $PIPELINE_DEBUG έχει οριστεί σε "1", τότε το man θα εκτυπώσει μηνύματα εντοπισμού σφαλμάτων στην τυπική έξοδο σφαλμάτων, περιγράφοντας κάθε υποδιεργασία που εκτελεί.
LANG, LC_MESSAGES
Ανάλογα με το σύστημα και την υλοποίηση, είτε η μεταβλητή $LANG είτε η μεταβλητή $LC_MESSAGES θα αναζητηθούν για την τρέχουσα τοπική ρύθμιση μηνυμάτων. Το man θα εμφανίσει τα μηνύματά του σε αυτήν την τοπική ρύθμιση (εάν είναι διαθέσιμη). Δείτε το setlocale(3) για ακριβείς λεπτομέρειες.
ΑΡΧΕΙΑ
/etc/manpath.config
Αρχείο διαμόρφωσης man-db.
/usr/share/man
Μια παγκόσμια ιεραρχία σελίδων εγχειριδίου.
ΠΡΟΤΥΠΑ
POSIX.1-2001, POSIX.1-2008, POSIX.1-2017.
ΔΕΣ ΕΠΙΣΗΣ
apropos(1), groff(1), less(1), manpath(1), nroff(1), troff(1), whatis(1), zsoelim(1), manpath(5), man(7), catman(8), mandb(8)
Η τεκμηρίωση για ορισμένα πακέτα μπορεί να είναι διαθέσιμη σε άλλες μορφές, όπως info(1) ή HTML.
ΙΣΤΟΡΙΚΟ
1990 1991 – Αρχικά γράφτηκε από τον John W. Eaton (_).
Δεκ 23 1992: Ο Rik Faith (_) εφάρμοσε διορθώσεις σφαλμάτων που παρείχε ο Willem Kasdorp (_).
30 Απριλίου 1994 – 23 Φεβρουαρίου 2000: Ο Wilf. (_) ανέπτυξε και συντηρούσε αυτό το πακέτο με τη βοήθεια λίγων αφοσιωμένων ανθρώπων.
30 Οκτωβρίου 1996 – 30 Μαρτίου 2001: Ο Fabrizio Polacco <_> συντηρούσε και βελτίωνε αυτό το πακέτο για το έργο Debian, με τη βοήθεια της κοινότητας.
31 Μαρτίου 2001 – σήμερα: Ο Colin Watson <_> αναπτύσσει και συντηρεί πλέον το man-db.
ΣΦΑΛΜΑΤΑ
https://gitlab.com/man-db/man-db/-/issues
https://savannah.nongnu.org/bugs/?group=man-db