metalint - מקוון בענן

תָכְנִית:

שֵׁם

metalint - בודק עקביות יחידות מטה-קונפיג

תַקצִיר

metalint [ -hklsV ] [ -L dir ]

תיאור

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

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

אפשרויות

Metalint מזהה את קבוצת האפשרויות הבאה:

-h הדפס תיאור שימוש קצר וצא.

-k שמור על זמני .MT במדריך.

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

-s מצב שקט.

-L dir עוקף את מיקום ברירת המחדל של הספרייה. בדרך כלל שימושי רק עבור metaconfig
מתחזקים לבדוק מקומית את היחידות המפותחות במקום את
זמינים לציבור. ה dir שצוין הוא זה שמכיל את היחידות
U במדריך.

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

דיאגנוסטיקה

האבחון הבא עשוי להיפלט על ידי metalint:

"(?MAKE) מתעלם שורת רישום תלות כפולה."
יותר מתלות אחת של ?MAKE: נמצאה ביחידה. יכול להיות שיש
רק שורה אחת כזו, אם כי עשויות להופיע מספר קווי פעולה מסוג ?MAKE.

"(?MAKE) יחידה מיוחדת 'Xxx' לא אמורה להיות רשומה כנוצרת."
ניתן לרשום סמל יחידה מיוחדת (אות ראשונה באות רישיות) רק כפי שנעשה ב-
יחידה מיוחדת עצמה. כדי לדכא אזהרה זו במקרים לגיטימיים, הוסף '+' מלפנים
של הסמל הפוגע (שים לב שעבור יחידות לא מיוחדות, ה-'+' במיקום זה
מציין סמל פנימי שלא אמור להופיע בקובץ config.sh).

"(?MAKE) '+xxx' מופיע x פעמים."
תלות מותנית רשומה יותר מפעם אחת. זה אמנם לא מזיק.

"(?MAKE) 'xxx' מופיע x פעמים."
תלות רגילה מופיעה יותר מפעם אחת. שוב, טעות לא מזיקה.

"(?MAKE) 'xxx' מופיע כתלות מותנית וגם כתלות מלאה."
סמל רשום כתלות נורמלית וכתנאי. Metaconfig יצטרך
תחשוב על זה כתלות מלאה, אבל אולי זה לא מה שאתה בהתחלה
מבוקש...

"(?Y) הוראת פריסה לא ידועה 'xxx'."
הנחיות פריסה עשויות להיות רק אחת מהן חלק עליון, ברירת מחדל or תחתית, אבל המקרה לא
חוֹמֶר. הנחיה לא ידועה פשוט מתעלמת ומטופלת כאילו ברירת מחדל היה
נָקוּב.

"(?S) תיאור כפול עבור המשתנה '$xxx'."
סמל מעטפת מתואר יותר מפעם אחת, וזה ייצור שני ערכים ב-
מילון מונחים.

"(?S) משתנה '$xxx' אינו רשום בשורה ?MAKE:."
היחידה מתארת ​​ערך סמל מעטפת שלא ניתן להשתמש בו חיצונית שכן לא
רשום כתלות.

"(?S) שגיאת תחביר ב-?S: construct."
מסביר את עצמו.

"(?C) תיאור כפול עבור הסמל 'XXX'."
סמל C מתואר יותר מפעם אחת, וזה ייצור עבורו שני ערכים ב-
מילון מונחים.

"(?C) שגיאת תחביר ב-?C: construct."
מסביר את עצמו.

"(?H) סמל 'XXX' כבר הוגדר."
ככל הנראה, שני קווים ?H: מגדירים את אותו סמל C.

"(?H) משתנה '$xxx' אפילו לא מופיע ב-?MAKE: line."
נעשה שימוש במשתנה, אך אינו מופיע בשורת התלות.

"הקטע (?H) כבר הסתיים על ידי '?H:.'."
לא יכולות להיות יותר שורות ?H: אחרי ה-'?H:.' הראשונות מסמן את הסוף של זה
סָעִיף.

