גבר - מקוון בענן

תָכְנִית:

שֵׁם

man - ממשק למדריכי העזר המקוונים

תַקצִיר

איש [-C פילה] [-d] [-D] [--אזהרות[=אזהרות]] [-R הַצפָּנָה] [-L אזור] [-m
מערכת[,...]] [-M נתיב] [-S רשימה] [-e הארכה] [-i|-I] [--רגקס|-ווילדקארד]
[--שמות בלבד] [-a] [-u] [--ללא דפי משנה] [-P זימונית] [-r הפקודה] [-7] [-E הַצפָּנָה]
[--ללא מיקוף] [--אין הצדקה] [-p מחרוזת] [-t] [-T[מכשיר]] [-H[דפדפן]]
[-X[dpi]] [-Z] [[סעיף] עמוד ...] ...
איש -k [אפרופו אפשרויות] regexp ...
איש -K [-w|-W] [-S רשימה] [-i|-I] [--רגקס] [סעיף] טווח ...
איש -f [מה זה אפשרויות] עמוד ...
איש -l [-C פילה] [-d] [-D] [--אזהרות[=אזהרות]] [-R הַצפָּנָה] [-L אזור] [-P זימונית]
[-r הפקודה] [-7] [-E הַצפָּנָה] [-p מחרוזת] [-t] [-T[מכשיר]] [-H[דפדפן]] [-X[dpi]] [-Z]
פילה ...
איש -w|-W [-C פילה] [-d] [-D] עמוד ...
איש -c [-C פילה] [-d] [-D] עמוד ...
איש [-?V]

תיאור

איש הוא הביפר הידני של המערכת. כל אחד עמוד טיעון שניתן ל איש הוא בדרך כלל השם של
תוכנית, שירות או פונקציה. ה מדריך ל עמוד הקשורים לכל אחד מהטיעונים הללו
לאחר מכן נמצא ומוצג. א סעיף, אם יסופק, ינחה איש להסתכל רק בזה
סעיף של המדריך. פעולת ברירת המחדל היא חיפוש בכל האפשרויות הזמינות סעיפים
לפי סדר מוגדר מראש ("1 nl 8 3 2 3posix 3pm 3perl 5 4 9 6 7" כברירת מחדל, אלא אם כן
נדחק על ידי ה SECTION הנחיה ב /etc/manpath.config), ולהראות רק את הראשון
עמוד נמצא, גם אם עמוד קיים במספר סעיפים.

הטבלה למטה מציגה את סעיף מספרי המדריך ואחריו סוגי הדפים
הם מכילים.

1 תוכניות ניתנות להפעלה או פקודות מעטפת
2 קריאות מערכת (פונקציות המסופקות על ידי הליבה)
3 שיחות ספרייה (פונקציות בתוך ספריות תוכניות)
4 קבצים מיוחדים (נמצאים בדרך כלל ב / dev)
5 פורמטים ומוסכמות של קבצים למשל / etc / passwd
משחקי 6
7 שונות (כולל חבילות מאקרו ומוסכמות), למשל איש(7), גרף(7)
8 פקודות ניהול מערכת (בדרך כלל רק עבור root)
9 שגרות ליבה [לא סטנדרטיות]

מדריך עמוד מורכב ממספר חלקים.

שמות סעיפים קונבנציונליים כוללים שֵׁם, תַקצִיר, תְצוּרָה, תיאור, אפשרויות,
יְצִיאָה סטָטוּס, לַחֲזוֹר ערך, שגיאות, הסביבה, קבצים, גרסאות, התאמה ל, אורים,
באגים, דוגמא, מחברים, ו לִרְאוֹת גם.

המוסכמות הבאות חלות על תַקצִיר סעיף ויכול לשמש כמדריך ב
סעיפים אחרים.

סיכה טֶקסט הקלד בדיוק כפי שמוצג.
נטוי טֶקסט להחליף בטיעון מתאים.
[-א ב ג] כל הארגומנטים או כל הארגומנטים בתוך [ ] הם אופציונליים.
-a|-b אפשרויות מופרדות על ידי | לא ניתן להשתמש יחד.
טענה ... טענה ניתן לחזור על עצמו.
[ביטוי] ... שלם ביטוי בתוך [ ] ניתן לחזור.

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

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

