גרופר - אונליין בענן

תָכְנִית:

שֵׁם

groffer - הצגת קבצי groff ודפי man ב-X וב-tty

תַקצִיר

גרופר [--] [מפרט קבצים ....]

גרופר [אפשרות מצב ....] [אפשרויות גרוף ....] [אפשרויות-אדם ....] [אפשרויות X ....]
[--] [מפרט קבצים ....]

גרופר -h | - עזרה

גרופר -v | --גִרְסָה

תיאור

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

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

השימוש הרגיל הוא די פשוט על ידי מתן שם קובץ או שם של איש עמוד לְלֹא
אפשרויות נוספות. אבל לטיפול באפשרויות יש אפשרויות רבות ליצירת אפשרויות מיוחדות
התנהגויות. ניתן לעשות זאת בקבצי תצורה, באמצעות סביבת המעטפת
משתנה $GROFFER_OPT, או בשורת הפקודה.

ניתן ליצור ולצפות בפלט במספר דרכים שונות הזמינות עבור גרף.
זה כולל את גרף מציג X Window מקורי gxditview(1), כל אחד פוסט-סקריפט, PDF, או דוי
תוכנית תצוגה, דפדפן אינטרנט על ידי יצירת html in www מצב, או כמה טֶקסט מצבי in
מסופי טקסט.

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

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

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

אוֹפְּצִיָה סקירה כללית

שבירה אפשרויות

[-h | - עזרה] [-v | --גִרְסָה]

גרופר מצב אפשרויות

[--אוטומטי] [--בְּרִירַת מֶחדָל] [--מצבי-ברירת-מחדל מצב 1, מצב 2,....] [--dvi] [--גרוף]
[--html] [--לטינית1] [--מצב מצב תצוגה] [-- pdf] [--pdf2] [--נ.ב] [--מָקוֹר]
[--טֶקסט] [--to-stdout] [--tty] [--utf8] [--צוֹפֶה פרוג] [--www] [--איקס | --איקס]

אפשרויות קָשׁוּר ל גרף

[-T | --התקן מכשיר] [-Z | --פלט-ביניים | --דיטרוף]

כל עוד יותר גרף אופציות קצרות מתקבלות.

אפשרויות ל איש דפים

[--אַגַב] [--אפרופוס-נתונים] [--אפרופוס-דבל] [--אפרופוס-פרוגס] [--איש]
[--לא אחי] [--לא-מיוחד] [--מה זה]

ארוך אפשרויות משימות יותר החל מ- גנה איש

[--את כל] [--ascii] [--דיטרוף] [--סיומת סִיוֹמֶת] [--מקומי שפה]
[--local-file] [--מקום | --איפה] [--manpath תיקייה1: תיקייה2:....] [--ללא מיקום]
[--ביפר התוכנית] [--מקטעים שנייה 1: שנייה 2:....] [--מערכות מערכת1, מערכת2,....]
[--התקן-troff מכשיר]

אפשרויות ארוכות נוספות של GNU איש מתקבלים גם כן.

X חלון ארגז כלים אפשרויות

[--bd | --צבע גבול פיקסלים] [--בג | --רקע כללי צֶבַע]
[--בוו | --רוחב גבול פיקסלים] [--לְהַצִיג תצוגה X] [--fg | --חֲזִית צֶבַע]
[--fn | --רגל | --גוֹפָן שם_font] [--גֵאוֹמֶטרִיָה גודל_מיקום] [--פתרון הבעיה ערך] [--קרוואן]
[--כותרת מחרוזת] [--xrm משאב X]

אפשרויות ל פיתוח

[--לנפות] [--שמות-קבצים-ניפוי-באגים] [--debug-grog] [--ניפוי-שמירה] [--פרמטרי-ניפוי-באגים]
[--debug-tmpdir] [--לא לעשות כלום] [--הדפס טֶקסט] [-V]

מפרט קבצים טיעונים

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

בהמשך, המונח סיומת_מקטע משמש. פירוש הדבר מילה ש
מורכב איש סעיף שאחריו, אופציונלית, מגיעה הארכה. השם של
a איש סעיף הוא דמות אחת מתוך [1–9 ב-], ה הארכה היא מילה כלשהי. ה
הארכה חסר בעיקר.

לא מפרט קבצים פרמטרים פירושם קלט סטנדרטי.

- מייצג קלט סטנדרטי (יכול להופיע מספר פעמים).

שם הקובץ שם הנתיב של קובץ קיים.

איש:שם(סיומת_מקטע)
איש:שם.סיומת_מקטע
שם(סיומת_מקטע)
שם.סיומת_מקטע
סיומת_מקטע שם
חפש בדף האיש שם בחלק עם הרחבה אופציונלית
סיומת_מקטע.

איש:שם דף האיש בתחתית התחתונה איש סעיף זה היה שם.

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

אוֹפְּצִיָה פרטים

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

כל האפשרויות הקצרות של גרופר תואמים לאפשרויות הקצרות של גרף(1). הכל ארוך
אפשרויות של גרופר תואמים לאפשרויות הארוכות של איש(1).