"(?H) קו cpp לא שכיח צריך להיות מוגן באמצעות '?%<:'."
כל ?H: קווים המוכרים על ידי metaconfig ועל כן metalint יש אלה
הכללה ב-config.h מוגנת אוטומטית על ידי סמל מתאים אם אין כזה
מסופק. עם זאת, יש להגן על קווים לא מזוהים באמצעות הרצף '?%<:' ל
הימנע מהכללתם אם היחידה לא תיטען ב-Configure.

"שורה (?H) לא צריכה להיות רשומה כאן אלא ב'?C:'."
רק שורות cpp צריכות להופיע בקטע ?H:. אם יש לך הערה לשים
לגבי הסמל, השתמש ב-?C:. אם אתה רוצה להגיב לדור מסוים
רצף, הכנס אותם ל-?X: הערה כדי שהם לא יכנסו ל-config.h.

"(?H) אילוץ 'xxx' הוא סמל לא ידוע."
כל האילוצים המובילים של ?sym: על קווי ה-?H: צריכים להיות מעטפת חוקית או C
סמל, המוגדר ביחידה.

"(?M) שגיאת תחביר ב-?M: construct."
מסביר את עצמו.

"(?M) סמל 'xxx' כבר מופיע בשורה ?M: ב-'yyy'."
נוסתה הגדרת קסם לסמל xxx, אך הגדרה אחרת כבר סופקה
ביחידה yyy.

"(?V) התעלמו מהצהרה גלויה ביחידה לא מיוחדת."
הצהרות גלויות (?V: קווים) עשויות להופיע רק ביחידות מיוחדות. אחרת, הם
חסרי משמעות.

"(?V) רוצה שהמשתנה '$xxx' יהיה גלוי."
לא ניתן ליצור משתנה מבוקש (המתואר כתלות בקו ?MAKE:).
גלוי מכיוון שאין בכך שום היגיון: היחידה לא יכולה לסמוך על זה ואז
לפרסם אותו כמוגדר מקומי.

"(?V) המשתנה '$xxx' מוגדר לגלוי."
לא ניתן להפוך משתנה מוגדר (רשום כפי שנעשה בשורה ?MAKE:) גלוי, שכן
אפשר גם לרצות אותו ישירות ביחידה אחרת.

"(?V) משתנה '$xxx' כבר נראה ביחידה yyy."
הצהרה לא עקבית: שתי יחידות הופכות סמל בודד אחד לגלוי...

"(?V) משתנה '$xxx' כבר קריאה-כתיבה גלויה ב-yyy."
המשתנה כבר הפך לגלוי כקריאה-כתיבה על ידי יחידה אחרת.

"(?V) משתנה '$xxx' כבר גלוי לקריאה בלבד ב-yyy."
המשתנה כבר הפך לגלוי כקריאה בלבד על ידי יחידה אחרת.

"(?W) משתנה '$xxx' כבר רצה."
משתנה כבר רצוי, אין צורך לבקש זאת במפורש כאן.

"(?W) משתנה '$xxx' מוגדר גם באופן מקומי."
משתנה מבוקש יתנגש עם משתנה מוגדר מקומי ויכול לגרום
מקבל ערך אשפה.

"(?W) משתנה '$xxx' כבר מופיע בשורה ?W: ב-'yyy'."
המשתנה בקטע סמל המעטפת של קו ?W: יכול להופיע רק ביחידה אחת.

"(?F) הפיק את הקובץ 'xxx' בהצהרה משתקפת."
הקובץ מופיע יותר מפעם אחת בשורה ?F: תחת אותו שם. זה כן
לא מופיעים כאשר מצהירים גם על קובץ UU פרטי וגם על קובץ ציבורי עם אותו הדבר
שם, למשל.

"(?F) קובץ UU ביחידה לא מיוחדת התעלמו."
קבצי UU פרטיים (כלומר קבצים כמו ה קראתי תסריט נוצר לעיון מאוחר יותר על ידי
גדר) ניתן ליצור רק ביחידות מיוחדות. חריגים מותרים אם הקו ?F:
לפניו רמז תקין ?LINT:.

"(?T) סמל זמני '$xxx' הכפיל המוצהר."
מסביר את עצמו.

