להתנועע - מקוון בענן

תָכְנִית:

שֵׁם

התנועע - החל מדבקות שנדחו ובצע הבדלים מבחינה מילולית

תַקצִיר

להתנודד [פוּנקצִיָה] [אפשרויות] פילה [קבצים]

תיאור

הפונקציה העיקרית של להתנודד הוא להחיל תיקון על קובץ באופן דומה ל-
תיקון(1) תוכנית.

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

אז, להתנודד יזהה (במקרים מסוימים) שינויים שכבר הוחלו, ויזהה
להתעלם מהם.

להתנודד מבטיח שכל שינוי בתיקון יוחל על קובץ היעד איכשהו. אם
לא ניתן לבצע שינוי מסוים בקובץ, הקובץ מסומן כדי להראות היכן
השינוי צריך להיעשות בצורה דומה ל למזג(1) תוכנית עם -A אוֹפְּצִיָה. כל אחד
הערה מכילה 3 רכיבים: חלק מהקובץ המקורי שבו צריך השינוי
להחיל, חלק מהתיקון שלא ניתן היה להתאים במדויק בקובץ, וה-
טקסט שאמור להחליף את החלק הזה של התיקון. אלה מופרדים בקווים
מכיל 7 תווים זהים בדיוק, '<', '|', '=' או '>', אולי
ואחריו מילה תיאורית. לכן
<<<<<<< נמצא
חלק מהקובץ המקורי
||||||| צָפוּי
טקסט להחלפה
=======
טקסט להחלפתו
>>>>>>> החלפה
מציין ש"טקסט להחלפה" צריך להיות מוחלף ב"טקסט להחלפה בו" איפשהו
בחלק של הקובץ המקורי. למרות זאת להתנודד לא הצליח למצוא מקום לעשות
השינוי הזה.

להתנודד יכול גם להפיק דוחות עימות המציגים רק את המילים המעורבות במקום
מאשר להראות קווים שלמים. במקרה זה הפלט נראה כך:
<<<---original|||old===new--->>>

שימוש אפשרי אחד ב להתנודד זה לרוץ תיקון להחיל איזה תיקון, ולאסוף רשימה של
דוחה על ידי ניטור הודעות השגיאה מהתיקון. ואז עבור כל קובץ שעבורו א
נמצא הדחייה, הפעל
wiggle --replace originalfile originalfile.rej

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

לחלופין, ניתן להזין את קובץ התיקון המקורי ל- לדפדף מצב כ
wiggle -B < patchfile

זה יאפשר לבדוק את השינויים והקונפליקטים ובמידה מסוימת לשנות אותם;
ואז ניתן לשמור את התוצאות.

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

-m, --לְמַזֵג
בחר את הפונקציה "מיזוג". זוהי פונקציית ברירת המחדל.

-d, --הבדל
בחר את הפונקציה "הבדל". זה מציג את ההבדלים בין הקבצים. זה יכול
להינתן לאחר --לְדַפדֵף (ראה להלן) ובמקרה זה תיקון או הבדל של שני קבצים יכולים
ניתן לצפות ללא המסמכים המקוריים.

-x, --לחלץ
בחר את הפונקציה "חילוץ". זה מחלץ ענף אחד של קובץ תיקון או מיזוג.

-B, --לְדַפדֵף
בחר את הפונקציה "עיון". זה דומה ל"מיזוג" (או "הבדל") רק עם a
מצגת שונה. במקום שהתוצאה פשוט תישלח לתקן
פלט, הוא מוצג באמצעות GUI מבוסס ncurses כך שכל חתך של התיקון
ניתן לבחון כדי להבין אילו קונפליקטים מעורבים ומה צריך להיות
התעלמו מהסדר שהתיקון יתנועע למקומו.

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

-l, --שורות
בקש שכל הפעולות והתצוגה יהיו מבוססות קו.

-b, --התעלם מחסר
ביטול הדגשת הרווח הלבן (רווח, טאב ושורה חדשה) קובע הבדלים ו
שינויים.

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

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