ניתן לקצר ארגומנטים עבור שמות אפשרויות ארוכים בכמה דרכים. ראשית, הארגומנט
נבדק האם ניתן להאריך אותו כפי שהוא. יתר על כן, כל סימן מינוס - is
נחשב כנקודת התחלה לקיצור חדש. זה מוביל לקבוצה של מספר רב של
קיצורים עבור ארגומנט בודד. לדוגמה, --de-nf יכול לשמש כקיצור
ל --debug-not-func, אבל --גוֹב עובד גם כן. אם קיצור הארגומנט מוביל
למספר אפשרויות שנוצרות מופיעה שגיאה.

קיצורים אלה מותרים רק במשתנה הסביבה $GROFFER_OPT, אבל לא ב
קבצי התצורה. בתצורה, כל האפשרויות הארוכות חייבות להיות מדויקות.

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

-h | - עזרה
הדפס מידע עזרה עם הסבר קצר על אפשרויות לפלט סטנדרטי.

-v | --גִרְסָה
הדפס מידע על גרסת הפלט הסטנדרטי.

גרופר מצב אפשרויות
מצב התצוגה ותוכניות הצפייה נקבעים על ידי אפשרויות אלה. אם אף אחת מהאפשרויות אינה
אפשרויות המצב והצופה הללו מצוינות גרופר מנסה למצוא מצב תצוגה מתאים
באופן אוטומטי. מצבי ברירת המחדל הם מצב PDF, מצב ps, מצב html, מצב x, ו מצב דוי
בחלון X עם צופים שונים ו מצב tty עם מכשיר utf8 תחת פחות על מסוף;
מצבים אחרים נבדקים אם התוכניות עבור מצב ברירת המחדל הראשי אינן קיימות.

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

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

--אוטומטי שווה ערך ל --mode=אוטומטי.

--בְּרִירַת מֶחדָל
אפס את כל התצורה מאפשרויות שורת פקודה שעובדו בעבר אל
ערכי ברירת מחדל. זה שימושי כדי למחוק את כל האפשרויות הקודמות של
תצורה, ב $GROFFER_OPT, ולהפעיל מחדש את עיבוד האפשרויות באמצעות השאר בלבד
של שורת הפקודה.

--מצבי-ברירת-מחדל מצב 1, מצב 2,....
הגדר את רצף המצבים עבור המכונית מצב לרשימה המופרדת בפסיקים שניתנה ב
טַעֲנָה. לִרְאוֹת --מצב לפרטים על מצבים. הצג באופן ברירת המחדל;
למעשה, זה אומר לנסות את המצבים x, ps, ו tty ברצף הזה.

--dvi שווה ערך ל --mode=dvi.
--צוֹפֶה פרוג
בחר תוכנית צפייה עבור דוי מצבזה יכול להיות שם קובץ או תוכנית שיש
חיפשתי ב $ PATHחלון X ידוע דוי הצופים כוללים xdvi(1) ו dvilx(1). בתוך
בכל מקרה, ניתן לספק טיעונים נוספים.

--גרוף
שווה ערך ל --mode=גרוף.

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

--מצב ערך
הגדר את מצב התצוגה. ערכי המצב הבאים מזוהים:

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

דוי הצגת קלט מעוצב ב- דוי תוכנית הצפייה. כברירת מחדל, התוכנית המעוצבת
הקלט מוצג עם xdvi(1) תוכנית.

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

html תרגם את הקלט לפורמט HTML והצג את התוצאה בדפדפן אינטרנט
תוכנית. כברירת מחדל, קיומם של רצף של דפדפני אינטרנט סטנדרטיים
נבדק, החל מ- כובש(1) ו מוזילה(1). מציג טקסט html
is לִינקס(1).

PDF לשנות roff קלט קבצים אל PDF פילה באמצעות גרף (1) מכשיר
-Tpdfזוהי ברירת המחדל PDF גנרטור. המחולל PDF פילה is
מוצג באמצעות תוכניות צפייה מתאימות, כגון אוקולרי(1).

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

ps הצג קלט מעוצב בתוכנית מציג Postscript. כברירת מחדל, ה-
קלט מעוצב מוצג באחת מתוכניות הצפייה הרבות.

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

tty פורמט ב-a גרף טֶקסט מצב ולכתוב את התוצאה לפלט סטנדרטי באמצעות
תוכנת זיווג טקסט, אפילו כאשר היא בחלון X.

www שווה ערך ל --mode=html.

x הצג את הקלט המעוצב בגרסה מקורית roff הצופה. כברירת מחדל, ה-
קלט מעוצב מוצג עם gxditview(1) תוכנית מופצת
יחד עם גרףאבל כלי X Window הסטנדרטי xditview(1) יכול להיות גם
נבחר עם האפשרות --צוֹפֶהרזולוציית ברירת המחדל היא 75dpi, אבל
100dpi אפשריים גם כן. ברירת המחדל גרף מכשיר לפתרון של
75dpi is X75-12, עבור 100dpi זה X100. המקביל גרף
ביניים תפוקה עבור המכשיר בפועל נוצר והתוצאה היא
מוצג. לקבלת פתרון של 100dpi, רוחב ברירת המחדל של הגיאומטריה של
תוכנית התצוגה נבחרה כך 850dpi.