"ההנחיה צריכה לבוא אחרי ?הצהרות".
ההנחיה הרשומה בין () בתחילת ההודעה הזו באמת צריכה לבוא
לאחר השורות ?MAKE:. עליך להזמין מחדש את היחידה או metalint לא יוכל
לאבחן בעיות כראוי.

"רצף שליטה '?XXX:' התעלם בתוך הגוף."
נסה להשתמש בקו בקרה שאינו ?X: או ?LINT: בגוף היחידה, מה שצריך
להיות רק קוד מעטפת

"המשתנה '$xxx' השתנה."
משתנה הרשום כרצוי בשורת התלות משתנה. משתנה כזה צריך
להיות לקריאה בלבד עבור היחידה. להשתמש ב שינוי רמז מוך לדחיקת הודעה זו
מקרים פתולוגיים.

"לא ?MAKE: שורה המתארת ​​תלות."
לכל יחידה צריכה להיות קו תלות, או שהיא תתעלם בשקט על ידי
metaconfig. הודעה זו מודחקת על ידי רמז ריק ?LINT:.

"קו הגוף הראשון צריך להיות ': תיאור' כללי."
שורת המעטפת הראשונה של היחידה שתתווסף ל-Configure שנוצר
הסקריפט צריך להכיל תיאור של מטרת היחידה, בשורה ':'. חייב להיות
רווח אחרי ה':', שכן הוא מתפרש על ידי הקליפה והתיאור
יש להימנע מתווים מטא כמו '(' או '>' אלא אם כל המחרוזת מצוטטת. זה
ההודעה מודחקת על ידי רמז ?LINT: ללא הערה.

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

"מצאה מטא-דמות ללא ציטוט > בשורת ההערה."
שורה שמתחילה ב-':' מתפרשת על ידי המעטפת אך תתעלם ממנה. זה אומר
שמטא-תווים משמעותיים כמו '(' או '>' חייבים לצטט או להמלט עם
קו נטוי מוביל.

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

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

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

"הסמל '$xxx' לא תואר."
סמל המעטפת שהוגדר על ידי יחידה זו לא תועד. להשתמש ב לתאר רמז מוך
כדי לדכא את ההודעה הזו.

"סמל C 'XXX' לא תואר."
סמל C שהוגדר על ידי יחידה זו לא תועד. להשתמש ב ידוע רמז מוך ל
לדכא את ההודעה הזו.

"סמל C 'XXX' לא הוגדר על ידי שום קו ?H:."
סמל AC פורסם על ידי מעולם לא הוגדר, ולכן הוא לא יכול להופיע ב- config.h
קובץ ולכן הוא חסר תועלת...

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

"משתנה תלות שאינו בשימוש '$xxx'."
כנראה שלא נעשה שימוש במשתנה מעטפת. להשתמש ב שינוי or להשתמש רמזי מוך
(בהתאם למצב) כדי לדכא את ההודעה הזו.

"משתנה תנאי שאינו בשימוש '$xxx'.
ככל הנראה לא נעשה שום שימוש מהתלות המותנית הזו. ה שינוי or להשתמש מוך
ניתן להשתמש ברמזים כדי לדכא הודעה זו.

"המשתנה הזמני '$xxx' שאינו בשימוש."
לא נעשה שימוש במשתנה המוצהר כזמני בשורה ?T:. ה להשתמש רמז מוך יהיה
לרמות metalint לחשוב שהוא אכן בשימוש.

"רצף בקרה לא ידוע '?XXX:'."
נסה להשתמש ברצף בקרה לא ידוע.

"לא ידוע בקשת LINT 'שקר' התעלמה."
נעשה שימוש בתג ?LINT: לא ידוע. כל התגים הללו חייבים להיות מאוייתים באותיות קטנות.

"לסמל '$xxx' אין ערך ברירת מחדל."
לסמל המשמש כתלות מותנית ביחידה כלשהי אין ערך ברירת מחדל שנקבע על ידי a
?D: קו.

"מעופש ?MAKE: תלות 'xxx'."
יחידה מפרטת סמל כתלות, אבל סמל זה אינו ידוע אחרת, כלומר
לעולם לא מופיע כפי שנעשה על ידי כל יחידה אחרת.

"חסר סמל '$xxx' ב-?MAKE."
סמל בשימוש או שהוגדר לא היה רשום כתלות בשורה ?MAKE:.

