imake - מקוון בענן

תָכְנִית:

שֵׁם

imake - ממשק קדם-מעבד C לכלי השירות make

תַקצִיר

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

תיאור

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

אפשרויות

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

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

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

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

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

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

-C שם הקובץ
אפשרות זו מציינת את שם קובץ ה-.c שנבנה ב-stream
מַדרִיך. ברירת המחדל היא Imakefile.c.

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

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

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

איך IT עבודות

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

#define IMAKE_TEMPLATE "Imake.tmpl"
#define INCLUDE_IMAKEFILE
#include IMAKE_TEMPLATE

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

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

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

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

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

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

foo: foo1.o foo2.o
$(CC) -o $@ foo1.o foo2.o $(LDFLAGS)

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

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

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

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

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

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

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

קלט קבצים

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

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

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

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