דוגמאות

איש ls
הצג את דף המדריך עבור פריט (תכנית) ls.

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

איש -t כינוי | lpr -Pps
עצב את הדף המדריך שאליו מתייחס `כינוי', בדרך כלל דף ידני של מעטפת, לתוך
ברירת מחדל טראף or גרף עצבו והעבירו אותו למדפסת ששמה ps. פלט ברירת המחדל
ל גרף הוא בדרך כלל PostScript. איש - עזרה צריך לייעץ באיזה מעבד מדובר
מחויב ל -t אוֹפְּצִיָה.

איש -l -Tדוי ./foo.1x.gz > ./foo.1x.dvi
פקודה זו תפרק ותעצב את דף המדריך למקור nroff ./foo.1x.gz אל תוך
a מכשיר עצמאי (dvi) קוֹבֶץ. ההפניה מחדש היא הכרחית כמו ה -T גורם גורם
פלט שיש להפנות אליו stdout ללא ביפר. ניתן היה לראות את הפלט באמצעות א
תוכנית כגון xdvi או עיבוד נוסף לתוך PostScript באמצעות תוכנה כגון
dvips.

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

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

סקירה כללית

אפשרויות רבות זמינות עבור איש על מנת להעניק גמישות רבה ככל האפשר ל-
מִשׁתַמֵשׁ. ניתן לבצע שינויים בנתיב החיפוש, בסדר המקטע, במעבד הפלט ועוד
התנהגויות ופעולות המפורטות להלן.

אם מוגדר, משתני סביבה שונים נחקרים כדי לקבוע את פעולתם איש.
אפשר להגדיר את המשתנה `תפוס הכל' $MANOPT לכל מחרוזת בשורת הפקודה
פורמט, למעט כל הרווחים המשמשים כחלק מארגומנט של אופציה חייבים להיות
נמלט (לפניו נטוי לאחור). איש ינתח $MANOPT לפני הניתוח שלו
שורת הפקודה. אפשרויות אלה הדורשות ארגומנט יעקפו על ידי אותן אפשרויות
נמצא בשורת הפקודה. כדי לאפס את כל האפשרויות המוגדרות ב-$MANOPT, -D יכול להיות
שצוין כאפשרות שורת הפקודה הראשונית. זה יאפשר לאדם 'לשכוח' מה
אפשרויות שצוינו ב-$MANOPT למרות שהם בטח עדיין היו תקפים.

עזרי הביפר הידניים ארוזים כ man-db לעשות בהם שימוש נרחב מדד מטמונים של מסד נתונים.
מטמונים אלה מכילים מידע כגון היכן ניתן למצוא כל עמוד ידני ב-
מערכת הקבצים ומה שלה מה זה (תיאור קצר של שורה אחת של דף האיש) מכיל, ו
להתיר איש לרוץ מהר יותר מאשר אם היה צריך לחפש בכל פעם במערכת הקבצים כדי למצוא את
דף מדריך מתאים. אם תתבקש באמצעות -u אוֹפְּצִיָה, איש יבטיח כי
מטמונים נשארים עקביים, מה שיכול למנוע את הצורך להפעיל תוכנה ידנית לעדכון
מסורתי מה זה מסדי נתונים של טקסט.

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