X שווה ערך ל --mode=x.

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

גרף צור פלט של התקן עם רגיל גרף בלי להשתמש בתצוגה המיוחדת
תכונות של גרופראם לא צוין התקן על ידי האפשרות -T מה היא גרף
ברירת מחדל ps מניחים.

מָקוֹר הפקת קוד המקור של ה-roff של קבצי הקלט ללא עיבוד נוסף.

-- pdf שווה ערך ל --mode=pdf.
--pdf2 שווה ערך ל --mode=pdf2.
--צוֹפֶה פרוג
בחר תוכנית צפייה עבור PDF מצבזה יכול להיות שם קובץ או תוכנית שיש
חיפשתי ב $ PATHניתן לספק טיעונים בנוסף.

--נ.ב שווה ערך ל --mode=ps.
--צוֹפֶה פרוג
בחר תוכנית צפייה עבור ps מצבזה יכול להיות שם קובץ או תוכנית שיש
חיפשתי ב $ PATHמציגי Postscript נפוצים כוללים אוקולרי(1), לְהַצִיג(1), gv(1),
נוף רפאים(1), ו gs(1), בכל מקרה, ניתן לספק טיעונים נוספים.

--מָקוֹר
שווה ערך ל --mode=מקור.

--טֶקסט שווה ערך ל --mode=טקסט.

--to-stdout
הקובץ עבור המצב הנבחר נוצר ותוכנו מודפס בתקן
פלט. הוא לא יוצג במצב גרפי.

--tty שווה ערך ל --mode=tty.
--צוֹפֶה פרוג
בחר ביפר טקסט עבור מצב ttyהביפר הסטנדרטי הוא פחות(1). אפשרות זו היא
שווה ערך ל איש אוֹפְּצִיָה --pager=פרוגארגומנט האפשרות יכול להיות שם קובץ או
תוכנית לחיפוש $ PATHניתן לספק טיעונים בנוסף.

--www שווה ערך ל --mode=html.
--צוֹפֶה
פרוג.

--איקס | --איקס
שווה ערך ל --mode=x.
--צוֹפֶה פרוג
בחר תוכנית צפייה עבור x מצבתוכניות צפייה מתאימות הן gxditview(1)
שהוא ברירת המחדל ו xditview(1). הארגומנט יכול להיות כל קובץ הפעלה או קובץ
תוכנית ב $ PATHניתן לספק טיעונים בנוסף.

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

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

אפשרויות קָשׁוּר ל גרף
כל האפשרויות הקצרות של גרופר תואמים לאפשרויות הקצרות של גרף(1). ה
בעקבות של גרף לאפשרויות יש משמעות מיוחדת נוספת בתוך גרופר or
הגיוני לשימוש רגיל.

בגלל התנהגות הפלט המיוחדת של גרף אוֹפְּצִיָה -Z גרופר נועד
להיות מועבר ל גרף מצב; ה גרופר תכונות הצפייה מושבתות שם. האחרות
גרף האפשרויות אינן משנות את המצב, אך מאפשרות להתאים אישית את תהליך העיצוב.

--א זה יוצר קירוב ASCII של הפלט ב- טֶקסט מצביזה יכול להיות
חשוב כאשר לבידור הטקסט יש בעיות עם רצפי בקרה ב tty מצב.

--M פילה
להוסיף פילה בתור גרף קובץ מאקרו. זה שימושי במקרה שלא ניתן לזהותו
באופן אוטומטי.

- פ opt_or_arg
שלח את הטיעון opt_or_arg כאופציה או ארגומנט אופציה לתוצאה בפועל גרף
מעבד פוסט.

-ט devname | --התקן devname
אפשרות זו קובעת גרףהתקן הפלט של. ההתקנים החשובים ביותר הם ה-
התקני פלט טקסט להפניה לקבוצות תווים שונות, כגון ASCII,
utf8, 1, utf8, ואחרים. כל אחד מהארגומנטים הללו עובר גרופר אל
טֶקסט מצב באמצעות מכשיר זה, כדי מצב tty אם המצב בפועל אינו טֶקסט מצב.
הבא devname הארגומנטים ממופים לפונקציה המתאימה גרופר
--mode=devname אפשרות: דוי, html, ו ps. כל X* ארגומנטים ממופים אל מצב x.
אחד את השני devname הארגומנט עובר ל מצב גרף באמצעות מכשיר זה.

--איקס שווה גרף -X. הוא מציג את גרף ביניים תפוקה עם
gxditviewמכיוון שהאיכות יחסית גרועה, אפשרות זו אינה בשימוש; השתמשו --איקס
במקום זאת, משום ש- x מצב משתמש ב- X* מכשיר לתצוגה טובה יותר.

-Z | --פלט-ביניים | --דיטרוף
עבור אל גרף מצב ולעצב את הקלט עם גרף ביניים תפוקה
ללא עיבוד לאחר מכן; ראה groff_out(5). זה שווה ערך לאפשרות --דיטרוף
of איש, שגם בו ניתן להשתמש.

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

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

