איש - פיקוד לינוקס - פיקוד יוניקס

שֵׁם

אדם - פורמט ולהציג את דפי אינטרנט מקוונים
מנפאט - לקבוע נתיב החיפוש של המשתמש עבור דפי אדם

תַקצִיר

[ -path ] [ -Path ] [ -S section_list ] [ שם הקטע ] [ -Path ] [ -M המערכת ] [ -p מחרוזת ] [ -C config_file ] [ -M pathlist ]

תיאור

אדם פורמטים ומציג את דפי אינטרנט מקוונים. אם תציין מקטע , האדם ייראה רק בחלק זה של המדריך. השם הוא בדרך כלל השם של הדף הידני, שהוא בדרך כלל השם של פקודה, פונקציה או קובץ. עם זאת, אם השם מכיל קו נטוי ( / ) ואז האדם מפרש אותו כמפרט קובץ, כך שאתה יכול לעשות אדם. / 5 או 5 או אפילו גבר /cd/foo/bar.1.gz .

ראה להלן תיאור של המקום שבו האדם מחפש את קבצי הדף הידניים.

אפשרויות

-C config_file

ציין את קובץ התצורה לשימוש; ברירת המחדל היא /etc/man.config . (ראה man.conf (5)).

נתיב

ציין את רשימת הספריות כדי לחפש דפי אדם. הפרד את הספריות עם קולונים. רשימה ריקה היא זהה לא מפרט -M בכלל. ראה ערך חיפוש עבור דפים ידניים .

-ביפר

ציין באיזה ביפר להשתמש. אפשרות זו עוקפת את משתנה הסביבה MANPAGER , אשר בתורו עוקפת את משתנה PAGER . כברירת מחדל, האדם משתמש ב- usr / bin / less-lessr .

-S section_list

רשימה היא רשימה מופרדת המפרידה של סעיפים ידניים לחיפוש. אפשרות זו עוקפת את משתנה הסביבה MANSECT .

-א

כברירת מחדל, האדם ייסגר לאחר הצגת הדף הידני הראשון שהוא מוצא. שימוש באפשרות זו מאלץ את האדם להציג את כל העמודים הידניים המתאימים לשם, ולא רק את הדף הראשון.

-ג

ערוך מחדש את דף מקור המקור, גם כאשר קיים דף חתול מעודכן. זה יכול להיות משמעותי אם דף החתול היה מעוצב עבור מסך עם מספר שונה של עמודות, או אם הדף preformatted פגום.

ד

למעשה, לא להציג את דפי האיש, אבל לעשות להדפיס gobs של מידע באגים.

-D

הן להציג מידע באגים הדפסה.

-f

שווה ערך ל- whatis .

-F או - formformat

פורמט בלבד - אל תציג.

-h

הדפס הודעת עזרה של שורה אחת וצא.

-k

השווה לאפרופוס .

-K

חפש את המחרוזת שצוין ב * כל * דפי אדם. אזהרה: זה כנראה מאוד איטי! זה עוזר לציין סעיף. (רק כדי לתת מושג גס, על המחשב שלי זה לוקח בערך דקה לכל 500 דפי אדם.)

-M המערכת

ציין קבוצה חלופית של דפי אדם לחיפוש לפי שם המערכת שניתן.

מחרוזת

ציין את רצף של preprocessors לרוץ לפני nroff או troff . לא כל ההתקנות תהיה קבוצה שלמה של preprocessors. חלק מהפרופראסור ומכתבים המשמשים לייעודם הם: eqn (e), grap (g), pic (p), tbl (t), vgrind (v), עיין (r). אפשרות זו עוקפת את משתנה הסביבה MANROFFSEQ .

-t

השתמש / usr / bin / groff -Tps -mandoc כדי לעצב את הדף ידני, עובר את הפלט כדי stdout. הפלט מ / usr / bin / groff -Tps -mandoc ייתכן שיהיה צורך לעבור דרך מסנן זה או אחר לפני ההדפסה.

-W או --path

לא להציג את דפי האיש, אבל להדפיס את המיקום (ים) של הקבצים כי יהיה מעוצב או מוצג. אם לא ניתן ויכוח: להציג (על stdout) רשימה של ספריות כי הוא חיפש על ידי אדם עבור דפי אדם. אם manpath הוא קישור לאיש, אז "manpath" שווה "גבר - נתיב".

-W

כמו -W, אך שם קובץ הדפסה אחד בכל שורה, ללא מידע נוסף. זה שימושי בפקודות פגז כמו גבר - גבר xargs ls -l

דפי CAT