שורה ריקה, או כזו המכילה רק ריקים, תטופל כמילה בודדת
שתתאים לכל שורה ריקה אחרת, לא משנה כמה רווחים יש לה.

-b אין השפעה ב --קַו מצב.

-p, --תיקון
התייחס לקובץ בשם האחרון כאל תיקון במקום קובץ (עם --diff) או מיזוג
(--לחלץ). ב למזג or לדפדף מצב, -p דורש שיהיה בדיוק קובץ אחד אשר
הוא תיקון ואשר יכול להכיל תיקונים למספר קבצים. התיקונים ממוזגים
לכל קובץ. כאשר משתמשים בו ב למזג במצב, שימוש זה דורש את --החלף אוֹפְּצִיָה
מכיוון שכתיבת הרבה קבצים ממוזגים ל-Standard-out אינה מעשית.

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

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

-o, --פלט=
במקום לכתוב את התוצאה ל-stdout או להחליף את הקובץ המקורי, זה
מבקש שהפלט ייכתב לקובץ הנתון. זה רק בעל משמעות
עם --לְמַזֵג or --לְדַפדֵף כאשר ניתן מיזוג בודד לגלישה.

אפשרות זו עוקפת -r.

-R, --לַהֲפוֹך
בשימוש עם ה הבדל פונקציה, החלף את הקבצים לפני חישוב ה
הבדלים. בשימוש עם ה למזג or לדפדף פונקציות, להתנודד ניסיונות
לבטל שינויים במקום להחיל אותם.

-i, --לא להתעלם
בדרך כלל התנודדות תתעלם משינויים בתיקון שנראה שכבר היו
מיושם במקור. עם הדגל הזה השינויים האלה מדווחים כהתנגשויות
במקום להתעלם.

-W, --הצג-מתנועע
בעת שימוש עם --לְמַזֵג, מדווחים על קונפליקטים שניתן להניע למקומם
מתנגש עם בית נוסף שמראה מה תהיה התוצאה אם ​​הדגל הזה
לא היה בשימוש. הבית הנוסף מוצג בשורה המכילה 7
אמפרסנד (&) תווים כך:
<<<<<<< נמצא
חלק מהקובץ המקורי
||||||| צָפוּי
טקסט להחלפה
=======
טקסט להחלפתו
&&&&&&& פתרון הבעיה
טקסט שייגרם כתוצאה מתנועה מוצלחת
>>>>>>> החלפה

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

-h, - עזרה
הדפס הודעת עזרה פשוטה. אם ניתן לאחר אחד מבוחרי הפונקציות
(--לְמַזֵג, --הבדל, --לחלץ, --לְדַפדֵף) העזרה הספציפית לפונקציה זו מוצגת.

-V, --גִרְסָה
הצג את מספר הגרסה של להתנודד.

-v, --מִלוּלִי
הפעל מצב מילולי. כרגע זה לא משנה.

-q, --שֶׁקֶט
אפשר מצב שקט. זה מדכא את ההודעה מפונקציית המיזוג כאשר היא נמצאת
הם קונפליקטים בלתי פתירים.

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

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

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

להתנודד מחלץ את שלושת הטקסטים הדרושים לו מקבצים הרשומים בשורת הפקודה.
ניתן לרשום 1, 2 או 3 קבצים, וכל אחד מהם עשוי להיות מקף בודד המסמל
קלט סטנדרטי.

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

אם ניתנים שני קבצים, אז הראשון פשוט מכיל את הטקסט הראשי, והשני הוא
מטופל כקובץ תיקון (הפלט של "diff -u" או "diff -c", או קובץ ".rej" מ
תיקון) ושני הטקסטים האחרים מופקים מזה.

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

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

בדרך כלל תוצאת המיזוג נכתבת לפלט סטנדרטי. אם ה -r ניתן דגל,
הפלט נכתב לקובץ שמחליף את הקובץ הנתון המקורי. במקרה זה ה
שם הקובץ המקורי שונה ל-a .porig סיומת (עבור "מקור מתוקן" וזה הגיוני
אם אתה משתמש לראשונה תיקון להחיל תיקון, ולאחר מכן להשתמש להתנודד לנענע את הפוסלים פנימה).