"חסר xxx מ-?MAKE עבור '$yyy' גלוי."
נעשה שימוש בסמל המוגדר כגלוי על ידי יחידה מיוחדת, אך יחידה מיוחדת זו לא
חלק מקו התלות.

"מעודן ?M: תלות 'xxx'."
קו קסם מפרט סמל C כתלות, אך סמל זה אינו ידוע על ידי אף יחידה.

"סמל לא ידוע '$xxx'."
אין לי מושג מהו הסמל הזה. אם המשתנה מוגדר חיצונית, זה
ניתן לדחות אזהרה באמצעות ?LINT: חיצוני תקין.

"סמל לקריאה בלבד '$xxx' מוגדר."
סמל שאמור להיות לקריאה בלבד מוגדר על ידי גוף קוד המעטפת של היחידה.

"נעשה שימוש בסמל המיושן 'xxx'."
סמל מיושן משמש בקוד המעטפת של היחידה.

"סמל לא מוצהר '$xxx' מוגדר."
היחידה מנסה להגדיר משתנה מעטפת שלא הוכרז אחרת כמוכן
או כמשתנה זמני, או מה שלא יהיה.

"לא סגור ?H: סעיף."
הקטע ?H: לא הסתיים על ידי '?H:.' אחד קו לפני הגוף של
יחידה או התחלה של קטע ?C: אחר.

"סמל C 'xxx' מוגדר ביחידות הבאות:"
סמל C מוגדר ביותר מיחידה אחת. רשומות יחידות פוגעניות.

"סמל מעטפת 'xxx' מוגדר ביחידות הבאות:"
סמל מעטפת מוגדר ביותר מיחידה אחת. יחידות פוגעניות עוקבות.

"סמל מעטפת 'xxx' הוא בסך הכל:"
סמל מעטפת מוגדר על ידי יחידות מסוימות, מיושן על ידי אחרות ומשמש כזמני.

"סמל מעטפת 'xxx' מוגדר וגם מיושן:"
מסביר את עצמו.

"סמל מעטפת 'xxx' מוגדר ומשמש כזמני:"
מסביר את עצמו.

"סמל מעטפת 'xxx' מיושן משמש גם כזמני:"
מסביר את עצמו.

"ההגדרה של '$xxx' לא נסגרה על ידי '?S:.'."
מסביר את עצמו.

"ההגדרה של 'XXX' לא נסגרה על ידי '?C:.'."
מסביר את עצמו.

"הגדרה קסומה של 'xxx' לא נסגרה על ידי '?M:.'."
מסביר את עצמו.

"המשתנה '$xxx' מוגדר חיצונית."
נעשה שימוש במשתנה המוגדר חיצוני (כלומר ביחידה אחרת), ללא תקין
מידע על תלות. להשתמש ב חיצוני רמז מוך כדי לדכא הודעה זו.

"הקובץ 'xxx' לא נוצר."
קובץ הרשום כקובץ UU פרטי לא נוצר על ידי היחידה המיוחדת. הבריאה היא
זוהה על ידי ראיית הפניית מעטפת מפורשת לקובץ, לא על ידי מרומז
יצירה (כמו למשל אוסף C). כל היחידות המיוחדות צריכות
בכל מקרה צור רק סקריפטים של מעטפת, כך שלא ניתן לדכא את ההודעה הזו באמצעות
רמז מוך.

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

"קובץ זמני 'xxx' שאינו בשימוש.
הקובץ הוכרז על קו ?F: אך נראה שלא נעשה בו שימוש בשום מקום.

"שימוש לא נכון בקובץ הזמני 'xxx'.
קובץ זמני מקומי הוכרז על קו ?F: והוא משמש בצורה כזו
אולי לא המתאים. אכן, יש לקרוא לכל הקבצים המקומיים הללו עם an
נתיב יחסי מפורש, כדי למנוע חיפושי PATH שעלולים להביא לך קובץ אחר.

