git-rev-parse - عبر الإنترنت في السحابة

برنامج:

اسم

git-rev-parse - انتقاء وتدليك المعلمات

موجز

طائرة نفاثة تحليل المراجعة [ --اختيار ] ...

الوصف

تأخذ العديد من أوامر Git الخزفية مزيجًا من الأعلام (أي المعلمات التي تبدأ بحرف a
اندفاع -) والمعلمات المخصصة للأساس طائرة نفاثة قائمة المراجعة الأمر الذي يستخدمونه داخليًا
والعلامات والمعلمات للأوامر الأخرى التي يستخدمونها مع المصب طائرة نفاثة قائمة المراجعة. هذا
يتم استخدام الأمر للتمييز بينهما.

OPTIONS

عملية وسائط
يجب أن يظهر كل خيار من هذه الخيارات أولاً في سطر الأوامر.

- parseopt
استعمل طائرة نفاثة تحليل المراجعة في وضع تحليل الخيارات (انظر قسم PARSEOPT أدناه).

--sq- اقتباس
استعمل طائرة نفاثة تحليل المراجعة في وضع اقتباس الصدفة (انظر قسم SQ-QUOTE أدناه). أضع ثقتي في
الخيار --sq أدناه ، هذا الوضع لا يقتبس إلا. لم يتم عمل أي شيء آخر للأمر
إدخال.

مزيد من الخيارات For - parseopt
- keep-dashdash
ذات مغزى فقط في - وضع parseopt. يخبر المحلل اللغوي للخيار بترديد أول -
التقى بدلا من تخطيه.

- توقف عند عدم الخيار
ذات مغزى فقط في - وضع parseopt. دع المحلل اللغوي للخيار يتوقف في البداية
حجة عدم الخيار. يمكن استخدام هذا لتحليل الأوامر الفرعية التي تتخذ خيارات
أنفسهم.

- عالقة
ذات مغزى فقط في - وضع parseopt. إخراج الخيارات في شكلها الطويل إذا
متاح ، وحججهم عالقة.

مزيد من الخيارات For تصفية
--revs- فقط
لا تقم بإخراج أعلام ومعلمات لا يقصد بها طائرة نفاثة قائمة المراجعة أمر.

--لا دورات
لا تقم بإخراج العلامات والمعلمات المخصصة لـ طائرة نفاثة قائمة المراجعة أمر.

- أعلام
لا تخرج المعلمات غير العلم.

- لا أعلام
لا تخرج معلمات العلم.

مزيد من الخيارات For الناتج
--إفتراضي
إذا لم يكن هناك معلمة معطاة من قبل المستخدم ، فاستخدم في حين أن.

--اختصار
تتصرف كما لو طائرة نفاثة تحليل المراجعة تم استدعاؤه من دليل فرعي للعمل
شجرة. يتم حل أي أسماء ملفات ذات صلة كما لو كانت مسبوقة بـ وسوف يكون
مطبوعة بهذا الشكل.

يمكن استخدام هذا لتحويل الوسائط إلى أمر يتم تشغيله في دليل فرعي بحيث تكون
لا يزال من الممكن استخدامها بعد الانتقال إلى المستوى الأعلى من المستودع. على سبيل المثال:

البادئة = $ (git rev-parse - show-prefix)
cd "$ (git rev-parse --show-toplevel)"
Eval "set - $ (git rev-parse --sq --prefix" $ prefix "" $ @ ")"

--تحقق
تحقق من توفير معلمة واحدة بالضبط ، وأنه يمكن تحويلها إلى ملف خام
20 بايت SHA-1 يمكن استخدامها للوصول إلى قاعدة بيانات الكائن. إذا كان الأمر كذلك ، قم بإرساله إلى ملف
الإخراج القياسي خلاف ذلك ، خطأ.

إذا كنت تريد التأكد من أن المخرجات تقوم بالفعل بتسمية كائن في الكائن الخاص بك
قاعدة البيانات و / أو يمكن استخدامها كنوع محدد من العناصر التي تطلبها ، يمكنك إضافة
^ {type} عامل تقشير للمعامل. على سبيل المثال ، git rev-parse "$ VAR ^ {الالتزام}"
سيتأكد من أن $ VAR يسمي كائنًا موجودًا يمثل التزامًا (أي التزام ، أو
علامة مشروحة تشير إلى الالتزام). للتأكد من أن $ VAR يسمي ملف
كائن من أي نوع ، يمكن استخدام git rev-parse "$ VAR ^ {object}".

