manilist - מקוון בענן

תָכְנִית:

שֵׁם

manilist - דווח על מצב קבצים בספריית מקור

תַקצִיר

מניליסט [ -abcdhnptV ] [ -i הארכה ] [ -f גלוי ] [ -p פוּרמָט ] [ -s מחרוזת ] [ -w
אשר ] [ -x הארכה ] [ -C מפריד ] [ -I כלול ] [ -L colsize ] [ -X נשלל ] [
קבצים or ספריות ]

תיאור

מניליסט סורק ספריית מקור ומפיק דוח על המצב של כל קובץ:
אם הוא מעודכן או לא לגבי patchlevel.h , אם הוא חסר
MANIFEST.new, ועוד כמה מידע שימושי שעשוי להיות מוגדר באופן דינמי. זה
ניתן להשתמש כדי לתחזק קובץ MANIFEST.new, להפיק רשימה מפורטת וסטטוס של א
קבוצת מדריכים וכו'... סט האפשרויות העשיר מסכים לעשות מניליסט מושלם
כלי ברמה נמוכה.

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

מה שקורה למעשה מורכב יותר מזה. מניליסט סורק את הקובץ MANIFEST.new ו
ואז עובר לולאה על כל הקבצים הרשומים שם. כְּלַפֵּי פְּנִים, מניליסט שומר על הכללה
ורשימת אי הכללה, שניהם מציינים הרחבות לקבצים. למשל, ההכללה
רשימה יכולה להיות ('.c', '.h') והאי הכללה ('.o', ',v') כך שמקורות C ייכללו
וקובצי אובייקט או RCS לא נכללו. כברירת מחדל, נעשה שימוש בכל הקבצים מלבד אלה שלא נכללו. כמה
בחירות אחרות עשויות להיות מיושמות בשלב זה, כפי שיוסבר בהמשך. לאלה
קבצים העוברים תהליך בחירה זה, מופק דו"ח על פי דו"ח פוּרמָט,
שהוא כברירת מחדל "ת:%c %n". האות A (או כל דבר לפני התו ':' הראשוני
הוא מפרט בחירת הקבצים עליו דיברנו. הנותר הוא ה
עיצוב, מחרוזת המודפסת כפי שהיא, מודולו כמה רצפי בריחה. כך קורה
זֶה %c הוא דגל הדמות ו %n הוא שם הקובץ הנוכחי.

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

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

אפשרויות

מניליסט מזהה את האפשרויות הבאות:

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

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

-c בדוק קבצים מול אלה הרשומים ב-MANIFEST.new (או כל קובץ שהוא
שצוין דרך ה -f אפשרות) ולדווח על אי התאמות דרך ה %c מאקרו.

-d dump רשימות סיומות כלולות ואינן נכללות ב-stderr, הרחבות הן מקום
מופרד. דרך טובה לדעת את רשימות ברירת המחדל היא להפעיל: מניליסט -f
/ dev / null -bd.

-f גלוי ציין קובץ מניפסט חלופי, ברירת המחדל היא להשתמש ב-MANIFEST.new.

-h הדפס את הודעת העזרה לשימוש וצא.

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

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

-p פוּרמָט הגדר את פורמט ההדפסה החדש, הכולל את הטופס מבחר:מחרוזתעם
מבחר להיות רשימה של אותיות בודדות המפרטות אילו קבצים מה-
יש להשתמש במניפסט עבור דוחות, ו מחרוזת להיות הודעה להדפיס בתור
דוח, עם כמה החלפות מאקרו. אפשר גם עמודה
עיצוב על ידי ציון '|' בתוך המחרוזת כדי לתחום את השונה
עמודות שאתה רוצה לראות. ראה גם -C ו -L לפרמטרים נוספים של עיצוב.

-s מחרוזת ציין את מחרוזת חלק מפורמט ההדפסה (ראה -p לגנרל
תיאור של ה פוּרמָט). פקודות מאקרו זמינות מופיעות בהמשך
דף ידני.

-t התחל מהספרייה העליונה (ספריית השורש של ההפצה)
ללא קשר לספרייה הנוכחית. חייב להיות א חבילה הקובץ אל
ציין מהי הספרייה העליונה.

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

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

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

-I כלול ציין רשימה חדשה של סיומות שייכללו בדוחות. זֶה
עוקף את רשימת ברירת המחדל המקורית (אילו -i משמש ל להוסיף סיומות ל
הרשימה). סיומות חייבות להיות מופרדות ברווח.

-L colsize בעת שימוש בעיצוב עמודות (התו '|' משמש לציון
עמודות), ניתן להשתמש באפשרות זו כדי לציין את רוחב העמודה המרבי,
הפרדה של כל רוחב באמצעות ',' בודד. השארת רוחב לא מוגדר לא
להטיל כל הגבלה על רוחבו. לדוגמה, אם מחרוזת הפורמט היא
%n|%d|%t, אפשר להגביל את העמודה האמצעית (תיאורים מ
MANIFEST.new) עד 40 תווים ועמודת השם (ראשון) עד 15
תווים, ומשאיר את האחרון ללא הגבלות מוטלות, על ידי שימוש -L
15,40,.

-V הדפס מספר גרסה וצא.

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

משתמש פורמטים

הגמישות של מניליסט מובא על ידי השימוש במחרוזת עיצוב דינמית עבור
מסירת דוחותיה. אפשר לציין פורמט דרך ה -p אפשרות או רק חלקים
ממנו: מחרוזת הטקסט via -s ובחירת הקבצים עם -w.

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

A כל הקבצים מלבד אלה שלא נכללו (כלומר אותם קבצים שהסיומת שלהם רשומה ב-
רשימת החרגות). זוהי פעולת ברירת המחדל.
a כל הקבצים הכלולים ו/או לא נכללו (קיצור דרך עבור ix). שימו לב שקבצים שהם
לא כלול ולא נכלל לא יופיעו בדוח.
d דווח רק עבור ספריות.
f דווח רק עבור קבצים.
i רק הקבצים הכלולים מופיעים ברשימה.
m רק הקבצים או הספריות שנמצאו במניפסט רשומים.
n רק אותם קבצים או ספריות לֹא שנמצאו במניפסט רשומים.
x רק קבצים שלא נכללים רשומים.

כאשר אתה מציין יותר מאות אחת, הדוח המתקבל תלוי באופי ה-
בְּחִירָה. ל d, f, m ו n, מבוצע איחוד הגיוני. זה אומר לציין fd or mn
זהה לאי ציון דבר, אבל זה פחות יעיל מאז מניליסט מוכרח
לבצע את הבדיקות שאחרת היא הייתה עוקפת. ה i ו x בוררים מיוחדים: מאת
ברירת מחדל, כל הקבצים שלא נכללו מדווחים. מפרט x מבקש גם לא נכלל
קבצים. מפרט i מגביל את הדוח לקבצים הכלולים. משתמש בשניהם בו זמנית
זמן (ix) יאלץ דוח עבור קבצים שנכללים או לא נכללים.

מאקרו החלפה
החלק המחרוזת של פורמט הדוח יכול לעשות שימוש בפקודות המאקרו הבאות:

%c תו המקודד את מצב הקובץ.
%d תיאור מקובץ המניפסט, אם קיים.
%n שם הקובץ (הנתיב שלו מהספרייה העליונה).
%s גודל הקובץ, בבתים.
%t חותמת זמן של השינוי האחרון.

שלח מצב
אל האני %c מאקרו, שנותן תו בודד שמקודד את סטטוס הקובץ, יכול להתרחב לאחד מה-
הבא.
. הקובץ מעודכן (לא חדש מ- patchlevel.h).
- הקובץ קיים במניפסט אך חסר.
> הקובץ השתנה מאז התיקון האחרון (חדש מ patchlevel.h).
+ הקובץ קיים אך אינו רשום במניפסט.
o הקובץ קיים אך אינו רשום במניפסט והוא ישן מ- patchlevel.h
x הקובץ רשום במניפסט וקיים, אך לא נכלל. באופן טבעי, זה
יופיע בדוח רק אם x הבורר ניתן בפורמט הדוח.
? הקובץ רשום במניפסט, אינו קיים והוחרגה.

דוגמאות

הפקודה

מניליסט -ct -p 'ni:%n'

יפרט את כל קבצי המקור מההפצה שלך שאינם רשומים ברשימה שלך
קובץ MANIFEST.new. שימו לב שזה כולל רק קבצי "מקור", כלומר קבצים שלהם
ההרחבה מופיעה ברשימת ההכללה. אם אינך מעוניין בהגבלה זו, החלף
מחרוזת העיצוב עם n:%n (רק הקבצים הבלתי נכללים לא יופיעו).

כדי לבנות קובץ MANIFEST ראשוני, השתמש ב:

מניליסט -n -p 'Af:%n' > לְהַפְגִין

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

השתמש במניליסט מקוון באמצעות שירותי onworks.net