כלי עזר אלה תומכים בקובצי nroff דחוסים עם, כברירת מחדל, הסיומות
of .Z, .z ו .gz. אפשר להתמודד עם כל הרחבת דחיסה, אבל זה
המידע חייב להיות ידוע בזמן הליקוט. כמו כן, כברירת מחדל, כל דפי החתולים שהופקו הם
דחוס באמצעות מופעלת דחיסת. כל היררכיית עמודים ידנית `גלובלית' כגון / usr / share / man or
/ usr / X11R6 / man יכול להיות כל ספרייה בתור היררכיית דפי החתול שלה. באופן מסורתי החתול
דפים מאוחסנים תחת אותה היררכיה כמו דפי האיש, אך מסיבות כגון אלו
שצוין ב שלח הִיֵרַרכִיָה תֶקֶן (FHS), אולי עדיף לאחסן אותם במקום אחר.
לפרטים כיצד לעשות זאת, אנא קרא נתיב אדם(5). לפרטים מדוע לעשות זאת,
לקרוא את התקן.

תמיכה בינלאומית זמינה עם חבילה זו. דפי מדריך לשפת האם הם
נגיש (אם זמין במערכת שלך) באמצעות שימוש ב אזור פונקציות. כדי להפעיל כזה
תמיכה, יש צורך להגדיר $LC_MESSAGES,$שפה או מערכת אחרת תלויה
משתנה סביבה למקום השפה שלך, המצוין בדרך כלל ב- POSIX 1003.1 מבוסס
פורמט:

<שפה>[_<שטח>[.<סט תווים>[,<גרסה>]]]

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

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

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

מחדל

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

לאחר איתור דף ידני, מתבצעת בדיקה כדי לברר אם קרוב משפחה
קובץ 'cat' מעוצב מראש כבר קיים והוא חדש יותר מקובץ nroff. אם כן ו
כלומר, הקובץ המעוצב מראש מפורק (בדרך כלל) ואז מוצג, באמצעות שימוש ב-a
ביפר. ניתן לציין את הביפר במספר דרכים, אחרת יחזור ל-a
נעשה שימוש ברירת מחדל (ראה אפשרות -P לפרטים). אם לא נמצא חתול או מבוגר מה-
קובץ nroff, ה-nroff מסונן דרך תוכניות שונות ומוצג מיד.

אם ניתן להפיק קובץ חתול (ספריית חתולים יחסית קיימת ויש לה מתאים
הרשאות), איש ידחוס ויאחסן את קובץ החתול ברקע.

המסננים מפוענחים במספר אמצעים. ראשית, אפשרות שורת הפקודה -p or
משתנה הסביבה $MANROFFSEQ נחקר. אם -p לא היה בשימוש וה
משתנה סביבה לא הוגדר, השורה הראשונית של קובץ nroff מנותחת עבור a
מחרוזת קדם-מעבד. כדי להכיל מחרוזת קדם-מעבד חוקית, השורה הראשונה חייבת להיות דומה

'\" <מחרוזת>

איפה מחרוזת יכול להיות כל שילוב של אותיות המתואר לפי אפשרות -p לְהַלָן.

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

צינור עיצוב נוצר מהמסננים ומהפורמט הראשי (nroff or
[tg]roff עם -t) והוצאה להורג. לחלופין, אם תוכנית ניתנת להפעלה mandb_nfmt (אוֹ
mandb_tfmt עם -t) קיים בשורש עץ הגבר, הוא מבוצע במקום זאת. זה עובר
קובץ המקור הידני, מחרוזת הפרה-מעבד, ולחלופין ההתקן שצוין עם
-T or -E כטיעונים.

אפשרויות

אפשרויות שאינן ארגומנטים משוכפלים בשורת הפקודה, ב-$MANOPT, או שניהם,
אינם מזיקים. עבור אפשרויות הדורשות ארגומנט, כל שכפול יעקוף את
ערך הארגומנט הקודם.

כללי אפשרויות
-C פילה, --config-file=פילה
השתמש בקובץ תצורת המשתמש הזה במקום בברירת המחדל של ~/.manpath.

-d, --לנפות
הדפס מידע על ניפוי באגים.

-D, --בְּרִירַת מֶחדָל
אפשרות זו ניתנת בדרך כלל כאפשרות הראשונה ומתאפסת של גבר התנהגות
לברירת המחדל שלו. השימוש בו הוא לאפס את האפשרויות שאולי הוגדרו
$MANOPT. כל האפשרויות הבאות -D תהיה השפעתם הרגילה.

--אזהרות[=אזהרות]
אפשר אזהרות מ גרף. זה עשוי לשמש כדי לבצע בדיקות שפיות על
טקסט מקור של דפי מדריך. אזהרות היא רשימה מופרדת בפסיקים של שמות אזהרה;
אם זה לא מסופק, ברירת המחדל היא "mac". ראה את הצומת "אזהרות" ב מידע גרף
לרשימה של שמות אזהרה זמינים.

ראשי מצבי of מבצע
-f, --מה זה
שווה ערך ל מה זה. הצג תיאור קצר מהדף המדריך, אם
זמין. לִרְאוֹת מה זה(1) לפרטים.

-k, --אַגַב
שווה ערך ל אפרופו. חפש בתיאורי הדף הידניים הקצרים עבור מילות מפתח ו
להציג התאמות כלשהן. לִרְאוֹת אפרופו(1) לפרטים.

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

-l, --local-file
הפעל מצב 'מקומי'. עיצוב והצג קבצים ידניים מקומיים במקום חיפוש
דרך האיסוף הידני של המערכת. כל ארגומנט דף ידני יהיה
מתפרש כקובץ מקור nroff בפורמט הנכון. אין קובץ חתול
מיוצר. אם '-' מופיע כאחד מהארגומנטים, הקלט יילקח מ
סטדין. כאשר אפשרות זו אינה בשימוש, והאדם לא מצליח למצוא את הדף הנדרש,
לפני הצגת הודעת השגיאה, הוא מנסה לפעול כאילו הייתה אפשרות זו
מסופק, תוך שימוש בשם כשם קובץ ומחפש התאמה מדויקת.

-w, --איפה, --נָתִיב, --מקום
אל תציג את דפי המדריך בפועל, אלא הדפס את המיקום/ים של המקור
קבצי nroff שיעוצבו.

-W, --היכן-חתול, --location-cat
אל תציג את דפי המדריך, אלא הדפס את המיקום/ים של החתול
קבצים שיוצגו. אם -w ו-W צוינו שניהם, הדפס את שניהם
מופרדים על ידי רווח.

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

-R הַצפָּנָה, --קוד מחדש=הַצפָּנָה
במקום לעצב את הדף הידני בדרך הרגילה, פלט את המקור שלו הומר
לצוין הַצפָּנָה. אם אתה כבר יודע את הקידוד של קובץ המקור,
אתה יכול גם להשתמש manconv(1) ישירות. עם זאת, אפשרות זו מאפשרת לך להמיר
מספר דפים ידניים לקידוד יחיד מבלי לציין במפורש את ה
קידוד של כל אחד מהם, בתנאי שהם כבר הותקנו במבנה דומה
להיררכיית דפים ידנית.

מציאה מדריך ל דפים
-L אזור, --locale=אזור
איש בדרך כלל יקבע את המקום הנוכחי שלך על ידי קריאה לפונקציה C
setlocale(3) אשר חוקר משתני סביבה שונים, אולי כולל
$LC_MESSAGES ו $שפה. כדי לעקוף זמנית את הערך שנקבע, השתמש בזה
אפשרות לספק א אזור מחרוזת ישירות ל איש. שימו לב שזה לא ייקח
השפעה עד שהחיפוש אחר דפים יתחיל בפועל. פלט כגון הודעת העזרה
יוצג תמיד במקום שנקבע בתחילה.

-m מערכת[,...], --מערכות=מערכת[,...]
אם למערכת זו יש גישה לדפים הידניים של מערכת הפעלה אחרת, הם יכולים להיות
גישה באמצעות אפשרות זו. כדי לחפש דף ידני מדף המדריך של NewOS
אוסף, השתמש באפשרות -m מערכת הפעלה חדשה.

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

-M נתיב, --manpath=נתיב
ציין נתיב אדם חלופי לשימוש. כברירת מחדל, איש שימושים נתיב אדם קוד נגזר ל
לקבוע את הנתיב לחיפוש. אפשרות זו עוקפת את ה-$MANPATH סביבה
משתנה וגורם אפשרות -m להתעלם.

נתיב שצוין כ-manpath חייב להיות השורש של היררכיית דפים ידנית
מובנה למקטעים כמתואר במדריך man-db (תחת "דף המדריך
מערכת"). כדי להציג דפים ידניים מחוץ להיררכיות כאלה, ראה את -l אוֹפְּצִיָה.

-S רשימה, -s רשימה, --מקטעים=רשימה
רשימה היא רשימה מופרדת בנקודתיים או בפסיקים של סעיפים ידניים של 'סדר ספציפי'
לחפש. אפשרות זו עוקפת את ה-$מנסקט משתנה הסביבה. (ה -s איות
מיועד לתאימות למערכת V.)

-e הרחבה משנה, --extension=הרחבה משנה
מערכות מסוימות משלבות חבילות גדולות של דפים ידניים, כגון אלו
ליווי את Tcl חבילה, להיררכיית העמודים הידניים הראשיים. כדי לעקוף את
בעיה של שני דפים ידניים עם אותו שם כגון יציאה(3), Tcl
כל הדפים הוקצו בדרך כלל למדור l. מכיוון שזה מצער, זה קורה עכשיו
אפשר לשים את הדפים בקטע הנכון, ולהקצות ספציפי
'הרחבה' אליהם, במקרה הזה, יציאה(3tcl). בפעולה רגילה, איש יצטרך
תצוגה יציאה(3) בעדיפות ל יציאה(3tcl). כדי לנהל משא ומתן על המצב הזה ול
הימנע מהצורך לדעת באיזה חלק נמצא הדף שאתה צריך, הוא נמצא כעת
אפשרי לתת איש a הרחבה משנה מחרוזת המציינת באיזו חבילה הדף חייב
שייך ל. באמצעות הדוגמה לעיל, אספקת האפשרות -e TCL ל איש יצטרך
הגבל את החיפוש לדפים בעלי הרחבה של *tcl.

-i, --התעלם ממקרה
התעלם מרישיות בעת חיפוש דפים ידניים. זוהי ברירת המחדל.

-I, --מקרה התאמה
חפש דפים ידניים תלוי רישיות.

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

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

--שמות בלבד
אם --רגקס or -ווילדקארד נעשה שימוש באפשרות, התאם רק שמות עמודים, לא עמודים
תיאורים, כמו עם מה זה(1). אחרת, אין השפעה.

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

-u, --עדכון
אפשרות זו גורמת איש לבצע בו בדיקת עקביות 'רמת האיודות'
מטמונים של מסד נתונים כדי להבטיח שהם ייצוג מדויק של
מערכת קבצים. תהיה לזה השפעה מועילה רק אם איש מותקן עם ה-setuid
סט סיביות.

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

$ man -aw git diff
/usr/share/man/man1/git-diff.1.gz

כדי להשבית התנהגות זו, השתמש ב- --ללא דפי משנה אוֹפְּצִיָה.

$ 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=זימונית
ציין באיזה זימונית פלט להשתמש. כברירת מחדל, איש שימושים זימונית. אפשרות זו
עוקף את ה-$MANPAGER משתנה סביבה, אשר בתורו עוקף את ה-$פיפר
משתנה הסביבה. זה לא משמש יחד עם -f or -k.

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

-r הפקודה, --prompt=הפקודה
אם גרסה עדכנית של פחות משמש כביפר, איש ינסה להגדיר את זה
כמה אפשרויות הגיוניות. בקשת ברירת המחדל נראית כך

מדריך ל עמוד שם(שניות) קו x

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

אספקה -r עם מחרוזת יעקוף את ברירת המחדל הזו. המחרוזת עשויה להכיל את
טֶקסט $MAN_PN אשר יורחב לשם דף המדריך הנוכחי ושלו
שם המדור מוקף ב-'(' ו-')'. המחרוזת המשמשת לייצור ברירת המחדל
יכול להתבטא כ

\ מדריך ל\ עמוד\ \$MAN_PN\ ?ltline\ %lt?L/%L.:
בייט\ %bB?s/%s..?\ (סוף):?pB\ %pB\\%..
(ללחוץ h ל לעזור or q ל לְהַפְסִיק)

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

ה-$חסר גבר ניתן להשתמש במשתנה הסביבה המתואר להלן כדי להגדיר ברירת מחדל
מחרוזת הנחיה אם אף אחת לא מסופקת בשורת הפקודה.

-7, --ascii
כאשר צופים בטהור ASCII(7) דף ידני במסוף 7 סיביות או אמולטור מסוף,
ייתכן שתווים מסוימים לא יוצגו כהלכה בעת השימוש ב- 1(7) מכשיר
תיאור עם גנה nroff. אפשרות זו מאפשרת טהור ASCII דפים ידניים להיות
מוצג ב ASCII עם 1 התקן. זה לא יתרגם שום דבר 1 טקסט.
הטבלה הבאה מציגה את התרגומים שבוצעו: חלקים מסוימים ממנה עשויים להיות רק
מוצג כהלכה בעת השימוש גנה nroff's 1(7) מכשיר.

תיאור Octal latin1 ascii
────────────────────────────────────────────
מקף המשך 255 - -
כדור (נקודה אמצעית) 267 · o
מבטא חריף 264 ' '
סימן כפל 327 × x

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

אפשרות זו מתעלמת בעת שימוש באפשרויות -t, -H, -T, או -Z ויכול להיות חסר תועלת עבור
nroff אחר מאשר של GNU.

-E הַצפָּנָה, --הַצפָּנָה=הַצפָּנָה
צור פלט עבור קידוד תו שאינו ברירת המחדל. לאחור
תְאִימוּת, הַצפָּנָה עשוי להיות nroff מכשיר כגון ASCII, 1, או utf8 as
כמו כן קידוד תווים אמיתי כגון UTF-8.

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

אם אתה כותב דף ידני ופשוט רוצה למנוע nroff ממקף
מילה בנקודה לא מתאימה, אל תשתמש באפשרות זו, אלא עיין ב- nroff
תיעוד במקום; לדוגמה, אתה יכול לשים "\%" בתוך מילה כדי לציין
שניתן למקף בנקודה זו, או לשים "\%" בתחילת מילה ל
למנוע ממנו להיות מקף.

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

אם אתה כותב דף ידני ופשוט רוצה למנוע nroff מהצדקה
פסקאות מסוימות, אל תשתמש באפשרות זו, אלא עיין ב- nroff תיעוד
במקום זאת; לדוגמה, אתה יכול להשתמש בבקשות ".na", ".nf", ".fi" ו-".ad" כדי
להשבית זמנית את ההתאמה והמילוי.

-p מחרוזת, --קדם מעבד=מחרוזת
ציין את רצף המעבדים המקדימים להפעלה לפני nroff or טראף/גרף. לא הכל
להתקנות תהיה קבוצה מלאה של מעבדי קדם. חלק מהמעבדים הקדם ו
האותיות המשמשות לייעודן הן: eqn (e), גרפ (g), קצת (p), tbl (t), vgrind
(v), להתייחס (r). אפשרות זו עוקפת את ה-$MANROFFSEQ משתנה הסביבה.
זסולים מופעל תמיד כמעבד הקדם הראשון.

-t, --טרוף
השתמש גרף -מנדוק כדי לעצב את הדף הידני ל-stdout. אפשרות זו אינה נדרשת
בשיתוף עם -H, -T, או -Z.

-T[מכשיר], --התקן-troff[=מכשיר]
אפשרות זו משמשת לשינוי גרף (או אולי של טרוף) פלט שיתאים לו
מכשיר שאינו ברירת המחדל. זה מרמז -t. דוגמאות (מסופק עם
Grop-1.17) כוללים דוי, 1, ps, utf8, X75 ו X100.

-H[דפדפן], --html[=דפדפן]
אפשרות זו תגרום גרף לייצר פלט HTML, ויציג את הפלט הזה
בדפדפן אינטרנט. בחירת הדפדפן נקבעת על ידי האופציונלי דפדפן
ארגומנט אם מסופק אחד, על ידי ה-$מתווך משתנה סביבה, או על ידי קומפיל-
ברירת המחדל של זמן אם זה לא מוגדר (בדרך כלל לִינקס). אפשרות זו מרמזת -t, ויהיה
לעבוד רק עם גנה טראף.

-X[dpi], --gxditview[=dpi]
אפשרות זו מציגה את הפלט של גרף בחלון גרפי באמצעות ה- gxditview
תכנית. ה dpi (נקודות לאינץ') עשויות להיות 75, 75-12, 100 או 100-12, ברירת המחדל היא
75; הגרסאות -12 משתמשות בגופן בסיס של 12 נקודות. אפשרות זו מרמזת -T עם
מכשיר X75, X75-12, X100 או X100-12 בהתאמה.

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

מקבל לעזור
-?, - עזרה
הדפס הודעת עזרה וצא.

--נוֹהָג
הדפס הודעת שימוש קצרה וצא.

-V, --גִרְסָה
הצג מידע על גרסה.

יְצִיאָה סטָטוּס

0 ביצוע תוכנית מוצלח.

1 שגיאת שימוש, תחביר או קובץ תצורה.

2 טעות תפעולית.

3 תהליך צאצא החזיר סטטוס יציאה שאינו אפס.

16 לפחות אחד מהדפים/הקבצים/מילות המפתח לא היה קיים או לא תואם.

הסביבה

MANPATH
אם $MANPATH מוגדר, הערך שלו משמש כנתיב לחיפוש דפים ידניים.

MANROFFOPT
התוכן של $MANROFFOPT מתווספים לשורת הפקודה בכל פעם איש מעורר
הפורמט (nroff, טראף, או גרף).

MANROFFSEQ
אם $MANROFFSEQ מוגדר, הערך שלו משמש לקביעת קבוצת המעבדים המקדימים
להעביר כל עמוד ידני. רשימת המעבדים המוגדרים כברירת מחדל תלויה במערכת.

מנסקט
אם $מנסקט מוגדר, הערך שלו הוא רשימה מופרדת בנקודתיים של סעיפים והוא משמש
כדי לקבוע באילו סעיפים ידניים לחפש ובאיזה סדר. ברירת המחדל היא "1
nl 8 3 2 3posix 3pm 3perl 5 4 9 6 7", אלא אם כן הוא עוקף את SECTION הוראה
in /etc/manpath.config.

MANPAGER, פיפר
אם $MANPAGER או $פיפר מוגדר ($MANPAGER משמש בהעדפה), נעשה שימוש בערכו
כשם התוכנית המשמשת להצגת דף המדריך. כברירת מחדל, זימונית is
מְשׁוּמָשׁ.

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

חסר גבר
אם $חסר גבר מוגדר, הערך שלו ישמש כמחרוזת ההנחיה המוגדרת כברירת מחדל עבור
פחות ביפר, כאילו הועבר באמצעות ה- -r אפשרות (כך שכל המופעים של ה
טֶקסט $MAN_PN יורחב באותו אופן). לדוגמה, אם אתה רוצה להגדיר
מחרוזת ההנחיה ללא תנאי ל"מחרוזת ההנחיה שלי", הגדר $חסר גבר ל
"-פסמי הפקודה מחרוזת'. משתמש ב -r האפשרות עוקפת את משתנה הסביבה הזה.

מתווך
אם $מתווך מוגדר, הערך שלו הוא רשימה מופרדת בנקודתיים של פקודות, שכל אחת מהן
בתורו משמש כדי לנסות להפעיל דפדפן אינטרנט עבור איש --html. בכל פקודה, %s
מוחלף בשם קובץ המכיל את פלט ה-HTML מ גרף, %% מוחלף על ידי
סימן אחוז בודד (%), ו %c מוחלף בנקודתיים (:).

מערכת אם $מערכת מוגדר, תהיה לו אותה השפעה כאילו היא צוינה כ-
ויכוח ל -m אוֹפְּצִיָה.

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

MANWIDTH
אם $MANWIDTH מוגדר, הערך שלו משמש כאורך השורה עבור עמודים ידניים
צריך להיות מעוצב. אם זה לא מוגדר, דפים ידניים יפורמטו בשורה
אורך המתאים למסוף הנוכחי (באמצעות הערך של $עמודים,
ioctls(2) אם זמין, או חזרה ל-80 תווים אם אף אחד מהם אינו זמין).
דפי חתול יישמרו רק כאשר ניתן להשתמש בפורמט ברירת המחדל, כלומר מתי
אורך קו המסוף הוא בין 66 ל-80 תווים.

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

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

שפה, LC_MESSAGES
תלוי במערכת וביישום, אחד או שניהם של $שפה ו $LC_MESSAGES
ייחקר עבור אזור ההודעה הנוכחי. איש יציג את ההודעות שלו
במקום זה (אם זמין). לִרְאוֹת setlocale(3) לפרטים מדויקים.

השתמש ב-man באינטרנט באמצעות שירותי onworks.net