זהו מניף הפקודה שניתן להפעיל בספק האירוח החינמי של OnWorks באמצעות אחת מתחנות העבודה המקוונות המרובות שלנו, כגון Ubuntu Online, Fedora Online, אמולטור מקוון של Windows או אמולטור מקוון של MAC OS
תָכְנִית:
שֵׁם
manlifter - תסריט המרה המוני ורתמת בדיקה ל-doclifter
תַקצִיר
גובה אדם [-ד אוֹפְּצִיָה] [-ה] [-פ קובץ רשימה] [-היי Mandir] [-מ] [-M] [-o outdir]
[-עמ' תיקיית תיקונים] [-P] [-q] [-v] [-s סעיף] [-איקס להוציא] שם...
גובה אדם [-S]
תיאור
גובה אדם הוא תסריט שמרצף דוקליפטר(1) להמיר עץ שלם של עמוד ידני
XML-Docbook, אופציונלי גם יוצר HTML מה-XML. שימוש נוסף הוא בתור א
כלי בדיקת עינויים עבור doclifter; הוא רושם שגיאות לפלט סטנדרטי ואוסף תזמונים.
נקרא ללא ארגומנטים של קובץ, manlifter מנסה להמיר את כל דפי האיש הכשירים
מותקן במערכת, תוך הצבת קבצי ה-XML שהתקבלו תחת xmlman בקובץ הנוכחי
מַדרִיך. כל עמוד foo.N שתורגם בהצלחה מועתק ל-manN/foo.xml מתחת ל-
ספריית פלט, ללא קשר מאיזו ספריית מקור היא הגיעה.
דף ידני נחשב לא כשיר להמרה אצווה אם הוא מכיל טקסט המציין
זה נוצר מ-DocBook masters של מ-Doxygen.
עבור כל קובץ מקור שנבדק, אם קובץ היעד קיים והוא חדש יותר מהקובץ
מקור, ההמרה מדלגת; לפיכך, ריצות מצטברות של גובה אדם לעשות הכי פחות עבודה
נחוץ כדי לשמור על עץ XML היעד מעודכן. באופן דומה, במצב -h קבצי HTML נגזרים
נעשה רק כשצריך.
דפי סטאב שהם סתם .לכן ניתוב מחדש מתורגם לקישורים סימליים מתאימים של XML
קבצים (ועם -h, קבצי HTML).
גובה אדם ניתן לקרוא גם עם ארגומנט קובץ בודד, שמתפרש כגזע
שם של דף ידני פוטנציאלי. גובה אדם לאחר מכן מחפש את כל הסעיפים הידניים שנבחרו
דף תואם ומנסה להמיר אותו. במקרה זה, עותק של דף האדם וה-
הגרסה שהומרה יורדת מיד מתחת לספריית הפלט, עם השמות
foobar.man ו-foobar.man.xml, בהתאמה. מצב זה הוא בדרך כלל רק לעניין
ל דוקליפטר מפתחים לאיתור באגים בתוכנית זו.
בכל אחד מהמקרים לעיל, גובה אדם יבטל את הדחיסה של הקובץ אם יש לו .gz, .bz2 או
סיומת .Z על השם.
האפשרויות הן כדלקמן:
-d
העבר את ארגומנט המחרוזת לכל קריאת doclifter כאפשרויות. כל אסימון מופרד מרווחים
במחרוזת הופך לארגומנט נפרד בקריאה.
-e
הפעל במצב סינון יומן (בעיקר מעניין דוקליפטר מפתחים). במצב זה,
גובה אדם קורא יומן בדיקה מקלט סטנדרטי ומסנן אותו בצורה תלויה
האפשרויות -f ו-q. אם אף אחד מאלה לא ניתן, הודעות מהרצות מוצלחות כן
הופשט ורק שגיאות עברו לפלט סטנדרטי.
-f
בדרך כלל, הפעל את doclifter על הקבצים הנקראים לפי כל שורה בקובץ הארגומנט. ב
מצב מסנן שגיאות הארגומנט מתפרש במקום זאת כרגיל סינון
ביטוי.
-h
צור גם תרגומי HTML לתוך ספריית הפלט. סימון ציטריות של DocBook
הופך להיפר-קישורים בספרייה, ונוצר רישום תוכן ל
index.html.
-I
ציין את השורש של עץ הדף הידני. כברירת מחדל זה /usr/share/man.
-m
צור תיקון כדי לתקן את העמוד האחרון שהובא. הוא מועתק, נקרא עורך
העותק (באמצעות משתנה הסביבה עורכת $), ואז הבדל(1) נקרא לרדת
התיקון בספריית ה-prepatch. נכשל עם שגיאה אם כבר קיים תיקון כזה
מתנה.
-M
הרם את הקבצים שצוינו, ולאחר מכן בצע את המקבילה לאפשרות -m.
-o
הגדר את ספריית הפלט שאליה יוסרו תרגומי XML-DocBook. על ידי
ברירת המחדל היא xmlman תחת הספרייה הנוכחית במצב אצווה, או הנוכחית
ספרייה אחרת.
-p
פרש את הארגומנט כשם של ספריית תיקונים (שם ברירת המחדל הוא prepatch
תחת הספרייה הנוכחית). כל קובץ בשם foo.N.patch מתפרש כתיקון ל
יוחל על הדף הידני foo(N) לפני ש-doclifter יתרגם אותו.
-P
אפשר יצירת פרופילים באמצעות מודול Python Hotshot; זה שימושי רק עבור כוונון
doclifter כך שהוא פועל מהר יותר. נתונים גולמיים נכתבים ל-manlifter.prof, ומעוכלים
הדוח מצורף ליומן הפלט הסטנדרטי. אזהרה: קבצי הנתונים הגולמיים יכולים
להפוך לעצום, והעיבוד לאחר יצירת הדוחות יכול להימשך זמן רב כמו
עיבוד בפועל (או יותר!).
-q
בדרך כלל, העבר את האפשרות -q (שקט) לכל קריאת doclifter. במצב סינון שגיאות,
להחזיר רשימה של קבצים שבהם התרגום נכשל.
-v
העבירו את האפשרות -v (מילה במילה) לכל קריאת doclifter. ניתן לחזור על אפשרות זו
להגביר את רמת הדיבור.
-s
ציין קטע לסריקה. השתמש בזה עם טיעון; זה לא צריך להיות נחוץ מתי
עושה המרה של כל העץ.
-S
ערוך סטטיסטיקות שגיאות מא גובה אדם קובץ log המוצג בקלט רגיל. זֶה
האופציה תעניין בעיקר דוקליפטר מפתחים.
-X
במצב אצווה אל תכלול דפים הרשומים בקובץ הארגומנט. מיועד לשמש עבור דפים
שידועים כטובים ולוקח זמן רב מאוד להרים, כדי לצמצם את
זמן לריצת מבחן. (רוב הדפים מתרוממים תוך פחות מחצי שנייה, אבל כמה דפים יכולים לקחת
15 דקות או יותר.)
גובה אדם פולט קובץ יומן לפלט סטנדרטי. הקובץ מתחיל בשורת חותמת זמן ו-a
שורה ריקה, ומסתיימת בשורה שנותנת זמן ריצה וסטטיסטיקות מעניינות שונות.
בין אלה יש בתים, מופרדים בשורות ריקות, אחת לכל קובץ שעליו דוקליפטר
הופעל.
השורה הראשונה של כל בית מתחילה ב-"! ", ואחריה שם הנתיב של המקור
ביפר ידני, ואחריו "=" ומצב ההחזרה של doclifter המופעל על הקובץ הזה.
אחרי זה חלל ו דוקליפטרזמן הריצה של שניות.
שורה ראשונית זו עשויה להיות אחריה על ידי הודעות מידע ופלט השגיאה של
ריצת doclifter.
גובה אדם חייב למצוא עותק של דוקליפטר בספרייה הנוכחית או באחד מה-
ספריות הפקודות שלך נתיב על מנת לרוץ.
השתמש ב-manlifter באינטרנט באמצעות שירותי onworks.net
