כאב ראש - מקוון בענן

תָכְנִית:

שֵׁם

headache - תוכנית לניהול הרישיון של קובץ המקור שלך.

תַקצִיר

כְּאֵב רֹאשׁ [-ח פילה] [-ג פילה] [-r] [-עזרה | --עֶזרָה] פילה...

תיאור

דף מדריך זה מתעד בקצרה את כְּאֵב רֹאשׁ פקודה.

דף מדריך זה נכתב עבור הפצת Debian GNU/Linux בגלל המקור
לתוכנית אין דף ידני.

זה שימוש נפוץ לשים בתחילת קובצי קוד המקור כותרת קצרה שנותנת,
למשל, מידע על זכויות יוצרים. כְּאֵב רֹאשׁ הוא כלי פשוט וקל משקל עבור
ניהול בקלות של כותרות אלו. בין הפונקציות שלו, אפשר לציין:

· יש ליצור כותרות בדרך כלל כהערות בקובצי קוד מקור. כְּאֵב רֹאשׁ מבצעים
עם סוגי קבצים שונים ומייצר עבור כל אחד מהם כותרות בהתאמה
פורמט.

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

פקודה קו אפשרויות

פילה
שם של קובץ אחד לעיבוד

קובץ -h
צור כותרת עם טקסט המגיע מהקובץ

קובץ -c
קרא את קובץ התצורה הנתון

-עזרה עזרה
הצג את רשימת האפשרויות של כְּאֵב רֹאשׁ

נוהג

הבה נמחיש את השימוש בכלי זה בעזרת דוגמה קטנה. נניח שיש לך קטן
פרויקט ערבוב C וקוד Caml המורכב משלושה קבצים 'foo.c', 'bar.ml' ו-'bar.mli'',
ואתה רוצה לצייד אותם בכותרת כלשהי. קודם כל כתוב קובץ header, כלומר א
יש לציין קובץ טקסט רגיל כולל כותרות המידע. דוגמה לקובץ כזה
נתון באיור 1. בהמשך, אנו מניחים שקובץ זה נקרא 'myheader' והוא נמצא ב-
אותה ספרייה כמו קבצי מקור.

לאחר מכן, כדי ליצור כותרות, פשוט הפעל את הפקודה: כְּאֵב רֹאשׁ -h הכותרת שלי foo.c
bar.ml bar.mli

כל קובץ מצויד בכותרת הכוללת את הטקסט שניתן בקובץ הכותרות
'myheader', מוקף בכמה תווים נוספים בהתאם לפורמט שלו מה שהופך אותו ל-a
הערה (למשל '(*' ו-'*)' בקבצי '.ml'). אם תעדכן את קובץ הכותרת 'myheader', אתה
פשוט צריך להפעיל מחדש את הפקודה לעיל כדי לעדכן כותרות בקובצי קוד מקור.

באופן דומה, ריצה: כְּאֵב רֹאשׁ -r foo.c bar.ml bar.mli מסיר כל קיים בקבצים
'foo.c', 'bar.ml' ו-'bar.mli'. קבצים שאין להם כותרת נשמרים ללא שינוי.

תְצוּרָה קובץ

סוגי קבצים ופורמט הכותרת עשויים להיות מוגדרים על ידי קובץ תצורה. כברירת מחדל, ה
נעשה שימוש בקובץ התצורה המובנה המופיע באיור 2. אתה יכול גם להשתמש בעצמך
קובץ התצורה הודות ל- -c אפשרות: כְּאֵב רֹאשׁ -c myconfig -h הכותרת שלי foo.c bar.ml
bar.mli

על מנת לכתוב את התצורה שלך, אתה יכול לעקוב אחר הדוגמה המופיעה באיור 2. א
קובץ התצורה מורכב מרשימה של ערכים מופרדים על ידי התו '|'. כל אחד מ
הם עשויים משני חלקים המופרדים על ידי '->'.

הראשון הוא ביטוי רגולרי. (ביטוי רגולרי מוקף בתוך כפול
מרכאות ובעלי אותו תחביר כמו ב-Gnu Emacs.) כְּאֵב רֹאשׁ קובע סוגי קבצים
לפי שמות בסיס של קבצים; לפיכך, כל קובץ מטופל באמצעות השורה הראשונה בשמו
גפרורים.

השני מתאר את הפורמט של כותרות עבור קבצים מסוג זה. הוא מורכב מה
שם של דגם (למשל 'מסגרת'), אולי אחריו רשימה של ארגומנטים. טיעונים הם
שם: 'פתוח:"(*"' פירושו שהערך של הארגומנט 'פתוח' הוא '(*'. כְּאֵב רֹאשׁ
כרגע תומך בשלושה דגמים ובמילת מפתח מיוחדת:

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

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

לא
מודל זה לא יוצר כותרת ואין לו ארגומנט.

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

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