* לבנות גרף מסגרת דומה ל- איש עמוד לפלט של אפרופו,

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

* ההגבלה על ידי --מקטעים מטופל גם כן,

* תווים כלליים מותרים ומטופלים ללא אפשרות נוספת.

--אפרופוס-נתונים
הצג רק את אפרופו תיאורים עבור מסמכי נתונים, אלו הם איש(7)
סעיפים 4, 5, ו 7ישיר סעיף הצהרות מתעלמות, תווים כלליים (wildcards) מתעלמים
קיבל.

--אפרופוס-דבל
הצג רק את אפרופו תיאורים עבור מסמכי פיתוח, אלה הם איש(7)
סעיפים 2, 3, ו 9ישיר סעיף הצהרות מתעלמות, תווים כלליים (wildcards) מתעלמים
קיבל.

--אפרופוס-פרוגס
הצג רק את אפרופו תיאורים למסמכים בתוכניות, אלו הם איש(7)
סעיפים 1, 6, ו 8ישיר סעיף הצהרות מתעלמות, תווים כלליים (wildcards) מתעלמים
קיבל.

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

* כל שם קובץ שאוחזר נוסף,

* קבצים מקומיים מטופלים גם כן,

* ה שפה ו מערכת המיקום נתמך,

* התצוגה ממוסגרת על ידי גרף פורמט פלט דומה ל- איש עמוד,

* תווים כלליים מותרים ללא אפשרות נוספת.

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

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

--לא אחי | --local-file
אל תבדוק עבור איש דפים. --local-file הוא המתאים איש אוֹפְּצִיָה.

--לא-מיוחד
השבתת שיחות קודמות של --את כל, --אַגַב*, ו --מה זה.

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

בהמשך, ה- איש אפשרויות בעלות משמעות מיוחדת עבור גרופר מתועדים.

אם למערכת שלך יש GNU איש התקין את כל סט האפשרויות הארוכות והקצרות של GNU איש
ניתן להעביר את התוכנית דרך משתנה הסביבה $MANOPT; ראה איש(1).

--את כל בחיפוש איש דפים, לאחזר את כל המסמכים המתאימים במקום רק אחד.

-7 | --ascii
In טֶקסט מצבי, הצגת תרגום ASCII של תווים מיוחדים עבור פונקציות קריטיות
סביבה. זה שווה ערך ל גרף -mtty_char; ראה groff_tmac(5).

--דיטרוף
ייצור גרף ביניים תפוקה. זה שווה ערך ל גרופר -Z.

--סיומת סִיוֹמֶת
להגביל איש עמוד חיפוש שמות קבצים שיש בהם סִיוֹמֶת מצורף לסעיף שלהם
אלמנט. לדוגמה, בשם הקובץ /usr/share/man/man3/terminfo.3ncurses.gz
מה היא איש עמוד ההרחבה היא קללות.

--מקומי שפה
הגדר את השפה עבור איש דפים. יש לכך את אותה השפעה, אך היא דורסת $LANG.

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

--ללא מיקום
אל תציג את מיקום הקבצים שאוחזרו; פעולה זו מאפסת קריאה קודמת אל
--מקוםזה נוסף על ידי גרופר.

--manpath תיקייה1: תיקייה2:....
השתמש בנתיב החיפוש שצוין לאחזור איש דפים במקום התוכנית
ברירות מחדל. אם הארגומנט מוגדר למחרוזת ריקה "", החיפוש אחר איש עמוד is
נכה.

--ביפר
הגדר את תוכנית הביפר tty מצב; ברירת המחדל היא פחותניתן להגדיר זאת באמצעות --צוֹפֶה.

--מקטעים שנייה 1: שנייה 2:....
הגבל את החיפוש אחר איש דפים לנתון סעיפים, רשימה מופרדת באמצעות נקודתיים.

--מערכות מערכת1, מערכת2,....
חיפוש איש דפים עבור מערכות ההפעלה הנתונות; הארגומנט מערכות הוא
רשימה מופרדת בפסיקים.

--איפה
שווה ערך ל --מקום.

X חלון ארגז כלים אפשרויות
האפשרויות הארוכות הבאות הותאמו מאפשרויות הכלים של X Window Toolkit המתאימות.
גרופר יעביר אותם לתוכנית הצפייה בפועל אם מדובר בתוכנית X Window.
אחרת, אפשרויות אלו מתעלמות.

למרבה הצער, אפשרויות אלו משתמשות בסגנון הישן של סימן מינוס יחיד עבור אפשרויות ארוכות.
גרופר ששונה לסטנדרט עם שימוש בסימן מינוס כפול עבור אופציות ארוכות, עבור
דוגמא, גרופר משתמש באפשרות --גוֹפָן עבור אפשרות חלון X -גוֹפָן.

לִרְאוֹת X(7) ובתיעוד על אפשרויות ערכת הכלים של X Window לפרטים נוספים עליהן
אפשרויות והטיעונים שלהן.

--רקע כללי צֶבַע
הגדר את צבע הרקע של חלון הצופה.

--bd פיקסלים
זה שווה ערך ל --צבע גבול.

--בג צֶבַע
זה שווה ערך ל --רקע כללי.

