imake - אונליין בענן

תָכְנִית:

שֵׁם

imake - ממשק קדם-מעבד C לכלי make

תַקצִיר

אימאק [ -Dלְהַגדִיר ] [ -Idir ] [ -Uלְהַגדִיר ] [ -Tתבנית ] [ -f שם הקובץ ] [ -C שם הקובץ ] [
-s שם הקובץ ] [ -e ] [ -v ]

תיאור

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

אפשרויות

ניתן להעביר את אפשרויות שורת הפקודה הבאות אל אימאק:

-Dלְהַגדִיר
אפשרות זו מועברת ישירות אל cpp. הוא משמש בדרך כלל להגדרת ספריות-
משתנים ספציפיים. לדוגמה, מערכת חלונות X השתמשה בדגל זה כדי להגדיר טופדיר
לשם הספרייה המכילה את החלק העליון של הפצת הליבה ו
CURDIR לשם הספרייה הנוכחית, יחסית לראש הדף.

-Iבספרייה
אפשרות זו מועברת ישירות אל cpp. הוא משמש בדרך כלל כדי לציין את
הספרייה שבה ה- אימאק ניתן למצוא קבצי תבנית ותצורה.

-Uלְהַגדִיר
אפשרות זו מועברת ישירות אל cppהוא משמש בדרך כלל לביטול הגדרות משתנים
בעת ניפוי שגיאות אימאק קבצי תצורה.

-Tתבנית
אפשרות זו מציינת את שם קובץ התבנית הראשית (שבדרך כלל הוא
הממוקם בספרייה שצוינה עם -I) בשימוש על ידי cpp. ברירת המחדל היא
Imake.tmpl.

-f שם הקובץ
אפשרות זו מציינת את שם קובץ הקלט לכל ספרייה. ברירת המחדל היא
Imakefile.

-C שם הקובץ
אפשרות זו מציינת את שם קובץ ה-.c שנבנה במערכת הנוכחית.
ספרייה. ברירת המחדל היא Imakefile.c.

-s שם הקובץ
אפשרות זו מציינת את שם ה- לעשות קובץ התיאור שייווצר אך
לעשות אין להפעילו. אם ה- שם הקובץ הוא מקף (-), הפלט נכתב
ל stdoutברירת המחדל היא ליצור, אך לא לבצע, קובץ Makefile.

-e אפשרות זו מציינת את אימאק צריך לבצע את שנוצר קובץ Makefile. ה
ברירת המחדל היא להשאיר זאת למשתמש.

-v אפשרות זו מעידה על כך אימאק צריך להדפיס את cpp שורת הפקודה שזהו
באמצעות כדי לייצר את קובץ Makefile.

איך IT עבודות

אני מכין מעורר cpp עם כל -I or -D דגלים מועברים בשורת הפקודה ומעבירים את השם
של קובץ המכיל את 3 השורות הבאות:

#define IMAKE_TEMPLATE "Imake.tmpl"
#הגדר INCLUDE_IMAKEFILE
#include_IMAKE_TEMPLATE

איפה Imake.tmpl ו Imakefile עשוי להיות מבוטל על ידי ה- -T ו -f אפשרויות פקודה,
בהתאמה.

ה-IMAKE_TEMPLATE בדרך כלל קורא קובץ המכיל פרמטרים תלויי-מכונה.
(צוין כ cpp סמלים), קובץ פרמטרים ספציפי לאתר, קובץ המגדיר משתנים, א
קובץ המכיל cpp פונקציות מאקרו ליצירה לעשות כללים, ולבסוף ה Imakefile
(כפי שצוין על ידי INCLUDE_IMAKEFILE) בספרייה הנוכחית. ה- Imakefile משתמש במאקרו
פונקציות המציינות אילו מטרות יש לבנות; אימאק דואג לייצר את
כללים מתאימים.

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

קובץ הכללים (שנקרא בדרך כלל Imake.rules בספריית התצורה) מכיל
מגוון רחב של cpp פונקציות מאקרו שתצורתן מוגדרת בהתאם לפלטפורמה הנוכחית.
אני מכין מחליף כל מופע של המחרוזת ``@@'' בשורה חדשה כדי לאפשר פקודות מאקרו ש
יצירת יותר משורה אחת של לעשות כללים. לדוגמה, המאקרו