-Q ، - هادئ
ذات مغزى فقط في وضع التحقق. لا تقم بإخراج رسالة خطأ إذا كانت الوسيطة الأولى
ليس اسم كائن صالح ؛ بدلاً من ذلك ، اخرج من حالة عدم الصفر بصمت. SHA-1s لـ
تتم طباعة أسماء الكائنات الصالحة على أنها stdout على النجاح.

--sq
عادة ما يكون الناتج سطرًا واحدًا لكل علم ومعلمة. هذا الخيار يجعل الإخراج أ
سطر واحد ، مقتبس بشكل صحيح للاستهلاك عن طريق الصدفة. مفيد عندما تتوقع الخاص بك
المعلمة لاحتواء المسافات البيضاء والأسطر الجديدة (على سبيل المثال عند استخدام معول -S مع طائرة نفاثة
فرق- *). على عكس الخيار --sq-quote ، لا يزال يتم تفسير إدخال الأمر
كالمعتاد.

--ليس
عند إظهار أسماء الكائنات ، قم ببدءها بـ ^ والقطاع ^ بادئة من أسماء الكائنات
التي لديها بالفعل واحدة.

--abbrev-ref [= (صارم | فضفاض)]
اسم قصير غير غامض لاسم الكائنات. خيار core.warnAmbiguousRefs هو
تستخدم لتحديد وضع الاختصار الصارم.

- قصير ، - قصير = رقم
بدلاً من إخراج قيم SHA-1 الكاملة لأسماء الكائنات ، حاول اختصارها إلى
اسم فريد أقصر. في حالة عدم تحديد الطول ، يتم استخدام 7. الحد الأدنى للطول هو 4.

--رمزي
عادة ما يتم إخراج أسماء الكائنات في شكل SHA-1 (مع احتمال ^ اختصار)؛ هذه
الخيار يجعلها الإخراج في نموذج أقرب ما يمكن من الإدخال الأصلي.

- الاسم الكامل الرمزي
هذا مشابه لـ - رمزي ، لكنه يغفل المدخلات غير المراجع (أي فرع أو
أسماء العلامات أو بشكل أكثر وضوحًا في إزالة الغموض عن نموذج "الرؤساء / المعلمون" ، عندما تريد ذلك
قم بتسمية الفرع "الرئيسي" عندما يكون هناك علامة مسماة للأسف "رئيسي") ، وعرض
عليها كأسماء كاملة (مثل "المراجع / الرؤساء / المعلمون").

مزيد من الخيارات For الأجسام
--الكل
اعرض كل المراجع الموجودة في المراجع /.

- الفروع [= النمط] ، - العلامات [= النمط] ، - الفروع [= النمط]
اعرض جميع الفروع ، أو العلامات ، أو فروع التتبع عن بعد ، على التوالي (على سبيل المثال ، المراجع التي تم العثور عليها
في المراجع / الرؤوس أو المراجع / العلامات أو المراجع / أجهزة التحكم عن بُعد ، على التوالي).