האדם ינסה לשמור את דפי האדם מעוצב, על מנת לשמור את זמן העיצוב בפעם הבאה הדפים האלה נדרשים. באופן מסורתי, גרסאות מעוצבות של דפים ב- DIR / manX נשמרות ב- DIR / catX, אך ניתן להגדיר ב- /etc/man.config מיפויים אחרים מאדם dir ל- dir cat. אין דפי חתול נשמרים כאשר ספריית החתול הנדרשת אינה קיימת. אין דפי חתול נשמרים כאשר הם מעוצבים עבור אורך שורה שונה מ 80. לא דפי חתול נשמרים כאשר man.conf מכיל את הקו NOCACHE.

ניתן להפוך את האדם לחולה לאדם. לאחר מכן, אם ספריית חתול יש הבעלים של הבעלים ואת מצב 0755 (רק לכתוב על ידי אדם), ואת הקבצים חתול יש הבעלים של הבעלים ואת מצב 0644 או 0444 (רק לכתוב על ידי אדם, או לא לכתיבה בכלל), אין משתמש רגיל יכול לשנות את דפי חתול או לשים קבצים אחרים בספריית החתול. אם אדם לא נעשים, אז המדריך בספרייה צריך להיות מצב 0777 אם כל המשתמשים צריכים להיות מסוגלים להשאיר דפים חתול שם.

אפשרות -c כוחות לעצב מחדש דף, גם אם קיים דף חתול לאחרונה.

חיפוש עבור דפים ידניים

האדם משתמש בשיטה מתוחכמת של מציאת קבצי דפים ידניים, בהתבסס על אפשרויות ההקראה ומשתני הסביבה, קובץ התצורה /etc/man.config , וחלקם מובנים במוסכמות ובהיוריסטיקה.

קודם כל, כאשר הארגומנט שם לאדם מכיל קו נטוי ( / ), האדם מניח שהוא מפרט קובץ עצמו, ואין חיפוש מעורב.

אבל במקרה הרגיל שבו שם אינו מכיל קו נטוי, האדם מחפש מגוון של ספריות עבור קובץ זה יכול להיות דף ידני עבור הנושא בשם.

אם תציין את האפשרות -M pathlist , pathlist היא רשימה מופרדת המעי הגס של הספריות שהאדם מחפש.

אם לא תציין -M אבל תגדיר את משתנה הסביבה MANPATH , הערך של משתנה זה הוא רשימת הספריות שהאדם מחפש.

אם לא תציין רשימת נתיבים מפורשת עם -M או MANPATH , האדם מפתח רשימת נתיבים משלו בהתבסס על התוכן של קובץ התצורה /etc/man.config . הצהרות MANPATH בקובץ התצורה מזהות ספריות מסוימות שיכללו בנתיב החיפוש.

יתר על כן, ההצהרות MANPATH_MAP להוסיף את נתיב החיפוש בהתאם נתיב החיפוש הפקודה (כלומר משתנה הסביבה שלך PATH ). עבור כל ספרייה שעשויה להיות בנתיב החיפוש של הפקודה, הצהרה MANPATH_MAP מציינת ספריה שיש להוסיף אותה לנתיב החיפוש עבור קובצי דפים ידניים. האדם מסתכל על המשתנה PATH ומוסיף את הספריות המתאימות לנתיב החיפוש של קובץ הדף הידני. לכן, עם השימוש הנכון של MANPATH_MAP , כאשר אתה נושא את הפקודה xyz , אתה מקבל דף ידני עבור התוכנית כי יפעל אם הוציא את הפקודה xyz .

בנוסף, עבור כל ספריה בנתיב החיפוש הפקודה (אנו קוראים לזה "ספריית פקודות") שעבורו אין לך הצהרה MANPATH_MAP , האדם באופן אוטומטי מחפש ספריית דף ידני "בקרבת מקום" כלומר כמו תיקיית משנה ב ספריית פקודות עצמה או בספריית האב של ספריית הפקודה.

ניתן להשבית את החיפושים האוטומטיים "הסמוכים" על ידי הכללת משפט NOAUTOPATH ב /etc/man.config .

בכל ספריה בנתיב החיפוש כמתואר לעיל, האדם מחפש קובץ בשם נושא . , עם סיומת אופציונלית על מספר הסעיף ואולי סיומת דחיסה. אם הוא אינו מוצא קובץ כזה, הוא ייראה בכל תיקיות משנה בשם N או N, כאשר N הוא מספר החלק הידני. אם הקובץ נמצא בתת-תיקיה N , האדם מניח שהוא קובץ דף ידני מעוצב (דף חתול). אחרת, האדם מניח שהוא לא מעוצב. בכל מקרה, אם שם הקובץ יש סיומת דחיסה ידועה (כמו .gz ), האדם מניח שהוא gzipped.

אם אתה רוצה לראות היכן (או אם) האדם ימצא את הדף הידני לנושא מסוים, השתמש באפשרות --path ( -w ).

חשוב: השתמש בפקודת הגבר ( % man ) כדי לראות כיצד נעשה שימוש בפקודה במחשב הספציפי שלך.