cvsconvert - מקוון בענן

תָכְנִית:

שֵׁם

cvsconvert - בצע המרת Git ובדוק מול ה-CVS המקורי

תַקצִיר

cvsconvert [-v] [-n] [-p] [-k expandspec] [repo | ריפו/מודול]

תיאור

cvsconvert מבצע המרה של מאגר CVS ל-Git ובודק את תוכן העץ
בכל הסניף טיפים ותגים כדי לוודא שההיסטוריה זהה.

(חריג: ענפי gitspace סינתטיים עם *-UNNAMED-BRANCH נוצרו כדי לאסוף
התחייבויות CVS חסרות בית אינן נבדקות. תראה אזהרה כאשר אחד מאלה
דילג.)

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

המרת Git נשארת בספרייה הנקראת על שם ארגומנט ה-repo, עם סיומת של
"-גיט".

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

"קוֹבֶץ באה לידי ביטוי לא התאמה": מציין שגרסאות ה-CVS וה-Git של גרסה זו ב-
ההיסטוריה מכילה כמה שמות קבצים שאינם מתאימים זה לזה. (Git ו-CVS
מתעלמים מקבצי התעלמות-דפוס ולא יפעילו הודעה זו.) כאשר הודעה זו
מתרחשת, קבצים משותפים עדיין נבדקים עבור שוויון.

"%s ו %s יש לו שונה": שני קבצי CVS ו-Git תואמים אינם משתווים. א
רישום הבדל יבוא בהמשך.

פתרון תקלות

ישנם שני סוגים של תקלות המרה לא רציניות: חוסר התאמה של תוכן הקובץ עקב
שדות מילות מפתח מורחבים במאסטרים, וקבצים שנמחקו ב-CVS המתרחשים רק ב-
מניפסטים של gitspace המשויכים לתגיות.

אתה יכול לזהות אי התאמה של תוכן עקב הרחבת מילות מפתח בקלות. הם ייצרו
הבדלים בשורה אחת של שורות המכילות סימני דולרים המקיפים טקסט של מילת מפתח. כי
קבצים בינאריים יכולים להיות פגומים על ידי הרחבת מילות מפתח, כברירת מחדל, cvs-fast-export מתנהג
כמו cvs -kb מצב ואינו מבצע הרחבת מילות מפתח משלו. לפיכך, אתה צריך לעולם לא לִרְאוֹת
כזה אי התאמות אלא אם עברת באפשרות -k.

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

סביר להניח שחוסר התאמה מובהק בתגים יתרחש בקבצים שנמחקו ב-CVS
אבל נמשך תחת תגים מאוחרים יותר בהמרה של Git. אתה יכול להמר שזה מה שקורה
אם, כאשר אתה מחפש את שם הנתיב במאגר CVS, אתה מוצא אותו בעליית גג
במדריך.

הדיווחים המזויפים האלה קורים מכיוון ש-CVS לא תמיד שומר מספיק מידע
עקוב אחר מחיקות בצורה מהימנה, והוא מעט רופף בטיפול בתיקוני מדינה "מתים".
כדי לגרום ל-CVS ול-git repos שלך להתאים בצורה מושלמת, ייתכן שתצטרך להוסיף ל-delete fileops
ההמרה - או, יותר סביר, להעביר את הקיימים בחזרה לאורך הסניפים שלהם ל-commits
שקודם לתג gitspace - באמצעות מנתח מחדש(1).

חוסר התאמה מפגין בכיוון השני (נוכח ב-CVS, נעדר ב-gitspace) צריך
לעולם לא מתרחשים. אם כן, שלח דוח באג.

כל סוג אחר של תוכן או התאמה מניפסט - אבל במיוחד כל אחד בענף המאסטר - הוא
חדשות רעות ומצביעות על מום חמור במאגר או על באג ב-cvs-fast-export
(או אולי שניהם). יש לדווח על כל מצב כזה כבאג.

באגי המרה נוטים להתרחש באופן לא פרופורציונלי במבוגרים, סניפים או תגים מ
לפני של-CVS היו committids מהימן. לעתים קרובות התרופה היעילה ביותר היא פשוט למחוק
ענפי זבל ותגיות; מנתח מחדש(1) עושה זאת בקלות.

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

אפשרויות

-p
אפשר דוחות התקדמות מ-cvs-fast-export בזמן שהוא פועל.

-k
העבר מפרט הרחבת מילות מפתח אל cvs-fast-export(1) ו cvs(1).

-n
בדיקה בלבד, אל תשמור את המרת Git לאחר פליטת אבחון.

-v
מִלוּלִי. הצג פקודות משנה בזמן שהן מבוצעות והודעות שונות לניפוי באגים.

-q
אמור ל-cvs-fast-export לפעול בשקט.

מגבלות

תוכנית זו אינה מתמודדת בחן אם שמות תגים של CVS שאינם חוקיים עבור Git צריכים להיות
חיטוי במהלך ההמרה.

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

התוכנית זקוקה לאפשרות cvs ​​-R כדי לגשת למאגר לקריאה בלבד. זה יהיה לכן
נכשלים עם גרסאות של GNU CVS ישנות מ-1.12.1 (2005) שאין להן אפשרות זו.

דיווח באגים

דווח על באגים לאריק ס. ריימונד[מוגן בדוא"ל]>. עמוד הפרויקט נמצא ב
http://catb.org/~esr/cvs-fast-export

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