עוד אם ה -o האפשרות ניתנת עם שם קובץ, הפלט ייכתב לזה
קוֹבֶץ. במקרה זה לא נוצר גיבוי.

אם לא מתרחשות שגיאות (כגון שגיאות גישה לקובץ) להתנודד ייצא עם סטטוס 0 אם הכל
השינויים מוזגו בהצלחה, ועם סטטוס יציאה של 1 והודעה קצרה אם יש
לא ניתן היה למזג את השינויים במלואם ובמקום זאת הוכנסו כהערות. לעומת זאת, אם
או --דוח-מתנועע or --הצג-מתנועע ניתנו אפשרויות, להתנודד יתקיים גם עם
סטטוס 1 אם היה צורך להכניס שינויים כלשהם למרות שזה הצליח.

פונקציית המיזוג יכולה לפעול בשלושה מצבים שונים ביחס לשורות או למילים.

עם --שורות אפשרות, שורות שלמות מושוות וכל התנגשויות מדווחות כשלמות
קווים שצריך להחליף.

עם --מילים אפשרות, מילים בודדות מושוות וכל עימות מדווח רק
מכסה את המילים המושפעות. זה משתמש בפורמט הקונפליקט <<<|||===>>>.

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

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

1 אם שינוי ממיר A ל B ו A נמצא במקום מתאים במקור
קובץ, הוא מוחלף ב B. זה כולל את האפשרות ש B ריק, אבל
לא ש A זה ריק.

2 אם נמצא שינוי שפשוט מוסיף B והטקסט מיד לפני ו
לאחר ההוספה נמצאים סמוכים בקובץ המקורי במתאימה
מקום, אם כן B מוכנס בין אותם טקסטים סמוכים.

3 אם נמצא שינוי איזה משתנה A ל B וזה מופיע (בהתבסס על הקשר) ל
ליישר קו עם B במקור, ההנחה היא שהשינוי הזה כבר היה
מיושם, ומתעלמים מהשינוי. כאשר זה קורה, הודעה המשקפת את
מספר השינויים שהתעלמו מהם מודפס על ידי להתנודד. אופטימיזציה זו יכולה להיות
מדוכא עם -i דגל.

4 אם נמצא שינוי שאינו מתאים לאף אחת מהאפשרויות לעיל, אז א
סכסוך מדווח כפי שתואר קודם לכן.

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

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

בעת חישוב יישור מבוסס מילים (ברירת המחדל), להתנודד אולי צריך להראות את המילים האלה-
הבדלים מבוססים. זה נעשה באמצעות הרחבה לפורמט Unified-diff. אם שורה
מתחיל בפס אנכי, ואז הוא עשוי להכיל קטעים מוקפים בריבוי מיוחדים
סוגריים של תווים. הסוגריים "<<<++" ו-"++>>>" מקיפים טקסט נוסף בעוד "<<<--"
ו"-->>>" טקסט שהוסר מקיף.

להתנודד ניתן לתת את שני הטקסטים להשוואה באחת משלוש דרכים.

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

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

אם שני קבצים ניתנים יחד עם האפשרות --patch, אזי הקובץ השני מוערך
להיות תיקון או הענף הראשון (עם -1) או השני (עם -2) מוחלץ ו
בהשוואה לטקסט שנמצא בקובץ הראשון.

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

EXTRACT
פונקציית החילוץ של להתנודד פשוט חושף את הפונקציונליות הפנימית לחילוץ
ענף אחד של תיקון או קובץ מיזוג.

יש לתת קובץ אחד בדיוק, ותניח שהוא קובץ מיזוג אלא אם כן
--תיקון ניתן, ובמקרה זה מניחים תיקון.

בחירת הסניף נעשה על ידי מתן אחד מ -1, -2, או -3 עם משמעויות ברורות.

ברוס
פונקציית הגלישה של להתנודד מציג את התוצאה של מיזוג או (עם -d) הבדל בא
GUI מבוסס טקסט שניתן לנווט באמצעות הקשות דומות ל vi(1) או Emacs(1).

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