#define program_target(program, objlist) @@\
תוכנית: objlist @@\
$(CC) -o $@ objlist $(LDFLAGS)

כאשר נקרא עם program_target(foo, foo1.o foo2.o) יתרחב ל

פו: פו1.o פו2.o
$(CC) -o $@ foo1.o foo2.o $(LDFLAGS)

אני מכין מחליף גם כל מופע של המילה ``XCOMM'' בתו ``#'' כדי
לאפשר הצבת הערות ב-Makefile מבלי לגרום לשגיאות של ``הנחיה לא חוקית'' מ-
המעבד המקדים.

קצת מורכב אימאק נדרש יצירת מאקרו לעשות משתנים מקומיים לכל קריאה של
מאקרו, לעתים קרובות משום שערכם תלוי בפרמטרים המועברים למקרו. כזה
ניתן ליצור משתנים באמצעות אימאק משתנה מהצורה XVARdefn, שם n הוא
ספרה אחת. ייחודי לעשות משתנה יוחלף. הופעות מאוחרות יותר של ה-
משתנה XVARusen יוחלף על ידי המשתנה שנוצר על ידי המתאים XVARdefn.

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

להשתמש עִם LA X חלון מערכת

מערכת חלונות X בשימוש אימאק בהרחבה עד לשחרור X11R6.9, הן עבור הגרסה המלאה
בונה בתוך עץ המקור ותוכנה חיצונית. מאז עבר X ל-GNU autoconf
ו-automake עבור מערכת הבנייה שלה ב-X11R7.0 ובגרסאות מאוחרות יותר, אך עדיין שומר על imake
לבניית תוכנות חיצוניות קיימות שטרם עברו המרה.

כפי שצוין לעיל, שני משתנים מיוחדים, טופדיר ו קורדיר, מוכנים לבצע הפניות
קבצים המשתמשים בשמות נתיבים יחסיים בקלות רבה יותר. לדוגמה, הפקודה הבאה נוצרת
באופן אוטומטי כדי לבנות את קובץ Makefile בספרייה lib/X/ (יחסית לחלק העליון של
מקורות):

% ../.././config/imake -I../.././config \
-DTOPDIR=../../. -DCURDIR=./lib/X
בעת בניית תוכניות X מחוץ לעץ המקור, סמל מיוחד שימוש בהתקנת מוגדר
ו טופדיר ו CURDIR מושמטים. אם קבצי התצורה עברו כראוי
מותקן, הסקריפט xmkmf(1) ניתן להשתמש.

קלט קבצים

הנה סיכום הקבצים שנקראו על ידי אימאק כפי שמשתמשים בו X. ההזחה מראה מה
קבצים כוללים אילו קבצים אחרים.
משתנים גנריים של imake.tmpl
site.def ספציפי לאתר, מוגדר BeforeVendorCF
*.cf ספציפי למכונה
*כללי ספרייה משותפים של Lib.rules
site.def ספציפי לאתר, AfterVendorCF מוגדר
חוקי Imake.rules
משתנים ספציפיים ל-X של Project.tmpl
*משתני ספרייה משותפים של Lib.tmpl
Imakefile
חוקי הספרייה Library.tmpl
כללי שרת Server.tmpl
כללים מרובי-הליכים של Threads.tmpl

שים לב כי site.def נכלל פעמיים, פעם אחת לפני *.cf קובץ ופעם אחת לאחר מכן.
למרות שרוב ההתאמות האישיות של האתר צריכות להיות מוגדרות לאחר ה- *.cf קובץ, חלקם, כגון
יש לציין מראש את בחירת המהדר, מכיוון שהגדרות משתנים אחרות עשויות להיות
תלויים בהם.

הפעם הראשונה site.def כלול, המשתנה BeforeVendorCF מוגדר, ו-
בפעם השנייה, המשתנה AfterVendorCF מוגדר. כל הקוד ב site.def צריך להיות בפנים
#ifdef עבור אחד מהסמלים האלה.

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