--בוו פיקסלים
זה שווה ערך ל --רוחב גבול.

--צבע גבול פיקסלים
מציין את צבע הגבול המקיף את חלון הצופה.

--רוחב גבול פיקסלים
מציין את הרוחב בפיקסלים של הגבול המקיף את חלון הצופה.

--לְהַצִיג תצוגה X
הגדר את תצוגת חלון ה-X שעליה תופעל תוכנית הצופה, ראה את
תיעוד X Window עבור התחביר של הארגומנט.

--חֲזִית צֶבַע
הגדר את צבע החזית של חלון הצופה.

--fg צֶבַע
זה שווה ערך ל --חֲזִית.

--fn שם_font
זה שווה ערך ל --גוֹפָן.

--גוֹפָן שם_font
הגדר את הגופן בו משתמש חלון הצופה. הארגומנט הוא שם גופן של חלון X.

--רגל שם_font
זה שווה ערך ל --גוֹפָן.

--גֵאוֹמֶטרִיָה גודל_מיקום
הגדר את הגיאומטריה של חלון התצוגה, כלומר את גודלו ואת ההתחלה שלו.
עמדה. ראה X(7) עבור התחביר של הארגומנט.

--פתרון הבעיה ערך
הגדר את רזולוציית X Window ב-dpi (נקודות לאינץ') בחלק מתוכנות הצפייה. היחיד
ערכי dpi נתמכים הם 75 ו 100למעשה, רזולוציית ברירת המחדל עבור גרופר
מוגדר 75dpiהרזולוציה גם מגדירה את התקן ברירת המחדל ב מצב x.

--קרוואן הפוך את צבע החזית והרקע של חלון הצפייה.

--כותרת 'כַּמָה טֶקסט'
הגדר את הכותרת עבור חלון הצופה.

--xrm 'מַשׁאָב'
הגדר משאב X Window.

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

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

--debug-grog
הדפס את הפלט של כל גְרוֹג פקודות.

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

--פרמטרי-ניפוי-באגים
הדפס את הפרמטרים, כפי שהתקבלו מקבצי התצורה, מ GROFFER_OPT,
ואת הארגומנטים של שורת הפקודה.

--debug-tmpdir
הדפס את שם הספרייה הזמנית.

--לא לעשות כלום
זה כמו --גִרְסָה, אך ללא הפלט; אף מציג לא מופעל. זה גורם
חוש בלבד בהתפתחות.

--print=טֶקסט
פשוט הדפס את הארגומנט לפי רמת השגיאה הסטנדרטית. זה טוב לבדיקת פרמטרים.

-V זוהי אפשרות מתקדמת לניפוי באגים בלבד. במקום להציג את התבנית המעוצבת
קלט, הרבה גרופר מידע ספציפי מודפס לפלט סטנדרטי:

* שם קובץ הפלט בספרייה הזמנית,

* מצב התצוגה של התוצאה בפועל גרופר לָרוּץ,

* תוכנית התצוגה לצפייה בפלט עם הארגומנטים שלה,

* הפרמטרים הפעילים מקבצי התצורה, הארגומנטים ב $GROFFER_OPT, ו
הארגומנטים של שורת הפקודה,

* הצינור שיופעל על ידי גרף תוכנית, אך מבלי להפעיל אותה.

אפשרויות שימושיות נוספות לניפוי שגיאות הן גרף אוֹפְּצִיָה -Z ו --mode=גרוף.

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

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

האפשרויות --אַגַב* יש טיפול מיוחד של מפרט קבצים טיעונים. כל טיעון הוא
נלקח כתכנית חיפוש בפני עצמה. כמו כן, ניתן להשתמש בביטוי רגולרי (regexp) ב
מפרט הקובץ. לדוגמה, גרופר --אַגַב ‏'^gro.f$' חיפושים גרף ב איש עמוד
שם, בעוד גרופר --אַגַב גרף חיפושים גרף איפשהו בשם או בתיאור של
מה היא איש דפים.

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

יש צורך לדעת שבכל מערכת ה- איש דפים ממוינים לפי שלהם
תוכן למספר חלקים. ה קלאסי איש סעיפים יש שם בן תו אחד,
או ספרה מ 1 ל 9 או אחת הדמויות n or o.

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

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

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

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

* איש:שם(סיומת_מקטע), איש:שם.סיומת_מקטע, שם(סיומת_מקטע), or
שם.סיומת_מקטע חפש בדף האיש שם במקטע האדם ואולי הרחבה של
סיומת_מקטע.

* עכשיו איש:שם מחפש אחר איש עמוד בחלק הנמוך ביותר איש סעיף שיש בו מסמך
נקרא שם.

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

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

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

תפוקה מצבים

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

מוצעים מספר מצבים שונים, מצבים גרפיים עבור X Window, טֶקסט מצבי, וכמה
ישיר גרף מצבי לצורך ניפוי שגיאות ופיתוח.

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

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

גרפי לְהַצִיג מצבים
מצבי התצוגה הגרפיים פועלים בעיקר בסביבת X Window (או דומה
יישומים בתוך סביבות חלונות אחרות). משתנה הסביבה $DISPLAY
והאופציה --לְהַצִיג משמשים לציון תצוגת חלון X שתשמש. אם זה
משתנה הסביבה ריק גרופר מניחה שאין חלון X פעיל ומשנה ל-
טֶקסט מצבניתן לשנות התנהגות אוטומטית זו באמצעות האפשרות --מצבי-ברירת-מחדל.

צופים ידועים עבור מצבי התצוגה הגרפיים ותוכנות הצפייה הסטנדרטיות של X Window
יש לו

* בצופה PDF (PDF מצב)

* בדפדפן אינטרנט (html or www מצב)

* במציג Postscript (ps מצב)

חלון X roff צופים כמו gxditview(1) או xditview(1) (ב x מצב)

* בתוכנית צופה DVI (דוי מצב)

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

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

טקסט מצבי
ישנם שני מצבים לפלט טקסט, מצב טֶקסט עבור פלט רגיל ללא ביפר ו
מצב tty עבור פלט טקסט במסוף טקסט באמצעות תוכנת זימונית כלשהי.

אם המשתנה $DISPLAY לא מוגדר או ריק, גרופר מניח שצריך להשתמש בו tty מצב.

ביישום בפועל, ה- גרף התקן פלט 1 נבחר עבור טֶקסט מצבי.
ניתן לשנות זאת על ידי ציון אפשרות -T or --התקן.

ניתן לציין את הביפר שיש להשתמש בו באמצעות אחת מהאפשרויות --ביפר ו --צוֹפֶה, או על ידי
משתנה הסביבה $PAGERאם כל זה לא מנוצל, פחות(1) תוכנית עם
אוֹפְּצִיָה -r להצגה נכונה של רצפי בקרה משמש כזיפר ברירת מחדל.

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

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

אפשרות --to-stdout לא מוצג במצב גרפי. זה פשוט יוצר את הקובץ עבור
במצב הנבחר ולאחר מכן מדפיס את תוכנו לפלט סטנדרטי.

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

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

הכל גרף אופציות קצרות נתמכות על ידי גרופר.

גבר עמוד חיפוש

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

--איש מאלץ לפרש את כל פרמטרי הקובץ כ מפרט הקובץ לחיפוש איש דפים.

--לא אחי
--local-file
השבת את איש חיפוש; כך שיוצגו רק קבצים מקומיים.

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

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

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

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

השמיים איש נתיב היא רשימה של ספריות המופרדות באמצעות נקודתיים. היא נוצרת על ידי
השיטות הבאות.

* משתנה הסביבה $MANPATH ניתן להגדיר.

* ניתן לקרוא זאת מהארגומנטים של משתנה הסביבה $MANOPT.

* איש נתיב ניתן לציין ידנית באמצעות האפשרות --manpathטיעון ריק
מבטל את איש עמוד מחפש.

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

* אם זה לא עובד, נתיב ברירת מחדל סביר מ $ PATH נקבע.

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

* משתנה הסביבה מערכת $ בעל העדיפות הנמוכה ביותר.

* ניתן לעקוף זאת על ידי אפשרות ב $MANOPT.

* זה שוב מבוטל על ידי אפשרות שורת הפקודה --מערכות.

מספר שמות של פועל מערכות ניתן לתת על ידי הוספת שמותיהם, מופרדים על ידי
פְּסִיק.

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

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

* משתנה סביבתי $LANG.

* זה מבוטל על ידי $LC_MESSAGES.

* זה מבוטל על ידי $LC_ALL.

* ניתן לעקוף זאת על ידי מתן אפשרות ב $MANOPT.

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

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

כמובן, שפה השם נקבע על ידי אישבגנו איש, זה מצוין ב-
פורמט מבוסס POSIX 1003.1:

[_[.[,]]],

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

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

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

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

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

מצד השני, דְחִיסָה זה רק מידע על איך הקובץ דחוס.
זה לא חשוב למשתמש, ולכן לא ניתן לציין זאת בשורת הפקודה.

ישנן 4 שיטות לציין א סעיף בשורת הפקודה:

* משתנה סביבתי $MANSECT

* אפשרות שורת פקודה --מקטעים

* נספח ל שם טיעון בצורה .

* טיעון מקדים לפני ה שם טיעון בצורה

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

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

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

* משתנה סביבתי $הרחבה

* אפשרות שורת פקודה --סיומת

* נספח ל . טיעון בצורה .

* טיעון מקדים לפני ה שם טיעון בצורה

לפרטים נוספים אודות איש עמוד מחפש, רואה איש(1).

דוגמאות of איש קבצים
/usr/share/man/man1/groff.1
זהו קובץ לא דחוס עבור ה- איש עמוד גרוף ב סעיף 1ניתן לקרוא לזה
by
ש# גרופר גרוף
לא סעיף מצוין כאן, אז הכל סעיפים יש לחפש, אבל כמו סעיף 1
מחפשים תחילה קובץ זה יימצא ראשון. שם הקובץ מורכב מ-
הרכיבים הבאים. / usr / שתף / איש / חייב להיות חלק מ- איש נתיב; ה
ספריית משנה גבר1/ והחלק .1 לעמוד על ה סעיף; גרף הוא שמו של ה-
איש עמוד.

/usr/local/share/man/man7/groff.7.gz
שם הקובץ מורכב מהרכיבים הבאים. /usr/local/share/man צריך
להיות חלק מה איש נתיב; ספריית המשנה גבר7/ והחלק .7 לעמוד על ה
סעיף; גרף הוא שמו של ה- איש עמוד; החלק האחרון .gz מייצג א
דחיסה עם מופעלת דחיסת(1). כפי ש- סעיף זה לא הראשון, יש לציין אותו
ניתן לעשות זאת באמצעות אחת מהפקודות הבאות.
ש# גרופר גרוף.7
ש# גרופר 7 גרוף
ש# גרופר --סעיפים=7 גרוף

/usr/local/man/man1/ctags.1emacs21.bz2
כאן / usr / local / man חייב להיות בפנים איש נתיב; ספריית המשנה גבר1/ ושם הקובץ
חלק .1 לעמוד על סעיף 1; שמו של ה- איש עמוד is ctags; לסעיף יש
הארכה emacs21והקובץ דחוס כך . Bz2 עם bzip2(1). הקובץ יכול
לצפייה באמצעות אחת מהפקודות הבאות
ש# גרופר ctags.1e
ש# גרופר 1e ctags
ש# גרופר --הרחבה=e --סעיפים=1 תגיות
כאשר e הוא קיצור של ההרחבה emacs21.

/usr/man/linux/de/man7/man.7.Z
הספריה / usr / man הוא כעת חלק מה- איש נתיב; ואז ישנה תת-ספרייה
עבור פועל מערכת שם לינוקס/; לאחר מכן מגיעה תת-ספרייה de / עבור הגרמני
שפה; ה סעיף שמות man7 ו .7 ידועים עד כה; איש הוא שמו של ה-
איש עמוד, ו .Z מסמל את הדחיסה שניתן לטפל בה על ידי מופעלת דחיסת(1). אנחנו רוצים
כעת הראה כיצד לספק מספר ערכים עבור אפשרויות מסוימות. זה אפשרי עבור
סעיפים ו פועל מערכת שמות. אז אנחנו משתמשים כ סעיפים 5 ו 7 וכמו מערכת
שמות לינוקס ו אקסהפקודה היא אז

ש# גרופר --מיקום=ה--סעיפים=5:7 --מערכות=לינוקס,אייקס מאן
ש# LANG=de MANSECT=5:7 SYSTEM=לינוקס,aix גרופר מאן

שִׁחרוּר לַחַץ

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

הסביבה

השמיים גרופר התוכנית תומכת במשתני מערכת רבים, רובם באדיבות אחרים
תוכניות. כל משתני הסביבה של גרף(1) וגנו איש(1) ומערכת סטנדרטית כלשהי
משתנים מכובדים.

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

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

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

ש# DISPLAY=:0.1 גרופר מה שזה לא יהיה &

$LC_ALL
$LC_MESSAGES
$LANG אם אחד מהמשתנים הללו מוגדר (ברצף הנ"ל), תוכנו הוא
מתפרש כמקום, השפה בה יש להשתמש, במיוחד בעת אחזור
איש דפיםשם מקומי הוא בדרך כלל בצורה הבאה
שפה[_שטח[.ערכת קודים[@מתקן]]], איפה שפה היא שפת ISO 639
קוד, שטח הוא קוד מדינה לפי ISO 3166, ו ערכת קודים הוא קבוצת תווים או
מזהה קידוד כמו ISO-8859-1 או UTF-8; ראה setlocale(3). ערכי המיקום
C ו-POSIX מייצגים ברירת מחדל, כלומר ה- איש עמוד ספריות ללא שפה
קידומת. זוהי אותה התנהגות כמו כאשר כל שלושת המשתנים אינם מוגדרים.

$PAGER ניתן להשתמש במשתנה זה כדי להגדיר את הזימונים עבור פלט ה-tty. לדוגמה, כדי
השבת לחלוטין את השימוש בביפר, הגדר משתנה זה ל- חתול(1) תוכנית

ש# PAGER=חתול ​​גרוטר כל דבר

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

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

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

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

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

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

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

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

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

משתנה הסביבה $MANROFFSEQ מתעלמים ממנו גרופר מכיוון שההכרח
מעבדים מקדים נקבעים באופן אוטומטי.

תְצוּרָה קבצים

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

/etc/groff/groffer.conf
קובץ תצורה כלל-מערכתי עבור גרופר.

$HOME/.groff/groffer.conf
קובץ תצורה ספציפי למשתמש עבור גרופר, שם $ HOME מציין את בית המשתמש
ספרייה. קובץ זה נקרא על שם קובץ התצורה של המערכת כולה כדי לאפשר
עקיפה על ידי המשתמש.

שני הקבצים מטופלים עבור התצורה, אך קובץ התצורה ב /וכו מגיע
ראשית; הוא מוחלף על ידי קובץ התצורה בספריית הבית; שניהם
קבצי התצורה מוחלפים על ידי משתנה הסביבה $GROFFER_OPTהכל
מוחלף על ידי ארגומנטים משורת הפקודה.

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

אסור ששמות האפשרויות בקבצי התצורה יהיו מקוצרים, הם חייבים להיות מדויקים.

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

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

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

כל השורות בקווי התצורה שאינן מתחילות בתו מינוס מתעלמות,
כך שהערות המתחילות ב-`#' אפשריות. לכן אין פקודות מעטפת ב-
קבצי תצורה.

כדוגמה, חשבו על קובץ התצורה הבא שניתן להשתמש בו גם ב
/etc/groff/groffer.conf or ~/.groff/groffer.conf .

# קובץ תצורה של גרופר
#
# אפשרויות groffer המשמשות בכל קריאה של groffer
--חזית=כחול כהה
--רזולוציה=100
--viewer=gxditview -geometry 900x1200
--צופה xpdf -Z 150

השורות שמתחילות ב # פשוט מתעלמים מהם, כך שהם פועלים כשורות פקודה. זה
ערכות תצורה ארבע גרופר אפשרויות (השורות המתחילות ב-`-'). לזה יש את
ההשפעות הבאות:

* השתמשו בצבע טקסט של כחול כהה בכל הצופים שתומכים בכך, כגון gxditview.

* השתמש ברזולוציה של 100dpi בכל הצופים שתומכים בכך, כגון gxditview. על ידי
זה, התקן ברירת המחדל ב x מצב מוגדר X100.

* כוח gxditview(1) בתור ה- מצב X מציג המשתמש באפשרות הגיאומטריה לקביעת הרוחב
ל 900px והגובה ל 1200pxגיאומטריה זו מתאימה לרזולוציה של
100dpi.

* להשתמש xpdf(1) בתור ה- מצב pdf הצופה עם הטיעון -Z 150.

דוגמאות

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

ש# groffer /usr/local/share/doc/groff/meintro.ms.gz

פירוק, עיצוב והצגת הקובץ הדחוס meintro.ms.gz בספרייה
/usr/local/share/doc/groff, באמצעות הצופה הסטנדרטי gxditview כצופה גרפי כאשר
בחלון X, או ב פחות(1) תוכנית זימונית כאשר אינה בחלון X.

ש# גרופר גרוף

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

ש# איש גרופר: גרוף

חפש את ה איש עמוד of גרף אפילו כאשר הקובץ ./גרוף קיים.

ש# גרופר גרוף.7
ש# גרופר 7 גרוף

חפש את איש עמוד of גרף in איש סעיף 7חיפוש מקטע זה פועל רק עבור ספרה
או דמות בודדת מתוך קבוצה קטנה.

ש# גרופר fb.modes

אם הקובץ ./fb.modes לא קיים לפרש זאת כחיפוש אחר ה- איש עמוד of
fb.modes. בתור ההרחבה מצבי אינו תו יחיד בסגנון קטע קלאסי
הארגומנט אינו מפוצל לחיפוש אחר fb.

ש# גרופר גרוףטראף(1)' man:roff

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

ש# LANG=de groffer --man --viewer=galeon ls

לאסוף את הגרמני איש עמוד (שָׂפָה de) בשביל ה ls תוכנית, לפרוק אותה, לעצב אותה ל
html פורמט (www מצב) וצפה בתוצאה בדפדפן האינטרנט גליון. האפשרות --איש
מבטיח כי איש עמוד מאוחזר, גם כאשר קובץ מקומי ls קיים בפועל
במדריך.

ש# גרופר --מקור 'איש:roff(7)'

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

ש# גרופר --de-p --in --ap

זוהי קבוצה של טיעונים מקוצרים, היא נקבעת כ

ש# groffer --פרמטרי-ניפוי-באגים --פלט-ביניים --אפרופו

ש# קובץ cat.gz | groffer -Z -mfoo

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

ש# הד '\f[CB]וואו!' |
> גרופר --x --bg אדום --fg צהוב --גיאומטריה 200x100 -

הצג את המילה WOW! בחלון קטן בגופן מודגש ברוחב קבוע, תוך שימוש בצבע צהוב על
רקע אדום.

תְאִימוּת

השמיים גרופר התוכנית כתובה בפרל, גרסת פרל בזמן הכתיבה הייתה גרסה 5.8.8.

גרופר מספק מנתח משלו עבור ארגומנטים משורת פקודה התואם לשניהם
POSIX קמצנים(1) וגנו getopt(1). הוא יכול לטפל בארגומנטים של אפשרויות ובשמות קבצים
המכיל רווח לבן וקבוצה גדולה של תווים מיוחדים. הסטנדרט הבא
סוגי אפשרויות נתמכים.

* האפשרות המורכבת מסימן מינוס יחיד - מתייחס לקלט סטנדרטי.

* סימן מינוס יחיד ואחריו תווים מתייחס לאפשרות של תו בודד או
שילוב שלהם; לדוגמה, ה- גרופר שילוב אופציות קצרות -קמפו is
שווה ערך ל -Q -m Foo.

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

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

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

ש# קובץ גרופר 1 -a -o arg קובץ 2

שווה

ש# groffer -a -o arg -- file1 file2

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

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