זוהי הפקודה lexgrog שניתן להפעיל בספק האירוח החינמי של OnWorks באמצעות אחת מתחנות העבודה המקוונות המרובות שלנו, כגון Ubuntu Online, Fedora Online, אמולטור מקוון של Windows או אמולטור מקוון של MAC OS
תָכְנִית:
שֵׁם
lexgrog - נתח מידע על כותרות בדפי אדם
תַקצִיר
lexgrog [-m|-c] [-dfw?V] [-E הַצפָּנָה] פילה ...
תיאור
lexgrog הוא יישום של השירות המסורתי "ניחוש גרוף" ב לקס. זה קורא
את רשימת הקבצים בשורת הפקודה שלו כקובצי מקור של דף אדם או מעוצבים מראש
דפי "חתול", ומציג את שמם ותיאורם כפי שהם משתמשים בהם אפרופו ו מה זה, ה
רשימה של מסנני עיבוד מקדים הנדרשים על ידי דף המשתמש לפני שהוא מועבר אליו nroff or
טראף, או שניהם.
אם הקלט שלו מעוצב בצורה גרועה, lexgrog ידפיס "ניתוח נכשל"; זה עשוי להיות שימושי עבור
תוכנות חיצוניות שצריכות לבדוק את תקינותן של דפי אדם. אם אחד מ lexgrogהקלט של
הקבצים הם "-", הם יקראו מקלט רגיל; אם קובץ קלט כלשהו דחוס, א
גרסה מפורקת תיקרא אוטומטית.
אפשרויות
-d, --לנפות
הדפס מידע על ניפוי באגים.
-m, --איש
ניתוח קלט כקובצי מקור של דף אדם. זוהי ברירת המחדל אם לא אחת --איש ולא
--חתול נתון.
-c, --חתול
ניתוח קלט כדפי אדם מעוצבים מראש ("דפי חתול"). --איש ו --חתול אולי לא
ניתן בו זמנית.
-w, --מה זה
הצג את השם והתיאור מהכותרת של דף האיש, כפי שהשתמשו בו אפרופו ו
מה זה. זוהי ברירת המחדל אם לא אחת --מה זה ולא --מסננים נתון.
-f, --מסננים
הצג את רשימת המסננים הדרושים לעיבוד מקדים של דף האדם לפני העיצוב
עם nroff or טראף.
-E הַצפָּנָה, --הַצפָּנָה הַצפָּנָה
לעקוף את ערכת התווים המנחשת עבור הדף הַצפָּנָה.
-?, - עזרה
הדפס הודעת עזרה וצא.
--נוֹהָג
הדפס הודעת שימוש קצרה וצא.
-V, --גִרְסָה
הצג מידע על גרסה.
יְצִיאָה סטָטוּס
0 ביצוע תוכנית מוצלח.
1 שגיאת שימוש.
2 lexgrog נכשל בניתוח אחד או יותר מקבצי הקלט שלו.
דוגמאות
$ lexgrog man.1
man.1: "אדם - ממשק למדריכי העזר המקוונים"
$ lexgrog -fw man.1
man.1 (t): "אדם - ממשק למדריכי העזר המקוונים"
$ lexgrog -c whatis.cat1
whatis.cat1: "whatis - הצג תיאורי דפים ידניים"
$ lexgrog שבור.1
broken.1: הניתוח נכשל
מה זה ניתוח
מנדב (שמשתמש באותו קוד כמו lexgrog) מנתח את שֵׁם חלק בראש כל אחד
דף מדריך המחפש שמות ותיאורים של התכונות המתועדות בכל אחד מהם. בזמן
המנתח די סובלני, מכיוון שהוא צריך להתמודד עם מספר צורות שונות שיש
בשימוש היסטורי, הוא עלול לפעמים להיכשל בחילוץ המידע הנדרש.
כאשר משתמשים במסורתי איש מאקרו סט, נכון שֵׁם הקטע נראה משהו כמו
זֶה:
שם .SH
foo \- תוכנית לעשות משהו
חלק מהבימונים הידניים דורשים שה-'\-' יהיה בדיוק כפי שמוצג; מנדב הוא יותר סובלני, אבל
עבור תאימות עם מערכות אחרות, בכל זאת מומלץ לשמור את
מַהֲלָך סְרָק.
בצד שמאל, עשויים להיות מספר שמות, מופרדים בפסיקים. שמות המכילים
יתעלם מהרווח הלבן כדי למנוע התנהגות פתולוגית אצל חולים מסוימים שֵׁם
מקטעים. הטקסט בצד ימין הוא בעל צורה חופשית, ועשוי להתפרס על מספר רב
שורות. אם מספר תכונות עם תיאורים שונים מתועדים באותו
דף ידני, לכן נעשה שימוש בטופס הבא:
שם .SH
foo, bar \- תוכניות לעשות משהו
.br
baz \- תוכנית לא לעשות כלום
(ניתן להשתמש במאקרו שמתחיל פסקה חדשה, כמו .PP, במקום מאקרו הפסקה
.br.)
בעת שימוש ב-BSD שמקורו mdoc מאקרו סט, נכון שֵׁם הקטע נראה משהו כמו
זֶה:
.Sh NAME
.נמ פו
תוכנית נד לעשות משהו
ישנן מספר סיבות נפוצות לכך שניתוח Whatis נכשל. לפעמים מחברי מדריך
דפים מחליפים את '.SH NAME' ב-'.SH MYPROGRAM', ולאחר מכן מנדב לא יכול למצוא את הקטע מ
כדי לחלץ את המידע שהוא צריך. לפעמים מחברים כוללים קטע NAME, אבל
הצב שם טקסט חופשי במקום 'שם \- תיאור'. עם זאת, כל תחביר
הדומה לאמור לעיל יש לקבל.
השתמש ב-lexgrog באינטרנט באמצעות שירותי onworks.net