إذا تم تقديم نمط ، فسيتم عرض المراجع المطابقة لـ shell glob المحدد فقط. إذا كان
لا يحتوي النمط على حرف لامع (؟ ، * ، أو [) ، يتم تحويله إلى بادئة
تطابق بإلحاق / *.

- كرة = نمط
اعرض جميع المراجع التي تتطابق مع نمط نمط الكرة الأرضية. إذا لم يبدأ النمط
مع المراجع / ، يتم إضافة هذا تلقائيًا. إذا كان النمط لا يحتوي على ملف
الحرف اللامع (؟ ، * ، أو [) ، يتم تحويله إلى مطابقة بادئة عن طريق إلحاق / *.

- استبعاد =
لا تقم بتضمين مطابقة المراجع أن التالي - جميع ، - الفروع ، - العلامات ،
- remote، أو - glob ستعتبر خلاف ذلك. تتراكم التكرارات لهذا الخيار
أنماط الاستبعاد حتى - all ، - الفروع ، - العلامات ، - remote ، أو - glob
الخيار (الخيارات أو الحجج الأخرى لا تمسح الأنماط المتراكمة).

يجب ألا تبدأ الأنماط المعطاة بالمراجع / الرؤوس أو المراجع / العلامات أو المراجع / أجهزة التحكم عن بعد عندما
تُطبق على الفروع ، أو العلامات ، أو - على التوالي ، ويجب أن تبدأ بـ
المراجع / عند تطبيقها على - glob أو - all. إذا كانت زائدة /* المقصود ، يجب أن تعطى
صراحة.

- لا لبس فيه =
اعرض كل كائن يبدأ اسمه بالبادئة المحددة. ال يجب أن يكون في
4 أرقام سداسية عشرية على الأقل لتجنب إدراج كل كائن في
المستودع عن طريق الخطأ.

مزيد من الخيارات For ملفات
--المحلية- EN- فارس
أدرج متغيرات البيئة GIT_ * المحلية للمستودع (مثل GIT_DIR أو
GIT_WORK_TREE ، لكن ليس GIT_EDITOR). يتم سرد أسماء المتغيرات فقط ، وليس
قيمتها ، حتى لو تم تعيينها.

- جيت دير
إظهار $ GIT_DIR إذا تم تحديده. وإلا اعرض المسار إلى دليل .git. الطريق
الموضح ، عندما يكون نسبيًا ، متعلقًا بدليل العمل الحالي.

إذا لم يتم تعريف $ GIT_DIR ولم يتم اكتشاف الدليل الحالي ليقع في Git
المستودع أو شجرة العمل طباعة رسالة إلى stderr والخروج بحالة غير صفرية.

- بوابة مشتركة دير
إظهار GIT_COMMON_DIR $ إذا تم تحديده ، وإلا $ GIT_DIR.

- هو داخل بوابة دير
عندما يكون دليل العمل الحالي أسفل دليل المستودع ، اطبع "true" ،
خلاف ذلك "خطأ".

--هو داخل شجرة العمل
عندما يكون دليل العمل الحالي داخل شجرة عمل المستودع ، اطبع
"صواب" ، وإلا "خطأ".

--مستودع مكشوف
عندما يكون المستودع فارغًا ، اطبع "صواب" ، وإلا "خطأ".

- حل-بوابة دير
تحقق فيما لو هو مستودع تخزين صالح أو ملف gitfile يشير إلى مستودع صالح ،
وطباعة موقع المستودع. لو هو ملف gitfile ثم حل
تتم طباعة المسار إلى المستودع الحقيقي.

- مسار المدخل
حل "$ GIT_DIR / "ويأخذ متغيرات نقل المسار الأخرى مثل
وضع في الحساب $ GIT_OBJECT_DIRECTORY ، $ GIT_INDEX_FILE ... على سبيل المثال ، إذا
تم ضبط $ GIT_OBJECT_DIRECTORY على / foo / bar ثم "git rev-parse --git-path object / abc"
إرجاع / foo / شريط / abc.

- إظهار- cdup
عندما يتم استدعاء الأمر من دليل فرعي ، اعرض مسار المستوى الأعلى
دليل متعلق بالدليل الحالي (عادةً ما يكون تسلسل "../" ، أو ملف
سلسلة فارغة).

- إظهار البادئة
عندما يتم استدعاء الأمر من دليل فرعي ، اعرض مسار التيار
دليل متعلق بدليل المستوى الأعلى.

- إظهار المستوى
إظهار المسار المطلق لدليل المستوى الأعلى.

- مسار الفهرس المشترك
اعرض المسار إلى ملف الفهرس المشترك في وضع الفهرس المقسم ، أو فارغًا إذا لم يكن موجودًا
وضع تقسيم الفهرس.

أخرى مزيد من الخيارات
- منذ = تاريخ ، - بعد = تاريخ
تحليل سلسلة التاريخ ، وإخراج المقابل - max-age = معلمة لـ طائرة نفاثة
قائمة المراجعة.

- حتى = تاريخ ، - قبل = تاريخ
قم بتحليل سلسلة التاريخ ، ثم قم بإخراج المعامل min-age = = المعامل الخاص بـ طائرة نفاثة
قائمة المراجعة.

...
العلامات والمعلمات المراد تحليلها.

التحديد التنقيحات

معلمة مراجعة عادة ، ولكن ليس بالضرورة ، تسمية كائن الالتزام. يستخدم
ما يسمى ب مدد SHA-1 بناء الجملة. فيما يلي طرق مختلفة لتهجئة أسماء الكائنات. ال
تلك المدرجة بالقرب من نهاية هذه القائمة أسماء الأشجار والنقاط الموجودة في الالتزام.

، على سبيل المثال dae86e1950b1277e545cee180551750029cfe735, dae86e
اسم كائن SHA-1 الكامل (سلسلة سداسية عشرية من 40 بايت) ، أو سلسلة فرعية بادئة
فريد داخل المستودع. على سبيل المثال dae86e1950b1277e545cee180551750029cfe735 و
يقوم كل من dae86e بتسمية نفس كائن التعيين إذا لم يكن هناك كائن آخر في المستودع الخاص بك
الذي يبدأ اسمه الكائن بـ dae86e.

، على سبيل المثال الإصدار 1.7.4.2-679-g3bee7fb
الإخراج من git description؛ على سبيل المثال ، علامة أقرب ، متبوعة اختياريًا بشرطة وعلامة
عدد عمليات ارتكاب ، متبوعة بشرطة ، أ g، واسم كائن مختصر.

، على سبيل المثال رئيسي, رؤساء / سيد, المراجع / رؤساء / سيد
اسم مرجع رمزي. على سبيل المثال رئيسي عادةً ما يعني كائن الالتزام المشار إليه بواسطة
المراجع / رؤساء / سيد. إذا كان لديك كلاهما رؤساء / سيد و العلامات / الماجستير، يمكنك
يقول صراحة رؤساء / سيد لإخبار Git الذي تقصده. عند الغموض ، أ
يتم توضيحها من خلال إجراء المباراة الأولى في القواعد التالية:

1. إذا GIT_DIR دولار / موجود ، هذا ما تعنيه (عادة ما يكون هذا مفيدًا فقط
For هيد, FETCH_HEAD, ORIG_HEAD, MERGE_HEAD و CHERRY_PICK_HEAD);

2. خلاف ذلك ، المراجع / إذا كانت موجودة

3. خلاف ذلك ، المراجع / العلامات / إذا كانت موجودة

4. خلاف ذلك ، المراجع / رؤساء / إذا كانت موجودة

5. خلاف ذلك ، المراجع / إذا كانت موجودة

6. خلاف ذلك ، المراجع / /رئيس إذا كانت موجودة.

هيد يسمي الالتزام الذي أسست عليه التغييرات في شجرة العمل.
FETCH_HEAD يسجل الفرع الذي جلبته من مستودع بعيد باستخدام
طلب جلب جلب البوابة الأخير. ORIG_HEAD تم إنشاؤه بواسطة الأوامر التي تحرك الخاص بك هيد
بطريقة جذرية ، لتسجيل موقف هيد قبل عمليتهم ، لذلك
أنه يمكنك بسهولة تغيير رأس الفرع إلى الحالة قبل الركض
لهم. MERGE_HEAD يسجل الالتزامات التي تقوم بدمجها في فرعك
عند تشغيل git merge. CHERRY_PICK_HEAD يسجل الالتزام الذي أنت عليه
قطف الكرز عند تشغيل git cherry-pick.

لاحظ أن أيًا من ملفات المراجع / * الحالات المذكورة أعلاه قد تأتي إما من GIT_DIR دولار / المراجع
دليل أو من GIT_DIR $ / المراجع المعبأة ملف. بينما اسم المرجع هو ترميز
غير محدد ، يُفضل UTF-8 لأن بعض معالجة الإخراج قد تفترض أسماء المرجع في
يو تي إف-8.

@
@ وحده هو اختصار لـ هيد.

@ { }، على سبيل المثال سيد @ {أمس}, رأس @ {5 دقائق منذ}
مرجع متبوع باللاحقة @ بمواصفات تاريخ محاطة بزوج من الأقواس
(على سبيل المثال {في الامس}, {1 شهر 2 أسابيع 3 أيام 1 ساعة 1 ثان منذ} or {1979-02-26
18:30:00}) يحدد قيمة المرجع في نقطة زمنية سابقة. قد تكون هذه اللاحقة
تستخدم فقط بعد اسم المرجع مباشرة ويجب أن يحتوي المرجع على سجل موجود
($ GIT_DIR / سجلات /). لاحظ أن هذا يبحث عن حالة محلي المرجع في معين
زمن؛ على سبيل المثال ، ما كان في منطقتك رئيسي فرع الأسبوع الماضي. إذا كنت تريد أن تنظر في
يرتكب خلال أوقات معينة ، انظر --حيث و --حتى.

@ { }، على سبيل المثال سيد @ {1}
مرجع متبوع باللاحقة @ بمواصفات ترتيبية محاطة بزوج من الأقواس
(على سبيل المثال 1 {}, 15 {}) يحدد القيمة السابقة من رقم ذلك المرجع. على سبيل المثال سيد @ {1}
هي القيمة المباشرة المسبقة لـ رئيسي في حين سيد @ {5} هي القيمة الخامسة المسبقة لـ
رئيسي. لا يجوز استخدام هذه اللاحقة إلا فورًا بعد اسم المرجع ويجب على المرجع
لديك سجل موجود ($ GIT_DIR / سجلات /).

@ { }، على سبيل المثال @ {1}
يمكنك استخدام @ أنشئ بجزء مرجعي فارغ للحصول على إدخال إعادة تسجيل لـ
الفرع الحالي. على سبيل المثال ، إذا كنت في فرع blabla ل then @ {1} يعني نفس الشيء
blabla @ {1}.

@ {- }، على سبيل المثال @ {- 1}
البناء @ {- } يعني تم فحص الفرع / الالتزام قبل الحالي
.

@ {upstream}، على سبيل المثال سيد @ {upstream}, @ {u}
اللاحقة @ {upstream} إلى اسم فرع (نموذج قصير @ {u}) بالعودة الى
الفرع الذي تم تعيين الفرع المحدد بواسطة اسم الفرع للبناء فوقه (تم تكوينه
مع فرع. . remote و Branch. .دمج). يتم تعيين اسم الفرع المفقود افتراضيًا على
واحد الحالي.

@{يدفع}، على سبيل المثال سيد @ {push}, @{يدفع}
اللاحقة @{يدفع} يُبلغ عن الفرع "الذي سنضغط عليه" إذا تم تشغيل git push
بينما تم سحب اسم الفرع (أو ملف هيد إذا لم يتم تحديد اسم الفرع).
نظرًا لأن وجهة الدفع الخاصة بنا موجودة في مستودع بعيد ، فإننا بالطبع نبلغ عن الملف المحلي
فرع التتبع الذي يتوافق مع هذا الفرع (أي شيء في المراجع /).

إليك مثال لتوضيح الأمر بشكل أكبر:

$ git config push.default الحالي
$ git config Remote.pushdefault myfork
$ git checkout -b أصل / ماجستير mybranch

$ git rev-parse --symbolic-full-name @ {upstream}
المراجع / أجهزة التحكم عن بعد / الأصل / الماجستير

$ git rev-parse --symbolic-full-name @ {push}
المراجع / أجهزة التحكم عن بعد / myfork / mybranch

لاحظ في المثال أننا قمنا بإعداد سير عمل مثلثي ، حيث ننسحب من واحد
الموقع والدفع إلى موقع آخر. في سير عمل غير ثلاثي ، @{يدفع} بالضبط مثل
@ {upstream}، ولا داعي لذلك.

^، على سبيل المثال رأس ^ ، الإصدار 1.5.1 ^ 0
لاحقة ^ إلى معلمة مراجعة تعني الأصل الأول لكائن الالتزام. ^
يعني الوالد عشر (أي ^ ما يعادل ^ 1). كقاعدة خاصة ،
^ 0 يعني الالتزام نفسه ويستخدم عند هو اسم كائن العلامة
الكائن الذي يشير إلى كائن الالتزام.

~، على سبيل المثال سيد ~ 3
لاحقة ~ إلى معلمة مراجعة تعني كائن الالتزام الذي يمثل ذ
جيل سلف لكائن الالتزام المسمى ، يتبع الأبوين الأولين فقط. بمعنى آخر
~ 3 ما يعادل ^ ^ ^ وهو ما يعادل ^ 1 ^ 1 ^ 1. انظر أدناه للحصول على
توضيح لاستخدام هذا النموذج.

^ { }، على سبيل المثال الإصدار 0.99.8 ^ {الالتزام}
لاحقة ^ متبوعًا باسم نوع كائن محاط بزوج مقوس يعني عدم الإشارة
الكائن في بشكل متكرر حتى كائن من النوع تم العثور أو الكائن
لا يمكن إلغاء الإشارة إليه بعد الآن (في هذه الحالة ، barf). على سبيل المثال ، إذا هو
ارتكاب العش ^ {الالتزام} يصف كائن الالتزام المقابل. وبالمثل ، إذا
هي شجرة العش ، ^ {شجرة} يصف كائن الشجرة المقابل. ^ 0 is
اختصار ل ^ {الالتزام}.

مراجعة ^ {كائن} يمكن استخدامها للتأكد تزيد السرعة يسمي كائنًا موجودًا ، بدون
تتطلب تزيد السرعة لتكون علامة ، وبدون إلغاء مرجعية تزيد السرعة؛ لأن العلامة هي بالفعل
كائن ، لا يلزم إلغاء الإشارة إليه ولو مرة واحدة للوصول إلى كائن.

rev ^ {tag} يمكن استخدامها لضمان ذلك تزيد السرعة يحدد كائن علامة موجود.

^ {}، على سبيل المثال الإصدار 0.99.8 ^ {}
لاحقة ^ متبوعًا بزوج قوس فارغ يعني أن الكائن يمكن أن يكون علامة ، و
قم بإرجاع الإشارة إلى العلامة بشكل متكرر حتى يتم العثور على كائن بدون علامة.

^ {/ }، على سبيل المثال HEAD ^ {/ fix مقرف حشرة}
لاحقة ^ إلى معلمة مراجعة ، متبوعة بزوج مقوس يحتوي على نص بقيادة
بشرطة مائلة ، هو نفسه :/يصلح مقرف علة بناء الجملة أدناه فيما عدا أنه يقوم بإرجاع
أصغر التزام مطابق يمكن الوصول إليه من قبل ^.

: /، على سبيل المثال :/يصلح مقرف علة
النقطتان ، متبوعًا بشرطة مائلة ، متبوعة بنص ، لتسمية ارتكاب رسالته
يطابق التعبير العادي المحدد. يقوم هذا الاسم بإرجاع أصغر مطابقة
ارتكاب الذي يمكن الوصول إليه من أي مرجع. إذا كانت رسالة الالتزام تبدأ بامتداد ! لصحتك!
يجب أن أكرر ذلك ؛ التسلسل الخاص : /!، متبوعًا بشيء آخر غير !، هل
محفوظة الآن. يمكن أن يتطابق التعبير العادي مع أي جزء من رسالة التنفيذ. إلى
تبدأ رسائل المطابقة بسلسلة ، يمكن للمرء استخدامها على سبيل المثال : / ^ foo.

:، على سبيل المثال الرأس: اقرأ, : README, ماجستير: ./ التمهيدي
لاحقة : متبوعًا بمسار يسمي النقطة أو الشجرة في المسار المحدد في شجرة العش
كائن يسمى الجزء الذي يسبق القولون. :طريق (مع وجود جزء فارغ قبل ملف
القولون) حالة خاصة من بناء الجملة الموصوفة بعد ذلك: المحتوى المسجل في الفهرس
في المسار المحدد. مسار يبدأ بـ ./ or .. / هو متعلق بالعمل الحالي
الدليل. سيتم تحويل المسار المحدد ليكون نسبيًا لجذر الشجرة العاملة
الدليل. هذا هو الأكثر فائدة لمعالجة النقطة أو الشجرة من الالتزام أو الشجرة التي
لها نفس هيكل الشجرة مثل شجرة العمل.

: :، على سبيل المثال : 0: التمهيدي, : README
نقطتان ، متبوعًا بشكل اختياري برقم المرحلة (من 0 إلى 3) ونقطتين ، متبوعًا بعلامة النقطتين
path ، يقوم بتسمية كائن blob في الفهرس عند المسار المحدد. رقم المرحلة مفقود (و
النقطتان التي تليها) تسمي إدخال المرحلة 0. أثناء الدمج ، المرحلة 1 هي ملف
سلف مشترك ، المرحلة 2 هي إصدار الفرع المستهدف (عادةً ما يكون الإصدار الحالي
الفرع) ، والمرحلة 3 هي الإصدار من الفرع الذي يتم دمجه.

هنا رسم توضيحي لجون لويليغر. كلا العقدتين B و C هما والدا الالتزام
العقدة A. يتم ترتيب الالتزامات الرئيسية من اليسار إلى اليمين.

GHIJ
\ / \ /
DEF
\ | / \
\ | / |
\ | / |
قبل الميلاد
\ /
\ /
A

أ = = أ ^ 0
ب = أ ^ = أ ^ 1 = أ ~ 1
ج = أ ^ 2 = أ ^ 2
د = أ ^ ^ = أ ^ 1 ^ 1 = أ ~ 2
ه = ب ^ 2 = أ ^ ^ 2
F = B ^ 3 = A ^^ 3
G = A ^ ^ = A ^ 1 ^ 1 ^ 1 = A ~ 3
ع = د ^ 2 = ب ^ ^ 2 = A ^ ^ 2 = أ ~ 2 ^ 2
أنا = F ^ = B ^ 3 ^ = A ^^ 3 ^
J = F ^ 2 = B ^ 3 ^ 2 = A ^ 3 ^ 2

التحديد نطاقات

تعمل أوامر اجتياز التاريخ مثل git log على مجموعة من الأوامر ، وليس مجرد أمر واحد
ارتكب. لهذه الأوامر ، يتم تحديد مراجعة واحدة بالتدوين الموضح في ملف
القسم السابق يعني مجموعة الالتزامات التي يمكن الوصول إليها من هذا الالتزام ، بعد الالتزام
سلسلة النسب.

لاستبعاد أوامر يمكن الوصول إليها من التزام ، بادئة ^ تم استخدام التدوين. على سبيل المثال ^ ص 1 r2 يعني
يمكن الوصول إليها من r2 ولكن استبعد الأشخاص الذين يمكن الوصول إليهم من r1.

تظهر عملية المجموعة هذه في كثير من الأحيان بحيث يكون هناك اختصار لها. عندما يكون لديك اثنان
يرتكب r1 و r2 (المسمى وفقًا للصيغة الموضحة في تحديد المراجعات أعلاه) ،
يمكنك طلب الالتزامات التي يمكن الوصول إليها من r2 باستثناء تلك التي يمكن الوصول إليها من
r1 بواسطة ^ ص 1 r2 ويمكن كتابته كـ r1..r2.

تدوين مماثل r1 ... r2 يسمى الاختلاف المتماثل r1 و r2 ويتم تعريفه على أنه
r1 r2 --ليس $ (بوابة دمج القاعدة --الكل r1 ص 2). إنها مجموعة الالتزامات التي يمكن الوصول إليها
من أحد r1 or r2 ولكن ليس من كليهما.

في هذين الاختصارين ، يمكنك حذف طرف واحد وتركه افتراضيًا على HEAD. على سبيل المثال،
الأصل.. هو اختزال لـ الأصل .. رأس ويسأل "ماذا فعلت منذ أن تفرعت من
فرع الأصل؟ "وبالمثل ، ..الأصل هو اختزال لـ الرأس .. الأصل ويسأل "ماذا فعل ال
منذ أن تفرعت منهم؟ "لاحظ ذلك .. يعني رأس .. رأس وهو فارغ
نطاق يمكن الوصول إليه ولا يمكن الوصول إليه من HEAD.

اختزالان آخران لتسمية المجموعة التي يتم تشكيلها من خلال الالتزام ويلتزم الأصل
يوجد. ال r1 ^ @ التدوين يعني جميع آباء r1. r1 ^! يتضمن الالتزام r1 لكنه يستبعد الجميع
من والديها.

كي تختصر:


قم بتضمين الالتزامات التي يمكن الوصول إليها من (أي أسلاف) .

^
استبعاد الالتزامات التي يمكن الوصول إليها من (أي أسلاف) .

..
قم بتضمين الالتزامات التي يمكن الوصول إليها من لكن استبعد تلك التي يمكن الوصول إليها
من عند . عندما إما أو تم حذفه ، يتم تعيينه افتراضيًا هيد.

...
قم بتضمين الالتزامات التي يمكن الوصول إليها من أي منهما أو ولكن استبعاد تلك
يمكن الوصول إليها من كليهما. عندما إما أو تم حذفه ، يتم تعيينه افتراضيًا هيد.

^ @، على سبيل المثال رأس ^ @
لاحقة ^ متبوعة بعلامة في نفس قائمة جميع آباء
(بمعنى: تضمين أي شيء يمكن الوصول إليه من والديه ، ولكن ليس الالتزام نفسه).

^!، على سبيل المثال رأس ^!
لاحقة ^ متبوعًا بعلامة تعجب هو نفس إعطاء الالتزام وثم
كل الأبوين مسبوقة بـ ^ لاستبعادهم (وأسلافهم).

فيما يلي بعض الأمثلة:

DGHD
DFGHIJDF
^ GDHD
^ DBEIJFB
ب .. CC
ب ... CGHDEBC
^ DBCEIJFBC
CIJFC
C ^ @ IJF
ج ^! ج
F ^! DGHDF

بارسوبت

في الوضع - parseopt ، طائرة نفاثة تحليل المراجعة يساعد خيارات التدليك لإحضار البرامج النصية إلى shell
لديها نفس المرافق C عمارات. إنه يعمل كخيار عادي (على سبيل المثال تقسيم واحد
يبدل القيم الإجمالية) ، يشبه إلى حد ما جيتوبت(1) لا.

يأخذ على الإدخال القياسي مواصفات الخيارات لتحليل وفهم ،
وتردد على الإخراج القياسي سلسلة مناسبة ل sh(1) EVAL لتحل محل
الحجج مع التطبيع. في حالة الخطأ ، يتم إخراج الاستخدام على الخطأ القياسي
تيار ، ويخرج برمز 129.

ملاحظة: تأكد من اقتباس النتيجة عند تمريرها للتقييم. إنظر في الأسفل للمثال.

إدخال شكل
طائرة نفاثة تحليل المراجعة - parseopt تنسيق الإدخال يعتمد على النص بالكامل. يتكون من جزأين ، يفصل بينهما
سطر يحتوي فقط على -. الأسطر قبل الفاصل (يجب أن تكون واحدة أو أكثر) هي
تستخدم للاستخدام. تصف الأسطر بعد الفاصل الخيارات.

كل سطر من الخيارات له هذا التنسيق:

* ؟ SP + مساعدة LF


تنسيقه هو حرف الخيار القصير ، ثم اسم الخيار الطويل مفصولاً بامتداد
فاصلة. كلا الجزأين غير مطلوبين ، على الرغم من ضرورة وجود جزء واحد على الأقل. قد لا تحتوي على
أي من الشخصيات. h و help و dry-run و f أمثلة على ذلك
.


هي من * ، = ،؟ أو !.

· استخدم = إذا كان الخيار يأخذ حجة.

· يستخدم ؟ ليعني أن الخيار يأخذ حجة اختيارية. ربما تريد
استخدم الوضع - stuck-long لتتمكن من تحليل الوسيطة الاختيارية بشكل لا لبس فيه.

· استخدم * للإشارة إلى أن هذا الخيار يجب ألا يكون مدرجًا في الاستخدام الذي تم إنشاؤه لـ
حجة. يتم عرضه لـ - help-all كما هو موثق في جيتكلي(7).

· يستخدم ! لعدم إتاحة الخيار الطويل المطابق المطابق.


، إذا تم تحديده ، يتم استخدامه كاسم للوسيطة في إخراج المساعدة ، لـ
الخيارات التي تأخذ الحجج. تم إنهاؤه بمسافة بيضاء أولى. إنها
من المعتاد استخدام شرطة لفصل الكلمات في تلميح وسيطة متعددة الكلمات.

يتم استخدام ما تبقى من الخط ، بعد تجريد المسافات ، كمساعدة مرتبطة بـ
الخيار.

يتم تجاهل الأسطر الفارغة ، ويتم استخدام الأسطر التي لا تتطابق مع هذه المواصفات كخيار
رؤوس المجموعة (ابدأ السطر بمسافة لإنشاء مثل هذه السطور عن قصد).

مثال
OPTS_SPEC = "\
بعض الأوامر [خيارات] ...

بعض الأوامر لا foo و bar!
--
ح ، تساعد في إظهار المساعدة

foo بعض الخيارات الأنيقة - foo
شريط = بعض الخيارات الرائعة - شريط مع وسيطة
baz = arg خيار رائع آخر - baz مع وسيطة محددة
qux؟ مسار qux قد يأخذ حجة المسار ولكن له معنى في حد ذاته

رأس مجموعة الخيارات
ج؟ الخيار ج مع وسيطة اختيارية "

Eval "$ (echo" $ OPTS_SPEC "| git rev-parse --parseopt -" $ @ "|| echo exit $؟)"

الأستعمال نص
عندما يكون "$ @" is -h أو --help في المثال أعلاه ، سيظهر نص الاستخدام التالي:

الاستخدام: بعض الأوامر [خيارات] ...

بعض الأوامر لا foo و bar!

-h ، - ساعد في إظهار المساعدة
--foo بعض الخيارات الأنيقة - foo
- بار ... بعض الخيارات الرائعة - شريط مع حجة
--باز خيار آخر رائع - باز بحجة مسمى
--qux [= ] qux قد تأخذ حجة المسار ولكن لها معنى في حد ذاته

رأس مجموعة الخيارات
-C [...] الخيار C مع وسيطة اختيارية

SQ- اقتباس

في وضع الاقتباس --sq ، طائرة نفاثة تحليل المراجعة أصداء على الإخراج القياسي سطر واحد مناسب ل
sh(1) EVAL. يتكون هذا السطر من خلال تطبيع الحجج التالية --sq-quote. لا شيئ
بخلاف الاقتباس من الحجج.

إذا كنت تريد استمرار تفسير إدخال الأمر كالمعتاد بواسطة طائرة نفاثة تحليل المراجعة أمام
الإخراج مقتبس من shell ، راجع الخيار --sq.

مثال
$ cat> your-git-script.sh << \ EOF
#!/ بن / ش
args = $ (git rev-parse --sq-quote "$ @") # اقتباس وسيطات يوفرها المستخدم
command = "git frotz -n24 $ args" # واستخدمه داخل ملف
# سطر الأوامر
EVAL "أمر $"
EOF

$ sh your-git-script.sh "a b'c"

أمثلة

· طباعة اسم كائن الالتزام الحالي:

$ git rev-parse - تحقق من الرأس

· اطبع اسم كائن الالتزام من المراجعة في متغير shell $ REV:

$ git rev-parse - تحقق من $ REV ^ {الالتزام}

سيظهر هذا خطأ إذا كان $ REV فارغًا أو ليس مراجعة صالحة.

· على غرار ما ورد أعلاه:

$ git rev-parse - المعلم الافتراضي - تحقق من $ REV

ولكن إذا كان $ REV فارغًا ، فسيتم طباعة اسم كائن الالتزام من master.

GIT

جزء من طائرة نفاثة(1) جناح

استخدم git-rev-parse عبر الإنترنت باستخدام خدمات onworks.net