הדפדפן מספק מספר דפי עזרה תלויי הקשר שאליהם ניתן לגשת
הקלדה '?'

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

כמות מוגבלת של עריכה מותרת תוך כדי לדפדף מצב. כרגע טקסט כלומר
לא רצוי ניתן להשליך עם x. פעולה זו תמיר קונפליקט או שינוי ללא שינוי,
ו-Unmatched to Changed (שמשנה אותו למעשה למחרוזת הריקה). באופן דומה
ניתן לסמן טקסט כרצוי עם c. זה ימיר קונפליקט או זר ל
השתנה. שימוש חוזר באותו מקש יחזיר את השינוי.

לבסוף, האותיות הגדולות X יחזיר את כל השינויים בקו הנוכחי.

כדי לבצע שינויים גורפים יותר אתה יכול להשתמש v שמפעיל עורך, מעדיף $VISUAL or
עורכת $ אם הם ממוקמים בסביבה.

אם תבצע שינויים כלשהם, wiggle ישאל אותך אם אתה רוצה לשמור את השינויים, גם אם
--החלף לא ניתן.

אזהרה

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

דוגמאות

להתנודד --החלף פילה file.rej
זה השימוש הרגיל של להתנודד וייקח כל שינוי file.rej זֶה תיקון יכול
לא חלים, ומזג אותם לתוך פילה.

להתנודד -dp1 פילה file.rej
זה יבצע השוואה מבחינה מילית בין ה פילה ו לפני ענף של
הבדל ב file.rej ולהציג את ההבדלים. זה מאפשר לך לראות היכן תיקון נתון
יחול.

להתנודד --לְמַזֵג - עזרה
קבל עזרה לגבי פונקציית המיזוג של להתנודד.

להתנודד --לְדַפדֵף --תיקון update.patch
ניתוח ה update.patch קובץ עבור תיקונים והצגת רשימה של קבצים מתוקנים שיכולים להיות
עיין כדי לבחון כל תיקון בפירוט.

להתנודד ניתן לשלב עם סילון כך שהוא משמש ככלי ברירת המחדל של המיזוג וההבדל
כְּלִי. ניתן להשיג זאת על ידי הוספת השורות הבאות ל .gitconfig בבית המשתמש
במדריך.
[למזג "להתנועע"]
name = "גלל מיזוג גמיש"
דרייבר = להתנועע -o %A %A %O %B
רקורסיבי = בינארי
[לְמַזֵג]
כלי = להתנועע
[mergetool "להתנועע"]
cmd = wiggle -B -o $Merged $LOCAL $BASE $REMOTE
[difftool "להתנועע"]
cmd = להתנועע -Bd $LOCAL $REMOTE
זה יעשה סילון mergetool ו סילון difftool להשתמש להתנודד.

אם אתה רוצה סילון להשתמש תמיד להתנודד למיזוגים (שעשויים להיות מסוכנים), אתה יכול להוסיף
* להתמזג = להתנועע
למתאים תכונות גיטרה קובץ כגון $HOME/.config/git/attributes.

ציטוט

השם של להתנודד קיבל השראה מהציטוט הבא.

הבעיה שאני מוצא היא שלעתים קרובות אני רוצה לקחת
(קובץ1+תיקון) ->קובץ2,
כשאין לי קובץ 1. אבל מיזוג כלים רוצים לקחת
(קובץ1|קובץ2) ->קובץ3.
לא ראיתי כלי גרפי שעוזר לך לנענע תיקון
לתוך קובץ.
-- אנדרו מורטון - 2002

חסרונות

- להתנודד לא יכול לקרוא את הפלט המורחב המאוחד-diff שהוא מייצר עבור --diff
--מילים.

- להתנודד לא יכול לקרוא את פורמט המיזוג המבוסס על מילים שהוא מייצר עבור --merge
--מילים.

- להתנודד לא מבין ביוניקוד ולכן יתייחס הרבה לכל התווים שאינם ASCII
כפי שהוא מתייחס לסימני פיסוק - הוא יתייחס לכל אחת כאל מילה נפרדת. ה
הדפדפן לא יציג תווים שאינם ASCII כראוי.

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