"ייתכן שלא תמיד תקבל את הקובץ 'xxx' מ-'unit.U'."
נראה שאתה קורא לקובץ שצוין, אבל לא באמצעות קרוב משפחה מפורש
שם נתיב. הסתמכות על ה-PATH כדי למצוא את הקובץ הזה אינה בטוחה. כדי לתקן בעיה זו,
להתקשר לקובץ שלך באמצעות משהו כמו ./xxx.

"חסרה יחידה מ-?MAKE לקובץ הפרטי 'xxx'."
אתה משתמש בקובץ UU פרטי מבלי לרשום את היחידה המיוחדת שמייצרת אותו
קו התלות שלך. הוסף את היחידה לרשימת התלות שלך.

"קובץ פרטי לא ידוע 'xxx'."
הקובץ אינו מופיע באף שורה ?F:; איך שזה צריך.

"הקובץ 'xxx' מוגדר ביחידות הבאות:"
נראה שהיחידות המפורטות אינן מסכימות מי מגדיר את הקובץ.

"שם ריק כאן מסמך מיואש."
עליך להימנע משימוש בשמות ריקים עבור מסמכים כאן, כמו metalint לא יהיה
לפקח על אלה.

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

"הנחיה מזויפת 'LINT xxx'."
הוספת הנחיה ?LINT: שאינה משמשת לאזהרות שיתוק.

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

"מחזור כולל:"
רשום קטע של התלות שבה נמצא המחזור. זה עשוי לכלול
הרבה יותר סמלים מההודעה הקודמת, כי metalint למעשה סורק מחדש את
כללים להדגיש את המחזור ועוצר בכל פעם שהוא מצא אחד, כלומר לא
נסה למזער אותו (המחזור נמצא באמצעות אלגוריתם אחר, שלמרבה הצער
לא יכול לירוק את זה החוצה אלא רק לומר בוודאות שיש אחד).

הפניה

Metalint משתמש בשורות הבקרה הבאות, שאחרת מתעלמים מהן metaconfig:

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

?F:קבצים נוצר
קו זה משרת שתי מטרות: הוא א metalint רמז, וגם מציין מיקום עבור
עתיד jmake להשתמש. זה חייב לרשום שלושה סוגים של קבצים: הזמני שהם
נוצרו לבדיקה, אלו הפרטיים של UU שנוצרו בספריית UU למועד מאוחר יותר
עיון, והציבוריים שנותרו בספריית השורש של החבילה. זמני
קבצים חייבים להיות רשומים עם '!' קודם לכן תו (כלומר "לא! אין בהם שימוש חוזר
מאוחר יותר!"), יש להקדים את קובצי UU פרטיים ב-'./' (כלומר: כדי להשתמש בהם, נניח
./קוֹבֶץ, לא רק פילה), ויש לקרוא לציבוריים כפי שהם.

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

?מוֹך:מילות מפתח symbol_list
מציין רמז מוך. מילות המפתח הבאות זמינות:

שינוי משתנה מעטפת בסדר לשינוי
לִיצוֹר קובץ מתמיד בסדר שייווצר על ידי יחידה לא מיוחדת
לְהַגדִיר משתני מעטפת המפורטים מוגדרים ביחידה זו
לתאר משתני מעטפת ברשימה מתוארים על ידי ?S:
חיצוני משתנה ידוע כמוגדר חיצונית
ריק קובץ יחידה ריק ונשמר רק כמציין מיקום.
ידוע מתוארים משתני C המפורטים
אין תגובה קובץ unit הוא מיוחד ועלול להחמיץ שורת ': description' מובילה.
לא כאן השמות הרשומים אינם כאן מסמכים (למשל "1 << foo" ב-C
תכנית)
סט משתנים ברשימה מוגדרים
להשתמש המשתנים המפורטים משמשים יחידה זו
לא סגור השמות הרשומים של כאן-מסמכים אינם סגורים ביחידה זו
usefile נעשה שימוש בקובץ המופיע ברשימה (אין להוסיף את השם עם '!' עבור זמני
יחידות)

מחברים

הרלן סטן[מוגן בדוא"ל]> כתב את הגרסה הראשונה, המבוססת על זה של לארי וול
metaconfig מ- dist 2.0.
רפאל מנפרדי[מוגן בדוא"ל]> שכתב אותו מאפס עבור 3.0 עם כמה
שיפורים.

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