כאב ראש - אונליין בענן

תָכְנִית:

שֵׁם

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

תַקצִיר

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

תיאור

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

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

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

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

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

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

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

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

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

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

נוהג

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

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

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

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

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

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

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

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

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

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

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

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

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

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