زئبق - عبر الإنترنت في السحابة

برنامج:

اسم

hg - نظام إدارة كود المصدر Mercurial

موجز

hg أمر [خيار] ... [حجة] ...

الوصف

• hg يوفر الأمر واجهة سطر أوامر لنظام Mercurial.

COMMAND عناصر

ملفات ...
يشير إلى اسم ملف واحد أو أكثر أو أسماء ملفات المسار النسبي؛ راجع أنماط اسم الملف
للحصول على معلومات حول مطابقة الأنماط

مسار يشير إلى مسار على الجهاز المحلي

تنقيح
يشير إلى مجموعة التغييرات التي يمكن تحديدها كرقم مراجعة لمجموعة التغييرات، أو علامة، أو
أو سلسلة فرعية فريدة من قيمة تجزئة Changeset

مستودع مسار
إما اسم مسار المستودع المحلي أو URI للمستودع البعيد.

OPTIONS

-R ،--مخزن
الدليل الجذر للمستودع أو اسم ملف حزمة التراكب

--cwd
تغيير دليل العمل

-ص ، - غير تفاعلي
لا تطالب، اختر الخيار الأول تلقائيًا لجميع المطالبات

-q ، --هادئ
قمع الإخراج

-الخامس، - الإسراف
تمكين الإخراج الإضافي

- تكوين
خيار ضبط/تجاوز التكوين (استخدم "section.name=value")

--Debug
تمكين إخراج التصحيح

- الشرير
بدء المصحح

--التشفير
ضبط ترميز مجموعة الأحرف (الافتراضي: UTF-8)

--encodingmode
ضبط وضع ترميز مجموعة الأحرف (الافتراضي: صارم)

--تتبع الأثر
قم دائمًا بطباعة تتبع عند الاستثناء

--زمن الوقت الذي يستغرقه الأمر

--الملف الشخصي
ملف تعريف تنفيذ أمر الطباعة

--الإصدار
الإخراج معلومات الإصدار والخروج

-ح ، --مساعدة
عرض المساعدة والخروج

--مختفي
خذ بعين الاعتبار مجموعات التغييرات المخفية

[+] يمكن تحديد الخيار المحدد عدة مرات

أوامر

تضيف
أضف الملفات المحددة في الالتزام التالي:

hg أضف [خيار]... [ملف]...

جدولة الملفات ليتم التحكم في إصدارها وإضافتها إلى المستودع.

ستتم إضافة الملفات إلى المستودع في الالتزام التالي. للتراجع عن إضافة قبل ذلك،
انظر تعريف hg ننسى.

إذا لم يتم إعطاء أي أسماء، أضف جميع الملفات إلى المستودع (باستثناء الملفات المطابقة .hginore).

أمثلة:

· تتم إضافة ملفات جديدة (غير معروفة) تلقائيًا hg تضيف:

ليرة سورية
foo.c
حالة $ زئبق
؟ foo.c
إضافة $ زئبق
إضافة foo.c
حالة $ زئبق
فو.ج

· يمكن تحديد الملفات المحددة المراد إضافتها:

ليرة سورية
bar.c foo.c
حالة $ زئبق
؟ شريط.ج
؟ foo.c
$ hg أضف bar.c
حالة $ زئبق
شريط ج
؟ foo.c

إرجاع 0 إذا تمت إضافة جميع الملفات بنجاح.

خيارات:

-أنا،--يشمل
تضمين أسماء مطابقة للأنماط المحددة

-X ،- استثناء
استبعاد الأسماء المطابقة للأنماط المحددة

-س، --subrepos
يتكرر في المستودعات الفرعية

-ن، --ركض جاف
لا تقم بتنفيذ أي إجراءات، فقط اطبع المخرجات

[+] يمكن تحديد الخيار المحدد عدة مرات

اضف احذف
إضافة جميع الملفات الجديدة، وحذف جميع الملفات المفقودة:

إضافة hg [خيار]... [ملف]...

قم بإضافة جميع الملفات الجديدة وإزالة جميع الملفات المفقودة من المستودع.

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

استخدم خيار -s/--similarity للكشف عن الملفات المعاد تسميتها. يأخذ هذا الخيار نسبة مئوية
بين 0 (معطل) و100 (يجب أن تكون الملفات متطابقة) كمعلمة خاصة به. مع المعلمة
أكبر من 0، وهذا يقارن كل ملف تمت إزالته بكل ملف مضاف ويسجل تلك الملفات
مماثلة بما فيه الكفاية لإعادة التسمية. يمكن أن يكون اكتشاف الملفات المعاد تسميتها بهذه الطريقة مكلفًا. بعد الاستخدام
هذا الخيار، hg الحالة -C يمكن استخدامها للتحقق من الملفات التي تم تحديدها على أنها منقولة أو
إعادة تسميته. إذا لم يتم تحديده، فإن القيمة الافتراضية -s/--similarity هي 100 ويتم إعادة تسمية الأسماء المتطابقة فقط
تم الكشف عن الملفات.

أمثلة:

· أصبح هناك عدد من الملفات (bar.c وfoo.c) جديدة، بينما تمت إزالة foobar.c (بدون
استخدام hg إزالة) من المستودع:

ليرة سورية
bar.c foo.c
حالة $ زئبق
! foobar.c
؟ شريط.ج
؟ foo.c
إضافة $ hg
إضافة شريط ج
إضافة foo.c
إزالة foobar.c
حالة $ زئبق
شريط ج
فو.ج
ص foobar.c

· تم نقل ملف foobar.c إلى foo.c دون استخدامه hg إعادة تسمية. بعد ذلك، كان
تم التعديل قليلاً:

ليرة سورية
foo.c
حالة $ زئبق
! foobar.c
؟ foo.c
إضافة $ hg - التشابه 90
إزالة foobar.c
إضافة foo.c
إزالة تسجيل foobar.c وإعادة تسميته إلى foo.c (94% مشابه)
حالة $ hg -C
فو.ج
foobar.c
ص foobar.c

إرجاع 0 إذا تمت إضافة جميع الملفات بنجاح.

خيارات:

-س،--تشابه
تخمين الملفات المعاد تسميتها حسب التشابه (0<=s<=100)

-س، --subrepos
يتكرر في المستودعات الفرعية

-أنا،--يشمل
تضمين أسماء مطابقة للأنماط المحددة

-X ،- استثناء
استبعاد الأسماء المطابقة للأنماط المحددة

-ن، --ركض جاف
لا تقم بتنفيذ أي إجراءات، فقط اطبع المخرجات

[+] يمكن تحديد الخيار المحدد عدة مرات

علق
إظهار معلومات مجموعة التغييرات سطرًا لكل ملف:

hg علق [-r REV] [-f] [-a] [-u] [-d] [-n] [-c] [-l] ملف...

قم بإدراج التغييرات في الملفات، مع إظهار معرف المراجعة المسؤول عن كل سطر.

يعد هذا الأمر مفيدًا لاكتشاف متى تم إجراء التغيير ومن قام به.

إذا قمت بتضمين --file، أو --user، أو --date، فسيتم منع رقم المراجعة إلا إذا قمت بذلك
قم أيضًا بتضمين --number.

بدون خيار -a/--text، سيتجنب التعليق التوضيحي معالجة الملفات التي يكتشفها على أنها ثنائية.
باستخدام -a، سيقوم التعليق التوضيحي بالتعليق على الملف على أي حال، على الرغم من أن النتائج ستكون على الأرجح
لا مفيد ولا مرغوب فيه.

يعود 0 على النجاح.

خيارات:

-r ،--ريف
قم بتعليق المراجعة المحددة

--إتبع
اتبع النسخ/إعادة التسمية وأدرج اسم الملف (مهمل)

--لا اتباع
لا تتبع النسخ وإعادة التسمية

-a، --نص
التعامل مع جميع الملفات كنص

-u ، --المستعمل
قائمة المؤلف (طويلة مع -v)

-F، --ملف
قائمة اسم الملف

-د، --تاريخ
قم بإدراج التاريخ (قصير مع -q)

-ن، --عدد
قائمة رقم المراجعة (الافتراضي)

-c ، --changeset
قائمة التغييرات

-ل ، --رقم السطر
إظهار رقم السطر عند أول ظهور

-w ، --تجاهل - كل - المسافة
تجاهل المسافة البيضاء عند مقارنة الخطوط

-ب، - تجاهل-تغيير الفضاء
تجاهل التغييرات في مقدار المساحة البيضاء

-ب، - تجاهل الأسطر الفارغة
تجاهل التغييرات التي تكون جميع أسطرها فارغة

-أنا،--يشمل
تضمين أسماء مطابقة للأنماط المحددة

-X ،- استثناء
استبعاد الأسماء المطابقة للأنماط المحددة

-T ،--نموذج
عرض مع القالب (تجريبي)

[+] يمكن تحديد الخيار المحدد عدة مرات

الأسماء المستعارة: اللوم

أرشيف
إنشاء أرشيف غير مُصدر لمراجعة المستودع:

أرشيف الزئبق [الخيار]...DEST

بشكل افتراضي، المراجعة المستخدمة هي النسخة الأصلية لدليل العمل؛ استخدم -r/--rev ل
تحديد مراجعة مختلفة.

يتم اكتشاف نوع الأرشيف تلقائيًا بناءً على امتداد الملف (للتجاوز، استخدم
-t/--اكتب).

أمثلة:

· إنشاء ملف مضغوط يحتوي على الإصدار 1.0:

أرشيف hg -r 1.0 project-1.0.zip

· إنشاء كرة القطران باستثناء ملفات .hg:

hg archive project.tar.gz -X ".hg*"

الأنواع الصالحة هي:

ملفات

دليل مليء بالملفات (افتراضي)

قطران

أرشيف القطران، غير مضغوط

tbz2

أرشيف القطران مضغوط باستخدام bzip2

TGZ

أرشيف القطران مضغوط باستخدام gzip

uzip

أرشيف مضغوط، غير مضغوط

الرمز البريدي

أرشيف مضغوط، مضغوط باستخدام انكماش

يتم إعطاء الاسم الدقيق للأرشيف أو الدليل الوجهة باستخدام سلسلة تنسيق؛ يرى
hg مساعدة تصدير للتفاصيل.

كل عضو يضاف إلى ملف أرشيف لديه بادئة دليل ملحقة مسبقًا. استخدم -p/--البادئة لـ
تحديد سلسلة تنسيق للبادئة. الافتراضي هو الاسم الأساسي للأرشيف، مع
تمت إزالة اللواحق.

يعود 0 على النجاح.

خيارات:

--لا يوجد فك تشفير
لا تمر الملفات من خلال أجهزة فك التشفير

-p ،--اختصار
بادئة الدليل للملفات الموجودة في الأرشيف

-r ،--ريف
مراجعة للتوزيع

-t ،--نوع
نوع التوزيع المراد إنشاؤه

-س، --subrepos
يتكرر في المستودعات الفرعية

-أنا،--يشمل
تضمين أسماء مطابقة للأنماط المحددة

-X ،- استثناء
استبعاد الأسماء المطابقة للأنماط المحددة

[+] يمكن تحديد الخيار المحدد عدة مرات

تراجع
التأثير العكسي لمجموعة التغييرات السابقة:

hg backout [خيار]... [-r] REV

قم بإعداد مجموعة تغييرات جديدة مع التراجع عن تأثير REV في دليل العمل الحالي. لو
لم تتم مواجهة أي صراعات، وسيتم ارتكابها على الفور.

إذا كان REV هو أصل دليل العمل، فسيتم الالتزام بمجموعة التغييرات الجديدة هذه
تلقائيًا (ما لم يتم تحديد --no-commit).

ملاحظات hg تراجع لا يمكن استخدامها لإصلاح عملية الدمج غير المرغوب فيها أو غير الصحيحة.

أمثلة:

· عكس تأثير أصل دليل العمل. سيكون هذا التراجع
ارتكبت على الفور:

hg باك اوت -r .

· عكس تأثير المراجعة السيئة السابقة 23:

زئبق التراجع-ص 23

· عكس تأثير المراجعة السيئة السابقة 23 وترك التغييرات دون الالتزام بها:

hg backout -r 23 --no-commit
hg الالتزام -m "مراجعة النسخ الاحتياطي 23"

افتراضيًا، سيكون لمجموعة التغييرات المعلقة أصل واحد، مع الاحتفاظ بسجل خطي. مع
--merge، فإن مجموعة التغييرات المعلقة سيكون لها بدلاً من ذلك أصلان: الوالد القديم لـ
دليل العمل والطفل الجديد لـ REV الذي يلغي ببساطة REV.

قبل الإصدار 1.7، كان السلوك بدون --merge يعادل تحديد --merge
تليها hg تحديث --ينظف . لإلغاء الدمج وترك الطفل REV كرأس
ليتم دمجها بشكل منفصل.

يرى hg مساعدة التمور للحصول على قائمة التنسيقات الصالحة لـ -d/--date.

يرى hg مساعدة العودة للحصول على وسيلة لاستعادة الملفات إلى حالة مراجعة أخرى.

يُرجع 0 عند النجاح، و1 في حالة عدم التراجع أو وجود ملفات لم يتم حلها.

خيارات:

--دمج
الدمج مع الوالد القديم dirstate بعد التراجع

--ارتكب
الالتزام في حالة عدم مواجهة أي تعارض (مهمل)

- لا تلتزم
لا ترتكب

--الأبوين
أحد الوالدين للاختيار عند التراجع عن الدمج (موقوف)

-r ،--ريف
مراجعة للتراجع

-e، --تعديل
استدعاء المحرر على رسائل الالتزام

-t ،--أداة
تحديد أداة الدمج

-أنا،--يشمل
تضمين أسماء مطابقة للأنماط المحددة

-X ،- استثناء
استبعاد الأسماء المطابقة للأنماط المحددة

م ،--رسالة
استخدم النص كرسالة التزام

-ل ،--ملف تسجيل
قراءة رسالة الالتزام من الملف

-د،--تاريخ
سجل التاريخ المحدد كتاريخ الالتزام

-u ،--المستعمل
تسجيل المستخدم المحدد كملتزم

[+] يمكن تحديد الخيار المحدد عدة مرات

ينصف
البحث عن التقسيمات الفرعية لمجموعات التغييرات:

نصف الزئبق [-gbsr] [-U] [-c CMD] [REV]

يساعد هذا الأمر في العثور على مجموعات التغييرات التي تسبب مشاكل. للاستخدام، ضع علامة على الأقدم
مجموعة التغييرات التي تعرفها تعرض المشكلة على أنها سيئة، ثم قم بوضع علامة على أحدث مجموعة تغييرات وهي
خالية من المشكلة جيدة. سيقوم Bisect بتحديث دليل العمل الخاص بك إلى مراجعة لـ
الاختبار (ما لم يتم تحديد خيار -U/--noupdate). بمجرد قيامك بإجراء الاختبارات،
قم بوضع علامة على دليل العمل على أنه جيد أو سيئ، وسيتم تحديث bisect إلى دليل آخر
تغيير مجموعة المرشح أو الإعلان عن أنه وجد المراجعة السيئة.

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

إذا قمت بتوفير أمر، فسيتم استخدامه للتقسيم التلقائي. البيئة
سيحتوي المتغير HG_NODE على معرف مجموعة التغييرات التي يتم اختبارها. حالة الخروج من
سيتم استخدام الأمر لوضع علامة على المراجعات بأنها جيدة أو سيئة: الحالة 0 تعني جيد، 125 تعني إلى
تخطي المراجعة، 127 (الأمر غير موجود) سيؤدي إلى إحباط عملية التنصيف، وأي شيء آخر
حالة الخروج غير الصفرية تعني أن المراجعة سيئة.

بعض الأمثلة:

· ابدأ بالتقسيم بالمراجعة السيئة المعروفة 34 والمراجعة الجيدة 12:

زئبق منصف - سيء 34
زئبق منصف - جيد 12

· تقدم التقسيم الحالي عن طريق وضع علامة على المراجعة الحالية بأنها جيدة أو سيئة:

زئبق منصف --جيد
زئبق منصف - سيئة

· وضع علامة على المراجعة الحالية، أو المراجعة المعروفة، التي سيتم تخطيها (على سبيل المثال، إذا كانت هذه المراجعة
غير قابل للاستخدام بسبب مشكلة أخرى):

زئبق منصف --تخطي
زئبق منصف - تخطي 23

· تخطي كافة المراجعات التي لا تمس الدلائل فو or شريط:

hg bisect --skip "!( file('path:foo') & file('path:bar')) )"

· ننسى التنصيف الحالي:

hg منصف - إعادة تعيين

· استخدم "إجراء && إجراء اختبارات" للعثور تلقائيًا على أول مراجعة معطلة:

hg منصف - إعادة تعيين
زئبق منصف - سيء 34
زئبق منصف - جيد 12
hg bisect --command "إجراء && إجراء اختبارات"

· شاهد جميع مجموعات التغييرات التي تكون حالاتها معروفة بالفعل في القسم الحالي:

hg log -r "منصف (مقلم)"

· شاهد مجموعة التغييرات التي يتم تقسيمها حاليًا (مفيدة بشكل خاص في حالة التشغيل مع
-U/--noupdate):

hg log -r "منصف (الحالي)"

· شاهد جميع مجموعات التغييرات التي شاركت في التقسيم الحالي:

hg log -r "منصف (النطاق)"

· يمكنك حتى الحصول على رسم بياني جميل:

سجل hg --رسم بياني -r "منصف (النطاق)"

يرى hg مساعدة revsets للمزيد عن ينصف() الكلمة.

يعود 0 على النجاح.

خيارات:

-r ، --إعادة تعيين
إعادة تعيين حالة النصف

-g ، --جيد
علامة التغييرات جيدة

-ب، --سيء
وضع علامة على مجموعة التغييرات سيئة

-س، --يتخطى
تخطي اختبار التغييرات

-e، --يمتد
توسيع نطاق المنتصف

-c ،--أمر
استخدم الأمر للتحقق من حالة التغييرات

-U ، --لا تحديث
لا تقم بالتحديث إلى الهدف

الإشارات المرجعية
قم بإنشاء إشارة مرجعية جديدة أو قم بإدراج الإشارات المرجعية الموجودة:

الإشارات المرجعية [خيارات]... [الاسم]...

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

يؤدي إنشاء إشارة مرجعية أو تحديثها إلى وضع علامة "نشطة" عليها. النشط
تتم الإشارة إلى الإشارة المرجعية بعلامة "*". عند الالتزام، ستتقدم الإشارة المرجعية النشطة
إلى الالتزام الجديد. سهل hg تحديث سيتم أيضًا تقديم إشارة مرجعية نشطة، إن أمكن.
سيؤدي التحديث بعيدًا عن الإشارة المرجعية إلى إلغاء تنشيطها.

يمكن دفع الإشارات المرجعية وسحبها بين المستودعات (انظر hg مساعدة دفع و hg مساعدة سحب
). إذا تباعدت الإشارة المرجعية المشتركة، فستظهر "إشارة مرجعية متباينة" جديدة بالنموذج "name@path"
سيتم إنشاء. استخدام hg دمج سوف يحل التباين.

الإشارة المرجعية المسماة "@" لها الخاصية الخاصة التي hg استنساخ سوف التحقق من ذلك بشكل افتراضي
إذا كانت موجودة.

أمثلة:

· إنشاء إشارة مرجعية نشطة لخط جديد من التطوير:

كتاب hg ميزة جديدة

· إنشاء إشارة مرجعية غير نشطة كعلامة مكان:

كتاب زئبق-لقد قمت بمراجعته

· إنشاء إشارة مرجعية غير نشطة على مجموعة تغييرات أخرى:

كتاب زئبق -r .^ تم اختباره

· إعادة تسمية المرجعية تركيا إلى العشاء:

كتاب زئبق - م عشاء تركيا

· انقل الإشارة المرجعية "@" من فرع آخر:

كتاب زئبق -و @

خيارات:

-F، --فرض
القوة

-r ،--ريف
مراجعة لإجراء الإشارة المرجعية

-د، --حذف
حذف إشارة مرجعية معينة

م ،- إعادة تسمية
إعادة تسمية إشارة مرجعية معينة

-أنا، --غير نشط
وضع علامة على إشارة مرجعية غير نشطة

-T ،--نموذج
عرض مع القالب (تجريبي)

الأسماء المستعارة: المرجعية

خيران
تعيين أو إظهار اسم الفرع الحالي:

فرع الزئبق [-fC] [الاسم]

ملاحظة: أسماء الفروع دائمة وعمومية. يستخدم hg المرجعية لخلق خفيفة الوزن
المرجعية بدلا من ذلك. يرى hg مساعدة قاموس مصطلحات لمزيد من المعلومات حول الفروع المسماة
والإشارات المرجعية.

بدون أي وسيطة، قم بإظهار اسم الفرع الحالي. مع حجة واحدة، قم بتعيين العمل
اسم فرع الدليل (لن يكون الفرع موجودًا في المستودع حتى الالتزام التالي).
توصي الممارسة القياسية بإجراء التطوير الأساسي على الفرع "الافتراضي".

ما لم يتم تحديد -f/--force، فلن يسمح لك الفرع بتعيين اسم فرع موجود بالفعل
موجودا.

استخدم -C/--clean لإعادة تعيين فرع دليل العمل إلى الفرع الأصلي للعمل
الدليل، مما يلغي تغيير الفرع السابق.

استخدم الأمر hg تحديث للتبديل إلى فرع موجود. يستخدم hg ارتكاب - فرع قريب إلى
ضع علامة على رأس الفرع هذا على أنه مغلق. عندما يتم إغلاق جميع رؤوس الفرع، سيتم إغلاق الفرع
تعتبر مغلقة.

يعود 0 على النجاح.

خيارات:

-F، --فرض
قم بتعيين اسم الفرع حتى لو كان يظلل فرعًا موجودًا

-C ، --ينظف
إعادة تعيين اسم الفرع إلى اسم الفرع الأصلي

الفروع
قائمة مستودع الفروع المسماة:

فروع الزئبق [-ج]

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

استخدم الأمر hg تحديث للتبديل إلى فرع موجود.

يعود 0.

خيارات:

-a، --نشيط
إظهار الفروع التي لها رؤوس غير مدمجة فقط (مهملة)

-c ، --مغلق
إظهار الفروع العادية والمغلقة

-T ،--نموذج
عرض مع القالب (تجريبي)

حزمة
إنشاء ملف Changegroup:

حزمة hg [-f] [-t TYPE] [-a] [-r REV]... [--base REV]... ملف [DEST]

قم بإنشاء ملف Changegroup يجمع مجموعات التغييرات لإضافتها إلى المستودع.

لإنشاء حزمة تحتوي على جميع مجموعات التغييرات، استخدم -a/--all (أو --base null). خلاف ذلك، زئبق
يفترض أن الوجهة ستحتوي على جميع العقد التي تحددها باستخدام معلمات --base.
بخلاف ذلك، سيفترض hg أن المستودع يحتوي على جميع العقد في الوجهة، أو
default-push/default إذا لم يتم تحديد وجهة.

يمكنك تغيير تنسيق الحزمة باستخدام خيار -t/--type. يمكنك تحديد ضغط، أ
إصدار الحزمة أو كليهما باستخدام شرطة (إصدار شركات). طرق الضغط المتاحة هي:
none وbzip2 وgzip (افتراضيًا، يتم ضغط الحزم باستخدام bzip2). المتاح
التنسيقات هي: v1، v2 (الافتراضي هو الأكثر ملائمة).

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

يؤدي تطبيق الحزم إلى الحفاظ على جميع محتويات مجموعة التغييرات بما في ذلك الأذونات والنسخ/إعادة التسمية
المعلومات وتاريخ المراجعة.

يُرجع 0 عند النجاح، و1 إذا لم يتم العثور على تغييرات.

خيارات:

-F، --فرض
تشغيل حتى عندما تكون الوجهة غير ذات صلة

-r ،--ريف
مجموعة تغييرات مخصصة لإضافتها إلى الوجهة

-ب،--فرع
فرع معين ترغب في تجميعه

--يتمركز
مجموعة تغييرات أساسية من المفترض أن تكون متاحة في الوجهة

-a، --الكل
تجميع جميع مجموعات التغييرات في المستودع

-t ،--نوع
نوع ضغط الحزمة المطلوب استخدامه (الافتراضي: bzip2)

-e،--SSH
تحديد أمر ssh للاستخدام

--remotecmd
حدد الأمر hg ليتم تشغيله على الجانب البعيد

--غير آمن
لا تتحقق من شهادة الخادم (تجاهل تكوين web.cacerts)

[+] يمكن تحديد الخيار المحدد عدة مرات

قط
إخراج المراجعة الحالية أو المعطاة للملفات:

hg cat [خيار]...ملف...

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

قد يكون الإخراج إلى ملف، وفي هذه الحالة يتم إعطاء اسم الملف باستخدام تنسيق
خيط. قواعد التنسيق كما يلي:

%%

الحرف "%" الحرفي

%s

الاسم الأساسي للملف الجاري طباعته

%d

اسم الملف الجاري طباعته، أو "." إذا كان في جذر المستودع

%p

اسم المسار النسبي للجذر للملف الجاري طباعته

%H

تجزئة مجموعة التغييرات (40 رقمًا سداسيًا عشريًا)

%R

رقم مراجعة مجموعة التغييرات

%h

تجزئة مجموعة التغييرات القصيرة (12 رقمًا سداسيًا عشريًا)

%r

رقم مراجعة مجموعة التغييرات المبطن بصفر

%b

الاسم الأساسي لمستودع التصدير

يعود 0 على النجاح.

خيارات:

-o ،--انتاج
طباعة الإخراج إلى ملف باسم منسق

-r ،--ريف
طباعة المراجعة المحددة

--فك تشفير
قم بتطبيق أي مرشح فك تشفير مطابق

-أنا،--يشمل
تضمين أسماء مطابقة للأنماط المحددة

-X ،- استثناء
استبعاد الأسماء المطابقة للأنماط المحددة

[+] يمكن تحديد الخيار المحدد عدة مرات

استنساخ
عمل نسخة من المستودع الحالي:

hg clone [خيار]... المصدر [DEST]

قم بإنشاء نسخة من مستودع موجود في دليل جديد.

إذا لم يتم تحديد اسم دليل الوجهة، فسيتم تعيينه افتراضيًا على الاسم الأساسي للمصدر.

تتم إضافة موقع المصدر إلى المستودع الجديد .hg/hgrc الملف، كافتراضي
لاستخدامها في السحب في المستقبل.

المسارات المحلية فقط و ssh: // يتم دعم عناوين URL كوجهات. ل ssh: // الأماكن،
لا يوجد دليل عمل أو .hg/hgrc سيتم إنشاؤها على الجانب البعيد.

إذا كان المستودع المصدر يحتوي على إشارة مرجعية تسمى "@"، فسيتم سحب هذه المراجعة
في المستودع الجديد بشكل افتراضي.

للتحقق من إصدار معين، استخدم -u/--update، أو -U/--noupdate لإنشاء نسخة.
مع عدم وجود دليل العمل.

لسحب مجموعة فرعية فقط من مجموعات التغييرات، حدد واحدًا أو أكثر من معرفات المراجعات
-r/--rev أو الفروع مع -b/--branch. سوف يحتوي الاستنساخ الناتج على المحدد فقط
مجموعات التغيير وأسلافهم. تشير هذه الخيارات (أو "clone src#rev dest") إلى --pull، حتى
لمستودعات المصدر المحلية.

ملاحظة: سيتضمن تحديد علامة مجموعة التغييرات ذات العلامات ولكن ليس مجموعة التغييرات التي تحتوي عليها
الوسم.

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

في بعض الحالات، يمكنك استنساخ المستودعات ودليل العمل باستخدام الروابط الصلبة الكاملة
مع

$ cp -al REPO REPOCLONE

هذه هي أسرع طريقة للاستنساخ، ولكنها ليست آمنة دائمًا. العملية ليست ذرية
(التأكد من عدم تعديل REPO أثناء العملية أمر متروك لك) وعليك القيام بذلك
تأكد من أن محررك يكسر الروابط الصلبة (Emacs ومعظم أدوات Linux Kernel تفعل ذلك). أيضا، وهذا هو
غير متوافق مع بعض الملحقات التي تضع بيانات التعريف الخاصة بها ضمن دليل .hg،
مثل م ق.

سيقوم Mercurial بتحديث دليل العمل إلى أول مراجعة قابلة للتطبيق من هذا
قائمة:

أ. لاغٍ إذا كان -U أو مستودع المصدر لا يحتوي على مجموعات تغييرات

ب. اذا كنت . والمستودع المصدر محلي، وهو الأصل الأول لمستودع المصدر
عمل اخراجي

ج. مجموعة التغييرات المحددة بـ -u (إذا كان اسم فرع، فهذا يعني أحدث رأس لذلك
فرع)

د. مجموعة التغييرات المحددة بـ -r

ه. الرأس الأقصى المحدد بـ -b

F. الرأس الأقصى المحدد باستخدام صيغة مصدر url#branch

ز. تم وضع علامة على المراجعة بالإشارة المرجعية "@"، إذا كانت موجودة

ح. الرأس الأقصى للفرع الافتراضي

أنا. نصيحة

عند الاستنساخ من الخوادم التي تدعمه، قد يقوم Mercurial بجلب البيانات التي تم إنشاؤها مسبقًا من ملف
عنوان URL المُعلن عنه بواسطة الخادم. عند الانتهاء من ذلك، تعمل الخطافات على مجموعات التغييرات الواردة و
قد يتم تنشيط مجموعات التغيير مرتين، مرة للحزمة التي تم جلبها من عنوان URL والأخرى لأي منها
لم يتم جلب البيانات الإضافية من عنوان URL هذا. بالإضافة إلى ذلك، في حالة حدوث خطأ، سيتم حذف المستودع
قد يتم إرجاعها إلى استنساخ جزئي. قد يتغير هذا السلوك في الإصدارات المستقبلية. يرى hg
مساعدة -e clonebundles للمزيد.

أمثلة:

· استنساخ مستودع بعيد إلى دليل جديد يسمى hg/:

hg استنساخ http://selenic.com/hg

· إنشاء نسخة محلية خفيفة الوزن:

مشروع استنساخ الزئبق/ميزة المشروع/

· الاستنساخ من المسار المطلق على خادم ssh (لاحظ الشرطة المائلة المزدوجة):

hg clone ssh://user@server//home/projects/alpha/

· قم بإجراء استنساخ عالي السرعة عبر شبكة LAN أثناء التحقق من إصدار محدد:

استنساخ الزئبق - غير مضغوط http://server/repo -ش 1.5

· إنشاء مستودع بدون مجموعات التغييرات بعد مراجعة معينة:

hg Clone -r 04e544 تجريبي/جيد/

· استنساخ (وتتبع) فرع محدد محدد:

hg استنساخ http://selenic.com/hg#مستقر

يرى hg مساعدة عناوين المواقع للحصول على تفاصيل حول تحديد عناوين URL.

يعود 0 على النجاح.

خيارات:

-U ، --لا تحديث
سيتضمن الاستنساخ دليل عمل فارغًا (مستودعًا فقط)

-u ،--updaterev
المراجعة أو العلامة أو الفرع للتحقق

-r ،--ريف
تضمين مجموعة التغييرات المحددة

-ب،--فرع
استنساخ الفرع المحدد فقط

--يحذب استخدم بروتوكول السحب لنسخ البيانات الوصفية

--غير مضغوط
استخدام النقل غير المضغوط (السريع عبر الشبكة المحلية)

-e،--SSH
تحديد أمر ssh للاستخدام

--remotecmd
حدد الأمر hg ليتم تشغيله على الجانب البعيد

--غير آمن
لا تتحقق من شهادة الخادم (تجاهل تكوين web.cacerts)

[+] يمكن تحديد الخيار المحدد عدة مرات

ارتكاب
تنفيذ الملفات المحددة أو جميع التغييرات المعلقة:

الالتزام بـ [خيار]... [ملف]...

قم بتنفيذ التغييرات على الملفات المحددة في المستودع. على عكس SCM المركزي، هذا
العملية هي عملية محلية. يرى hg دفع للحصول على طريقة لتوزيع التغييرات بشكل فعال.

إذا تم حذف قائمة الملفات، فسيتم الإبلاغ عن جميع التغييرات بواسطة hg الحالة سوف تكون ملتزمة.

إذا كنت تقوم بتنفيذ نتيجة الدمج، فلا تقدم أي أسماء ملفات أو -I/-X
المرشحات.

إذا لم يتم تحديد أي رسالة التزام، فسيقوم Mercurial بتشغيل المحرر الذي تم تكوينه حيثما أمكنك ذلك
أدخل رسالة. في حالة فشل التزامك، ستجد نسخة احتياطية لرسالتك في
.hg/last-message.txt.

يمكن استخدام علامة -- Close-branch لتمييز رأس الفرع الحالي بأنه مغلق. عندما كل الرؤوس
إذا تم إغلاق أحد الفروع، فسيتم اعتبار الفرع مغلقًا ولم يعد مدرجًا.

يمكن استخدام العلامة --amend لتعديل أصل دليل العمل بعلامة جديدة
الالتزام الذي يحتوي على التغييرات في الأصل بالإضافة إلى تلك التي تم الإبلاغ عنها حاليًا بواسطة
hg الحالة، إذا كان هناك أي. يتم تخزين الالتزام القديم في حزمة احتياطية في
.hg/strip-backup (انظر hg مساعدة حزمة و hg مساعدة سيفصل حول كيفية استعادته).

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

ليس من الممكن تعديل مجموعات التغييرات العامة (انظر hg مساعدة المراحل) أو مجموعات التغييرات التي تحتوي على
الأطفال.

يرى hg مساعدة التمور للحصول على قائمة التنسيقات الصالحة لـ -d/--date.

يُرجع 0 عند النجاح، و1 إذا لم يتغير شيء.

أمثلة:

· الالتزام بجميع الملفات التي تنتهي بـ .py:

التزام hg - يتضمن "set:**.py"

· الالتزام بجميع الملفات غير الثنائية:

التزام hg - استبعاد "المجموعة: ثنائي ()"

· تعديل الالتزام الحالي وتحديد التاريخ إلى الآن:

hg الالتزام --تعديل --التاريخ الآن

خيارات:

-أ، --اضف احذف
وضع علامة على الملفات الجديدة/المفقودة كمضافة/إزالة قبل الالتزام

- فرع قريب
ضع علامة على رأس الفرع على أنه مغلق

--يعدل
تعديل أصل دليل العمل

-س، --سر
استخدم المرحلة السرية للالتزام

-e، --تعديل
استدعاء المحرر على رسائل الالتزام

-أنا، - تفاعلي
استخدام الوضع التفاعلي

-أنا،--يشمل
تضمين أسماء مطابقة للأنماط المحددة

-X ،- استثناء
استبعاد الأسماء المطابقة للأنماط المحددة

م ،--رسالة
استخدم النص كرسالة التزام

-ل ،--ملف تسجيل
قراءة رسالة الالتزام من الملف

-د،--تاريخ
سجل التاريخ المحدد كتاريخ الالتزام

-u ،--المستعمل
تسجيل المستخدم المحدد كملتزم

-س، --subrepos
يتكرر في المستودعات الفرعية

[+] يمكن تحديد الخيار المحدد عدة مرات

الأسماء المستعارة: سي

التكوين
إظهار إعدادات التكوين المدمجة من جميع ملفات hgrc:

التكوين hg [-u] [الاسم]...

بدون وسائط، قم بطباعة أسماء وقيم جميع عناصر التكوين.

باستخدام وسيطة واحدة للنموذج section.name، قم بطباعة قيمة عنصر التكوين هذا فقط.

باستخدام الوسائط المتعددة، يمكنك طباعة أسماء وقيم جميع عناصر التكوين مع القسم المطابق
أسماء.

باستخدام --edit، ابدأ تشغيل محرر على ملف التكوين على مستوى المستخدم. باستخدام --global، قم بتحرير ملف
ملف التكوين على مستوى النظام. باستخدام --local، قم بتحرير ملف التكوين على مستوى المستودع.

باستخدام --debug، تتم طباعة المصدر (اسم الملف ورقم السطر) لكل عنصر تكوين.

يرى hg مساعدة التكوين لمزيد من المعلومات حول ملفات التكوين.

يُرجع 0 عند النجاح، و1 إذا كان NAME غير موجود.

خيارات:

-u ، --غير موثوق به
إظهار خيارات التكوين غير الموثوق بها

-e، --تعديل
تحرير تكوين المستخدم

-ل ، --محلي
تحرير تكوين المستودع

-g ، --عالمي
تحرير التكوين العالمي

الأسماء المستعارة: showconfig debugconfig

نسخة
وضع علامة على الملفات على أنها منسوخة للالتزام التالي:

نسخة زئبق [الخيار]... [المصدر]... الوجهة

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

افتراضيًا، يقوم هذا الأمر بنسخ محتويات الملفات كما هي موجودة في العمل
الدليل. إذا تم استدعاؤها باستخدام -A/--after، فسيتم تسجيل العملية، ولكن لا يتم النسخ
نفذت.

يصبح هذا الأمر ساري المفعول مع الالتزام التالي. للتراجع عن نسخة قبل ذلك، راجع hg العودة.

يُرجع 0 عند النجاح، و1 إذا تمت مواجهة أخطاء.

خيارات:

-أ، --بعد
تسجيل نسخة حدثت بالفعل

-F، --فرض
النسخ القسري على ملف مُدار موجود

-أنا،--يشمل
تضمين أسماء مطابقة للأنماط المحددة

-X ،- استثناء
استبعاد الأسماء المطابقة للأنماط المحددة

-ن، --ركض جاف
لا تقم بتنفيذ أي إجراءات، فقط اطبع المخرجات

[+] يمكن تحديد الخيار المحدد عدة مرات

الأسماء المستعارة: سي بي

فرق
مستودع الفرق (أو الملفات المحددة):

hg diff [خيار]... ([-c REV] | [-r REV1 [-r REV2]]) [ملف]...

إظهار الاختلافات بين المراجعات للملفات المحددة.

يتم عرض الاختلافات بين الملفات باستخدام تنسيق الفرق الموحد.

ملاحظات hg فرق قد يؤدي إلى نتائج غير متوقعة لعمليات الدمج، حيث سيتم إجراء المقارنة افتراضيًا
مقابل مجموعة التغييرات الأصلية الأولى لدليل العمل في حالة عدم وجود مراجعات
محدد.

عند تقديم وسيطتين للمراجعة، تظهر التغييرات بين تلك المراجعات. لو
يتم تحديد مراجعة واحدة فقط ثم تتم مقارنة تلك المراجعة بدليل العمل،
وعندما لا يتم تحديد أي مراجعات، تتم مقارنة ملفات دليل العمل بها
الوالد الأول.

وبدلاً من ذلك، يمكنك تحديد -c/--change مع المراجعة لرؤية التغييرات في ذلك
مجموعة التغييرات بالنسبة إلى أصلها الأول.

بدون خيار -a/--text، سيتجنب diff إنشاء اختلافات في الملفات التي يكتشفها
الثنائية. مع -a، سيؤدي diff إلى إنشاء فرق على أي حال، وربما يؤدي إلى نتائج غير مرغوب فيها.

استخدم الخيار -g/--git لإنشاء فروق بتنسيق git Extended diff. للمزيد من
معلومات، اقرأ hg مساعدة فرق.

أمثلة:

· مقارنة ملف في دليل العمل الحالي بالملف الأصلي:

فرق الزئبق foo.c

· مقارنة نسختين تاريخيتين للدليل، مع معلومات إعادة التسمية:

فرق hg --git -r 1.0:1.2 lib/

· احصل على إحصائيات التغيير المتعلقة بالتغيير الأخير في تاريخ ما:

hg diff --stat -r "التاريخ('2 مايو')"

· فرق بين جميع الملفات المضافة حديثًا والتي تحتوي على كلمة أساسية:

فرق hg "set:added() وgrep(GNU)"

· مقارنة المراجعة ووالديها:

hg diff -c 9353 # قارن مع الوالد الأول
hg diff -r 9353^:9353 # نفس الشيء باستخدام بناء جملة revset
hg diff -r 9353^2:9353 # قارن مع الوالد الثاني

يعود 0 على النجاح.

خيارات:

-r ،--ريف
تنقيح

-c ،--يتغير
التغيير الذي تم عن طريق المراجعة

-a، --نص
التعامل مع جميع الملفات كنص

-g ، --شخص سخيف
استخدم تنسيق git Extended diff

--nodates
حذف التواريخ من رؤوس الفرق

--noprefix
حذف البادئات a/ وb/ من أسماء الملفات

-p ، --إظهار الوظيفة
إظهار الوظيفة التي يوجد بها كل تغيير

--يعكس
إنتاج فرق يلغي التغييرات

-w ، --تجاهل - كل - المسافة
تجاهل المسافة البيضاء عند مقارنة الخطوط

-ب، - تجاهل-تغيير الفضاء
تجاهل التغييرات في مقدار المساحة البيضاء

-ب، - تجاهل الأسطر الفارغة
تجاهل التغييرات التي تكون جميع أسطرها فارغة

-U ،--موحد
عدد أسطر السياق المراد إظهارها

- إحصائيات إخراج ملخص للتغييرات على غرار diffstat

--جذر
إنتاج فروق نسبة إلى الدليل الفرعي

-أنا،--يشمل
تضمين أسماء مطابقة للأنماط المحددة

-X ،- استثناء
استبعاد الأسماء المطابقة للأنماط المحددة

-س، --subrepos
يتكرر في المستودعات الفرعية

[+] يمكن تحديد الخيار المحدد عدة مرات

تصدير
تفريغ الرأس والاختلافات لواحدة أو أكثر من مجموعات التغييرات:

تصدير hg [خيار]... [-o OUTFILESPEC] [-r] [REV]...

اطبع رأس مجموعة التغييرات والاختلافات لمراجعة واحدة أو أكثر. إذا لم يتم إعطاء أي مراجعة،
يتم استخدام أصل دليل العمل.

المعلومات الموضحة في رأس مجموعة التغييرات هي: المؤلف، التاريخ، اسم الفرع (if
غير افتراضي)، وتجزئة مجموعة التغييرات، والوالد (الوالدين)، والتعليق على الالتزام.

ملاحظات hg تصدير قد ينشئ مخرجات فرق غير متوقعة لدمج مجموعات التغييرات، كما سيحدث
قارن مجموعة تغييرات الدمج مع أصلها الأول فقط.

قد يكون الإخراج إلى ملف، وفي هذه الحالة يتم إعطاء اسم الملف باستخدام تنسيق
خيط. قواعد التنسيق هي كما يلي:

%%

الحرف "%" الحرفي

%H

تجزئة مجموعة التغييرات (40 رقمًا سداسيًا عشريًا)

%N

عدد التصحيحات التي يتم إنشاؤها

%R

رقم مراجعة مجموعة التغييرات

%b

الاسم الأساسي لمستودع التصدير

%h

تجزئة مجموعة التغييرات القصيرة (12 رقمًا سداسيًا عشريًا)

%m

السطر الأول من رسالة الالتزام (الأحرف الأبجدية الرقمية فقط)

%n

رقم تسلسلي مبطن، يبدأ من 1

%r

رقم مراجعة مجموعة التغييرات المبطن بصفر

بدون خيار -a/--text، سيتجنب التصدير إنشاء اختلافات في الملفات التي يكتشفها
الثنائية. مع -a، سيؤدي التصدير إلى إنشاء فرق على أي حال، وربما يؤدي إلى نتائج غير مرغوب فيها.

استخدم الخيار -g/--git لإنشاء فروق بتنسيق git Extended diff. يرى hg مساعدة
فرق للمزيد من المعلومات.

مع خيار --switch-parent، سيكون الفرق مقابل الوالد الثاني. يمكن أن يكون
من المفيد مراجعة الدمج.

أمثلة:

· استخدم التصدير والاستيراد لنقل إصلاح الخلل إلى الفرع الحالي:

تصدير الزئبق - ص 9353 | استيراد الزئبق -

· تصدير جميع مجموعات التغييرات بين مراجعتين إلى ملف يحتوي على معلومات إعادة التسمية:

تصدير hg --git -r 123:150 > التغييرات.txt

· تقسيم التغييرات الصادرة إلى سلسلة من التصحيحات بأسماء وصفية:

hg Export -r "outgoing()" -o "%n-%m.patch"

يعود 0 على النجاح.

خيارات:

-o ،--انتاج
طباعة الإخراج إلى ملف باسم منسق

--switch-parent
فرق ضد الوالد الثاني

-r ،--ريف
المراجعات للتصدير

-a، --نص
التعامل مع جميع الملفات كنص

-g ، --شخص سخيف
استخدم تنسيق git Extended diff

--nodates
حذف التواريخ من رؤوس الفرق

[+] يمكن تحديد الخيار المحدد عدة مرات

ملفات
قائمة الملفات المتعقبة:

ملفات hg [خيار]... [نمط]...

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

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

أمثلة:

· قائمة كافة الملفات ضمن الدليل الحالي:

ملفات زئبق .

· يظهر الأحجام والأعلام للمراجعة الحالية:

ملفات hg -vr .

· قائمة كافة الملفات المسماة README:

ملفات hg -I "**/README"

· قائمة بجميع الملفات الثنائية:

ملفات hg "مجموعة: ثنائي ()"

· العثور على الملفات التي تحتوي على تعبير عادي:

ملفات hg "set:grep('bob')"

· البحث عن محتويات الملفات المتعقبة باستخدام xargs و grep:

ملفات الزئبق -0 | xargs -0 grep foo

يرى hg مساعدة أنماط و hg مساعدة مجموعات الملفات لمزيد من المعلومات حول تحديد الملف
أنماط - رسم.

إرجاع 0 إذا تم العثور على تطابق، 1 خلاف ذلك.

خيارات:

-r ،--ريف
ابحث في المستودع كما هو في REV

-0، --print0
نهاية أسماء الملفات بـ NUL، للاستخدام مع xargs

-أنا،--يشمل
تضمين أسماء مطابقة للأنماط المحددة

-X ،- استثناء
استبعاد الأسماء المطابقة للأنماط المحددة

-T ،--نموذج
عرض مع القالب (تجريبي)

-س، --subrepos
يتكرر في المستودعات الفرعية

[+] يمكن تحديد الخيار المحدد عدة مرات

ننسى
ننسى الملفات المحددة في الالتزام التالي:

زئبق ننسى [الخيار] ... ملف ...

قم بتمييز الملفات المحددة بحيث لن يتم تعقبها بعد الالتزام التالي.

يؤدي هذا إلى إزالة الملفات من الفرع الحالي فقط، وليس من سجل المشروع بأكمله، و
ولا يحذفها من دليل العمل.

لحذف الملف من دليل العمل، راجع hg إزالة.

للتراجع عن النسيان قبل الالتزام التالي، راجع hg تضيف.

أمثلة:

· ننسى الملفات الثنائية المضافة حديثا:

زئبق ننسى "مجموعة: تمت إضافته () وثنائي ()"

· ننسى الملفات التي سيتم استبعادها بواسطة .hgignore:

زئبق ننسى "مجموعة: hgignore ()"

يعود 0 على النجاح.

خيارات:

-أنا،--يشمل
تضمين أسماء مطابقة للأنماط المحددة

-X ،- استثناء
استبعاد الأسماء المطابقة للأنماط المحددة

[+] يمكن تحديد الخيار المحدد عدة مرات

تطعيم
نسخ التغييرات من الفروع الأخرى إلى الفرع الحالي:

طعم الزئبق [خيار]... [-r REV]... REV...

يستخدم هذا الأمر منطق الدمج الخاص بـ Mercurial لنسخ التغييرات الفردية من الفروع الأخرى
دون دمج الفروع في الرسم البياني للتاريخ. يُعرف هذا أحيانًا باسم "backporting" أو
'قطف الكرز'. افتراضيًا، سيقوم الكسب غير المشروع بنسخ المستخدم والتاريخ والوصف من المصدر
مجموعات التغييرات.

مجموعات التغييرات التي هي أسلاف للمراجعة الحالية، والتي تم تطعيمها بالفعل، أو
سيتم تخطي عمليات الدمج هذه.

إذا تم تحديد --log، فستحتوي رسائل السجل على تعليق مُلحق بالنموذج:

(المطعمة من CHANGESETHASH)

إذا تم تحديد --force، فسيتم تطعيم المراجعات حتى لو كانت أسلافًا بالفعل
أو تم تطعيمها إلى الوجهة. وهذا مفيد عندما تكون المراجعات منذ ذلك الحين
تم التراجع عنها.

إذا أدى دمج الكسب غير المشروع إلى حدوث تعارضات، فسيتم مقاطعة عملية الكسب غير المشروع بحيث يتم
يمكن حل الدمج الحالي يدويًا. بمجرد معالجة كافة الصراعات، الكسب غير المشروع
يمكن متابعة العملية باستخدام الخيار -c/--continue.

ملاحظة: لا يؤدي الخيار -c/--continue إلى إعادة تطبيق الخيارات السابقة، باستثناء --force.

أمثلة:

· انسخ تغييرًا واحدًا إلى الفرع المستقر وقم بتحرير وصفه:

تحديث زئبق مستقر
الكسب غير المشروع زئبق - تحرير 9393

· تطعيم مجموعة من مجموعات التغييرات باستثناء واحد، وهو تواريخ التحديث:

hg graft -D "2085::2093 وليس 2091"

· مواصلة الكسب غير المشروع بعد حل النزاعات:

زئبق الكسب غير المشروع -ج

· إظهار مصدر مجموعة التغييرات المطعمة:

سجل hg --debug -r .

· عرض المراجعات مرتبة حسب التاريخ:

hg log -r 'sort(all(), date)'

يرى hg مساعدة المراجعات و hg مساعدة revsets لمزيد من المعلومات حول تحديد المراجعات.

إرجاع 0 عند الإكمال الناجح.

خيارات:

-r ،--ريف
مراجعات للكسب غير المشروع

-c ، --استمر
استئناف الكسب غير المشروع المتقطع

-e، --تعديل
استدعاء المحرر على رسائل الالتزام

--سجل إلحاق معلومات الكسب غير المشروع لتسجيل الرسالة

-F، --فرض
الكسب غير المشروع القوة

-د، --التاريخ الحالي
سجل التاريخ الحالي كتاريخ الالتزام

-U ، --المستخدم الحالي
تسجيل المستخدم الحالي كملتزم

-د،--تاريخ
سجل التاريخ المحدد كتاريخ الالتزام

-u ،--المستعمل
تسجيل المستخدم المحدد كملتزم

-t ،--أداة
تحديد أداة الدمج

-ن، --ركض جاف
لا تقم بتنفيذ أي إجراءات، فقط اطبع المخرجات

[+] يمكن تحديد الخيار المحدد عدة مرات

البقرى
ابحث عن نمط في الملفات والمراجعات المحددة:

hg grep [خيار]... نمط [ملف]...

البحث في مراجعات الملفات عن التعبير العادي.

يتصرف هذا الأمر بشكل مختلف عن Unix grep. إنه يقبل فقط regexps Python/Perl. هو - هي
يبحث في تاريخ المستودع، وليس دليل العمل. يقوم دائمًا بطباعة المراجعة
الرقم الذي تظهر فيه المباراة.

افتراضيًا، يطبع grep فقط مخرجات المراجعة الأولى للملف الذي يجد فيه ملف
مباراة. لجعله يطبع كل مراجعة تحتوي على تغيير في حالة المطابقة ("-" لـ a
المطابقة التي تصبح غير مطابقة، أو "+" للمطابقة غير المطابقة التي تصبح مطابقة)، استخدم
--كل العلم.

إرجاع 0 إذا تم العثور على تطابق، 1 خلاف ذلك.

خيارات:

-0، --print0
نهاية الحقول بـ NUL

--الكل طباعة جميع المراجعات المطابقة

-a، --نص
التعامل مع جميع الملفات كنص

-F، --إتبع
اتبع سجل التغييرات، أو سجل الملف عبر النسخ وإعادة التسمية

-أنا، - أقل من حالة
تجاهل الحالة عند المطابقة

-ل ، - ملفات مع مباريات
طباعة أسماء الملفات والمراجعات المطابقة فقط

-ن، --رقم السطر
طباعة أرقام الأسطر المطابقة

-r ،--ريف
تم تغيير ملفات البحث فقط ضمن نطاق المراجعة

-u ، --المستعمل
قائمة المؤلف (طويلة مع -v)

-د، --تاريخ
قم بإدراج التاريخ (قصير مع -q)

-أنا،--يشمل
تضمين أسماء مطابقة للأنماط المحددة

-X ،- استثناء
استبعاد الأسماء المطابقة للأنماط المحددة

[+] يمكن تحديد الخيار المحدد عدة مرات

رأس
إظهار رؤساء الفروع:

رؤوس الزئبق [-ct] [-r STARTREV] [REV]...

بدون وسائط، قم بإظهار جميع رؤوس الفروع المفتوحة في المستودع. رؤساء الفروع هم
مجموعات التغييرات التي ليس لها أحفاد في نفس الفرع. هم حيث التنمية
تحدث بشكل عام وهي الأهداف المعتادة لعمليات التحديث والدمج.

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

إذا تم تحديد -c/--clod، فاعرض أيضًا رؤوس الفروع المميزة بعلامة "مغلق" (انظر hg ارتكاب
- فرع قريب).

إذا تم تحديد STARTREV، فسيتم تحديد تلك الرؤوس التي تنحدر من STARTREV فقط
عرض.

إذا تم تحديد -t/--topo، فسيتم تجاهل آليات الفرع المسماة وسيتم تجاهلها فقط
سيتم عرض الرؤوس (مجموعات التغيير بدون أي أطفال).

يُرجع 0 إذا تم العثور على رؤوس متطابقة، ويعيد 1 إذا لم يكن كذلك.

خيارات:

-r ،--ريف
إظهار الرؤوس فقط التي هي من نسل ستارتريف

-t ، - توبو
إظهار الرؤوس الطوبولوجية فقط

-a، --نشيط
إظهار رؤوس الفروع النشطة فقط (مهملة)

-c ، --مغلق
إظهار رؤوس الفروع العادية والمغلقة

--نمط
العرض باستخدام ملف خريطة القالب (مهمل)

-T ،--نموذج
عرض مع القالب

مساعدة
إظهار المساعدة لموضوع معين أو نظرة عامة على المساعدة:

مساعدة hg [-ecks] [TOPIC]

بدون أي وسيطات، قم بطباعة قائمة الأوامر مع رسائل المساعدة القصيرة.

بالنظر إلى موضوع أو ملحق أو اسم أمر، قم بطباعة التعليمات الخاصة بهذا الموضوع.

إرجاع 0 إذا نجحت.

خيارات:

-e، --تمديد
إظهار المساعدة للملحقات فقط

-c ، --أمر
إظهار المساعدة للأوامر فقط

-ك، --كلمة رئيسية
إظهار المواضيع المطابقة للكلمات الرئيسية

-س،--النظام
إظهار المساعدة لمنصة (منصات) محددة

[+] يمكن تحديد الخيار المحدد عدة مرات

تحديد
تحديد دليل العمل أو المراجعة المحددة:

تحديد الزئبق [-nibtB] [-r REV] [المصدر]

اطبع ملخصًا يحدد حالة المستودع في REV باستخدام تجزئة أصل واحدة أو اثنتين
المعرفات، تليها "+" إذا كان دليل العمل يحتوي على تغييرات متاحة، فإن
اسم الفرع (إن لم يكن الافتراضي)، وقائمة العلامات، وقائمة الإشارات المرجعية.

عندما لا يتم توفير REV، قم بطباعة ملخص للحالة الحالية للمستودع.

سيؤدي تحديد مسار إلى جذر المستودع أو حزمة Mercurial إلى تشغيل البحث
هذا المستودع/الحزمة.

أمثلة:

· إنشاء معرف بناء لدليل العمل:

معرف الزئبق --id> build-id.dat

· ابحث عن المراجعة المقابلة للعلامة:

معرف الزئبق -n -r 1.3

· التحقق من أحدث مراجعة للمستودع البعيد:

معرف الزئبق -r نصيحة http://selenic.com/hg/

يرى hg سجل لتوليد المزيد من المعلومات حول مراجعات محددة، بما في ذلك التجزئة الكاملة
معرفات.

إرجاع 0 إذا نجحت.

خيارات:

-r ،--ريف
تحديد المراجعة المحددة

-ن، - العدد
إظهار رقم المراجعة المحلي

-أنا، --هوية شخصية
إظهار معرف المراجعة العالمية

-ب، --فرع
إظهار الفرع

-t ، - العلامات
أضهر العلامات

-ب، --إشارات مرجعية
إظهار الإشارات المرجعية

-e،--SSH
تحديد أمر ssh للاستخدام

--remotecmd
حدد الأمر hg ليتم تشغيله على الجانب البعيد

--غير آمن
لا تتحقق من شهادة الخادم (تجاهل تكوين web.cacerts)

الأسماء المستعارة: معرف

استيراد
استيراد مجموعة مرتبة من التصحيحات:

استيراد الزئبق [الخيار]...التصحيح...

قم باستيراد قائمة التصحيحات وتنفيذها بشكل فردي (ما لم يتم تحديد --no-commit).

لقراءة تصحيح من الإدخال القياسي، استخدم "-" كاسم التصحيح. إذا تم تحديد عنوان URL، فإن
سيتم تنزيل التصحيح من هناك.

يطبق الاستيراد أولاً التغييرات على دليل العمل (ما لم يتم تحديد --bypass)،
سيتم إحباط الاستيراد إذا كانت هناك تغييرات معلقة.

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

يمكنك استيراد تصحيح مباشرة من رسالة بريد. حتى التصحيحات كمرفقات تعمل (إلى
استخدم الجزء الأساسي، ويجب أن يكون من النوع text/plain أو text/x-patch). من ورؤوس الموضوع
من رسائل البريد الإلكتروني يتم استخدامها كرسالة التزام ورسالة التزام افتراضية. كل النص/نص عادي
تتم إضافة الأجزاء قبل الفرق الأول إلى رسالة الالتزام.

إذا تم إنشاء التصحيح المستورد بواسطة hg تصديروالمستخدم والوصف من تجاوز التصحيح
القيم من رؤوس الرسائل والنص. القيم المعطاة في سطر الأوامر مع -m/--message و
-u/--تجاوز المستخدم هذه.

إذا تم تحديد --exact، فسيقوم import بتعيين دليل العمل إلى أصل كل تصحيح
قبل تطبيقه، وسيتم إحباطه إذا كانت مجموعة التغييرات الناتجة لها معرف مختلف عن معرف
واحد مسجل في التصحيح. قد يحدث هذا بسبب مشاكل في مجموعة الأحرف أو غيرها
أوجه القصور في تنسيق تصحيح النص.

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

ملاحظة: عندما لا يتم وضع أي كتل بشكل نظيف، hg استيراد --جزئي سيتم إنشاء مجموعة تغييرات فارغة،
استيراد بيانات تعريف التصحيح فقط.

باستخدام -s/--similarity، سيحاول hg اكتشاف إعادة التسمية والنسخ في التصحيح في ملف
بنفس الطريقة مثل hg اضف احذف.

من الممكن استخدام برامج التصحيح الخارجية لإجراء التصحيح عن طريق تعيين ui.patch
خيار التكوين. بالنسبة للأداة الداخلية الافتراضية، يمكن أيضًا تكوين الزغب عبر
patch.fuzz. شاهد hg مساعدة التكوين لمزيد من المعلومات حول ملفات التكوين وكيفية القيام بذلك
استخدم هذه الخيارات.

يرى hg مساعدة التمور للحصول على قائمة التنسيقات الصالحة لـ -d/--date.

أمثلة:

· استيراد التصحيح التقليدي من موقع على شبكة الإنترنت والكشف عن إعادة التسمية:

استيراد الزئبق - 80 http://example.com/bugfix.patch

· استيراد مجموعة التغييرات من خادم hgweb:

استيراد الزئبق http://www.selenic.com/hg/rev/5ca8c111e9aa

· استيراد كافة التصحيحات في mbox على غرار يونكس:

hg import incoming-patches.mbox

· محاولة استعادة مجموعة التغييرات التي تم تصديرها (ليس ذلك ممكنًا دائمًا):

استيراد hg --fix.patch المقترح بالضبط

· استخدم أداة خارجية لتطبيق تصحيح غامض للغاية بالنسبة للأداة الداخلية الافتراضية.

hg import --config ui.patch="patch --merge" fuzzy.patch

· تغيير التشويش الافتراضي من 2 إلى 7 أقل صرامة

hg import --config ui.fuzz=7 fuzz.patch

يُرجع 0 عند النجاح، و1 عند النجاح الجزئي (انظر --جزئي).

خيارات:

-p ،--قطاع
خيار شريط الدليل للتصحيح. وهذا له نفس معنى المقابل
خيار التصحيح (الافتراضي: 1)

-ب،--يتمركز
المسار الأساسي (مهمل)

-e، --تعديل
استدعاء المحرر على رسائل الالتزام

-F، --فرض
تخطي التحقق من التغييرات المعلقة غير الملتزم بها (مهملة)

- لا تلتزم
لا تلتزم، فقط قم بتحديث دليل العمل

--تجاوز
تطبيق التصحيح دون لمس دليل العمل

--جزئي
الالتزام حتى لو فشلت بعض الكتل

- بالضبط
قم بتطبيق التصحيح على العقد التي تم إنشاؤه منها

--اختصار
تطبيق التصحيح على الدليل الفرعي

--import-فرع
استخدم أي معلومات فرعية في التصحيح (ضمنيًا بواسطة --exact)

م ،--رسالة
استخدم النص كرسالة التزام

-ل ،--ملف تسجيل
قراءة رسالة الالتزام من الملف

-د،--تاريخ
سجل التاريخ المحدد كتاريخ الالتزام

-u ،--المستعمل
تسجيل المستخدم المحدد كملتزم

-س،--تشابه
تخمين الملفات المعاد تسميتها حسب التشابه (0<=s<=100)

الأسماء المستعارة: التصحيح

الوارد
إظهار مجموعات التغييرات الجديدة الموجودة في المصدر:

hg الوارد [-p] [-n] [-M] [-f] [-r REV]... [--bundle FILENAME] [المصدر]

إظهار مجموعات التغييرات الجديدة الموجودة في المسار/عنوان URL المحدد أو موقع السحب الافتراضي. هؤلاء
هي مجموعات التغييرات التي كان من الممكن سحبها في حالة السحب في الوقت الذي أصدرت فيه هذا
أمر.

راجع السحب للحصول على تفاصيل تنسيق المصدر الصالح.

باستخدام -B/--bookmarks، نتيجة مقارنة الإشارات المرجعية بين المحلية والبعيدة
يتم عرض المستودعات. باستخدام -v/--verbose، يتم أيضًا عرض الحالة لكل إشارة مرجعية
مثل أدناه:

تمت إضافة BM1 01234567890a
BM2 1234567890ab متقدم
تباعدت BM3 234567890abc
تم تغيير BM4 34567890abcd

يعتمد الإجراء المتخذ محليًا عند السحب على حالة كل إشارة مرجعية:

وأضاف

السحب سوف ينشئه

متقدم

سوف يقوم السحب بتحديثه

تباعدوا

سيؤدي السحب إلى إنشاء إشارة مرجعية متباينة

غير

تعتمد النتيجة على مجموعات التغيير عن بعد

من وجهة نظر سحب السلوك، المرجعية الموجودة فقط في جهاز التحكم عن بعد
يتم التعامل مع المستودع على أنه وأضاف، حتى لو تم حذفه محليًا بالفعل.

بالنسبة للمستودع البعيد، يؤدي استخدام --bundle إلى تجنب تنزيل مجموعات التغييرات مرتين إذا كان
الوارد يتبعه سحب.

أمثلة:

· عرض التغييرات الواردة مع التصحيحات والوصف الكامل:

زئبق واردة -vp

· إظهار التغييرات الواردة باستثناء عمليات الدمج، وتخزين حزمة:

hg in -vpM --bundle incoming.hg
زئبق سحب incoming.hg

· قائمة مختصرة بالتغييرات داخل الحزمة:

hg في التغييرات.hg -T "{desc|السطر الأول}\n"

يُرجع 0 إذا كانت هناك تغييرات واردة، ويعيد 1 بخلاف ذلك.

خيارات:

-F، --فرض
تشغيل حتى لو كان المستودع البعيد غير ذي صلة

-ن، --الأحدث أولاً
إظهار أحدث سجل أولا

--باقة
ملف لتخزين الحزم فيه

-r ،--ريف
مجموعة تغييرات عن بعد مخصصة لإضافتها

-ب، --إشارات مرجعية
مقارنة الإشارات المرجعية

-ب،--فرع
فرع معين ترغب في سحبه

-p ، --رقعة قماشية
إظهار التصحيح

-g ، --شخص سخيف
استخدم تنسيق git Extended diff

-ل ،--حد
الحد من عدد التغييرات المعروضة

-M ، - لا دمج
لا تظهر عمليات الدمج

- إحصائيات إخراج ملخص للتغييرات على غرار diffstat

-G ، --رسم بياني
إظهار المراجعة DAG

--نمط
العرض باستخدام ملف خريطة القالب (مهمل)

-T ،--نموذج
عرض مع القالب

-e،--SSH
تحديد أمر ssh للاستخدام

--remotecmd
حدد الأمر hg ليتم تشغيله على الجانب البعيد

--غير آمن
لا تتحقق من شهادة الخادم (تجاهل تكوين web.cacerts)

-س، --subrepos
يتكرر في المستودعات الفرعية

[+] يمكن تحديد الخيار المحدد عدة مرات

الأسماء المستعارة: في

الحرف الأول
قم بإنشاء مستودع جديد في الدليل المحدد:

hg init [-e CMD] [--remotecmd CMD] [DEST]

قم بتهيئة مستودع جديد في الدليل المحدد. إذا كان الدليل المحدد غير موجود،
سيتم إنشاؤه.

إذا لم يتم توفير أي دليل، فسيتم استخدام الدليل الحالي.

من الممكن تحديد ssh: // URL كوجهة. يرى hg مساعدة عناوين المواقع لمزيد من
معلومات.

يعود 0 على النجاح.

خيارات:

-e،--SSH
تحديد أمر ssh للاستخدام

--remotecmd
حدد الأمر hg ليتم تشغيله على الجانب البعيد

--غير آمن
لا تتحقق من شهادة الخادم (تجاهل تكوين web.cacerts)

حدد
تحديد موقع الملفات المطابقة لأنماط معينة (تم إهمالها):

hg حدد موقع [الخيار]... [النمط]...

اطبع الملفات الخاضعة للتحكم Mercurial في دليل العمل الذي تتطابق أسماؤه مع المعطى
أنماط - رسم.

افتراضيًا، يبحث هذا الأمر في كافة الدلائل الموجودة في دليل العمل. للبحث فقط
الدليل الحالي وأدلته الفرعية، استخدم "--include .".

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

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

يرى hg مساعدة ملفات للحصول على أمر أكثر تنوعا.

إرجاع 0 إذا تم العثور على تطابق، 1 خلاف ذلك.

خيارات:

-r ،--ريف
ابحث في المستودع كما هو في REV

-0، --print0
نهاية أسماء الملفات بـ NUL، للاستخدام مع xargs

-F، --مسار كامل
طباعة المسارات الكاملة من جذر نظام الملفات

-أنا،--يشمل
تضمين أسماء مطابقة للأنماط المحددة

-X ،- استثناء
استبعاد الأسماء المطابقة للأنماط المحددة

[+] يمكن تحديد الخيار المحدد عدة مرات

سجل
إظهار سجل المراجعة للمستودع أو الملفات بأكملها:

سجل الزئبق [خيار]... [ملف]

طباعة تاريخ المراجعة للملفات المحددة أو المشروع بأكمله.

إذا لم يتم تحديد نطاق مراجعة، يكون النطاق الافتراضي هو نصيحة:0 ما لم يتم تعيين --follow، حيث
في حالة استخدام أصل دليل العمل كمراجعة البداية.

يتم عرض محفوظات الملفات دون متابعة إعادة تسمية أو نسخ محفوظات الملفات. استخدم -f/--follow
باستخدام اسم ملف لمتابعة السجل عبر عمليات إعادة التسمية والنسخ. --follow بدون اسم ملف
سيُظهر فقط أسلاف أو أحفاد المراجعة الأولية.

افتراضيًا، يقوم هذا الأمر بطباعة رقم المراجعة ومعرف مجموعة التغييرات والعلامات وغير التافهة
الوالدين والمستخدم والتاريخ والوقت وملخص لكل التزام. عند التبديل -v/--verbose
يتم استخدام، وتظهر قائمة الملفات التي تم تغييرها ورسالة الالتزام الكاملة.

باستخدام --graph، يتم عرض المراجعات على هيئة ASCII art DAG مع أحدث التغييرات في
الأعلى. "o" عبارة عن مجموعة تغييرات، و"@" هو أصل دليل العمل، و"x" قديم، و"+"
يمثل شوكة حيث تكون مجموعة التغييرات من الأسطر أدناه هي الأصل للدمج "o".
نفس الخط.

ملاحظات hg سجل --رقعة قماشية قد ينشئ مخرجات فرق غير متوقعة لدمج مجموعات التغييرات، كما سيحدث
قم فقط بمقارنة مجموعة تغييرات الدمج مع أصلها الأول. أيضا، الملفات فقط
سيظهر مختلف عن كلا الوالدين في الملفات:.

ملاحظة: لأسباب تتعلق بالأداء، hg سجل FILE قد يحذف التغييرات المكررة التي تم إجراؤها على الفروع
ولن تظهر عمليات الإزالة أو تغييرات الوضع. لرؤية كل هذه التغييرات، استخدم
--إزالة التبديل.

بعض الأمثلة:

· مجموعات التغييرات مع الأوصاف الكاملة وقوائم الملفات:

سجل الزئبق -v

· مجموعات التغييرات السلفية لدليل العمل:

سجل الزئبق -f

· آخر 10 التزامات على الفرع الحالي:

سجل الزئبق -l 10 -ب .

· مجموعات التغييرات تظهر كافة تعديلات الملف، بما في ذلك عمليات الإزالة:

سجل hg - تمت إزالة الملف.c

· جميع مجموعات التغييرات التي تمس الدليل، مع الاختلافات، باستثناء عمليات الدمج:

سجل hg -Mp lib/

· جميع أرقام المراجعة التي تطابق الكلمة الرئيسية:

خطأ hg log -k --قالب "{rev}\n"

· معرف التجزئة الكامل لأصل دليل العمل:

سجل الزئبق -r . --قالب "{عقدة}\n"

· قائمة قوالب السجل المتاحة:

قائمة سجل الزئبق -T

· تحقق مما إذا كانت مجموعة التغييرات المحددة مدرجة في إصدار موسوم:

hg log -r "a21ccf والسلف (1.9)"

· ابحث عن جميع مجموعات التغييرات التي أجراها بعض المستخدمين في نطاق زمني:

hg log -k alice -d "من مايو 2008 إلى يوليو 2008"

· ملخص لجميع مجموعات التغييرات بعد العلامة الأخيرة:

hg log -r "last(tagged())::" --template "{desc|firstline}\n"

يرى hg مساعدة التمور للحصول على قائمة التنسيقات الصالحة لـ -d/--date.

يرى hg مساعدة المراجعات و hg مساعدة revsets لمزيد من المعلومات حول التحديد والطلب
التنقيحات.

يرى hg مساعدة النماذج لمزيد من المعلومات حول الأنماط المعبأة مسبقًا وتحديد القوالب المخصصة.

يعود 0 على النجاح.

خيارات:

-F، --إتبع
اتبع سجل التغييرات، أو سجل الملف عبر النسخ وإعادة التسمية

--follow-first
اتبع فقط الأصل الأول لمجموعات تغييرات الدمج (مهملة)

-د،--تاريخ
إظهار المراجعات المطابقة لمواصفات التاريخ

-C ، - نُسخ
إظهار الملفات المنسوخة

-ك،--كلمة رئيسية
قم بإجراء بحث غير حساس لحالة الأحرف عن نص معين

-r ،--ريف
إظهار المراجعة أو المراجعة المحددة

--إزالة
تضمين المراجعات حيث تمت إزالة الملفات

م ، --فقط-يدمج
إظهار عمليات الدمج فقط (مهملة)

-u ،--المستعمل
المراجعات التي يرتكبها المستخدم

--فقط-فرع
إظهار مجموعات التغييرات فقط داخل الفرع المسمى المحدد (مهمل)

-ب،--فرع
إظهار مجموعات التغييرات داخل الفرع المحدد المحدد

-P ،--تقليم
لا تعرض المراجعة أو أي من أسلافها

-p ، --رقعة قماشية
إظهار التصحيح

-g ، --شخص سخيف
استخدم تنسيق git Extended diff

-ل ،--حد
الحد من عدد التغييرات المعروضة

-M ، - لا دمج
لا تظهر عمليات الدمج

- إحصائيات إخراج ملخص للتغييرات على غرار diffstat

-G ، --رسم بياني
إظهار المراجعة DAG

--نمط
العرض باستخدام ملف خريطة القالب (مهمل)

-T ،--نموذج
عرض مع القالب

-أنا،--يشمل
تضمين أسماء مطابقة للأنماط المحددة

-X ،- استثناء
استبعاد الأسماء المطابقة للأنماط المحددة

[+] يمكن تحديد الخيار المحدد عدة مرات

الأسماء المستعارة: التاريخ

واضح
إخراج المراجعة الحالية أو المعطاة لبيان المشروع:

بيان الزئبق [-r REV]

اطبع قائمة بالملفات التي يتم التحكم في إصدارها للمراجعة المحددة. إذا لم يتم إعطاء أي مراجعة،
يتم استخدام الأصل الأول لدليل العمل، أو المراجعة الفارغة في حالة عدم وجود مراجعة
فحصت.

باستخدام -v، يمكنك طباعة أذونات الملفات والارتباط الرمزي والبتات القابلة للتنفيذ. باستخدام --debug، قم بطباعة الملف
تجزئة المراجعة.

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

يعود 0 على النجاح.

خيارات:

-r ،--ريف
المراجعة للعرض

--الكل قائمة الملفات من كافة المراجعات

-T ،--نموذج
عرض مع القالب (تجريبي)

دمج
دمج مراجعة أخرى في دليل العمل:

دمج الزئبق [-P] [[-r] REV]

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

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

--أداة يمكن استخدامها لتحديد أداة الدمج المستخدمة لدمج الملفات. إنه يتجاوز
متغير البيئة HGMERGE وملفات التكوين الخاصة بك. يرى hg مساعدة أدوات الدمج For
خيارات.

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

يرى hg مساعدة حل للحصول على معلومات حول التعامل مع تعارضات الملفات.

للتراجع عن عملية دمج غير ملتزم بها، استخدم hg تحديث --ينظف . والتي سوف تحقق من نسخة نظيفة من
أصل الدمج الأصلي، مع فقدان كافة التغييرات.

يُرجع 0 عند النجاح، و1 إذا كانت هناك ملفات لم يتم حلها.

خيارات:

-F، --فرض
فرض الدمج بما في ذلك التغييرات المعلقة (مهملة)

-r ،--ريف
مراجعة للدمج

-P ، --معاينة
مراجعة المراجعات للدمج (لم يتم إجراء أي دمج)

-t ،--أداة
تحديد أداة الدمج

المنتهية ولايته
إظهار مجموعات التغييرات غير الموجودة في الوجهة:

hg الصادرة [-M] [-p] [-n] [-f] [-r REV]... [DEST]

إظهار مجموعات التغييرات غير الموجودة في مستودع الوجهة المحدد أو الدفع الافتراضي
موقع. هذه هي مجموعات التغييرات التي سيتم دفعها إذا تم طلب الدفع.

راجع السحب للحصول على تفاصيل تنسيقات الوجهة الصالحة.

باستخدام -B/--bookmarks، نتيجة مقارنة الإشارات المرجعية بين المحلية والبعيدة
يتم عرض المستودعات. باستخدام -v/--verbose، يتم أيضًا عرض الحالة لكل إشارة مرجعية
مثل أدناه:

تمت إضافة BM1 01234567890a
تم حذف BM2
BM3 234567890abc المتقدمة
تباعدت BM4 34567890abcd
تم تغيير BM5 4567890abcde

يعتمد الإجراء المتخذ عند الدفع على حالة كل إشارة مرجعية:

وأضاف

ادفع مع -B سوف نقوم بإنشائه

تم الحذف

ادفع مع -B سوف تحذفه

متقدم

سوف يقوم Push بتحديثه

تباعدوا

ادفع مع -B سيتم تحديثه

غير

ادفع مع -B سيتم تحديثه

من وجهة نظر سلوك الدفع، فإن الإشارات المرجعية موجودة فقط في جهاز التحكم عن بعد
يتم التعامل مع المستودع على أنه تم الحذف، حتى لو تمت إضافتها عن بعد.

يُرجع 0 إذا كانت هناك تغييرات صادرة، ويعيد 1 بخلاف ذلك.

خيارات:

-F، --فرض
تشغيل حتى عندما تكون الوجهة غير ذات صلة

-r ،--ريف
مجموعة تغييرات مخصصة ليتم تضمينها في الوجهة

-ن، --الأحدث أولاً
إظهار أحدث سجل أولا

-ب، --إشارات مرجعية
مقارنة الإشارات المرجعية

-ب،--فرع
فرع معين ترغب في دفعه

-p ، --رقعة قماشية
إظهار التصحيح

-g ، --شخص سخيف
استخدم تنسيق git Extended diff

-ل ،--حد
الحد من عدد التغييرات المعروضة

-M ، - لا دمج
لا تظهر عمليات الدمج

- إحصائيات إخراج ملخص للتغييرات على غرار diffstat

-G ، --رسم بياني
إظهار المراجعة DAG

--نمط
العرض باستخدام ملف خريطة القالب (مهمل)

-T ،--نموذج
عرض مع القالب

-e،--SSH
تحديد أمر ssh للاستخدام

--remotecmd
حدد الأمر hg ليتم تشغيله على الجانب البعيد

--غير آمن
لا تتحقق من شهادة الخادم (تجاهل تكوين web.cacerts)

-س، --subrepos
يتكرر في المستودعات الفرعية

[+] يمكن تحديد الخيار المحدد عدة مرات

الأسماء المستعارة: خارج

الآباء
إظهار أصول دليل العمل أو المراجعة (مهملة):

الآباء الزئبق [-r REV] [ملف]

اطبع المراجعات الأصلية لدليل العمل. إذا تم تقديم المراجعة عبر -r/--rev، فإن
ستتم طباعة أصل تلك المراجعة. إذا تم إعطاء وسيطة ملف، فستتم المراجعة في
الذي تم تغيير الملف فيه آخر مرة (قبل مراجعة دليل العمل أو الوسيطة
--rev إذا تم تقديمه) تتم طباعته.

هذا الأمر يعادل:

hg log -r "p1()+p2()" أو
hg log -r "p1(REV)+p2(REV)" أو
hg log -r "max(::p1() and file(FILE))+max(::p2() and file(FILE))" أو
hg log -r "max(::p1(REV) وfile(FILE))+max(::p2(REV) وfile(FILE))"

يرى hg ملخص و hg مساعدة revsets للحصول على معلومات ذات صلة.

يعود 0 على النجاح.

خيارات:

-r ،--ريف
إظهار أولياء أمور المراجعة المحددة

--نمط
العرض باستخدام ملف خريطة القالب (مهمل)

-T ،--نموذج
عرض مع القالب

مسارات
إظهار الأسماء المستعارة للمستودعات البعيدة:

مسارات الزئبق [الاسم]

إظهار تعريف اسم المسار الرمزي NAME. إذا لم يتم ذكر اسم، قم بإظهار تعريف الكل
الأسماء المتاحة.

الخيار -q/--quiet يمنع كافة المخرجات عند البحث عن NAME ويظهر المسار فقط
الأسماء عند سرد جميع التعاريف.

يتم تعريف أسماء المسارات في قسم [المسارات] في ملف التكوين الخاص بك وفي
/etc/mercurial/hgrc. إذا تم تشغيله داخل مستودع، .hg/hgrc يستخدم أيضا.

أسماء المسار الافتراضي و الدفع الافتراضي لها معنى خاص. عند إجراء دفعة أو
عملية السحب، يتم استخدامها كإجراء احتياطي إذا لم يتم تحديد موقع على الملف
سطر الأوامر. متى الدفع الافتراضي تم ضبطه، وسيتم استخدامه للدفع و الافتراضي سوف يستخدم
للسحب؛ خلاف ذلك الافتراضي يتم استخدامه كاحتياطي لكليهما. عند استنساخ المستودع،
تتم كتابة مصدر النسخ كـ الافتراضي in .hg/hgrc.

ملاحظات الافتراضي و الدفع الافتراضي تنطبق على جميع الواردة (على سبيل المثال hg الوارد) والصادرة
(على سبيل المثال hg المنتهية ولايته, hg البريد الإلكتروني و hg حزمة) عمليات.

يرى hg مساعدة عناوين المواقع للمزيد من المعلومات.

يعود 0 على النجاح.

خيارات:

-T ،--نموذج
عرض مع القالب (تجريبي)

مرحلة جديدة
تعيين أو إظهار اسم المرحلة الحالية:

مرحلة الزئبق [-p|-d|-s] [-f] [-r] [REV...]

بدون وسيطة، قم بإظهار اسم المرحلة للمراجعة (المراجع) الحالية.

باستخدام أحد -p/--public أو -d/--draft أو -s/--secret، قم بتغيير قيمة الطور لـ
المراجعات المحددة.

ما لم يتم تحديد -f/--force، hg مرحلة جديدة لن يتم نقل مجموعة التغييرات من مرحلة أقل إلى مرحلة
مرحلة أعلى. يتم ترتيب المراحل على النحو التالي:

عامة <مسودة <سرية

يُرجع 0 عند النجاح، و1 إذا تعذر تغيير بعض المراحل.

(لمزيد من المعلومات حول مفهوم المراحل، راجع hg مساعدة المراحل.)

خيارات:

-p ، --عام
تعيين مرحلة التغييرات للعامة

-د، --مسودة
تعيين مرحلة التغييرات للمسودة

-س، --سر
اضبط مرحلة مجموعة التغييرات على السرية

-F، --فرض
السماح بتحريك الحدود إلى الخلف

-r ،--ريف
مراجعة الهدف

[+] يمكن تحديد الخيار المحدد عدة مرات

سحب
سحب التغييرات من المصدر المحدد:

hg pull [-u] [-f] [-r REV]... [-e CMD] [--remotecmd CMD] [المصدر]

سحب التغييرات من مستودع بعيد إلى مستودع محلي.

يؤدي هذا إلى العثور على جميع التغييرات من المستودع في المسار المحدد أو عنوان URL المحدد وإضافتها إلى ملف
المستودع المحلي (المستودع الحالي ما لم يتم تحديد -R). بشكل افتراضي، هذا لا يحدث
تحديث نسخة المشروع في دليل العمل.

استعمل hg الوارد إذا كنت تريد أن ترى ما كان يمكن إضافته عن طريق السحب في الوقت الذي قمت فيه
أصدر هذا الأمر. إذا قررت بعد ذلك إضافة هذه التغييرات إلى المستودع، فيجب عليك ذلك
تستخدم hg سحب -r X أين X هي آخر مجموعة تغييرات مدرجة بواسطة hg الوارد.

إذا تم حذف SOURCE، فسيتم استخدام المسار "الافتراضي". يرى hg مساعدة عناوين المواقع لمزيد من
معلومات.

يُرجع 0 عند النجاح، و1 إذا كان التحديث يحتوي على ملفات لم يتم حلها.

خيارات:

-u ، --تحديث
قم بالتحديث إلى رأس الفرع الجديد إذا تم سحب مجموعات التغييرات

-F، --فرض
تشغيل حتى عندما يكون المستودع البعيد غير مرتبط

-r ،--ريف
مجموعة تغييرات عن بعد مخصصة لإضافتها

-ب،- المرجعية
المرجعية لسحب

-ب،--فرع
فرع معين ترغب في سحبه

-e،--SSH
تحديد أمر ssh للاستخدام

--remotecmd
حدد الأمر hg ليتم تشغيله على الجانب البعيد

--غير آمن
لا تتحقق من شهادة الخادم (تجاهل تكوين web.cacerts)

[+] يمكن تحديد الخيار المحدد عدة مرات

دفع
دفع التغييرات إلى الوجهة المحددة:

hg Push [-f] [-r REV]... [-e CMD] [--remotecmd CMD] [DEST]

ادفع مجموعات التغييرات من المستودع المحلي إلى الوجهة المحددة.

هذه العملية متناظرة للسحب: فهي مطابقة للسحب في الوجهة
مستودع من الحالي.

افتراضيًا، لن يسمح الدفع بإنشاء رؤوس جديدة في الوجهة، نظرًا لأنها متعددة
الرؤوس ستجعل من غير الواضح أي رأس يجب استخدامه. في هذه الحالة، فمن المستحسن أن
سحب ودمج قبل الدفع.

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

ملاحظة: ينبغي توخي المزيد من الحذر عند استخدام الخيار -f/--force، الذي سيدفع كل ما هو جديد
رؤوس على جميع الفروع، وهو الإجراء الذي سيسبب دائمًا ارتباكًا له
المتعاونين.

إذا تم استخدام -r/--rev، فسيتم دفع المراجعة المحددة وجميع أسلافها إلى الملف
مستودع بعيد.

إذا تم استخدام -B/--bookmark، فستتم مراجعة المراجعة ذات الإشارة المرجعية المحددة وأسلافها و
سيتم دفع الإشارة المرجعية إلى المستودع البعيد.

يرجى الاطلاع على hg مساعدة عناوين المواقع للحصول على تفاصيل مهمة حول ssh: // عناوين URL. إذا كانت الوجهة هي
تم حذفه، سيتم استخدام المسار الافتراضي.

يُرجع 0 إذا كان الدفع ناجحًا، ويعيد 1 إذا لم يكن هناك شيء للدفع.

خيارات:

-F، --فرض
دفع القوة

-r ،--ريف
مجموعة تغييرات مخصصة ليتم تضمينها في الوجهة

-ب،- المرجعية
المرجعية لدفع

-ب،--فرع
فرع معين ترغب في دفعه

--فرع جديد
السماح بدفع فرع جديد

-e،--SSH
تحديد أمر ssh للاستخدام

--remotecmd
حدد الأمر hg ليتم تشغيله على الجانب البعيد

--غير آمن
لا تتحقق من شهادة الخادم (تجاهل تكوين web.cacerts)

[+] يمكن تحديد الخيار المحدد عدة مرات

استعادة
التراجع عن معاملة متقطعة:

زئبق التعافي

التعافي من الالتزام أو السحب المتقطع.

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

يُرجع 0 في حالة النجاح، و1 في حالة فشل أي شيء في استرداده أو التحقق منه.

إزالة
إزالة الملفات المحددة في الالتزام التالي:

hg إزالة [الخيار]... ملف...

جدولة الملفات المشار إليها لإزالتها من الفرع الحالي.

يقوم هذا الأمر بجدولة الملفات المراد إزالتها عند الالتزام التالي. للتراجع عن الإزالة
قبل ذلك، انظر hg العودة. للتراجع عن الملفات المضافة، راجع hg ننسى.

يمكن استخدام -A/--after لإزالة الملفات التي تم حذفها بالفعل فقط، ويمكن استخدام -f/--force
يمكن استخدامه لفرض الحذف، ويمكن استخدام -Af لإزالة الملفات من المراجعة التالية
دون حذفها من دليل العمل.

يوضح الجدول التالي سلوك الإزالة لحالات الملفات المختلفة (الأعمدة) و
مجموعات الخيارات (الصفوف). حالات الملف تمت إضافتها [A] وتنظيفها [C] وتعديلها [M] و
مفقود [!] (كما ورد في hg الحالة). الإجراءات هي التحذير والإزالة (من الفرع) و
حذف (من القرص):

┌────────────┬────┬────┬───┐
│ اختيار/حالة │ أ │ ج │ م │ ! │
├──────────┼───┼────┼────┼───┤
│ لا شيء │ دبليو │ آر دي │ دبليو │ آر │
├──────────┼───┼────┼────┼───┤
│-و │ آر │ آر دي │ آر دي │ آر │
├──────────┼───┼────┼────┼───┤
│-أ │ ث │ ث │ ث │ ص │
├──────────┼───┼────┼────┼───┤
│-أف │ ص │ ص │ ص │ ص │
└──────────┴───┴────┴────┴───┘

ملاحظات hg إزالة لا يقوم أبدًا بحذف الملفات في الحالة المضافة [A] من دليل العمل، وليس
حتى لو --فرض محدد.

يُرجع 0 عند النجاح، و1 في حالة مواجهة أي تحذيرات.

خيارات:

-أ، --بعد
سجل الحذف للملفات المفقودة

-F، --فرض
إزالة (وحذف) الملف حتى لو تمت إضافته أو تعديله

-س، --subrepos
يتكرر في المستودعات الفرعية

-أنا،--يشمل
تضمين أسماء مطابقة للأنماط المحددة

-X ،- استثناء
استبعاد الأسماء المطابقة للأنماط المحددة

[+] يمكن تحديد الخيار المحدد عدة مرات

الأسماء المستعارة: آر إم

إعادة تسمية
إعادة تسمية الملفات؛ ما يعادل نسخة + إزالة:

hg إعادة تسمية [الخيار]... المصدر... DEST

وضع علامة على الوجهة كنسخ من المصادر؛ وضع علامة على المصادر للحذف. إذا كان dest دليلاً، فسيتم نسخه
يتم وضعها في هذا الدليل. إذا كان dest ملفًا، فلا يمكن أن يكون هناك سوى مصدر واحد.

افتراضيًا، يقوم هذا الأمر بنسخ محتويات الملفات كما هي موجودة في العمل
الدليل. إذا تم استدعاؤها باستخدام -A/--after، فسيتم تسجيل العملية، ولكن لا يتم النسخ
نفذت.

يسري هذا الأمر عند الالتزام التالي. للتراجع عن إعادة تسمية قبل ذلك، راجع hg العودة.

يُرجع 0 عند النجاح، و1 إذا تمت مواجهة أخطاء.

خيارات:

-أ، --بعد
تسجيل إعادة تسمية حدثت بالفعل

-F، --فرض
النسخ القسري على ملف مُدار موجود

-أنا،--يشمل
تضمين أسماء مطابقة للأنماط المحددة

-X ،- استثناء
استبعاد الأسماء المطابقة للأنماط المحددة

-ن، --ركض جاف
لا تقم بتنفيذ أي إجراءات، فقط اطبع المخرجات

[+] يمكن تحديد الخيار المحدد عدة مرات

الأسماء المستعارة: نقل MV

حل
إعادة عمليات الدمج أو ضبط/عرض حالة دمج الملفات:

عزم عالي [خيار]... [ملف]...

غالبًا ما تكون عمليات الدمج مع التعارضات التي لم يتم حلها نتيجة الدمج غير التفاعلي باستخدام
داخلي: دمج إعداد التكوين، أو أداة دمج سطر الأوامر مثل فرق 3. العزم
يتم استخدام الأمر لإدارة الملفات المتضمنة في عملية الدمج، بعد ذلك hg دمج تم تشغيله، و
قبل hg ارتكاب يتم تشغيله (أي يجب أن يكون لدليل العمل أصلان). يرى hg مساعدة
أدوات الدمج للحصول على معلومات حول تكوين أدوات الدمج.

يمكن استخدام أمر الحل بالطرق التالية:

· hg حل [--أداة أداة] ملف...: محاولة إعادة دمج الملفات المحددة، والتخلص منها
أية محاولات دمج سابقة. لا يتم إجراء إعادة الدمج للملفات التي تم وضع علامة عليها بالفعل
تم الحل. يستخدم --الكل/-أ لتحديد كافة الملفات التي لم يتم حلها. --أداة يمكن استخدامها لتحديد
أداة الدمج المستخدمة للملفات المحددة. إنه يتجاوز متغير البيئة HGMERGE و
ملفات التكوين الخاصة بك. يتم حفظ محتويات الملف السابق بملف .الأصل لاحقة.

· hg حل -m [ملف]: وضع علامة على الملف على أنه قد تم حله (على سبيل المثال بعد حله يدويًا).
إصلاح الملفات). الافتراضي هو وضع علامة على كافة الملفات التي لم يتم حلها.

· hg حل -u [ملف]...: وضع علامة على الملف على أنه لم يتم حله. الافتراضي هو وضع علامة على كل ما تم حله
الملفات.

· hg حل -l: سرد الملفات التي كانت بها أو لا تزال بها تعارضات. وفي القائمة المطبوعة U =
لم يتم حلها و R = حل.

ملاحظة: لن يسمح لك Mercurial بإلزام الملفات التي بها تعارضات دمج لم يتم حلها. يجب عليك أن
تستخدم hg حل -m قبل أن تتمكن من الالتزام بعد عملية الدمج المتعارضة.

يُرجع 0 عند النجاح، و1 في حالة فشل أي ملف في محاولة الحل.

خيارات:

-a، --الكل
حدد كافة الملفات التي لم يتم حلها

-ل ، --قائمة
قائمة حالة الملفات التي تحتاج إلى الدمج

م ، --علامة
وضع علامة على الملفات على أنها تم حلها

-u ، --إلغاء العلامة
وضع علامة على الملفات على أنها لم يتم حلها

-ن، --لا توجد حالة
إخفاء بادئة الحالة

-t ،--أداة
تحديد أداة الدمج

-أنا،--يشمل
تضمين أسماء مطابقة للأنماط المحددة

-X ،- استثناء
استبعاد الأسماء المطابقة للأنماط المحددة

-T ،--نموذج
عرض مع القالب (تجريبي)

[+] يمكن تحديد الخيار المحدد عدة مرات

العودة
استعادة الملفات إلى حالة الخروج الخاصة بهم:

hg العودة [خيار]... [-r REV] [الاسم]...

ملاحظة للتحقق من المراجعات السابقة، يجب عليك استخدام hg تحديث REV. لإلغاء
الدمج المتاح (وتفقد التغييرات)، استخدم hg تحديث --ينظف ..

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

باستخدام الخيارات -r/--rev أو -d/--date، قم بإرجاع الملفات أو الأدلة المحددة إلى مجلداتها
تنص على مراجعة محددة. لأن العودة لا تغير دليل العمل
أيها الآباء، سيؤدي ذلك إلى ظهور هذه الملفات معدلة. قد يكون هذا مفيدًا في "التراجع"
بعض أو كل التغييرات السابقة. يرى hg تراجع للطريقة ذات الصلة.

يتم حفظ الملفات المعدلة بلاحقة .orig قبل العودة. لتعطيل هذه النسخ الاحتياطية،
استخدم --no-backup.

يرى hg مساعدة التمور للحصول على قائمة التنسيقات الصالحة لـ -d/--date.

يرى hg مساعدة تراجع عن طريقة لعكس تأثير مجموعة التغييرات السابقة.

يعود 0 على النجاح.

خيارات:

-a، --الكل
التراجع عن كافة التغييرات عند عدم تقديم أي وسائط

-د،--تاريخ
تاريخ مطابقة المراجعة القصوى

-r ،--ريف
العودة إلى المراجعة المحددة

-C ، --لا يوجد نسخة احتياطية
لا تقم بحفظ نسخ احتياطية من الملفات

-أنا، - تفاعلي
تحديد التغييرات بشكل تفاعلي (تجريبي)

-أنا،--يشمل
تضمين أسماء مطابقة للأنماط المحددة

-X ،- استثناء
استبعاد الأسماء المطابقة للأنماط المحددة

-ن، --ركض جاف
لا تقم بتنفيذ أي إجراءات، فقط اطبع المخرجات

[+] يمكن تحديد الخيار المحدد عدة مرات

العودة
التراجع عن المعاملة الأخيرة (خطيرة) (مهملة):

التراجع عن الزئبق

الرجاء استخدام hg ارتكاب --يعدل بدلاً من التراجع لتصحيح الأخطاء في الالتزام الأخير.

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

تُستخدم المعاملات لتغليف تأثيرات جميع الأوامر التي تنشئ أوامر جديدة
مجموعات التغييرات أو نشر مجموعات التغييرات الموجودة في المستودع.

على سبيل المثال، الأوامر التالية هي أوامر معاملات، ويمكن إرجاع تأثيراتها
الى الخلف:

· يقترف

· يستورد

· يحذب

· الدفع (مع هذا المستودع كوجهة)

· فك

لتجنب فقدان البيانات بشكل دائم، سوف يرفض التراجع عن معاملة الالتزام إذا حدث ذلك
لم يتم تسجيل الخروج. استخدم --force لتجاوز هذه الحماية.

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

يُرجع 0 عند النجاح، و1 في حالة عدم توفر بيانات التراجع.

خيارات:

-ن، --ركض جاف
لا تقم بتنفيذ أي إجراءات، فقط اطبع المخرجات

-F، --فرض
تجاهل تدابير السلامة

جذر
اطبع الجذر (العلوي) لدليل العمل الحالي:

جذر زئبق

اطبع الدليل الجذر للمستودع الحالي.

يعود 0 على النجاح.

خدمة
بدء تشغيل خادم ويب مستقل:

خدمة زئبق [الخيار]...

ابدأ تشغيل متصفح مستودع HTTP المحلي واسحب الخادم. يمكنك استخدام هذا للمشاركة المخصصة
وتصفح المستودعات. يوصى باستخدام خادم ويب حقيقي لخدمة
مستودع لفترات أطول من الزمن.

يرجى ملاحظة أن الخادم لا يطبق التحكم في الوصول. وهذا يعني أنه من خلال
افتراضيًا، يمكن لأي شخص القراءة من الخادم ولا يمكن لأحد الكتابة إليه افتراضيًا. تعيين
web.allow_push الخيار ل * للسماح للجميع بالدفع إلى الخادم. يجب عليك استخدام حقيقي
خادم الويب إذا كنت بحاجة إلى مصادقة المستخدمين.

افتراضيًا، يقوم الخادم بتسجيل الوصول إلى stdout والأخطاء إلى stderr. استخدم ال
-A/--accesslog و-E/--errorlog خيارات لتسجيل الدخول إلى الملفات.

لجعل الخادم يختار رقم منفذ مجاني للاستماع إليه، حدد رقم المنفذ 0؛ في
في هذه الحالة، سيقوم الخادم بطباعة رقم المنفذ الذي يستخدمه.

يعود 0 على النجاح.

خيارات:

-أ،--accesslog
اسم ملف سجل الوصول المراد الكتابة إليه

-د، - ديمون
تشغيل الخادم في الخلفية

--daemon-pipefds
يستخدم داخليًا بواسطة الوضع الخفي

-E ،- Errorlog
اسم ملف سجل الأخطاء المراد الكتابة إليه

-p ،--ميناء
منفذ للاستماع عليه (افتراضي: 8000)

-a،--عنوان
العنوان الذي سيتم الاستماع إليه (الافتراضي: جميع الواجهات)

--اختصار
مسار البادئة للعرض منه (الافتراضي: جذر الخادم)

-ن،--اسم
الاسم الذي سيتم عرضه في صفحات الويب (الافتراضي: دليل العمل)

--web-conf
اسم ملف التكوين hgweb (راجع "hg help hgweb")

--webdir-conf
اسم ملف التكوين hgweb (مهمل)

--ملف معرف
اسم الملف المراد كتابة معرف العملية إليه

--stdio
للعملاء البعيدين

--cmdserver
للعملاء البعيدين

-t ،- قوالب
قوالب الويب للاستخدام

--نمط
نمط القالب للاستخدام

-6، --ipv6
استخدم IPv6 بالإضافة إلى IPv4

--شهادة
ملف شهادة SSL

الحالة
إظهار الملفات التي تم تغييرها في دليل العمل:

حالة الزئبق [خيار]... [ملف]...

إظهار حالة الملفات في المستودع. إذا تم إعطاء الأسماء، فسيتم تقديم الملفات المطابقة فقط
هو مبين. الملفات النظيفة أو التي تم تجاهلها أو مصدر عملية النسخ/النقل ليست كذلك
مُدرج ما لم يتم تقديم -c/--clean أو -i/--ignored أو -C/--copies أو -A/--all. ما لم الخيارات
الموصوفة بـ "إظهار فقط ..."، يتم استخدام الخيارات -mardu.

الخيار -q/--quiet يخفي الملفات التي لم يتم تعقبها (غير المعروفة والمتجاهلة) ما لم يطلب ذلك صراحة
مع -u/--غير معروف أو -i/--متجاهل.

ملاحظات hg الحالة قد يبدو الأمر مختلفًا مع الاختلاف في حالة تغيير الأذونات أو الدمج
قد حدث. لا يُبلغ تنسيق الفرق القياسي عن تغييرات الأذونات والاختلافات
يُبلغ فقط عن التغييرات المتعلقة بأصل دمج واحد.

إذا تم إعطاء مراجعة واحدة، يتم استخدامها كمراجعة أساسية. إذا تم إعطاء تنقيحين،
وتظهر الاختلافات بينهما. يمكن أيضًا استخدام خيار --change كاختصار
لسرد الملفات التي تم تغييرها للمراجعة من أصلها الأول.

الرموز المستخدمة لإظهار حالة الملفات هي:

م = معدلة
أ= مضاف
ص = تمت إزالته
ج = نظيف
! = مفقود (تم حذفه بواسطة أمر غير hg، ولكن لا يزال يتم تتبعه)
؟ = لم يتم تعقبها
أنا = تجاهلت
= أصل الملف السابق (مع --نسخ)

أمثلة:

· إظهار التغييرات في دليل العمل بالنسبة لمجموعة التغييرات:

حالة الزئبق - المراجعة 9353

· إظهار التغييرات في دليل العمل بالنسبة للدليل الحالي (انظر hg مساعدة
أنماط للمزيد من المعلومات):

حالة الزئبق إعادة:

· إظهار كافة التغييرات بما في ذلك النسخ الموجودة في مجموعة التغييرات الموجودة:

حالة الزئبق - نسخ - تغيير 9353

· احصل على قائمة NUL مفصولة بالملفات المضافة، مناسبة لـ xargs:

حالة الزئبق -an0

يعود 0 على النجاح.

خيارات:

-أ، --الكل
إظهار حالة جميع الملفات

م ، --معدل
إظهار الملفات المعدلة فقط

-a، --أضيفت
إظهار الملفات المضافة فقط

-r ، --إزالة
إظهار الملفات المحذوفة فقط

-د، --تم الحذف
إظهار الملفات المحذوفة (لكن المتعقبة) فقط

-c ، --ينظف
إظهار الملفات فقط بدون تغييرات

-u ، --مجهول
إظهار الملفات غير المعروفة (غير المتعقبة) فقط

-أنا، - مُتجاهل
إظهار الملفات التي تم تجاهلها فقط

-ن، --لا توجد حالة
إخفاء بادئة الحالة

-C ، - نُسخ
إظهار مصدر الملفات المنسوخة

-0، --print0
نهاية أسماء الملفات بـ NUL، للاستخدام مع xargs

--ريف
إظهار الفرق من المراجعة

--يتغير
قائمة الملفات التي تم تغييرها للمراجعة

-أنا،--يشمل
تضمين أسماء مطابقة للأنماط المحددة

-X ،- استثناء
استبعاد الأسماء المطابقة للأنماط المحددة

-س، --subrepos
يتكرر في المستودعات الفرعية

-T ،--نموذج
عرض مع القالب (تجريبي)

[+] يمكن تحديد الخيار المحدد عدة مرات

الأسماء المستعارة: ش

ملخص
تلخيص حالة دليل العمل:

ملخص الزئبق [--عن بعد]

يؤدي هذا إلى إنشاء ملخص مختصر لحالة دليل العمل، بما في ذلك الوالدين والفرع
حالة الالتزام والمرحلة والتحديثات المتاحة.

باستخدام الخيار --remote، سيتحقق هذا من المسارات الافتراضية للوارد والصادر
التغييرات. هذا يمكن أن يكون مضيعة للوقت.

يعود 0 على النجاح.

خيارات:

--التحكم عن بعد
تحقق من الدفع والسحب

الأسماء المستعارة: المبلغ

بطاقة
أضف علامة واحدة أو أكثر للمراجعة الحالية أو المحددة:

علامة hg [-f] [-l] [-m TEXT] [-d DATE] [-u USER] [-r REV] الاسم...

قم بتسمية مراجعة معينة باستخدام .

تُستخدم العلامات لتسمية مراجعات معينة للمستودع وهي مفيدة جدًا
مقارنة المراجعات المختلفة، للعودة إلى الإصدارات السابقة الهامة أو لوضع علامة على الفرع
النقاط كإصدارات، وما إلى ذلك. عادةً ما يكون تغيير علامة موجودة غير مسموح به؛ استخدم -f/--force
لتجاوز.

إذا لم يتم تقديم أي مراجعة، فسيتم استخدام أصل دليل العمل.

لتسهيل التحكم في الإصدار وتوزيع ودمج العلامات، يتم تخزينها كملف
الملف المسمى ".hgtags" والذي تتم إدارته بشكل مشابه لملفات المشاريع الأخرى ويمكن أن يكون
تم تحريره يدويًا إذا لزم الأمر. وهذا يعني أيضًا أن وضع العلامات ينشئ التزامًا جديدًا. الملف
يتم استخدام ".hg/localtags" للعلامات المحلية (غير المشتركة بين المستودعات).

عادةً ما يتم تنفيذ عمليات الالتزام بالعلامة على رأس الفرع. إذا كان والد العامل
الدليل ليس رئيس فرع، hg بطاقة يجهض؛ استخدم -f/--force لفرض الالتزام بالعلامة
تكون مبنية على مجموعة تغييرات غير رئيسية.

يرى hg مساعدة التمور للحصول على قائمة التنسيقات الصالحة لـ -d/--date.

نظرًا لأن أسماء العلامات لها الأولوية على أسماء الفروع أثناء البحث عن المراجعة، باستخدام موجود
لا يُنصح باستخدام اسم الفرع كاسم علامة.

يعود 0 على النجاح.

خيارات:

-F، --فرض
علامة القوة

-ل ، --محلي
جعل العلامة محلية

-r ،--ريف
مراجعة للعلامة

--إزالة
إزالة العلامة

-e، --تعديل
استدعاء المحرر على رسائل الالتزام

م ،--رسالة
استخدم النص كرسالة التزام

-د،--تاريخ
سجل التاريخ المحدد كتاريخ الالتزام

-u ،--المستعمل
تسجيل المستخدم المحدد كملتزم

علامات
قائمة علامات المستودع:

علامات الزئبق

يسرد هذا العلامات العادية والمحلية. عند استخدام رمز التبديل -v/--verbose، يتم استخدام رمز التبديل الثالث
تتم طباعة العمود "المحلي" للعلامات المحلية. عند استخدام المفتاح -q/--quiet، سيظهر فقط
تتم طباعة اسم العلامة.

يعود 0 على النجاح.

خيارات:

-T ،--نموذج
عرض مع القالب (تجريبي)

معلومات سرية
إظهار مراجعة النصيحة (تم إهمالها):

نصيحة زئبق [-p] [-g]

مراجعة التلميح (عادةً ما تسمى فقط التلميح) هي مجموعة التغييرات التي تمت إضافتها مؤخرًا إلى ملف
المستودع (وبالتالي الرأس الذي تم تغييره مؤخرًا).

إذا كنت قد قمت للتو بالتزام، فسيكون هذا الالتزام هو النصيحة. إذا كنت قد سحبت للتو
من مستودع تخزين آخر، يصبح طرف هذا المستودع هو الطرف الحالي. ال
تعتبر علامة "tip" علامة خاصة ولا يمكن إعادة تسميتها أو تعيينها لمجموعة تغييرات مختلفة.

تم إهمال هذا الأمر، يرجى استخدامه hg رأس بدلا من ذلك.

يعود 0 على النجاح.

خيارات:

-p ، --رقعة قماشية
إظهار التصحيح

-g ، --شخص سخيف
استخدم تنسيق git Extended diff

--نمط
العرض باستخدام ملف خريطة القالب (مهمل)

-T ،--نموذج
عرض مع القالب

سيفصل
تطبيق واحد أو أكثر من ملفات مجموعة التغيير:

hg فك حزمة الملف [-u]...

قم بتطبيق واحد أو أكثر من ملفات مجموعة التغيير المضغوطة التي تم إنشاؤها بواسطة أمر الحزمة.

يُرجع 0 عند النجاح، و1 إذا كان التحديث يحتوي على ملفات لم يتم حلها.

خيارات:

-u ، --تحديث
قم بالتحديث إلى رأس الفرع الجديد إذا تم تفكيك مجموعات التغييرات

تحديث
تحديث دليل العمل (أو تبديل المراجعات):

تحديث hg [-c] [-C] [-d DATE] [[-r] REV]

قم بتحديث دليل عمل المستودع إلى مجموعة التغييرات المحددة. إذا لم يكن هناك تغييرات
المحدد، قم بالتحديث إلى طرف الفرع المسمى الحالي وانقل الإشارة المرجعية النشطة (انظر
hg مساعدة الإشارات المرجعية).

يقوم التحديث بتعيين المراجعة الأصلية لدليل العمل على مجموعة التغييرات المحددة (انظر hg
مساعدة الآباء).

إذا لم تكن مجموعة التغييرات سليلًا أو سلفًا لأصل دليل العمل، فسيتم تعيين
تم إحباط التحديث. باستخدام الخيار -c/--check، يتم التحقق من دليل العمل
التغييرات غير الملتزم بها؛ إذا لم يتم العثور على أي شيء، يتم تحديث دليل العمل إلى الدليل المحدد
التغييرات.

تنطبق القواعد التالية عندما يحتوي دليل العمل على تغييرات غير ملتزم بها:

1. إذا لم يتم تحديد -c/--check أو -C/--clean، وإذا كانت مجموعة التغييرات المطلوبة عبارة عن
سلف أو سليل أصل دليل العمل، فإن التغييرات المتاحة هي
تم دمجها في مجموعة التغييرات المطلوبة وتركت النتيجة المدمجة متاحة. إذا
مجموعة التغييرات المطلوبة ليست سلفًا أو سليلًا (أي أنها موجودة في ملف آخر
فرع)، يتم إحباط التحديث والحفاظ على التغييرات المتاحة.

2. باستخدام الخيار -c/--check، يتم إلغاء التحديث ويتم إلغاء التغييرات غير الملتزم بها
محفوظة.

3. باستخدام الخيار -C/--clean، يتم تجاهل التغييرات غير الملتزم بها ودليل العمل
يتم تحديثه إلى مجموعة التغييرات المطلوبة.

لإلغاء عملية دمج غير ملتزم بها (وخسارة تغييراتك)، استخدم hg تحديث --ينظف ..

استخدم null كمجموعة التغييرات لإزالة دليل العمل (مثل hg استنساخ -U).

إذا كنت تريد إرجاع ملف واحد فقط إلى نسخة أقدم، فاستخدم hg العودة [-ر القس] اسم.

يرى hg مساعدة التمور للحصول على قائمة التنسيقات الصالحة لـ -d/--date.

يُرجع 0 عند النجاح، و1 إذا كانت هناك ملفات لم يتم حلها.

خيارات:

-C ، --ينظف
تجاهل التغييرات غير الملتزم بها (بدون نسخة احتياطية)

-c ، --التحقق من
التحديث عبر الفروع في حالة عدم وجود تغييرات غير ملتزم بها

-د،--تاريخ
تاريخ مطابقة المراجعة القصوى

-r ،--ريف
تنقيح

-t ،--أداة
تحديد أداة الدمج

الأسماء المستعارة: up checkout co

تحقق من
التحقق من سلامة المستودع:

التحقق من زئبق

التحقق من سلامة المستودع الحالي.

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

يرجى الاطلاع على https://mercurial-scm.org/wiki/RepositoryCorruption لمزيد من المعلومات حول
التعافي من الفساد في المستودع.

يُرجع 0 عند النجاح، و1 إذا تمت مواجهة أخطاء.

الإصدار
نسخة الإخراج ومعلومات حقوق النشر:

نسخة زئبق

نسخة الإخراج ومعلومات حقوق النشر

تاريخ صيغ

تسمح بعض الأوامر للمستخدم بتحديد تاريخ، على سبيل المثال:

· التراجع، الالتزام، الاستيراد، العلامة: حدد تاريخ الالتزام.

· السجل، العودة، التحديث: حدد المراجعة (المراجعة) حسب التاريخ.

العديد من تنسيقات التاريخ صالحة. وهنا بعض الأمثلة:

· Wed ديسمبر 6 13:18:29 2006 (يفترض المنطقة الزمنية المحلية)

· ديسمبر 6 13:18 -0600 (السنة المفترضة، تعويض الوقت المقدم)

· ديسمبر 6 13:18 بالتوقيت العالمي (UTC وGMT هما أسماء مستعارة لـ +0000)

· ديسمبر 6 (منتصف الليل)

· 13:18 (المفترض اليوم)

· 3:39 (3:39 صباحًا يفترض)

· 3: 39pm (شنومكس: شنومكس)

· 2006-12-06 13:18:29 (تنسيق ايزو 8601)

· 2006-12-6 13:18

· 2006-12-6

· 12-6

· 12/6

· 12/6/6 (6 ديسمبر 2006)

· اليوم (منتصف الليل)

· أمس (منتصف الليل)

· الآن - الآن

وأخيرًا، هناك التنسيق الداخلي لـ Mercurial:

· 1165411109 0 (الأربعاء 6 ديسمبر 13:18:29 2006 بالتوقيت العالمي)

هذا هو تنسيق التمثيل الداخلي للتواريخ. الرقم الأول هو عدد
ثانية منذ العصر (1970-01-01 00:00 بالتوقيت العالمي). والثاني هو إزاحة المحلية
المنطقة الزمنية، بالثواني غرب التوقيت العالمي المنسق (سالب إذا كانت المنطقة الزمنية شرق التوقيت العالمي المنسق).

يقبل أمر السجل أيضًا النطاقات الزمنية:

· <DATE - في أو قبل تاريخ/وقت معين

· > التاريخ - في أو بعد تاريخ/وقت معين

· تاريخ إلى تاريخ - نطاق زمني شامل

· -أيام - خلال عدد معين من الأيام من اليوم

مهرجان دبي السينمائي الدولي صيغ

التنسيق الافتراضي لـ Mercurial لعرض التغييرات بين نسختين من الملف هو
متوافق مع التنسيق الموحد لـ GNU diff، والذي يمكن استخدامه بواسطة GNU patch وغيرها الكثير
الأدوات القياسية الأخرى.

على الرغم من أن هذا التنسيق القياسي غالبًا ما يكون كافيًا، إلا أنه لا يقوم بتشفير المعلومات التالية:

· الحالة القابلة للتنفيذ وبتات الإذن الأخرى

· نسخ أو إعادة تسمية المعلومات

· التغيرات في الملفات الثنائية

· إنشاء أو حذف الملفات الفارغة

يدعم Mercurial أيضًا تنسيق الفرق الممتد من git VCS الذي يعالج هذه التنسيقات
محددات. لا يتم إنشاء تنسيق git diff افتراضيًا بسبب وجود عدد قليل من الأدوات المنتشرة
ما زلت لا أفهم هذا الشكل.

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

لجعل Mercurial ينتج تنسيق git Extended diff، استخدم خيار --git المتاح لـ
العديد من الأوامر، أو قم بتعيين 'git = True' في القسم [diff] من ملف التكوين الخاص بك. أنت
لا تحتاج إلى تعيين هذا الخيار عند استيراد الاختلافات بهذا التنسيق أو استخدامها في mq
تمديد.

البيئة المتغيرات

HG المسار إلى الملف القابل للتنفيذ "hg"، والذي يتم تمريره تلقائيًا عند تشغيل الخطافات أو الامتدادات أو
أدوات خارجية. إذا لم يتم ضبطه أو كان فارغًا، فهذا هو اسم الملف القابل للتنفيذ hg إذا تم تجميده،
أو ملف قابل للتنفيذ باسم "hg" (مع %PATHEXT% [الافتراضي هو COM/EXE/BAT/CMD]
ملحقات على نظام التشغيل Windows) يتم البحث عنها.

HGEDITOR
هذا هو اسم المحرر الذي سيتم تشغيله عند الالتزام. انظر المحرر.

(مهمل، استخدم ملف التكوين)

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

وضع التشفير
يؤدي هذا إلى ضبط سلوك Mercurial للتعامل مع الأحرف غير المعروفة أثناء تحويل الشفرة
إدخال المستخدم. الإعداد الافتراضي هو "صارم"، مما يؤدي إلى إحباط Mercurial إذا لم يتمكن من ذلك
خريطة شخصية. تتضمن الإعدادات الأخرى "استبدال"، الذي يستبدل غير معروف
الشخصيات، و"التجاهل"، الذي يسقطها. يمكن تجاوز هذا الإعداد باستخدام
--encodingmode خيار سطر الأوامر.

التشفير الجينيغامض
يؤدي هذا إلى تعيين سلوك Mercurial للتعامل مع الأحرف ذات العرض "الغامض" مثل
أحرف لاتينية معلمة مع خطوط شرق آسيوية. افتراضيًا، يفترض Mercurial
الأحرف الغامضة ضيقة، قم بتعيين هذا المتغير إلى "واسع" إذا كانت هذه الأحرف
تسبب مشاكل في التنسيق

HGMERGE
ملف قابل للتنفيذ لاستخدامه في حل تعارضات الدمج. سيتم تنفيذ البرنامج
بثلاث وسائط: ملف محلي، ملف بعيد، ملف سلف.

(مهمل، استخدم ملف التكوين)

HGRCPATH
قائمة الملفات أو الدلائل للبحث عن ملفات التكوين. فاصل العنصر هو
":" على يونكس، "؛" على ويندوز. إذا لم يتم تعيين HGRCPATH، فسيكون مسار البحث الافتراضي للنظام الأساسي
يستخدم. إذا كان فارغًا، فسيتم قراءة .hg/hgrc فقط من المستودع الحالي.

لكل عنصر في HGRCPATH:

· إذا كان دليلاً، تتم إضافة كافة الملفات التي تنتهي بـ .rc

· وإلا سيتم إضافة الملف نفسه

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

الخيارات المكافئة التي يتم تعيينها عبر إشارات سطر الأوامر أو متغيرات البيئة ليست كذلك
تم تجاوزها.

باستثناء
هذه قائمة مفصولة بفواصل من الميزات التي يجب الاحتفاظ بها عند تمكين HGPLAIN.
حاليًا يتم دعم القيم التالية:

الاسم المستعار

لا تقم بإزالة الأسماء المستعارة.

i18n

الحفاظ على التدويل.

com.revsetalias

لا تقم بإزالة الأسماء المستعارة revset.

سيؤدي ضبط HGPLAINEXCEPT على أي شيء (حتى سلسلة فارغة) إلى تمكين الوضع العادي.

HGUSER هذه هي السلسلة المستخدمة كمؤلف للالتزام. إذا لم يتم تعيينها، القيم المتاحة
سيتم النظر في هذا الترتيب:

· HGUSER (مهمل)

· ملفات التكوين من HGRCPATH

· بريد إلكتروني

· موجه تفاعلي

· LOGNAME (مع @ اسم المضيف ملحق)

(مهمل، استخدم ملف التكوين)

البريد الإلكتروني يمكن استخدامه كمؤلف للالتزام؛ انظر هجوسر.

اسم السجل
يمكن استخدامه كمؤلف للالتزام؛ انظر هجوسر.

VISUAL هذا هو اسم المحرر الذي سيتم استخدامه عند الالتزام. انظر المحرر.

EDITOR في بعض الأحيان يحتاج Mercurial إلى فتح ملف نصي في محرر ليقوم المستخدم بتعديله،
على سبيل المثال عند كتابة رسائل الالتزام. يتم تحديد المحرر الذي يستخدمه
النظر في متغيرات البيئة HGEDITOR وVISUAL وEDITOR بهذا الترتيب.
يتم اختيار الأول غير الفارغ. إذا كانت جميعها فارغة، فسيقوم المحرر افتراضيًا بذلك
"محرر معقول".

بايثونباث
يتم استخدام هذا بواسطة Python للعثور على الوحدات النمطية المستوردة وقد يلزم ضبطها
بشكل مناسب إذا لم يتم تثبيت Mercurial على مستوى النظام.

باستخدام ADDITIONAL المزايا

يتمتع Mercurial بالقدرة على إضافة ميزات جديدة من خلال استخدام الامتدادات. ملحقات
قد يضيف أوامر جديدة، ويضيف خيارات للأوامر الموجودة، ويغير السلوك الافتراضي لـ
الأوامر، أو تنفيذ الخطافات.

لتمكين الامتداد "foo"، الذي يتم شحنه مع Mercurial أو في مسار بحث Python،
قم بإنشاء إدخال له في ملف التكوين الخاص بك، مثل هذا:

[ملحقات]
فو =

يمكنك أيضًا تحديد المسار الكامل للامتداد:

[ملحقات]
ميزتي = ~/.hgext/myfeature.py

يرى hg مساعدة التكوين لمزيد من المعلومات حول ملفات التكوين.

لا يتم تحميل الملحقات بشكل افتراضي لعدة أسباب: يمكنها زيادة بدء التشغيل
تكاليف غير مباشرة؛ وقد تكون مخصصة للاستخدام المتقدم فقط؛ قد يقدمون الإمكانات
قدرات خطيرة (مثل السماح لك بتدمير التاريخ أو تعديله)؛ قد لا يكونون كذلك
جاهز لوقت الذروة؛ أو قد يغيرون بعض السلوكيات المعتادة للأسهم Mercurial. إنها
وبالتالي يعود الأمر للمستخدم لتفعيل الامتدادات حسب الحاجة.

لتعطيل ملحق تم تمكينه بشكل صريح في ملف تكوين ذي نطاق أوسع،
تسبق مسارها بـ!:

[ملحقات]
# تعطيل شريط الامتداد الموجود في /path/to/extension/bar.py
شريط =!/path/to/extension/bar.py
# كما سبق، ولكن لم يتم توفير مسار لتمديد baz
باز =!

ملحقات معطلة:

دوري أبطال آسيا السنانير للتحكم في الوصول إلى المستودع

صندوق اسود
قم بتسجيل أحداث المستودع في صندوق أسود لتصحيح الأخطاء

بجزيلا
خطافات للتكامل مع أداة تعقب الأخطاء Bugzilla

الرقيب مسح محتوى الملف في مراجعة معينة

يخض، يحرك بعنف أمر لعرض إحصائيات حول تاريخ المستودع

clonebundles
الإعلان عن الحزم التي تم إنشاؤها مسبقًا لاستنساخ البذور

اللون تلوين الإخراج من بعض الأوامر

تحول
استيراد المراجعات من مستودعات VCS الأجنبية إلى Mercurial

إيول إدارة الأسطر الجديدة تلقائيًا في ملفات المستودع

com.extdiff
أمر للسماح للبرامج الخارجية بمقارنة المراجعات

خادم
مصادقة http مع Factotum

المنافع العامة العالمية أوامر للتوقيع والتحقق من التغييرات

hgcia خطافات للتكامل مع خدمة إعلام CIA.vc

hgk تصفح المستودع بطريقة رسومية

تسليط الضوء على
تسليط الضوء على بناء الجملة لـ hgweb (يتطلب Pygments)

أصمت
تحرير التاريخ التفاعلي

الكلمة
توسيع الكلمات الرئيسية في الملفات المتعقبة

ملفات كبيرة
تتبع الملفات الثنائية الكبيرة

mq إدارة كومة من التصحيحات

أبلغ خطافات لإرسال إشعارات البريد الإلكتروني

بيجر تصفح إخراج الأمر باستخدام جهاز النداء الخارجي

patchbomb
أمر لإرسال مجموعات التغييرات كـ (سلسلة من) رسائل البريد الإلكتروني التصحيحية

تطهير أمر لحذف الملفات التي لم يتم تعقبها من دليل العمل

rebase أمر لنقل مجموعات من المراجعات إلى سلف مختلف

سجل أوامر لتحديد التغييرات بشكل تفاعلي للالتزام/qrefresh

إعادة الربط يعيد إنشاء الروابط الصلبة بين نسخ المستودع

مخططات
توسيع المخططات باستخدام اختصارات لأسراب المستودع

شارك مشاركة تاريخ مشترك بين عدة أدلة العمل

اكتنز حفظ واستعادة التغييرات إلى دليل العمل

قطاع تجريد مجموعات التغييرات وأحفادهم من التاريخ

زرع اعضاء
الأمر لزرع مجموعات التغييرات من فرع آخر

win32mbcs
السماح باستخدام مسارات MBCS مع الترميزات الإشكالية

زيروكونف
اكتشاف والإعلان عن المستودعات على الشبكة المحلية

التحديد FILE الاطقم

يدعم Mercurial لغة وظيفية لاختيار مجموعة من الملفات.

مثل أنماط الملفات الأخرى، تتم الإشارة إلى نوع النمط هذا ببادئة، "set:". اللغة
يدعم عددًا من المسندات التي انضمت إليها عوامل infix. يمكن أن يكون بين قوسين
تستخدم للتجميع.

يجب أن يتم اقتباس المعرفات مثل أسماء الملفات أو الأنماط بعلامات اقتباس مفردة أو مزدوجة إذا
أنها تحتوي على أحرف خارج [.*{}[]?/\_a-zA-Z0-9\x80-\xff] أو إذا كانت مطابقة لأحد
المسندات المحددة مسبقا. ينطبق هذا بشكل عام على أنماط الملفات بخلاف الكرات و
الحجج للمسندات.

يمكن استخدام الأحرف الخاصة في المعرفات المقتبسة عن طريق الهروب منها، على سبيل المثال، \n is
يتم تفسيره على أنه سطر جديد. لمنع تفسيرها، يمكن إضافة البادئات إلى السلاسل
مع r، على سبيل المثال ص '...'.

يوجد عامل بادئة واحد:

ليس x

الملفات ليست في x. الشكل القصير هو ! x.

هذه هي عوامل تشغيل infix المدعومة:

x و y

تقاطع الملفات في x و y. الشكل القصير هو x & y.

x or y

اتحاد الملفات في x و y. هناك نوعان من النماذج القصيرة البديلة: x | y و x +
y.

x - y

الملفات في x ولكن ليس في y.

يتم دعم المسندات التالية:

تمت الإضافة ()

الملف الذي يتم إضافته وفقًا لـ hg الحالة.

الثنائية()

الملف الذي يبدو ثنائيًا (يحتوي على بايت NUL).

نظيف ()

الملف نظيف وفقًا لـ hg الحالة.

نسخ()

الملف الذي يتم تسجيله على أنه منسوخ.

تم الحذف()

الاسم المستعار لـ مفتقد().

الترميز (الاسم)

يمكن فك تشفير الملف بنجاح باستخدام ترميز الأحرف المحدد. قد لا يكون
مفيد للترميزات الأخرى غير ASCII وUTF-8.

إيول (نمط)

يحتوي الملف على أسطر جديدة من النمط المحدد (dos، unix، mac). الملفات الثنائية هي
مستبعدة، والملفات ذات نهايات الخطوط المختلطة تتطابق مع أنماط متعددة.

إكسيك ()

الملف الذي تم وضع علامة عليه على أنه قابل للتنفيذ.

grep(التعبير العادي)

يحتوي الملف على التعبير العادي المحدد.

hgignore()

الملف الذي يتطابق مع نمط .hgignore النشط.

تم التجاهل ()

الملف الذي تم تجاهله وفقًا لـ hg الحالة. سيتم النظر في هذه الملفات فقط إذا
يتم استخدام هذا المسند.

مفتقد()

الملف المفقود وفقا ل hg الحالة.

معدل()

الملف الذي تم تعديله وفقا ل hg الحالة.

محمول ()

ملف له اسم محمول. (لا يتضمن هذا أسماء الملفات ذات الحالة
الاصطدامات.)

إزالة()

الملف الذي تتم إزالته وفقًا لـ hg الحالة.

تم الحل()

الملف الذي تم وضع علامة "تم الحل" عليه وفقًا لـ hg حل -l.

الحجم (التعبير)

حجم الملف يطابق التعبير المحدد. أمثلة:

· 1 كيلو (ملفات من 1024 إلى 2047 بايت)

· < 20 كيلو (ملفات أقل من 20480 بايت)

· >= .5 ميجابايت (ملفات بحجم 524288 بايت على الأقل)

· 4K - 1 ميجابايت (ملفات من 4096 بايت إلى 1048576 بايت)

ريبو فرعي([نمط])

المستودعات الفرعية التي تتطابق مساراتها مع النمط المحدد.

رابط رمزي ()

الملف الذي تم وضع علامة عليه كرابط رمزي.

مجهول()

الملف غير معروف وفقا ل hg الحالة. سيتم النظر في هذه الملفات فقط إذا
يتم استخدام هذا المسند.

لم تحل()

الملف الذي تم وضع علامة "لم يتم حله" وفقًا لـ hg حل -l.

بعض نماذج الاستعلامات:

· إظهار حالة الملفات التي تبدو ثنائية في دليل العمل:

حالة الزئبق -A "مجموعة: ثنائي ()"

· ننسى الملفات الموجودة في .hgignore ولكن تم تعقبها بالفعل:

hg ننسى "set:hgignore() ولم يتم تجاهله()"

· البحث عن الملفات النصية التي تحتوي على سلسلة:

ملفات الزئبق "مجموعة:البقرى(سحر) وليس ثنائي ()"

· ابحث عن ملفات C بترميز غير قياسي:

ملفات hg "set:**.c وغير مشفرة ('UTF-8')"

· التراجع عن نسخ الملفات الثنائية الكبيرة:

hg التراجع "المجموعة: منسوخ () وثنائي () والحجم ('> 1M')"

· إزالة الملفات المدرجة في foo.lst التي تحتوي على الحرف a أو b:

hg إزالة "مجموعة: 'listfile:foo.lst' و (**a* أو **b*)"

انظر أيضا hg مساعدة أنماط.

المعجم

سلف
أي مجموعة تغييرات يمكن الوصول إليها من خلال سلسلة غير منقطعة من مجموعات التغييرات الأصلية من ملف
مجموعة التغييرات المعطاة. بتعبير أدق، يمكن تعريف أسلاف مجموعة التغييرات من خلال اثنين
الخصائص: أحد الوالدين لمجموعة التغييرات هو سلف، ووالد السلف هو
سلف. انظر أيضًا: «السليل».

حفظ
الإشارات المرجعية هي مؤشرات لبعض الالتزامات التي تتحرك عند الالتزام. هم
تشبه العلامات من حيث أنه من الممكن استخدام أسماء الإشارات المرجعية في جميع الأماكن التي
يتوقع Mercurial معرف مجموعة التغييرات، على سبيل المثال، with hg تحديث. على عكس العلامات، تتحرك الإشارات المرجعية
على طول عندما تقوم بالالتزام.

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

الفرع (اسم) مجموعة التغييرات الفرعية التي تم إنشاؤها من أحد الوالدين الذي ليس رأسًا.
تُعرف هذه بالفروع الطوبولوجية، انظر "الفرع الطوبولوجي". اذا كان
عند تسمية الفرع الطوبولوجي، يصبح فرعًا مسمىًا. إذا كان هناك فرع طوبولوجي
لم يذكر اسمه، يصبح فرعا مجهولا. انظر "الفرع، مجهول" و"الفرع،
اسم الشيئ'.

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

مثال: "الفرع التجريبي."

(فعل) إجراء إنشاء مجموعة تغييرات فرعية مما يؤدي إلى وجود الوالدين
أكثر من طفل.

على سبيل المثال: "سأقوم بالتفرع في X."

فرع، مجهول
في كل مرة يتم إنشاء مجموعة تغييرات فرعية جديدة من أحد الوالدين الذي ليس رأسًا و
لم يتم تغيير اسم الفرع، يتم إنشاء فرع جديد مجهول.

فرع، صندوق توظيف برأس مال محدود
فرع مسمى تم إغلاق جميع رؤوس فروعه.

فرع، الافتراضي
الفرع المخصص لمجموعة التغييرات عندما لم يتم تعيين اسم مسبقًا.

الفرع رئيس
انظر "الرأس، الفرع".

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

ملاحظة: تم إهمال هذا المفهوم لأنه ضمني للغاية. وينبغي للفروع الآن
تكون مغلقة بشكل صريح باستخدام hg ارتكاب - فرع قريب عندما لم تعد هناك حاجة إليها.

فرع، عين
مجموعة من مجموعات التغييرات التي لها نفس اسم الفرع. بشكل افتراضي، أطفال
تنتمي مجموعة التغييرات في فرع مسمى إلى نفس الفرع المسمى. يمكن أن يكون الطفل
المخصصة صراحة لفرع مختلف. يرى hg مساعدة خيران, hg مساعدة الفروع و
hg ارتكاب - فرع قريب لمزيد من المعلومات حول إدارة الفروع.

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

الفرع معلومات سرية
انظر "نصيحة، فرع".

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

التغيير
سجل لمجموعات التغييرات بالترتيب الذي تمت إضافتها به إلى المستودع.
يتضمن ذلك تفاصيل مثل معرف مجموعة التغييرات والمؤلف ورسالة الالتزام والتاريخ والقائمة
من الملفات التي تم تغييرها.

مجموعة التغييرات
لقطة لحالة المستودع المستخدم لتسجيل التغيير.

مجموعة التغييرات, طفل
عكس مجموعة التغييرات الأصلية: إذا كان P هو أحد الوالدين لـ C، فإن C هو ابن لـ P.
لا يوجد حد لعدد الأطفال الذين قد تنجبهم مجموعة التغييرات.

مجموعة التغييرات id
تجزئة SHA-1 التي تحدد مجموعة التغييرات بشكل فريد. ويمكن تمثيله إما
سلسلة "طويلة" مكونة من 40 رقمًا سداسيًا عشريًا، أو سلسلة "قصيرة" مكونة من 12 رقمًا سداسيًا عشريًا.

مجموعة التغييرات, دمج
مجموعة التغييرات مع الوالدين. يحدث هذا عند تنفيذ عملية الدمج.

مجموعة التغييرات, أصل
مراجعة تعتمد عليها مجموعة التغييرات التابعة. على وجه التحديد، مجموعة التغييرات الأصل
مجموعة التغييرات C هي مجموعة التغييرات التي تسبق عقدتها C مباشرة في DAG.
تحتوي مجموعات التغيير على أبوين على الأكثر.

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

على سبيل المثال: "أنا أستخدم الخروج X."

(فعل) تحديث دليل العمل إلى مجموعة تغييرات محددة. يرى hg مساعدة تحديث.

على سبيل المثال: "سوف أتحقق من مجموعة التغييرات X."

طفل changeset
راجع "مجموعة التغيير أيها الطفل".

اغلاق changeset
انظر "الرأس، الفرع المغلق".

مغلق خيران
انظر "الفرع مغلق".

استنساخ (اسم) نسخة كاملة أو جزئية من المستودع. يجب أن يكون الاستنساخ الجزئي في
شكل المراجعة وأسلافها.

مثال: "هل نسختك محدثة؟"

(فعل) عملية إنشاء نسخة باستخدام hg استنساخ.

مثال: "سأقوم باستنساخ المستودع."

مغلق خيران رئيس
انظر "الرأس، الفرع المغلق".

ارتكب (اسم) مرادف لمجموعة التغييرات.

مثال: "هل تم إصلاح الخلل في التزامك الأخير؟"

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

مثال: "يجب عليك تنفيذ هذه التغييرات الآن."

سيست اختصار شائع لمصطلح Changeset.

DAG يمكن أن يكون مستودع مجموعات التغييرات لنظام التحكم في الإصدار الموزع (DVCS).
يوصف بأنه رسم بياني حلقي موجه (DAG)، يتكون من العقد والحواف، حيث
تتوافق العقد مع مجموعات التغييرات والحواف تشير إلى وجود علاقة بين الوالدين -> الطفل. هذا
يمكن تصور الرسم البياني بواسطة أدوات رسومية مثل hg سجل --رسم بياني. في ميركوريال،
يقتصر DAG على شرط أن يكون لدى الأطفال والدين على الأكثر.


تمت إزالة الميزة من الوثائق، ولكن لم تتم جدولة إزالتها.

الترتيب خيران
راجع "الفرع، الافتراضي".

السليل
أي مجموعة تغييرات يمكن الوصول إليها من خلال سلسلة من مجموعات التغييرات الفرعية من مجموعة معينة
التغييرات. بتعبير أدق، يمكن تعريف أحفاد مجموعة التغييرات من خلال اثنين
الخصائص: طفل مجموعة التغييرات هو سليل، وطفل سليل
هو سليل. انظر أيضًا: «السلف».

فرق (اسم) الفرق بين محتويات وسمات الملفات في اثنين
مجموعات التغييرات أو مجموعة التغييرات ودليل العمل الحالي. والفرق هو
عادة ما يتم تمثيلها في شكل قياسي يسمى "فرق" أو "تصحيح". "فرق جيت"
يتم استخدام التنسيق عندما تتضمن التغييرات نسخًا أو إعادة تسمية أو تغييرات على الملف
السمات، التي لا يمكن تمثيل/التعامل مع أي منها من خلال "diff" و"patch" الكلاسيكيين.

على سبيل المثال: "هل رأيت تصحيحي في الفرق؟"

(فعل) إن التمييز بين مجموعتين من التغييرات هو إجراء إنشاء فرق أو تصحيح.

مثال: "إذا اختلفت مع مجموعة التغييرات X، فسوف تفهم ما أعنيه."

الدليل، عامل
يمثل دليل العمل حالة الملفات التي يتتبعها Mercurial
سيتم تسجيله في الالتزام التالي. يتوافق دليل العمل في البداية مع
اللقطة في مجموعة التغييرات الموجودة، والمعروفة باسم أصل العمل
الدليل. راجع "الأصل، دليل العمل". يمكن تعديل الحالة عن طريق التغييرات
الملفات المقدمة يدويًا أو عن طريق الدمج. البيانات التعريفية للمستودع موجودة في
دليل .hg داخل دليل العمل.

مسودة لم تتم مشاركة مجموعات التغييرات في مرحلة المسودة مع مستودعات النشر و
وبالتالي يمكن تغييرها بأمان عن طريق امتدادات تعديل التاريخ. يرى hg مساعدة المراحل.

تجريبي
الميزة التي قد تتغير أو تتم إزالتها في وقت لاحق.

رسم بياني انظر داج و hg سجل --رسم بياني.

رئيس يمكن استخدام مصطلح "الرأس" للإشارة إلى كل من رأس الفرع أو رأس المستودع،
اعتمادا على السياق. راجع "الرأس، الفرع" و"الرأس، المستودع" لمعرفة التفاصيل
تعريفات.

الرؤوس هي المكان الذي يحدث فيه التطوير بشكل عام وهي الأهداف المعتادة
عمليات التحديث والدمج.

رئيس، خيران
مجموعة تغييرات بدون أحفاد على نفس الفرع المسمى.

رئيس، صندوق توظيف برأس مال محدود خيران
مجموعة التغييرات التي تشير إلى أن الرأس لم يعد مثيرًا للاهتمام. الرأس المغلق لا
تعد مدرجة من قبل hg رأس. يعتبر الفرع مغلقا عندما تكون جميع رؤوسه
مغلق وبالتالي لم يتم إدراجه بواسطة hg الفروع.

يمكن إعادة فتح الرؤوس المغلقة عن طريق إجراء تغييرات جديدة باعتبارها فرعًا لـ
مجموعة التغييرات التي تحدد الرأس على أنه مغلق.

رئيس، مستودع
رأس طوبولوجي لم يتم إغلاقه.

رئيس، الطوبوغرافية
مجموعة تغييرات بدون وجود أطفال في المستودع.

التاريخ، غير قابل للتغيير
بمجرد الالتزام، لا يمكن تغيير مجموعات التغييرات. الإضافات التي يبدو أنها تتغير
يُنشئ التاريخ في الواقع مجموعات تغييرات جديدة تحل محل المجموعات الموجودة، ثم يدمرها
مجموعات التغييرات القديمة. يمكن أن يؤدي القيام بذلك في المستودعات العامة إلى مجموعات تغييرات قديمة
يتم إعادته إلى المستودع.

التاريخ، إعادة كتابة
مجموعات التغييرات في المستودع غير قابلة للتغيير. ومع ذلك، يمكن لملحقات Mercurial
يمكن استخدامها لتغيير المستودع، عادةً بطريقة تحافظ على مجموعة التغييرات
محتويات.

غير قابل للتغيير تاريخ
انظر "التاريخ غير قابل للتغيير".

دمج changeset
راجع "مجموعة التغيير، الدمج".

واضح
تحتوي كل مجموعة تغييرات على بيان، وهو عبارة عن قائمة بالملفات التي يتم تعقبها بواسطة ملف
التغييرات.

دمج تستخدم للجمع بين فروع العمل المتباينة. عند التحديث إلى Changeset
ثم قم بدمج مجموعة تغييرات أخرى، يمكنك إحضار تاريخ مجموعة التغييرات الأخيرة
في دليل العمل الخاص بك. بمجرد حل التعارضات (ووضع علامة عليها)، يتم هذا الدمج
قد يتم الالتزام بها كمجموعة تغييرات مدمجة، حيث تجمع فرعين معًا في DAG.

عين خيران
انظر "الفرع، المسمى".

فارغة changeset
مجموعة التغييرات الفارغة إنها الحالة الأصلية للمستودعات التي تمت تهيئتها حديثًا و
المستودعات مع عدم وجود مراجعة مسحوبة. وبالتالي فهو أصل مجموعات التغييرات الجذرية
والسلف الفعال عند دمج مجموعات التغييرات غير ذات الصلة. يمكن تحديدها بواسطة
الاسم المستعار "خالي" أو بواسطة معرف مجموعة التغييرات "000000000000".

العنصر الرئيسي راجع "مجموعة التغيير، الوالد".

العنصر الرئيسي changeset
راجع "مجموعة التغيير، الوالد".

الأبوين، عامل دليل
يعكس أصل دليل العمل مراجعة افتراضية وهي تابعة لـ
يتم عرض مجموعة التغييرات (أو مجموعتي التغييرات مع دمج متاح) بواسطة hg الآباء. هذا
يتم تغيير مع hg تحديث. الأوامر الأخرى لرؤية أصل دليل العمل هي
hg ملخص و hg id. يمكن تحديده بالاسم المستعار ".".

بقعة (اسم) منتج عملية فرقية.

على سبيل المثال: "لقد أرسلت لك رقعتي."

(فعل) عملية استخدام ملف التصحيح لتحويل مجموعة تغييرات إلى أخرى.

مثال: "ستحتاج إلى تصحيح تلك المراجعة."

مرحلة حالة لكل مجموعة تغييرات تتتبع كيفية مشاركة مجموعة التغييرات أو كيفية مشاركتها. يرى
hg مساعدة المراحل.

عام تمت مشاركة مجموعات التغييرات في المرحلة العامة مع مستودعات النشر و
ولذلك تعتبر غير قابلة للتغيير. يرى hg مساعدة المراحل.

سحب عملية يتم فيها تغيير مجموعات البيانات في مستودع بعيد وليست موجودة على المستوى المحلي
يتم إحضار المستودع إلى المستودع المحلي. لاحظ أن هذه العملية بدون
تعمل الوسائط الخاصة على تحديث المستودع فقط، ولا تقوم بتحديث الملفات الموجودة في ملف
عمل اخراجي. يرى hg مساعدة سحب.

دفع عملية يتم فيها تغيير المجموعات في مستودع محلي غير موجود في جهاز بعيد
يتم إرسال المستودع إلى المستودع البعيد. لاحظ أن هذه العملية تضيف فقط
مجموعات التغييرات التي تم الالتزام بها محليًا في المستودع البعيد. غير ملتزم
لا يتم إرسال التغييرات. يرى hg مساعدة دفع.

مستودع
البيانات الوصفية التي تصف جميع الحالات المسجلة لمجموعة من الملفات. سجلت كل
يتم تمثيل الحالة بواسطة مجموعة التغييرات. عادة ما يتم العثور على المستودع (ولكن ليس دائمًا).
في ال .hg الدليل الفرعي لدليل العمل. يمكن إعادة إنشاء أي حالة مسجلة
عن طريق "تحديث" دليل العمل إلى مجموعة تغييرات معينة.

مستودع رئيس
انظر "الرأس، المستودع".

تنقيح
حالة المستودع في وقت ما. يمكن تحديث المراجعات السابقة
ل باستخدام hg تحديث. انظر أيضًا "رقم المراجعة"؛ انظر أيضًا "مجموعة التغييرات".

تنقيح عدد
يحدد هذا العدد الصحيح بشكل فريد مجموعة التغييرات في مستودع معين. هو - هي
يمثل الترتيب الذي تمت به إضافة مجموعات التغييرات إلى المستودع، بدءًا من
رقم المراجعة 0. لاحظ أن رقم المراجعة قد يختلف في كل نسخة
مستودع. للتعرف على مجموعات التغييرات بشكل فريد بين النسخ المختلفة، راجع
"معرف مجموعة التغيير".

سجل الأحداث آلية تخزين التاريخ المستخدمة من قبل Mercurial. وهو شكل من أشكال ترميز دلتا، مع
مراجعة كاملة عرضية للبيانات تليها دلتا لكل مراجعة متتالية. هو - هي
يتضمن بيانات وفهرسًا يشير إلى البيانات.

إعادة كتابة تاريخ
انظر "التاريخ، إعادة الكتابة".

جذر مجموعة التغييرات التي تحتوي فقط على مجموعة التغييرات الفارغة كأصل لها. معظم المستودعات لديها
مجموعة تغييرات جذر واحدة فقط.

سيكريت لا يجوز مشاركة مجموعات التغييرات في المرحلة السرية عبر الدفع أو السحب أو الاستنساخ. يرى hg
مساعدة المراحل.

بطاقة اسم بديل يُعطى لمجموعة التغييرات. يمكن استخدام العلامات في جميع الأماكن التي
يتوقع Mercurial معرف مجموعة التغييرات، على سبيل المثال، with hg تحديث. إنشاء علامة هو
المخزنة في السجل وبالتالي ستتم مشاركتها تلقائيًا مع الآخرين باستخدام الدفع
وسحب.

معلومه- سرية مجموعة التغييرات ذات أعلى رقم مراجعة. إنها مجموعة التغييرات في الآونة الأخيرة
تمت إضافتها في المستودع.

نصيحة، خيران
رئيس فرع معين بأعلى رقم مراجعة. عندما يكون اسم الفرع
يستخدم كمعرف للمراجعة، فهو يشير إلى طرف الفرع. أنظر أيضاً "الفرع،
رأس'. لاحظ أنه نظرًا لأن أرقام المراجعة قد تكون مختلفة في المستودعات المختلفة
المستنسخات، قد يكون طرف الفرع مختلفًا في المستودعات المستنسخة المختلفة.

تحديث (اسم) مرادف آخر لمجموعة التغييرات.

على سبيل المثال: "لقد قمت بدفع تحديث."

(فعل) يستخدم هذا المصطلح عادة لوصف تحديث حالة العمل
الدليل إلى مجموعة تغييرات محددة. يرى hg مساعدة تحديث.

مثال: "يجب عليك التحديث."

العمل دليل
انظر "الدليل، العمل".

العمل دليل أصل
راجع "الأصل، دليل العمل".

بناء الجملة لأي زئبقي تجاهل FILES

ملخص
يستخدم نظام Mercurial ملفًا يسمى .hginore في الدليل الجذر للمستودع إلى
التحكم في سلوكه عندما يبحث عن ملفات لا يتتبعها حاليًا.

الوصف
غالبًا ما يحتوي دليل العمل الخاص بمستودع Mercurial على ملفات لا ينبغي أن تحتوي عليها
يمكن تتبعها من قبل Mercurial. يتضمن ذلك ملفات النسخ الاحتياطي التي أنشأها المحررون وبناء المنتجات
تم إنشاؤها بواسطة المترجمين. يمكن تجاهل هذه الملفات عن طريق إدراجها في ملف .hginore ملف في
جذر دليل العمل. ال .hginore يجب إنشاء الملف يدويًا. إنها
عادةً ما يتم وضعها تحت التحكم في الإصدار، بحيث يتم نشر الإعدادات إلى الآخرين
المستودعات مع الدفع والسحب.

يتم تجاهل الملف الذي لم يتم تعقبه إذا كان مساره متعلقًا بالدليل الجذر للمستودع، أو أي ملف
مسار البادئة لذلك المسار، تتم مطابقته مع أي نمط في .hginore.

على سبيل المثال، لنفترض أن لدينا ملفًا لم يتم تعقبه، ملف، في أ/ب/ملف.ج داخل مستودعنا.
سوف يتجاهل الزئبقي ملف إذا كان هناك أي نمط في .hginore اعواد الثقاب أ/ب/ملف.ج, أ / ب or a.

بالإضافة إلى ذلك، يمكن لملف تكوين Mercurial الرجوع إلى مجموعة من الملفات لكل مستخدم أو مجموعة عامة
تجاهل الملفات. انظر تجاهل مفتاح التكوين على [واجهة المستخدم] قسم من hg مساعدة التكوين For
تفاصيل حول كيفية تكوين هذه الملفات.

للتحكم في معالجة Mercurial للملفات التي يديرها، تدعم العديد من الأوامر ملف -I و
-X خيارات؛ يرى hg مساعدة و hg مساعدة أنماط للتفاصيل.

الملفات التي تم تعقبها بالفعل لا تتأثر بـ .hgignore، حتى لو ظهرت في
.hginore. يمكن إضافة ملف X لم يتم تعقبه بشكل صريح باستخدام hg تضيف X، حتى لو كان X
تم استبعاده بواسطة نمط في .hgignore.

بناء الجملة
ملف التجاهل هو ملف نصي عادي يتكون من قائمة أنماط، بنمط واحد لكل ملف
خط. يتم تخطي الأسطر الفارغة. ال # يتم التعامل مع الحرف كحرف تعليق، و
\ يتم التعامل مع الحرف كحرف هروب.

يدعم Mercurial العديد من تركيبات الأنماط. بناء الجملة الافتراضي المستخدم هو نمط Python/Perl
التعبيرات العادية.

لتغيير بناء الجملة المستخدم، استخدم سطرًا من النموذج التالي:

بناء الجملة: الاسم

أين اسم هو واحد مما يلي:

REGEXP

التعبير العادي، بناء جملة بايثون/بيرل.

الكرة

الكرة الأرضية على شكل شل.

يظل بناء الجملة المختار ساري المفعول عند تحليل جميع الأنماط التالية، حتى آخر
تم تحديد بناء الجملة.

لم يتم تجذير أي من أنماط الكرة الأرضية أو regexp. نمط بناء جملة عالمي للنموذج * .c سوف
تطابق ملف ينتهي بـ .c في أي دليل، ونمط regexp للنموذج \.ج$ سوف تفعل
نفس الشيء. لتجذير نمط regexp، ابدأ بـ ^.

يمكن أن تحتوي الدلائل الفرعية على إعدادات .hgignore الخاصة بها عن طريق الإضافة
تضمين فرعي: المسار/إلى/subdir/.hgignore إلى الجذر .hginore. شاهد hg مساعدة أنماط For
تفاصيل عن تضمين فرعي: و تتضمن:.

ملاحظة: الأنماط المحددة في غير .hginore متجذرة دائما. لطفا أنظر hg مساعدة
أنماط للتفاصيل.

مثال
فيما يلي مثال لملف التجاهل.

# استخدم بناء الجملة الشامل.
بناء الجملة: الكرة الأرضية

*.إلك
*.pyc
*~

# التبديل إلى بناء جملة regexp.
بناء الجملة: regexp
^\.pc/

التكوين HGWEB

يمكن لخادم الويب الداخلي الخاص بـ Mercurial، hgweb، أن يخدم إما مستودعًا واحدًا أو شجرة من مستودعات الويب
المستودعات. في الحالة الثانية، يمكن تحديد مسارات المستودع والخيارات العامة باستخدام
ملف تكوين مخصص مشترك ل hg خدمة, hgweb.wsgi, hgweb.cgi و hgweb.fcgi.

يستخدم هذا الملف نفس بناء الجملة مثل ملفات تكوين Mercurial الأخرى ولكنه يتعرف عليه فقط
الأقسام التالية:

· الويب

· مسارات

· المجموعات

• الويب يتم وصف الخيارات بدقة في hg مساعدة التكوين.

• مسارات يقوم القسم بتعيين مسارات URL لمسارات المستودعات في نظام الملفات. سوف hgweb
عدم الكشف عن نظام الملفات مباشرة - يمكن نشر مستودعات Mercurial فقط وفقط
وفقا للتكوين.

الجانب الأيسر هو المسار في عنوان URL. لاحظ أن hgweb يحجز المسارات الفرعية مثل تزيد السرعة or
ملف، حاول استخدام أسماء مختلفة للمستودعات المتداخلة لتجنب التأثيرات المربكة.

الجانب الأيمن هو المسار في نظام الملفات. إذا كان المسار المحدد ينتهي بـ * or **
سيتم البحث في نظام الملفات بشكل متكرر عن المستودعات الموجودة أسفل تلك النقطة. مع * it
لن يتكرر في المستودعات التي يجدها (باستثناء .hg/بقع). مع ** ستستهلك في نهاية الأمر
ابحث أيضًا داخل أدلة عمل المستودع وربما تجد مستودعات فرعية.

في هذا المثال:

[مسارات]
/projects/a = /srv/tmprepos/a
/projects/b = c:/repos/b
/ = /srv/ريبوس/*
/المستخدم/بوب = /الصفحة الرئيسية/بوب/ريبوس/**

· الإدخالان الأولان يجعلان مستودعين في أدلة مختلفة يظهران ضمن المجلد
نفس الدليل في واجهة الويب

· الإدخال الثالث سوف ينشر كل مستودع Mercurial الموجود فيه /srv/ريبوس/، ل
على سبيل المثال المستودع /srv/ريبوس/quux/ سيظهر على شكل http://server/quux/

· الإدخال الرابع سيتم نشر كليهما http://server/user/bob/quux/ و
http://server/user/bob/quux/testsubrepo/

• مجموعات تم إهمال القسم وتم استبداله بـ مسارات.

عناوين URL و مشترك الحجج
تحتوي عناوين URL الموجودة ضمن كل مستودع على النموذج /{الأمر[/{الوسائط}] أين {يأمر}
يمثل اسم الأمر أو المعالج و {الحجج} يمثل أي عدد من
معلمات URL إضافية لهذا الأمر.

يمتلك خادم الويب نمطًا افتراضيًا مرتبطًا به. يتم تعيين الأنماط إلى مجموعة من الأسماء المسماة
قوالب. يتم استخدام كل قالب لعرض جزء معين من البيانات، مثل مجموعة التغييرات
أو فرق.

يمكن الكتابة فوق نمط الطلب الحالي بطريقتين. أولا، إذا {يأمر}
يحتوي على واصلة (-)، يحدد النص الموجود قبل الواصلة النمط. على سبيل المثال،
/ سجل الذرة سوف تجعل سجل معالج الأوامر مع ذرة أسلوب. الطريقة الثانية لتعيين
الاسلوب مع نمط وسيطة سلسلة الاستعلام. على سبيل المثال، /log?style=atom.
يُفضل معلمة URL الموصولة.

ليست كل القوالب متاحة لجميع الأنماط. محاولة استخدام أسلوب لا يفعل ذلك
قد يؤدي تحديد جميع القوالب إلى حدوث خطأ في عرض الصفحة.

العديد من الأوامر تأخذ {مراجعة} معلمة URL. يحدد هذا مجموعة التغييرات التي سيتم العمل عليها.
يتم تحديد هذا عادةً على أنه اختصار سداسي عشري قصير مكون من 12 رقمًا للأربعين الكامل
معرف المراجعة الفريد للشخصية. ومع ذلك، أي قيمة وصفها hg مساعدة المراجعات
يعمل عادة.

أوامر و عناوين URL
تتوفر أوامر الويب التالية وعناوين URL الخاصة بها:

/تعليق توضيحي/{مراجعة}/{مسار}
إظهار معلومات مجموعة التغييرات لكل سطر في الملف.

• fileannotate يتم تقديم القالب.

/archive/{revision}.{format}[/{path}]
الحصول على أرشيف لمحتوى المستودع.

يتم تحديد محتوى الأرشيف ونوعه بواسطة معلمة مسار URL. شكل هل
امتداد الملف لنوع الأرشيف الذي سيتم إنشاؤه. على سبيل المثال الرمز البريدي or tar.bz2. ليس كل الأرشيف
قد يسمح تكوين الخادم الخاص بك بالأنواع.

اختياري مسار تتحكم معلمة URL في المحتوى المراد تضمينه في الأرشيف. إذا تم حذفها،
كل ملف في المراجعة المحددة موجود في الأرشيف. إذا تم تضمينها، فقط
سيتم تضمين الملف المحدد أو محتويات الدليل المحدد في الأرشيف.

لم يتم استخدام أي قالب لهذا المعالج. يتم إنشاء محتوى خام وثنائي.

/إشارات مرجعية
عرض معلومات حول الإشارات المرجعية.

لا يتم قبول أي حجج.

• الإشارات المرجعية يتم تقديم القالب.

/ الفروع
عرض معلومات عن الفروع.

يتم تضمين كافة الفروع المعروفة في الإخراج، حتى الفروع المغلقة.

لا يتم قبول أي حجج.

• الفروع يتم تقديم القالب.

/سجل التغيير[/{مراجعة}]
عرض معلومات حول مجموعات التغييرات المتعددة.

إذا كان الخيار تنقيح وسيطة URL غائبة، وتبدأ المعلومات حول كافة مجموعات التغييرات
at معلومات سرية سيتم تقديمها. إذا تنقيح الوسيطة موجودة، سيتم عرض مجموعات التغييرات
بدءا من المراجعة المحددة.

If تنقيح غائب، تزيد السرعة يمكن تعريف وسيطة سلسلة الاستعلام. سيؤدي هذا
ابحث عن مجموعات التغييرات.

حجة ل تزيد السرعة يمكن أن تكون مراجعة واحدة، أو مجموعة مراجعة، أو كلمة أساسية حرفية
البحث عن بيانات مجموعة التغييرات (أي ما يعادل hg سجل -k).

• عدد مرات الظهور تحدد وسيطة سلسلة الاستعلام الحد الأقصى لعدد مجموعات التغييرات التي سيتم عرضها.

لغير عمليات البحث، التغيير سيتم تقديم القالب.

/تغييرات[/{مراجعة}]
عرض معلومات حول مجموعة تغييرات واحدة.

وسيطة مسار URL هي معرف مجموعة التغييرات المطلوب إظهاره. يرى hg مساعدة المراجعات For
القيم الممكنة. إذا لم يتم تعريفها، معلومات سرية سيتم عرض مجموعة التغييرات

• changeset يتم تقديم القالب. محتويات Changesettag, Changesetbookmark,
com.filenodelink, com.filenolink، ويمكن استخدام القوالب العديدة المتعلقة بالاختلافات
إنتاج الإخراج.

/مقارنة/{مراجعة}/{مسار}
أظهر مقارنة بين الإصدارين القديم والجديد من الملف من خلال التغييرات التي تم إجراؤها على ملف
مراجعة خاصة.

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

• سياق الكلام يمكن استخدام وسيطة سلسلة الاستعلام للتحكم في سطور السياق في الفرق.

• filecomparison يتم تقديم القالب.

/فرق/{مراجعة}/{مسار}
أظهر كيف تغير ملف في التزام معين.

• com.filediff يتم تقديم القالب.

تم تسجيل هذا المعالج تحت كل من / فرق و /filediff مسارات. / فرق يستخدم في
الكود الحديث.

/ملف/{مراجعة}[/{path}]
عرض معلومات حول دليل أو ملف في المستودع.

معلومات عن مسار سيتم تقديمها كمعلمة URL.

If مسار هو دليل، سيتم عرض معلومات حول الإدخالات في هذا الدليل.
هذا النموذج يعادل واضح معالج.

If مسار هو ملف، وسيتم عرض معلومات حول هذا الملف عبر filerevision
قالب.

If مسار لم يتم تعريفه، سيتم عرض معلومات حول الدليل الجذر.

/فرق/{مراجعة}/{مسار}
أظهر كيف تغير ملف في التزام معين.

• com.filediff يتم تقديم القالب.

تم تسجيل هذا المعالج تحت كل من / فرق و /filediff مسارات. / فرق يستخدم في
الكود الحديث.

/سجل الملف/{مراجعة}/{مسار}
عرض معلومات حول تاريخ الملف في المستودع.

• عدد مرات الظهور يمكن تعريف وسيطة سلسلة الاستعلام للتحكم في الحد الأقصى لعدد الإدخالات
ليعرض.

• الملف سيتم تقديم القالب.

/رسم بياني[/{مراجعة}]
عرض معلومات حول الهيكل الرسومي للمستودع.

يمكن استخدام المعلومات التي يقدمها هذا المعالج لإنشاء تمثيلات مرئية لـ
طوبولوجيا المستودع.

• تنقيح تتحكم معلمة URL في مجموعة تغييرات البداية.

• عدد مرات الظهور يمكن لوسيطة سلسلة الاستعلام تحديد عدد مجموعات التغييرات لإظهار المعلومات
ل.

سيعرض هذا المعالج رسم بياني قالب.

/موضوع المساعدة}]
تقديم وثائق المساعدة.

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

• مساعدة سيتم تقديم القالب عند طلب المساعدة لموضوع ما. موضوعات المساعدة سوف يكون
المقدمة لفهرس مواضيع المساعدة.

/سجل[/{مراجعة}[/{path}]]
إظهار المستودع أو سجل الملف.

لعناوين URL للنموذج /سجل/{مراجعة}، قائمة بمجموعات التغييرات التي تبدأ من المحدد
يتم عرض معرف مجموعة التغييرات. لو {مراجعة} لم يتم تعريف، الافتراضي هو معلومات سرية. هذا من
يعادل التغيير معالج.

لعناوين URL للنموذج /سجل/{مراجعة}/{ملف}، سيكون تاريخ ملف معين
هو مبين. هذا النموذج يعادل الملف معالج.

/البيان[/{مراجعة}[/{path}]]
عرض معلومات حول الدليل.

إذا تم حذف وسيطات مسار URL، فستظهر معلومات حول الدليل الجذر لـ معلومات سرية
سيتم عرض مجموعة التغييرات

نظرًا لأن هذا المعالج يمكنه عرض معلومات الدلائل فقط، فمن المستحسن استخدامه
ال ملف معالج بدلا من ذلك، لأنه يمكن التعامل مع كل من الدلائل والملفات.

• واضح سيتم تقديم القالب لهذا المعالج.

/تغييرات[/{مراجعة}]
عرض معلومات حول مجموعة تغييرات واحدة.

وسيطة مسار URL هي معرف مجموعة التغييرات المطلوب إظهاره. يرى hg مساعدة المراجعات For
القيم الممكنة. إذا لم يتم تعريفها، معلومات سرية سيتم عرض مجموعة التغييرات

• changeset يتم تقديم القالب. محتويات Changesettag, Changesetbookmark,
com.filenodelink, com.filenolink، ويمكن استخدام القوالب العديدة المتعلقة بالاختلافات
إنتاج الإخراج.

/shortlog
إظهار المعلومات الأساسية حول مجموعة من مجموعات التغييرات.

هذا يقبل نفس المعلمات مثل التغيير معالج. والفرق الوحيد هو
سجل قصير سيتم تقديم القالب بدلاً من التغيير قالب.

/ملخص
عرض ملخص لحالة المستودع.

يتم التقاط معلومات حول أحدث مجموعات التغييرات والإشارات المرجعية والعلامات والفروع من خلال هذا
معالج.

• ملخص يتم تقديم القالب.

/ العلامات
عرض معلومات حول العلامات.

لا يتم قبول أي حجج.

• علامات يتم تقديم القالب.

تقني التطبيق TOPICS

بال
حاوية لتبادل بيانات المستودع

com.changegroups
تمثيل بيانات سجل الأحداث

مدونات الفيديو
آلية تخزين المراجعة

دمج آدوات

لدمج الملفات، يستخدم Mercurial أدوات الدمج.

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

يتم استخدام أدوات الدمج لكل من hg حل, hg دمج, hg تحديث, hg تراجع وفي عدة
ملحقات.

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

متوفرة دمج أدوات
يتم تكوين أدوات الدمج الخارجية وخصائصها في تكوين أدوات الدمج
القسم - انظر hgrc(5) - ولكن غالبًا ما يمكن تسميتها حسب الملف القابل للتنفيذ.

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

هناك بعض أدوات الدمج الداخلي التي يمكن استخدامها. أدوات الدمج الداخلي هي:

:أحمق

إنشاء ثلاثة إصدارات من الملفات المراد دمجها، تحتوي على محتويات الملف المحلي،
أخرى وقاعدة. يمكن بعد ذلك استخدام هذه الملفات لإجراء الدمج يدويًا. إذا
الملف المراد دمجه اسمه a.txt، سيتم تسمية هذه الملفات وفقًا لذلك
a.txt.local, a.txt.other و a.txt.base وسيتم وضعها في نفسه
الدليل كملف a.txt.

:يفشل

بدلاً من محاولة دمج الملفات التي تم تعديلها في كلا الفرعين، فإنه يضع علامة
لهم باعتبارها دون حل. يجب استخدام أمر الحل لحل هذه التعارضات.

:محلي

يستخدم الإصدار المحلي من الملفات كإصدار مدمج.

:دمج

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

:دمج محلي

مثل :merge، لكن قم بحل جميع التعارضات بشكل غير تفاعلي لصالح المحلي
التغييرات.

:دمج-أخرى

مثل :merge، لكن يتم حل جميع التعارضات بشكل غير تفاعلي لصالح الآخر
التغييرات.

:دمج3

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

:آخر

يستخدم الإصدار الآخر من الملفات كإصدار مدمج.

:اِسْتَدْعَى

يسأل المستخدم عن الإصدار المحلي أو الإصدار الآخر الذي سيتم الاحتفاظ به كإصدار مدمج
الإصدار.

:tagmerge

يستخدم خوارزمية دمج العلامات الداخلية (تجريبية).

:اتحاد

يستخدم خوارزمية الدمج البسيطة الداخلية غير التفاعلية لدمج الملفات. فإنه سوف
استخدم كلا الجانبين الأيسر والأيمن لمناطق الصراع. لم يتم إدراج أي علامات.

الأدوات الداخلية متاحة دائمًا ولا تتطلب واجهة مستخدم رسومية ولكنها لا تتطلب ذلك افتراضيًا
التعامل مع الارتباطات الرمزية أو الملفات الثنائية.

اختيار a دمج أداة
يستخدم Mercurial هذه القواعد عند تحديد أداة الدمج التي سيتم استخدامها:

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

2. إذا كان HGMERGE متغير البيئة موجود، وقيمته مستخدمة ويجب أن تكون كذلك
قابل للتنفيذ بواسطة الصدفة.

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

4. إذا تم تعيين ui.merge فسيتم اعتباره بعد ذلك. إذا كانت القيمة ليست اسم أ
الأداة التي تم تكوينها، يتم استخدام القيمة المحددة ويجب أن تكون قابلة للتنفيذ بواسطة Shell.
وإلا فسيتم استخدام الأداة المسماة إذا كانت قابلة للاستخدام.

5. في حالة وجود أي أدوات دمج قابلة للاستخدام في قسم تكوين أدوات الدمج، فإن الأداة
يتم استخدام الأولوية القصوى.

6. إذا كان البرنامج اسمه hgmerge يمكن العثور عليها على النظام، يتم استخدامه - ولكن سيتم ذلك
لا يمكن استخدامه افتراضيًا للارتباطات الرمزية والملفات الثنائية.

7. إذا كان الملف المراد دمجه ليس ثنائيًا وليس رابطًا رمزيًا، فهو داخلي :دمج is
مستخدم.

8. فشل دمج الملف ويجب حله قبل الالتزام.

ملاحظة: بعد تحديد برنامج الدمج، سيحاول Mercurial بشكل افتراضي دمج الملف
الملفات باستخدام خوارزمية دمج بسيطة أولاً. فقط إذا لم ينجح بسبب
التغييرات المتعارضة سوف يقوم Mercurial بالفعل بتنفيذ برنامج الدمج. حتى ل
استخدام خوارزمية الدمج البسيطة أولاً يمكن التحكم فيها من خلال الإعداد المسبق لـ
أداة الدمج. يتم تمكين الدمج المسبق افتراضيًا ما لم يكن الملف ثنائيًا أو ملف
رابط رمزي.

راجع أدوات الدمج وأقسام واجهة المستخدم في hgrc(5) للحصول على تفاصيل حول تكوين الدمج
الأدوات.

التحديد مضاعف التنقيحات

عندما يقبل Mercurial أكثر من مراجعة واحدة، فقد يتم تحديدها بشكل فردي، أو
يتم تقديمه كنطاق مستمر طوبولوجيًا، مفصولاً بالحرف ":.

صيغة تدوين النطاق هي [BEGIN]:[END]، حيث BEGIN وEND هما المراجعة
معرفات. كل من BEGIN و END اختياريان. إذا لم يتم تحديد BEGIN، فسيتم تعيينه بشكل افتراضي
رقم المراجعة 0. إذا لم يتم تحديد END، فسيتم تعيينه افتراضيًا على الطرف. النطاق ): "هكذا
يعني "جميع المراجعات".

إذا كانت قيمة BEGIN أكبر من END، فسيتم التعامل مع المراجعات بترتيب عكسي.

يعمل النطاق كفاصل زمني مغلق. وهذا يعني أن النطاق 3:5 يعطي 3 و4 و5.
وبالمثل، فإن المدى 9:6 يعطي 9، 8، 7، و6.

FILE اسم أنماط - رسم

يقبل Mercurial العديد من الرموز لتحديد ملف واحد أو أكثر في المرة الواحدة.

افتراضيًا، يتعامل Mercurial مع أسماء الملفات على أنها أنماط كروية موسعة بنمط الصدفة.

يجب تحديد تدوينات النمط البديل بشكل صريح.

ملاحظة الأنماط المحددة في .hginore ليست متجذرة. لطفا أنظر hg مساعدة hgignore For
تفاصيل.

لاستخدام اسم مسار عادي دون أي مطابقة للنمط، ابدأ باستخدامه المسار:. هذه المسار
يجب أن تتطابق الأسماء تمامًا بدءًا من جذر المستودع الحالي.

لاستخدام الكرة الأرضية الموسعة، ابدأ اسمًا بـ الكرة الأرضية:. الكرات متجذرة في التيار
الدليل؛ الكرة الأرضية مثل * .c سيطابق فقط الملفات الموجودة في الدليل الحالي الذي ينتهي بـ
.c.

ملحقات بناء الجملة العالمية المدعومة هي ** لمطابقة أي سلسلة عبر فواصل المسار و
{أ، ب} ليعني "أ أو ب".

لاستخدام تعبير Perl/Python العادي، ابدأ اسمًا بـ إعادة:. مطابقة نمط التعبير العادي
يرتكز على جذر المستودع.

لقراءة أنماط الأسماء من ملف، استخدم ملف القائمة: or ملف القائمة0:. هذا الأخير يتوقع فارغة
أنماط محددة بينما يتوقع الأول خلاصات الأسطر. كل سلسلة تقرأ من الملف هي
يتم التعامل مع نفسه كنمط ملف.

لقراءة مجموعة من الأنماط من ملف، استخدم تتضمن: or تضمين فرعي:. تتضمن: سوف تستخدم كل شيء
الأنماط من الملف المحدد والتعامل معها كما لو تم تمريرها يدويًا.
تضمين فرعي: سيتم تطبيق الأنماط فقط على الملفات الموجودة ضمن التضمين الفرعي
دليل الملف. يرى hg مساعدة hgignore للحصول على تفاصيل حول تنسيق هذه الملفات.

جميع الأنماط، باستثناء الكرة الأرضية: المحدد في سطر الأوامر (وليس لـ -I or -X خيارات)، يمكن
تتطابق أيضًا مع الدلائل: يتم التعامل مع الملفات الموجودة ضمن الدلائل المتطابقة على أنها متطابقة.

أمثلة واضحة:

المسار: foo/bar شريط اسم في دليل اسمه foo في الجذر
من المستودع
المسار: المسار: اسم ملف أو دليل يسمى "المسار: الاسم"

أمثلة الكرة الأرضية:

glob:*.c أي اسم ينتهي بـ ".c" في الدليل الحالي
*.c أي اسم ينتهي بـ ".c" في الدليل الحالي
**.c أي اسم ينتهي بـ ".c" في أي دليل فرعي لـ
الدليل الحالي بما في ذلك نفسه.
foo/*.c أي اسم ينتهي بـ ".c" في الدليل foo
foo/**.c أي اسم ينتهي بـ ".c" في أي دليل فرعي لـ foo
بما في ذلك نفسها.

أمثلة التعبير العادي:

re:.*\.c$ أي اسم ينتهي بـ ".c"، في أي مكان في المستودع

أمثلة الملف:

listfile:list.txt قراءة القائمة من list.txt مع نمط ملف واحد في كل سطر
listfile0:list.txt قراءة القائمة من list.txt مع محددات البايت الخالية

انظر أيضا hg مساعدة مجموعات الملفات.

قم بتضمين أمثلة:

include:path/to/mypatternfile يقرأ الأنماط التي سيتم تطبيقها على كافة المسارات
subinclude:path/to/subignorefile يقرأ الأنماط خصيصًا للمسارات الموجودة في ملف
الدليل

العمل مع المراحل

ابحث عن . المراحل؟
المراحل عبارة عن نظام لتتبع مجموعات التغييرات التي تمت أو يجب مشاركتها. هذا
يساعد على منع الأخطاء الشائعة عند تعديل السجل (على سبيل المثال، باستخدام mq أو rebase
ملحقات).

تمر كل مجموعة تغييرات في المستودع بإحدى المراحل التالية:

· عامة: تكون مجموعة التغييرات مرئية على خادم عام

· المسودة: لم يتم نشر مجموعة التغييرات بعد

· سر: لا ينبغي دفع مجموعة التغييرات أو سحبها أو استنساخها

هذه المراحل مرتبة (عامة <مسودة <سرية) ولا يمكن أن تكون مجموعة التغييرات في مستوى أقل
المرحلة من أسلافه. على سبيل المثال، إذا كانت مجموعة التغييرات عامة، فإن جميع أسلافها عامة
عامة أيضا. وأخيرًا، يجب تغيير مراحل مجموعة التغييرات فقط نحو المرحلة العامة.

كيفية . المراحل تمكنت؟
بالنسبة للجزء الأكبر، يجب أن تعمل المراحل بشفافية. بشكل افتراضي، يتم إنشاء مجموعة التغييرات في
مرحلة المسودة ويتم نقلها إلى المرحلة العامة عندما يتم دفعها إلى مرحلة أخرى
مستودع.

بمجرد أن تصبح مجموعات التغييرات عامة، سيتم رفض تشغيل الإضافات مثل mq وrebase
لهم لمنع إنشاء مجموعات التغييرات المكررة. يمكن أيضًا معالجة المراحل يدويًا
مع الالجائزة hg مرحلة جديدة الأمر إذا لزم الأمر. يرى hg مساعدة -v مرحلة جديدة للحصول على أمثلة.

لجعل التزاماتك سرية بشكل افتراضي، ضع هذا في ملف التكوين الخاص بك:

[المراحل]
التزام جديد = سر

المراحل و الخوادم
عادة، كافة الخوادم نشر بشكل افتراضي. هذا يعنى:

- تظهر جميع مجموعات التغييرات المسودة التي تم سحبها أو استنساخها على مراحل
العامة على العميل

- تظهر جميع مجموعات التغييرات المسودة التي تم دفعها كعامة في كليهما
العميل والخادم

- لا يتم دفع مجموعات التغييرات السرية أو سحبها أو استنساخها

ملاحظة: لا يؤدي سحب مسودة مجموعة التغييرات من خادم النشر إلى وضع علامة عليها كعامة
جانب الخادم بسبب طبيعة السحب للقراءة فقط.

في بعض الأحيان قد يكون من المرغوب فيه دفع مجموعات التغييرات وسحبها في مرحلة المسودة للمشاركة
عمل غير مكتمل. يمكن القيام بذلك عن طريق تعيين مستودع لتعطيل النشر فيه
ملف الضبط:

[المراحل]
نشر = خطأ

يرى hg مساعدة التكوين لمزيد من المعلومات حول ملفات التكوين.

ملاحظة: يتم التعامل مع الخوادم التي تعمل بإصدارات أقدم من Mercurial على أنها نشر.

ملاحظة: لا يتم تبادل مجموعات التغييرات في المرحلة السرية مع الخادم. وهذا ينطبق عليهم
المحتوى: أسماء الملفات ومحتويات الملف وبيانات تعريف مجموعة التغييرات. لأسباب فنية،
قد يتم إرسال المعرف (على سبيل المثال d825e4025e39) لمجموعة التغييرات السرية إلى
الخادم.

أمثلة
· قائمة التغييرات في المرحلة المسودة أو السرية:

سجل hg -r "ليس عامًا ()"

· تغيير كافة مجموعات التغييرات السرية للمسودة:

مرحلة الزئبق - مسودة "سرية ()"

· نقل مجموعة التغييرات الحالية وأحفادها بالقوة من العامة إلى المسودة:

مرحلة الزئبق - القوة - المسودة.

· عرض قائمة بمراجعة مجموعة التغييرات والمرحلة:

سجل hg --قالب "{rev} {phase}\n"

· إعادة مزامنة مسودة مجموعات التغييرات مع مستودع بعيد:

مرحلة الزئبق -fd "الصادرة (URL)"

يرى hg مساعدة مرحلة جديدة لمزيد من المعلومات حول مراحل المعالجة يدويًا.

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

يدعم Mercurial عدة طرق لتحديد المراجعات الفردية.

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

يتم التعامل مع السلسلة السداسية العشرية المكونة من 40 رقمًا كمعرف مراجعة فريد.

يتم التعامل مع السلسلة السداسية العشرية التي يقل طولها عن 40 حرفًا على أنها مراجعة فريدة
المعرف ويشار إليه كمعرف قصير. المعرف المختصر هو فقط
صالحة إذا كانت بادئة معرف واحد كامل الطول.

يتم التعامل مع أي سلسلة أخرى كإشارة مرجعية أو علامة أو اسم فرع. الإشارة المرجعية هي منقولة
مؤشر للمراجعة. العلامة هي اسم دائم مرتبط بالمراجعة. اسم فرع
يشير إلى أعلى رأس فرع مفتوح لهذا الفرع - أو إذا كانت جميعها مغلقة، فإن
أقصى رأس مغلق للفرع. يجب ألا تحتوي أسماء الإشارات المرجعية والعلامات والفروع على
":" شخصية.

الاسم المحجوز "نصيحة" يحدد دائمًا المراجعة الأحدث.

يشير الاسم المحجوز "فارغ" إلى المراجعة الفارغة. هذه هي المراجعة فارغة
المستودع، وأصل المراجعة 0.

الاسم المحجوز "." يشير إلى أصل دليل العمل. إذا لم يكن هناك دليل العمل
سحبها، وهو ما يعادل فارغة. إذا كانت هناك عملية دمج غير ملتزم بها قيد التقدم، "." هل
مراجعة الوالد الأول.

التحديد مراجعة الاطقم

يدعم Mercurial لغة وظيفية لاختيار مجموعة من المراجعات.

تدعم اللغة عددًا من المسندات التي يتم ضمها بواسطة عوامل infix.
يمكن استخدام الأقواس للتجميع.

قد تحتاج المعرفات مثل أسماء الفروع إلى علامات اقتباس مفردة أو مزدوجة إذا كانت
تحتوي على أحرف مثل - أو إذا كانت تطابق أحد المسندات المحددة مسبقًا.

يمكن استخدام الأحرف الخاصة في المعرفات المقتبسة عن طريق الهروب منها، على سبيل المثال، \n is
يتم تفسيره على أنه سطر جديد. لمنع تفسيرها، يمكن إضافة البادئات إلى السلاسل
مع r، على سبيل المثال ص '...'.

يوجد عامل بادئة واحد:

ليس x

مجموعات التغيير ليست في x. الشكل القصير هو ! x.

هذه هي عوامل تشغيل infix المدعومة:

س::ص

نطاق DAG، ويعني جميع مجموعات التغييرات التي هي من نسل x وأسلاف y،
بما في ذلك x وy أنفسهم. إذا تم استبعاد نقطة النهاية الأولى، فهذا يعادل
إلى الأجداد (ذ)، فإذا ترك الثاني كان يعادل أحفاد (خ).

بناء الجملة البديل هو س..ي.

س: ذ

جميع مجموعات التغييرات التي تحتوي على أرقام مراجعة بين x وy، كلاهما شامل. أيضاً
يمكن استبعاد نقطة النهاية، فهي افتراضية على 0 وتلميح.

x و y

تقاطع مجموعات التغييرات في x و y. الشكل القصير هو x & y.

x or y

اتحاد مجموعات التغييرات في x و y. هناك نوعان من النماذج القصيرة البديلة: x | y
و x + y.

x - y

قم بتغيير المجموعات في x ولكن ليس في y.

س ^ ن

الوالد n لـ x أو n == 0 أو 1 أو 2. بالنسبة إلى n == 0, x; لـ n == 1، الوالد الأول
لكل مجموعة تغييرات في x؛ بالنسبة لـ n == 2، الأصل الثاني لمجموعة التغييرات في x.

س ~ ن

الجد الأول لـ x؛ س~0 هو س؛ س~3 is س^^^.

يوجد عامل postfix واحد:

x^

أي ما يعادل س ^ 1، الوالد الأول لكل مجموعة تغييرات في x.

يتم دعم المسندات التالية:

يضيف (نمط)

مجموعات التغييرات التي تضيف نمطًا مطابقًا للملف.

النمط بدون نوع صريح مثل الكرة الأرضية: ومن المتوقع أن تكون نسبة إلى
الدليل الحالي وتطابق مع ملف أو دليل.

الكل()

جميع مجموعات التغييرات، نفس 0: نصيحة.

سلف (* مجموعة التغييرات)

أكبر سلف مشترك لمجموعات التغييرات.

يقبل 0 أو أكثر من مجموعات التغييرات. سيعود قائمة فارغة عندما لا يتم تمرير أي وسيطات.
أكبر سلف مشترك لمجموعة تغييرات واحدة هو مجموعة التغييرات تلك.

الأجداد (مجموعة)

مجموعات التغييرات التي هي أسلاف مجموعة التغييرات في المجموعة.

المؤلف (سلسلة)

الاسم المستعار لـ المستخدم (سلسلة).

منصف (سلسلة)

تم وضع علامة على مجموعات التغييرات في حالة النصف المحددة:

· خير, سيئة, تخطى: تم وضع علامة واضحة على csets على أنها جيدة/سيئة/تخطي

· بضائع, الشر : مجموعات csets جيدة/سيئة طوبولوجيًا

· نطاق : csets المشاركة في التنصيف

· مجردة : مجموعات csets التي هي سلع أو سيئة أو تم تخطيها

· لم تختبر : csets الذي مصيره غير معروف حتى الآن

· تجاهل : تم تجاهل مجموعات csets بسبب طوبولوجيا DAG

· تيار : مجموعة cset التي يتم تقسيمها حاليًا

الإشارة المرجعية([الاسم])

الإشارة المرجعية المسماة أو كافة الإشارات المرجعية.

If الاسم ابدا ب إعادة:، ويتم التعامل مع باقي الاسم على أنه عادي
تعبير. لمطابقة إشارة مرجعية تبدأ فعليًا بـ إعادة:، استخدم البادئة
حرفي:.

فرع (سلسلة or جلس)

جميع مجموعات التغييرات التي تنتمي إلى فرع معين أو فروع معينة
مجموعات التغييرات.

If سلسلة ابدا ب إعادة:، ويتم التعامل مع باقي الاسم على أنه عادي
تعبير. لمطابقة الفرع الذي يبدأ بالفعل بـ إعادة:، استخدم البادئة
حرفي:.

نقطة تفرع()

مجموعات التغيير مع أكثر من طفل واحد.

صدم ()

تم وضع علامة على مجموعات التغييرات القابلة للتغيير على أنها خلفاء لمجموعات التغييرات العامة.

يمكن فقط أن تكون مجموعات التغييرات غير العامة وغير القديمة صدم.

باقة()

مجموعات التغيير في الحزمة.

يجب تحديد الحزمة بواسطة الخيار -R.

أطفال (مجموعة)

مجموعات التغييرات التابعة لمجموعات التغييرات في المجموعة.

مغلق()

تم إغلاق مجموعة التغييرات.

يحتوي على (نمط)

يحتوي بيان المراجعة على نمط مطابق للملف (لكن قد لا يقوم بتعديله).
يرى hg مساعدة أنماط للحصول على معلومات حول أنماط الملفات.

النمط بدون نوع صريح مثل الكرة الأرضية: ومن المتوقع أن تكون نسبة إلى
الدليل الحالي ومطابقته مع ملف بالضبط من أجل الكفاءة.

تم التحويل ([المعرف])

تم تحويل مجموعات التغييرات من المعرف المحدد في المستودع القديم إذا كان موجودًا، أو
جميع مجموعات التغييرات المحولة إذا لم يتم تحديد معرف.

التاريخ (الفاصل الزمني)

Changesets ضمن الفاصل الزمني، انظر hg مساعدة التمور.

تنازلي (سلسلة)

ابحث عن رسالة الالتزام للسلسلة. المطابقة غير حساسة لحالة الأحرف.

أحفاد (مجموعة)

مجموعات التغييرات التي هي من نسل مجموعات التغييرات في المجموعة.

الوجهة([مجموعة])

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

متشعب()

الخلفاء النهائيون لمجموعات التغييرات مع مجموعة بديلة من الخلفاء النهائيين.

مسودة()

مجموعة التغييرات في مرحلة المسودة.

ينقرض()

مجموعات التغييرات القديمة مع السلالات القديمة فقط.

اضافية (التسمية، [قيمة])

قم بتغيير المجموعات باستخدام التسمية المحددة في البيانات الوصفية الإضافية، مع الاختياري المحدد
.

If قيمنا ابدا ب إعادة:، ويتم التعامل مع باقي القيمة على أنها عادية
تعبير. لمطابقة قيمة تبدأ فعليًا بـ إعادة:، استخدم البادئة
حرفي:.

ملف (نمط)

مجموعات التغييرات التي تؤثر على الملفات المطابقة للنمط.

للحصول على نتيجة أسرع ولكن أقل دقة، فكر في الاستخدام سجل الملفات () بدلا من ذلك.

يستخدم هذا المسند الكرة الأرضية: كنوع افتراضي من النمط.

سجل الملفات (النمط)

مجموعات التغييرات متصلة بسجل الملفات المحدد.

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

النمط بدون نوع صريح مثل الكرة الأرضية: ومن المتوقع أن تكون نسبة إلى
الدليل الحالي ومطابقته مع ملف بالضبط من أجل الكفاءة.

إذا كانت بعض الروابط تشير إلى المراجعات التي تمت تصفيتها بواسطة العرض الحالي، فسنعمل
حوله لإرجاع قيمة غير تمت تصفيتها.

المجموعة الأولى، [ن])

اسم مستعار للحد ().

اتبع ([نمط])

اسم مستعار لـ ::. (أسلاف الأصل الأول لدليل العمل). إذا كان النمط
يتم تحديد تاريخ الملفات المطابقة للنمط المحدد، بما في ذلك
نسخة.

grep(التعبير العادي)

اعجاب الكلمة الأساسية (سلسلة) لكنه يقبل regex. يستخدم جريب (ص '...') لضمان هروب خاص
يتم التعامل مع الأحرف بشكل صحيح. على عكس الكلمة الأساسية (سلسلة)، المباراة هي
حساسية الموضوع.

رأس()

Changeset هو رأس فرع مسمى.

رؤساء (مجموعة)

أعضاء المجموعة بدون أطفال في المجموعة.

مختفي()

مجموعات التغييرات المخفية

معرف (سلسلة)

تم تحديد المراجعة بشكل غير غامض بواسطة بادئة السلسلة السداسية المحددة.

الكلمة الأساسية (سلسلة)

ابحث عن رسالة الالتزام واسم المستخدم وأسماء الملفات التي تم تغييرها للسلسلة. المباراة
غير حساس لحالة الأحرف.

آخر (مجموعة، [ن])

آخر n من الأعضاء في المجموعة، الافتراضي هو 1.

الحد (مجموعة [، ن[، عوض]])

أول n من أعضاء المجموعة، الافتراضي هو 1، بدءًا من الإزاحة.

مطابقة (مراجعة [, مجال])

مجموعات التغييرات التي تتطابق فيها مجموعة معينة من الحقول مع مجموعة الحقول الموجودة في المجموعة المحددة
مراجعة أو تعيين.

لمطابقة أكثر من حقل، قم بتمرير قائمة الحقول المراد مطابقتها مفصولة بمسافات
(على سبيل المثال المؤلفة وصف).

الحقول الصالحة هي معظم حقول المراجعة العادية وبعض الحقول الخاصة.

حقول المراجعة العادية هي وصف, المؤلفة , خيران, تاريخ, ملفات, مرحلة جديدة,
الآباء, الحالة الفرعية, المستخدم و فرق. لاحظ أن المؤلفة و المستخدم هي المرادفات. فرق
يشير إلى محتويات المراجعة. نسختان مطابقتان لهما فرق سوف أيضا
تطابق بهم ملفات.

الحقول الخاصة هي ملخص و البيانات الوصفية: ملخص يطابق السطر الأول من
وصف. البيانات الوصفية يعادل المطابقة وصف المستخدم تاريخ (أي ذلك
يطابق حقول البيانات الوصفية الرئيسية).

البيانات الوصفية هو الحقل الافتراضي الذي يتم استخدامه عند عدم تحديد أي حقول. أنت تستطيع
مطابقة أكثر من حقل في نفس الوقت.

الحد الأقصى (مجموعة)

مجموعة التغييرات مع أعلى رقم مراجعة في المجموعة.

دمج()

Changeset عبارة عن مجموعة تغييرات مدمجة.

دقيقة (مجموعة)

مجموعة التغييرات مع أقل رقم مراجعة في المجموعة.

يعدل (نمط)

يقوم Changesets بتعديل الملفات المطابقة للنمط.

النمط بدون نوع صريح مثل الكرة الأرضية: ومن المتوقع أن تكون نسبة إلى
الدليل الحالي وتطابق مع ملف أو دليل.

اسمه (مساحة الاسم)

مجموعات التغييرات في مساحة اسم معينة.

If مساحة الاسم ابدا ب إعادة:، يتم التعامل مع بقية السلسلة على أنها عادية
تعبير. لمطابقة مساحة الاسم التي تبدأ فعليًا بـ إعادة:، استخدم البادئة
حرفي:.

عفا عليها الزمن()

مجموعة تغييرات قابلة للتغيير مع إصدار أحدث.

فقط (مجموعة، [تعيين])

مجموعات التغييرات التي هي أسلاف المجموعة الأولى وليست أسلافًا لأي مجموعة أخرى
رئيس في الريبو. إذا تم تحديد مجموعة ثانية، والنتيجة هي أسلاف
المجموعة الأولى التي ليست أسلاف المجموعة الثانية (أي :: - :: ).

الأصل ([مجموعة])

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

الصادرة([المسار])

لم يتم العثور على مجموعات التغييرات في مستودع الوجهة المحدد، أو في الدفع الافتراضي
الموقع.

ص1([مجموعة])

الأصل الأول لمجموعات التغييرات في المجموعة، أو دليل العمل.

ص2([مجموعة])

الأصل الثاني لمجموعات التغييرات في المجموعة، أو دليل العمل.

الوالدين([مجموعة])

مجموعة جميع الوالدين لجميع مجموعات التغييرات في المجموعة، أو دليل العمل.

الحاضر (مجموعة)

مجموعة فارغة، إذا لم يتم العثور على أي مراجعة في المجموعة؛ خلاف ذلك، كافة المراجعات في المجموعة.

إذا لم يكن أي من المراجعات المحددة موجودًا في المستودع المحلي، فسيكون الاستعلام
إحباط عادة. لكن هذا المسند يسمح للاستعلام بالاستمرار حتى في مثل هذا
الحالات.

عام()

مجموعة التغييرات في المرحلة العامة.

عن بعد([معرف [،طريق]])

المراجعة المحلية التي تتوافق مع المعرف المحدد في مستودع بعيد، إذا
حاضر. هنا، "." المعرف هو مرادف للفرع المحلي الحالي.

يزيل (النمط)

مجموعات التغييرات التي تزيل الملفات المطابقة للنمط.

النمط بدون نوع صريح مثل الكرة الأرضية: ومن المتوقع أن تكون نسبة إلى
الدليل الحالي وتطابق مع ملف أو دليل.

مراجعة (رقم)

المراجعة باستخدام المعرف الرقمي المحدد.

عكس (مجموعة)

عكس ترتيب المجموعة.

جذور (مجموعة)

مجموعات التغييرات في المجموعة مع عدم وجود مجموعة تغييرات أصل في المجموعة.

سر()

مجموعة التغييرات في المرحلة السرية.

فرز (مجموعة [، [-]مفتاح...])

فرز حسب المفاتيح. ترتيب الفرز الافتراضي تصاعدي، حدد مفتاحًا كـ -مفتاح إلى
فرز بالترتيب التنازلي.

يمكن أن تكون المفاتيح:

· تزيد السرعة بالنسبة لرقم المراجعة

· خيران بالنسبة لاسم الفرع

· تنازلي لرسالة الالتزام (الوصف)،

· المستخدم لاسم المستخدم (المؤلفة يمكن استخدامها كاسم مستعار)،

· تاريخ لتاريخ الالتزام

ريبو فرعي([نمط])

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

العلامة ([الاسم])

العلامة المحددة بالاسم، أو جميع المراجعات ذات العلامات إذا لم يتم ذكر اسم.

If الاسم ابدا ب إعادة:، ويتم التعامل مع باقي الاسم على أنه عادي
تعبير. لمطابقة علامة تبدأ فعليًا بـ إعادة:، استخدم البادئة حرفي:.

غير مستقر()

مجموعات التغييرات غير القديمة مع أسلاف عفا عليها الزمن.

المستخدم (سلسلة)

اسم المستخدم يحتوي على سلسلة. المطابقة غير حساسة لحالة الأحرف.

If سلسلة ابدا ب إعادة:، يتم التعامل مع بقية السلسلة على أنها عادية
تعبير. لمطابقة مستخدم يحتوي بالفعل إعادة:، استخدم البادئة حرفي:.

يمكن تعريف المسندات الجديدة (المعروفة باسم "الأسماء المستعارة") باستخدام أي مجموعة من المسندات الموجودة
المسندات أو الأسماء المستعارة الأخرى. يبدو تعريف الاسم المستعار كما يلي:

=

في ال com.revsetalias قسم من ملف التكوين Mercurial. حجج النموذج $1,
$2، وما إلى ذلك يتم استبدالها من الاسم المستعار في التعريف.

على سبيل المثال،

[revsetalias]
ح = رؤساء ()
د($1) = الفرز($1، التاريخ)
رس($1, $2) = عكس(فرز($1, $2))

يحدد ثلاثة أسماء مستعارة، h, dو rs. روبية (0: نصيحة، مؤلف) يعادل بالضبط
عكس (فرز (0: نصيحة، مؤلف)).

عامل infix ## يمكن ربط السلاسل والمعرفات في سلسلة واحدة. على سبيل المثال:

[revsetalias]
المشكلة($1) = grep(r'\bissue[ :]?' ## $1 ## r'\b|\bbug\(' ## $1 ## r'\)')

قضية1234 ما يعادل grep(r'\bissue[ :]?1234\b|\bbug\(1234\)') في هذه الحالة. هذا
يتطابق مع جميع "الإصدار 1234" و"الإصدار: 1234" و"الإصدار 1234" و"علة(1234) ".

تتمتع جميع عوامل تشغيل البادئة وinfix وpostfix الأخرى بأولوية أقل من ##. على سبيل المثال، $1
## ~ $ 2 2 ما يعادل ($ 1 ## $2)~2.

معادلات سطر الأوامر ل hg سجل:

-ف -> ::.
-dx -> التاريخ(x)
-kx -> الكلمة الأساسية(x)
-م -> دمج ()
-ux -> المستخدم(x)
-bx -> الفرع (x)
-ف س -> !::x
-lx -> الحد (expr، x)

بعض نماذج الاستعلامات:

· مجموعات التغيير على الفرع الافتراضي:

hg log -r "فرع (افتراضي)"

· مجموعات التغييرات على الفرع الافتراضي منذ العلامة 1.5 (باستثناء عمليات الدمج):

hg log -r "فرع (افتراضي) و1.5 :: وليس دمج ()"

· فتح رؤوس الفروع:

hg log -r "head () وغير مغلق ()"

· التغييرات بين العلامات 1.3 و 1.5 مع ذكر "الشوائب" التي تؤثر هجيكست/*:

hg log -r "1.3::1.5 والكلمة الرئيسية (bug) والملف ('hgext/*')"

· مجموعات التغييرات التي تم إجراؤها في مايو 2008، مرتبة حسب المستخدم:

hg log -r "sort(date('May 2008'), user)"

· مجموعات التغييرات التي تشير إلى "خطأ" أو "مشكلة" غير موجودة في الإصدار الموسوم:

hg log -r "(الكلمة الرئيسية (خطأ) أو الكلمة الأساسية (المشكلة)) وليس الأسلاف (العلامة ())"

باستخدام زئبقي من عند نصوص لأي لبس التشغيل الآلي

من الشائع أن تستهلك الآلات (على عكس البشر) عقار Mercurial. موضوع المساعدة هذا
يصف بعض الاعتبارات الخاصة بربط الأجهزة مع Mercurial.

اختيار an السطح البيني
يمكن للآلات الاختيار من بين عدة طرق للتفاعل مع Mercurial. وتشمل هذه:

· تنفيذ hg عملية المعالجة

· الاستعلام عن خادم HTTP

· الاتصال بخادم الأوامر

تنفيذ hg تشبه العمليات إلى حد كبير كيفية تفاعل البشر مع Mercurial في القشرة.
يجب أن تكون مألوفة لك بالفعل.

hg خدمة يمكن استخدامها لبدء الخادم. افتراضيًا، سيؤدي هذا إلى تشغيل خادم HTTP "hgweb".
يدعم خادم HTTP هذا المخرجات التي يمكن قراءتها آليًا، مثل JSON. للمزيد راجع hg
مساعدة hgweb.

hg خدمة يمكن أيضًا بدء تشغيل "خادم الأوامر". يمكن للعملاء الاتصال بهذا الخادم والمشكلة
أوامر Mercurial عبر بروتوكول خاص. لمزيد من التفاصيل حول خادم الأوامر،
بما في ذلك الروابط إلى مكتبات العملاء، راجع https://mercurial.selenic.com/wiki/CommandServer.

hg خدمة تتمتع الواجهات القائمة على (hgweb وخوادم الأوامر) بميزة مقارنة بالواجهات البسيطة
hg معالجة الدعوات حيث أنها على الأرجح أكثر كفاءة. هذا لأن هناك
عبء كبير لتفرخ عمليات بايثون جديدة.

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

البيئة المتغيرات
كما هو موثق في hg مساعدة بيئة، تؤثر متغيرات البيئة المختلفة على
تشغيل الزئبق. ما يلي ذو صلة بشكل خاص بالآلات المستهلكة
زئبقي:

HGPLAIN
إذا لم يتم ضبطه، فقد يتأثر مخرجات Mercurial بإعدادات التكوين التي
التأثير على ترميزه ووضعه المطول وتوطينه وما إلى ذلك.

يوصى بشدة أن تقوم الأجهزة بتعيين هذا المتغير عند استدعاءه hg
العمليات.

التشفير
إذا لم يتم تعيينها، فسيتم اكتشاف اللغة التي يستخدمها Mercurial من البيئة. لو
اللغة المحددة لا تدعم عرض أحرف معينة، قد يكون Mercurial
عرض تسلسلات الأحرف هذه بشكل غير صحيح (غالبًا باستخدام "؟" كعنصر نائب
للأحرف غير الصالحة في اللغة الحالية).

يعد تعيين متغير البيئة هذا بشكل صريح ممارسة جيدة يجب ضمانها
نتائج متسقة. يعد "utf-8" خيارًا جيدًا في البيئات المشابهة لـ UNIX.

HGRCPATH
إذا لم يتم تعيينه، فسوف يرث Mercurial خيارات التكوين من ملفات التكوين باستخدام ملف
العملية الموضحة في hg مساعدة التكوين. يتضمن ذلك وراثة المستخدم أو على مستوى النظام
ملفات التكوين.

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

تستهلك أمر الناتج
من الشائع أن تحتاج الأجهزة إلى تحليل مخرجات أوامر Mercurial ذات الصلة
بيانات. يصف هذا القسم التقنيات المختلفة للقيام بذلك.

توزيع الخام أمر الناتج
من المحتمل أن يكون الحل الأبسط والأكثر فعالية لاستهلاك مخرجات الأوامر هو ببساطة
استدعاء hg الأوامر كما تفعل كمستخدم وتحليل مخرجاتها.

يمكن بسهولة تحليل مخرجات العديد من الأوامر باستخدام أدوات مثل البقرى, عطشو AWK.

الجانب السلبي المحتمل في تحليل مخرجات الأوامر هو أن مخرجات الأوامر يمكن أن تتغير
عند ترقية Mercurial. بينما يسعى Mercurial بشكل عام إلى التراجع القوي
التوافق، يتغير إخراج الأمر أحيانًا. إجراء اختبارات لجهازك الآلي
التفاعلات مع hg يوصى عمومًا بالأوامر، ولكنها أكثر أهمية عندما
يتم تضمين تحليل إخراج الأمر الخام.

باستخدام النماذج إلى مراقبة الناتج
كثير hg تدعم الأوامر الإخراج المعبأ عبر ملف -T/--قالب دعوى. للمزيد راجع
hg مساعدة النماذج.

تعتبر القوالب مفيدة للتحكم بشكل صريح في الإخراج بحيث تحصل على البيانات بالضبط
تريد تنسيقه بالطريقة التي تريدها. على سبيل المثال، سجل -T {عقدة}\n يمكن استخدامها لطباعة أ
قائمة محددة بالسطر الجديد لعقد مجموعة التغييرات بدلاً من المخرجات المصممة خصيصًا للإنسان والتي تحتوي على
المؤلفين، التواريخ، الأوصاف، الخ.

نصيحة إذا كان تحليل مخرجات الأمر الأولي معقدًا للغاية، ففكر في استخدام القوالب لإنشائها
حياتك أسهل.

• -T/--قالب تسمح الوسيطة بتحديد الأنماط المحددة مسبقًا. السفن الزئبقية مع
أنماط قابلة للقراءة آليًا جسون و XML، والتي توفر مخرجات JSON وXML، على التوالي.
تعتبر هذه مفيدة لإنتاج مخرجات يمكن قراءتها آليًا كما هي.

مهم
• جسون و XML تعتبر الأساليب تجريبية. في حين أنها قد تكون جذابة
لاستخدامها للحصول على مخرجات يمكن قراءتها آليًا بسهولة، قد يتغير سلوكهم
الإصدارات اللاحقة.

قد تظهر هذه الأنماط أيضًا نتائج غير متوقعة عند التعامل مع بعض الأنماط
الترميزات. يتعامل Mercurial مع أشياء مثل أسماء الملفات كسلسلة من البايتات و
تطبيع تسلسلات بايت معينة إلى JSON أو XML مع إعدادات تشفير معينة
يمكن أن يؤدي إلى مفاجآت.

أمر المخدم الناتج
إذا كنت تستخدم خادم الأوامر للتفاعل مع Mercurial، فمن المحتمل أنك تستخدم خادمًا موجودًا
Library/API التي تلخص تفاصيل تنفيذ خادم الأوامر. إذا كان الأمر كذلك، هذا
قد تقوم طبقة الواجهة بإجراء التحليل نيابةً عنك، مما يوفر عليك عناء تنفيذه
نفسك.

الناتج الإسهاب
غالبًا ما يكون للأوامر تنوع في إسهاب المخرجات، حتى عند وجود أنماط قابلة للقراءة آليًا
المستخدمة (على سبيل المثال -T جسون). إضافة -v / - مطول و --Debug إلى حجج الأمر يمكن
زيادة كمية البيانات التي يكشفها Mercurial.

هناك طريقة بديلة للحصول على البيانات التي تحتاجها وهي تحديد قالب بشكل صريح.

أخرى المواضيع
revsets
مجموعات المراجعات هي لغة استعلام وظيفية لاختيار مجموعة من المراجعات.
فكر في الأمر على أنه SQL لمستودعات Mercurial. Revsets مفيدة للاستعلام
مستودعات لبيانات محددة.

يرى hg مساعدة revsets للمزيد.

شارك تمديد
• شارك يوفر الامتداد وظيفة لمشاركة بيانات المستودع عبر
عدة نسخ عمل. يمكنه حتى "تجميع" التخزين تلقائيًا بشكل منطقي
المستودعات ذات الصلة عند الاستنساخ.

تكوين شارك يمكن أن يؤدي التمديد إلى استخدام كبير للموارد
الحد، وخاصة حول مساحة القرص والشبكة. هذا صحيح بشكل خاص
لبيئات التكامل المستمر (CI).

يرى hg مساعدة -e شارك للمزيد.

المستودعات الفرعية

تتيح لك المستودعات الفرعية دمج المستودعات أو المشاريع الخارجية في Mercurial الأصل
المستودع، وجعل الأوامر تعمل عليهم كمجموعة.

يدعم Mercurial حاليًا المستودعات الفرعية Mercurial وGit وSubversion.

تتكون المستودعات الفرعية من ثلاثة مكونات:

1. عمليات سحب المستودع المتداخلة. يمكن أن تظهر في أي مكان في دليل العمل الأصلي.

2. مراجع المستودع المتداخلة. يتم تعريفهم في .hgsub، والتي ينبغي وضعها في
جذر دليل العمل، وأخبر من أين تأتي عمليات سحب المستودع الفرعي.
تتم الإشارة إلى المستودعات الفرعية الزئبقية مثل:

المسار/إلى/المتداخل = https://example.com/nested/repo/path

يتم أيضًا دعم Git و Subversion subrepos:

path/to/nested = [git]git://example.com/nested/repo/path
المسار/إلى/المتداخل = [svn]https://example.com/nested/trunk/path

أين المسار/إلى/متداخل هو موقع الخروج نسبيًا إلى جذر Mercurial الأصلي،
و https://example.com/nested/repo/path هو مسار مستودع المصدر. يمكن للمصدر
قم أيضًا بالإشارة إلى مسار نظام الملفات.

نلاحظ أن .hgsub غير موجود افتراضيًا في مستودعات Mercurial، فيجب عليك ذلك
قم بإنشائه وإضافته إلى المستودع الأصلي قبل استخدام المستودعات الفرعية.

3. حالات المستودع المتداخلة. يتم تعريفهم في .hgsubstate، والذي يتم وضعه في الجذر
من دليل العمل، والتقاط أي معلومات مطلوبة لاستعادة
المستودعات الفرعية إلى الحالة التي تم الالتزام بها في مجموعة تغييرات المستودع الأصلي.
يقوم Mercurial تلقائيًا بتسجيل حالات المستودعات المتداخلة عند الالتزام في ملف
مستودع الوالدين.

ملاحظات
• .hgsubstate لا ينبغي تحرير الملف يدويا.

إضافة a مستودع فرعي
If .hgsub غير موجود، قم بإنشائه وإضافته إلى المستودع الأصلي. استنساخ أو الخروج
المشاريع الخارجية حيث تريد أن تعيش في المستودع الأصلي. يحرر .hgsub و
قم بإضافة إدخال المستودع الفرعي كما هو موضح أعلاه. عند هذه النقطة، المستودع الفرعي هو
يتم تعقبه وسيقوم الالتزام التالي بتسجيل حالته .hgsubstate وربطه به
مجموعة التغييرات الملتزمة.

تزامن a مستودع فرعي
لا تقوم Subrepos بتتبع أحدث التغييرات لمصادرها تلقائيًا. بدلا من ذلك، هم
يتم تحديثها إلى مجموعة التغييرات التي تتوافق مع مجموعة التغييرات التي تم سحبها في
مجموعة التغييرات ذات المستوى الأعلى. وذلك حتى يحصل المطورون دائمًا على مجموعة متسقة من التعليمات البرمجية المتوافقة
والمكتبات عند تحديثها.

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

حذف a مستودع فرعي
لإزالة مستودع فرعي من المستودع الأصلي، احذف مرجعه من .hgsub,
ثم قم بإزالة ملفاته.

تفاعل مع زئبقي أوامر
تضيف لا تتكرر الإضافة في subrepos ما لم يتم تحديد -S/--subrepos. ومع ذلك، إذا
قمت بتحديد المسار الكامل للملف في ريب فرعي، سيتم إضافته حتى بدون
-S/--subrepos المحدد. المستودعات الفرعية للتخريب تعمل حاليًا بصمت
تجاهلها.

اضف احذف
لا يتكرر addremove في subrepos ما لم يتم تحديد -S/--subrepos.
ومع ذلك، إذا قمت بتحديد المسار الكامل للدليل في طلب فرعي، فسيتم تنفيذ addremove
يمكن تنفيذها عليه حتى بدون تحديد -S/--subrepos. جيت والتخريب
ستطبع المستودعات الفرعية تحذيرًا وتستمر.

أرشيف
لا يتكرر الأرشيف في المستودعات الفرعية ما لم يتم تحديد -S/--subrepos.

قط يتعامل cat حاليًا مع تطابقات الملفات الدقيقة فقط في subrepos. التخريب
يتم تجاهل المستودعات الفرعية حاليًا.

ارتكاب ينشئ الالتزام لقطة متسقة لحالة المشروع بأكمله وعناصره
المستودعات الفرعية. إذا تم تعديل أي مستودعات فرعية، فسيتم إلغاء Mercurial.
يمكن جعل Mercurial يلتزم بدلاً من ذلك بجميع المستودعات الفرعية المعدلة عن طريق التحديد
-S/--subrepos، أو إعداد "ui.commitsubrepos=True" في ملف التكوين (راجع hg
مساعدة التكوين). بعد عدم وجود أي مستودعات فرعية معدلة، فإنه يسجل
حالتهم ويرتكبها أخيرًا في المستودع الأصلي. --adremove
يكرم الخيار أيضًا خيار -S/--subrepos. ومع ذلك، جيت والتخريب
ستقوم المستودعات الفرعية بطباعة تحذير وإحباط.

فرق diff لا يتكرر في subrepos ما لم يتم تحديد -S/--subrepos. التغييرات هي
يتم عرضه كالمعتاد على عناصر المستودعات الفرعية. المستودعات الفرعية التخريب هي
حاليا تجاهل بصمت.

ملفات لا تتكرر الملفات في subrepos ما لم يتم تحديد -S/--subrepos. لكن،
إذا قمت بتحديد المسار الكامل لملف أو دليل في طلب فرعي، فسيتم ذلك
يتم عرضه حتى بدون تحديد -S/--subrepos. جيت والتخريب
يتم حاليًا تجاهل المستودعات الفرعية بصمت.

ننسى ننسى حاليًا التعامل مع تطابقات الملفات الدقيقة فقط في subrepos. جيت والتخريب
يتم حاليًا تجاهل المستودعات الفرعية بصمت.

الوارد
لا يتكرر الوارد في subrepos ما لم يتم تحديد -S/--subrepos. جيت و
يتم حاليًا تجاهل مستودعات التخريب الفرعية بصمت.

المنتهية ولايته
لا يتكرر الصادر في subrepos ما لم يتم تحديد -S/--subrepos. جيت و
يتم حاليًا تجاهل مستودعات التخريب الفرعية بصمت.

سحب السحب ليس متكررًا لأنه ليس من الواضح ما يجب سحبه قبل التشغيل hg تحديث
. إدراج واسترجاع جميع تغييرات المستودعات الفرعية المشار إليها من قبل الشركة الأم
تعد مجموعات التغييرات التي تم سحبها من المستودع باهظة الثمن في أحسن الأحوال، ومستحيلة في Subversion
القضية.

دفع سيقوم Mercurial تلقائيًا بدفع جميع المستودعات الفرعية أولاً عندما يقوم المستودع الأصلي
يتم دفع المستودع. وهذا يضمن توفر تغييرات جديدة في المستودع الفرعي
عند الرجوع إليها بواسطة مستودعات المستوى الأعلى. الدفع أمر محظور للتخريب
المستودعات الفرعية.

الحالة لا تتكرر الحالة في المستودعات الفرعية ما لم يتم تحديد -S/--subrepos.
يتم عرض تغييرات المستودع الفرعي كتغييرات Mercurial عادية على الملف
عناصر المستودع الفرعي يتم حاليًا تجاهل مستودعات التخريب الفرعية بصمت.

إزالة لا تتكرر الإزالة في المستودعات الفرعية ما لم يتم تحديد -S/--subrepos.
ومع ذلك، إذا قمت بتحديد مسار ملف أو دليل في طلب فرعي، فستتم إزالته
حتى بدون -S/--subrepos. المستودعات الفرعية لـ Git و Subversion موجودة حاليًا
تجاهلها بصمت.

تحديث يستعيد التحديث subrepos إلى الحالة التي تم الالتزام بها في الأصل في الهدف
التغييرات. إذا كانت مجموعة التغييرات المسجلة غير متوفرة في المستودع الفرعي الحالي،
سيقوم Mercurial بسحبه أولاً قبل التحديث. وهذا يعني أن التحديث يمكن
تتطلب الوصول إلى الشبكة عند استخدام المستودعات الفرعية.

الخارطه المستودعات الفرعية مصادر
قد يتغير موقع مصدر المستودع الفرعي أثناء عمر المشروع، مما يؤدي إلى إبطال المراجع
المخزنة في تاريخ المستودع الأصلي. لإصلاح ذلك، يمكن تعريف قواعد إعادة الكتابة في
مستودع الوالدين hgrc ملف أو في تكوين Mercurial. انظر [المسارات الفرعية] القسم
hgrc(5) لمزيد من التفاصيل.

TEMPLATE الاستعمال

يتيح لك Mercurial تخصيص مخرجات الأوامر من خلال القوالب. يمكنك إما
قم بتمرير قالب أو حدد نمط قالب موجود من سطر الأوامر، عبر
- خيار القالب.

يمكنك تخصيص الإخراج لأي أمر "يشبه السجل": سجل، صادر، وارد، تلميح،
الآباء والرؤساء.

يتم حزم بعض الأنماط المضمنة مع Mercurial. يمكن سرد هذه مع hg سجل
--نموذج قائمة. مثال على الاستخدام:

$ hg log -r1.0::1.1 --سجل تغيير القالب

القالب عبارة عن جزء من النص، مع ترميز لاستدعاء توسيع متغير:

$ hg log -r1 --قالب "{عقدة}\n"
b56ce7b07c52de7d5fd79fb89701ea538af65746

تسمى السلاسل الموجودة بين الأقواس المتعرجة بالكلمات الأساسية. يعتمد توفر الكلمات الرئيسية على
السياق الدقيق للقالب. عادةً ما تكون هذه الكلمات الرئيسية متاحة لصياغة ملف
أمر يشبه السجل:

activebookmark
خيط. الإشارة المرجعية النشطة، إذا كانت مرتبطة بمجموعة التغييرات

المؤلفة خيط. المؤلف غير المعدل لمجموعة التغييرات.

ينصف خيط. حالة تقسيم مجموعة التغييرات.

الإشارات المرجعية
قائمة السلاسل. أي إشارات مرجعية مرتبطة بمجموعة التغييرات. يقوم أيضًا بتعيين "نشط" ،
اسم الإشارة المرجعية النشطة.

خيران خيط. اسم الفرع الذي تم إجراء التغييرات عليه.

Changesincelatesttag
عدد صحيح. جميع الأجداد ليسوا في أحدث علامة.

الأطفال
قائمة السلاسل. أبناء التغيير.

تاريخ معلومات التاريخ. التاريخ الذي تم فيه تنفيذ التغييرات.

تنازلي خيط. نص وصف التغييرات.

diffstat
خيط. إحصائيات التغييرات بالتنسيق التالي: "الملفات المعدلة:
+ تمت إضافة / - خطوط محذوفة "

إضافات قائمة الإملاءات ذات الإدخالات الرئيسية والقيمة لحقل "الإضافات" في مجموعة التغييرات هذه.

file_adds
قائمة السلاسل. الملفات المضافة بواسطة مجموعة التغييرات هذه.

file_copies
قائمة السلاسل. الملفات المنسوخة في مجموعة التغييرات هذه مع مصادرها.

file_copies_switch
قائمة السلاسل. مثل "file_copies" ولكن يتم عرضه فقط في حالة وجود رمز التبديل --copied
تعيين.

file_dels
قائمة السلاسل. الملفات التي تمت إزالتها بواسطة مجموعة التغييرات هذه.

file_mods
قائمة السلاسل. الملفات المعدلة بواسطة مجموعة التغييرات هذه.

ملفات قائمة السلاسل. جميع الملفات التي تم تعديلها أو إضافتها أو إزالتها بواسطة مجموعة التغييرات هذه.

graphnode
خيط. الحرف الذي يمثل عقدة مجموعة التغييرات في الرسم البياني لمراجعة ASCII

newtag
قائمة السلاسل. العلامات العالمية على أحدث سلف تم وضع علامة عليه عالميًا لـ
مجموعة التغييرات هذه.

newtagdistance
عدد صحيح. أطول مسار لأحدث علامة.

النطاقات
إملاء القوائم. الأسماء المرفقة بمجموعة التغييرات هذه لكل مساحة اسم.

العقدة خيط. تجزئة تعريف مجموعة التغييرات، كسلسلة مكونة من 40 رقمًا سداسيًا عشريًا.

p1node خيط. تجزئة تعريف الأصل الأول لمجموعة التغييرات، في صورة 40 رقمًا
سلسلة سداسية عشرية. إذا لم يكن لدى مجموعة التغييرات أي أصول، فستكون جميع الأرقام 0.

p1rev عدد صحيح. رقم مراجعة المستودع المحلي للأصل الأول لمجموعة التغييرات، أو
-1 إذا لم يكن لمجموعة التغييرات أي آباء.

p2node خيط. تجزئة تعريف الأصل الثاني لمجموعة التغييرات، في صورة 40 رقمًا
سلسلة سداسية عشرية. إذا لم يكن لمجموعة التغييرات أصل ثانٍ، فستكون جميع الأرقام 0.

p2rev عدد صحيح. رقم مراجعة المستودع المحلي للأصل الثاني لمجموعة التغييرات، أو
-1 إذا لم يكن لمجموعة التغييرات أصل ثانٍ.

الآباء
قائمة السلاسل. أصول مجموعة التغييرات بتنسيق "rev:node". إذا
تحتوي مجموعة التغييرات على أصل "طبيعي" واحد فقط (المراجعة السابقة) ولا شيء كذلك
مبين.

مرحلة جديدة خيط. اسم مرحلة مجموعة التغييرات.

معرف com لهذا التطبيق هو com.phaseidx
عدد صحيح. مؤشر مرحلة التغييرات

تزيد السرعة عدد صحيح. رقم مراجعة مجموعة التغييرات للمستودع المحلي.

اتفاقات فرعية
قائمة السلاسل. تم تحديث المستودعات الفرعية في مجموعة التغييرات.

علامات قائمة السلاسل. أي علامات مرتبطة بمجموعة التغييرات.

الكلمة الأساسية "التاريخ" لا تنتج مخرجات يمكن قراءتها بواسطة الإنسان. إذا كنت تريد استخدام تاريخ في
مخرجاتك، يمكنك استخدام مرشح لمعالجتها. المرشحات هي وظائف تقوم بإرجاع أ
سلسلة بناءً على متغير الإدخال. تأكد من استخدام مرشح stringify أولاً عندما تكون كذلك
تطبيق مرشح إدخال السلسلة على متغير إدخال يشبه القائمة. يمكنك أيضًا استخدام سلسلة من
المرشحات للحصول على الإخراج المطلوب:

نصيحة $ hg --قالب "{التاريخ|الإيزودات}\n"
2008-08-21 18:22 +0000

قائمة المرشحات:

addbreaks
أي نص. إضافة XHTML " "علامة قبل نهاية كل سطر باستثناء الأخير.

السن تاريخ. إرجاع فرق التاريخ/الوقت الذي يمكن قراءته بواسطة الإنسان بين التاريخ/الوقت المحدد و
التاريخ/الوقت الحالي.

basename
أي نص. يعامل النص كمسار، ويعيد المكون الأخير من المسار
بعد التقسيم بواسطة فاصل المسار (تجاهل الفواصل الزائدة). على سبيل المثال،
"foo/bar/baz" يصبح "baz" و"foo/bar//" يصبح "bar".

عد القائمة أو النص. إرجاع الطول كعدد صحيح.

نطاق أي نص. يبحث عن السلسلة الأولى التي تشبه عنوان البريد الإلكتروني، ويستخرجها
فقط مكون المجال. مثال: مستخدم <[البريد الإلكتروني محمي]> يصبح example.com.

البريد الإلكتروني أي نص. يستخرج السلسلة الأولى التي تشبه عنوان البريد الإلكتروني. مثال: مستخدم
<[البريد الإلكتروني محمي]> يصبح [البريد الإلكتروني محمي].

com.emailuser
أي نص. إرجاع جزء المستخدم من عنوان البريد الإلكتروني.

هرب أي نص. يستبدل أحرف XML/XHTML الخاصة "&" و"<" و">" بـ XML
الكيانات، وتصفية أحرف NUL.

ملء 68 أي نص. يلتف النص ليناسب 68 عمودًا.

ملء 76 أي نص. يلتف النص ليناسب 76 عمودًا.

السطر الأول
أي نص. إرجاع السطر الأول من النص.

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

hgdate تاريخ. إرجاع التاريخ كزوج من الأرقام: "1157407993 25200" (الطابع الزمني لنظام Unix،
إزاحة المنطقة الزمنية).

ايسودات
تاريخ. إرجاع التاريخ بتنسيق ISO 8601: "2009-08-18 13:00 +0200".

isodatesec
تاريخ. إرجاع التاريخ بتنسيق ISO 8601، بما في ذلك الثواني: "2009-08-18 13:00:13
+0200". راجع أيضًا مرشح rfc3339date.

خفض أي نص. تحويل النص إلى أحرف صغيرة.

غير فارغ
أي نص. يُرجع "(لا شيء)" إذا كانت السلسلة فارغة.

عتم
أي نص. إرجاع نص الإدخال الذي تم تقديمه كتسلسل من كيانات XML.

شخص أي نص. إرجاع الاسم قبل عنوان البريد الإلكتروني، وتفسيره وفقًا لـ RFC
5322

إعادة الهروب
أي نص. يهرب من كافة الأحرف "الخاصة"، باستثناء @. يتم الهروب من الخطوط المائلة للأمام
مرتين لمنع خوادم الويب من فكها قبل الأوان. على سبيل المثال، "@foo
bar/baz" يصبح "@foo%20bar%252Fbaz".

rfc3339date
تاريخ. إرجاع تاريخ باستخدام تنسيق تاريخ الإنترنت المحدد في RFC 3339:
"2009-08-18T13:00:13+02:00".

rfc822date
تاريخ. إرجاع تاريخ باستخدام نفس التنسيق المستخدم في رؤوس البريد الإلكتروني: "الثلاثاء، 18 أغسطس 2009
13:00:13 +0200".

في صفقات تغيير التجزئة. إرجاع الشكل القصير لتجزئة مجموعة التغييرات، أي 12 رقمًا سداسيًا عشريًا
سلسلة أرقام.

com.shortbisect
أي نص. يعامل نص كحالة تقسيم، وإرجاع حرف واحد
تمثيل الحالة (G: جيد، B: سيئ، S: تم تخطيه، U: لم يتم اختباره، I: تم تجاهله).
إرجاع مسافة واحدة إذا نص ليست حالة تنصيف صالحة.

التاريخ القصير
تاريخ. إرجاع تاريخ مثل "2006-09-18".

الانقسام
أي نص. تقسيم النص إلى قائمة الأسطر.

تشديد
أي نوع. يحول القيمة إلى نص عن طريق تحويل القيم إلى نص و
تسلسل لهم.

com.stripdir
تعامل مع النص كمسار وقم بإزالة مستوى الدليل، إن أمكن. على سبيل المثال، "فو"
و"foo/bar" يصبح "foo".

tabindent
أي نص. إرجاع النص، مع كل سطر غير فارغ باستثناء البداية الأولى
مع حرف علامة التبويب.

أعلى أي نص. تحويل النص إلى أحرف كبيرة.

urlescape
أي نص. يهرب من جميع الشخصيات "الخاصة". على سبيل المثال، يصبح "foo bar".
"فو%20بار".

المستخدم أي نص. إرجاع تمثيل قصير لاسم المستخدم أو عنوان البريد الإلكتروني.

لاحظ أن المرشح ليس أكثر من استدعاء دالة، أي إكسبر|مرشح معادل
إلى مرشح (إكسبر).

بالإضافة إلى المرشحات، هناك بعض الوظائف الأساسية المضمنة:

التاريخ (التاريخ [، FMT])
تنسيق التاريخ. يرى hg مساعدة التمور لتنسيق السلاسل الافتراضي هو تاريخ يونكس
التنسيق، بما في ذلك المنطقة الزمنية: "Mon Sep 04 15:13:13 2006 0700".

فرق([تشملنمط [, استبعاد النمط]])
إظهار الفرق، مع تحديد الملفات المراد تضمينها أو استبعادها بشكل اختياري.

ملء (النص [، عرض[، المعرف الأولي[، معلقة]]])
املأ العديد من الفقرات بمسافة بادئة اختيارية. انظر مرشح "الملء".

الحصول على (ديكت، مفتاح)
الحصول على سمة/مفتاح من كائن. بعض الكلمات الرئيسية هي أنواع معقدة. هذه الوظيفة
يسمح لك بالحصول على قيمة السمة على هذه الأنواع.

إذا (إكسبر، ثم[، آخر])
التنفيذ المشروط بناءً على نتيجة التعبير.

إذا يحتوي على (بحث، شيء، ثم[، آخر])
يتم التنفيذ بشكل مشروط بناءً على ما إذا كان العنصر "البحث" موجودًا في "الشيء".

إيفيك (expr1، إكسبر2, ثم[، آخر])
التنفيذ المشروط بناءً على ما إذا كان العنصران متكافئين.

مسافة بادئة (نص، الحروف البادئة[، السطر الأول])
المسافة البادئة لجميع الأسطر غير الفارغة مع الأحرف الواردة في سلسلة indentchars. ان
ستتجاوز المعلمة الثالثة الاختيارية المسافة البادئة للسطر الأول فقط في حالة
حاضر.

الانضمام (قائمة، سبتمبر)
ضم العناصر في القائمة باستخدام محدد.

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

أحدث علامة([نمط])
العلامات العالمية المطابقة للنمط المحدد في أحدث العلامات العالمية
سلف مجموعة التغييرات هذه.

التاريخ المحلي (التاريخ [، ت])
تحويل تاريخ إلى المنطقة الزمنية المحددة. الافتراضي هو التاريخ المحلي.

لوحة (نص، عرض[، ملء شار =' '[، حق = خطأ]])
نص الوسادة مع حرف التعبئة.

مراجعة (الاستعلام [، التنسيقات...])
تنفيذ استعلام مجموعة المراجعة. يرى hg مساعدة revset.

رستدوك (نص، أسلوب)
تنسيق النص المعاد هيكلته.

أقصر (عقدة، الحد الأدنى = 4)
الحصول على أقصر تمثيل للعقدة.

يبدأ ب(النمط، نص)
إرجاع القيمة من وسيطة "النص" إذا كانت تبدأ بالمحتوى من
حجة "النمط".

قطاع (نص [، الأحرف])
تجريد الأحرف من السلسلة. بشكل افتراضي، يتم إزالة كافة البادئة والزائدة
مسافة بيضاء.

فرعي (نمط، إستبدال، التعبير)
إجراء استبدال النص باستخدام التعبيرات العادية.

كلمة (رقم، نص[، فاصل])
إرجاع الكلمة n من سلسلة.

أيضًا، بالنسبة لأي تعبير يُرجع قائمة، يوجد عامل قائمة:

إكسبر % "{قالب}"

كما رأينا في المثال أعلاه، {نموذج} يتم تفسيره كقالب. لمنع ذلك من
يتم تفسيرها، يمكنك استخدام حرف الهروب \{ أو بادئة سلسلة خام، ص '...'.

بعض نماذج قوالب سطر الأوامر:

· تنسيق القوائم، على سبيل المثال الملفات:

$ hg log -r 0 --template "files:\n{files % ' {file}\n'}"

· انضم إلى قائمة الملفات باستخدام "،":

$ hg log -r 0 --template "files: {join(files, ', ')}\n"

· تعديل كل سطر من وصف الالتزام:

$ hg log --template "{splitlines(desc) % '**** {line}\n'}"

· تاريخ التنسيق:

$ hg log -r 0 --template "{date(date, '%Y')}\n"

· عرض التاريخ بالتوقيت العالمي:

$ hg log -r 0 --template "{localdate(date, 'UTC')|date}\n"

· إخراج الوصف المحدد بعرض تعبئة قدره 30:

$ hg log -r 0 --template "{fill(desc, 30)}"

· استخدم الشرطية لاختبار الفرع الافتراضي:

$ hg log -r 0 --template "{ifeq(branch, 'default', 'on the main Branch',
'في الفرع {فرع}')}\n"

· إلحاق سطر جديد إذا لم يكن فارغاً:

نصيحة $ hg --قالب "{if(author, '{author}\n')}"

· قم بتسمية الإخراج للاستخدام مع ملحق اللون:

$ hg log -r 0 --template "{label('changeset.{phase}', العقدة|short)}\n"

· عكس مرشح الخط الأول، أي كل شيء ما عدا السطر الأول:

$ hg log -r 0 --template "{sub(r'^.*\n?\n?', '', desc)}\n"

· عرض محتويات الحقل "الإضافي"، واحد في كل سطر:

$ hg log -r 0 --template "{join(extras, '\n')}\n"

· قم بتمييز الإشارة المرجعية النشطة بـ "*":

سجل $ hg --قالب "{الإشارات المرجعية % '{إشارة مرجعية}{ifeq(bookmark, active, '*')}'}\n"

· ابحث عن العلامة المرشحة للإصدار السابق، والمسافة والتغييرات منذ العلامة:

$ hg log -r . --قالب "{latesttag('re:^.*-rc$') % '{tag}, {changes}, {distance}'}\n"

· قم بتمييز أصل النسخة العاملة بـ "@":

$ hg log --template "{ifcontains(rev, revset('.'), '@')}\n"

· عرض تفاصيل مراجعات الوالدين:

$ hg log --template "{revset('parents(%d)', rev) % '{desc|firstline}\n'}"

· إظهار أوصاف الالتزام التي تبدأ بـ "القالب" فقط:

$ hg log --template "{startswith('template', firstline(desc))}\n"

· اطبع الكلمة الأولى من كل سطر من رسالة الالتزام:

سجل $ hg --قالب "{word(0, desc)}\n"

URL مسارات

عناوين URL الصالحة هي من النموذج:

محلي/نظام الملفات/المسار[#revision]
الملف: // المحلي / نظام الملفات / المسار [#revision]
http://[user[:pass]@]host[:port]/[path][#revision]
https://[user[:pass]@]host[:port]/[path][#revision]
ssh://[user@]host[:port]/[path][#revision]

يمكن للمسارات الموجودة في نظام الملفات المحلي أن تشير إما إلى مستودعات Mercurial أو إلى الحزمة
الملفات (كما تم إنشاؤها بواسطة hg حزمة or hg الوارد --باقة). أنظر أيضا hg مساعدة مسارات.

يشير المعرف الاختياري بعد # إلى فرع أو علامة أو مجموعة تغييرات معينة لاستخدامها
من المستودع البعيد. أنظر أيضا hg مساعدة المراجعات.

بعض الميزات، مثل الضغط على عناوين URL http:// وhttps:// تكون ممكنة فقط إذا كان
يتم تمكين الميزة بشكل صريح على خادم Mercurial البعيد.

لاحظ أن أمان عناوين URL لـ HTTPS يعتمد على التكوين الصحيح لـ web.cacerts.

بعض الملاحظات حول استخدام SSH مع Mercurial:

· يتطلب SSH حساب Shell يمكن الوصول إليه على الجهاز الوجهة ونسخة من hg in
المسار البعيد أو المحدد باسم Remotecmd.

· المسار متعلق بالدليل الرئيسي للمستخدم البعيد بشكل افتراضي. استخدم شرطة مائلة إضافية عند
بداية المسار لتحديد المسار المطلق:

ssh://example.com//tmp/repository

· لا يستخدم Mercurial نظام الضغط الخاص به عبر SSH؛ الشيء الصحيح الذي ينبغي عمله هو التكوين
في الخاص بك ~ / .ssh / التكوينعلى سبيل المثال:

المضيف *.mylocalnetwork.example.com
ضغط لا
مضيف *
ضغط نعم

بدلاً من ذلك، حدد "ssh -C" كأمر ssh في ملف التكوين الخاص بك أو باستخدام
خيار سطر الأوامر --ssh.

يمكن تخزين جميع عناوين URL هذه في ملف التكوين الخاص بك باستخدام الأسماء المستعارة للمسار ضمن ملف
قسم [المسارات] هكذا:

[مسارات]
الاسم المستعار 1 = URL1
الاسم المستعار 2 = URL2


يمكنك بعد ذلك استخدام الاسم المستعار لأي أمر يستخدم عنوان URL (على سبيل المثال hg سحب alias1
سيتم التعامل معها على أنها hg سحب URL1).

يعد الاسمان المستعاران للمسار خاصين لأنه يتم استخدامهما كإعدادات افتراضية عندما لا تقوم بتوفير ملف
عنوان URL للأمر:

الافتراضي:
عند إنشاء مستودع باستخدام hg clone، يقوم أمر clone بحفظ موقع الملف
المستودع المصدر باعتباره المسار "الافتراضي" للمستودع الجديد. ثم يتم استخدام هذا
عندما تحذف المسار من أوامر الدفع والسحب (بما في ذلك الأوامر الواردة و
منفتح).

الدفع الافتراضي:
سيبحث أمر الدفع عن مسار يسمى "الدفع الافتراضي"، ويفضله
"افتراضي" إذا تم تعريف كلاهما.

إمتداد

يحتوي هذا القسم على تعليمات للملحقات التي يتم توزيعها مع Mercurial.
تتوفر المساعدة الخاصة بالملحقات الأخرى في نظام المساعدة.

دوري أبطال آسيا
السنانير للتحكم في الوصول إلى المستودع

يجعل هذا الخطاف من الممكن السماح أو رفض الوصول للكتابة إلى فروع ومسارات محددة لـ a
المستودع عند تلقي مجموعات التغييرات الواردة عبر pretxnchangegroup وpretxncommit.

تتم مطابقة التفويض بناءً على اسم المستخدم المحلي على النظام الذي يوجد به الخطاف
يتم تشغيله، وليس مرتكب مجموعة التغييرات الأصلية (نظرًا لأن الأخير مجرد
غنيا بالمعلومات).

من الأفضل استخدام خطاف ACL مع غلاف مقيد مثل hgsh، مما يمنع
مصادقة المستخدمين من القيام بأي شيء آخر غير الدفع أو السحب. الخطاف ليس كذلك
آمن للاستخدام إذا كان لدى المستخدمين وصول تفاعلي إلى الصدفة، حيث يمكنهم بعد ذلك تعطيل الخطاف. ولا
هل من الآمن أن يشارك المستخدمون عن بعد الحساب، لأنه لا توجد طريقة للتمييز
لهم.

الترتيب الذي يتم به إجراء عمليات التحقق من الوصول هو:

1. قائمة الرفض للفروع (القسم acl.deny.branches)

2. السماح بقائمة الفروع (القسم acl.allow.branches)

3. رفض قائمة المسارات (القسم acl.deny)

4. السماح بقائمة المسارات (القسم acl.allow)

تأخذ أقسام السماح والرفض أزواجًا من القيمة الرئيسية.

على أساس الفرع الوصول للتعاليم مراقبة
استخدم acl.deny.branches و acl.allow.branches الأقسام التي لديها حق الوصول على أساس الفرع
يتحكم. المفاتيح في هذه الأقسام يمكن أن تكون إما:

· اسم الفرع أو

· علامة النجمة، لتتناسب مع أي فرع.

يمكن أن تكون القيم المقابلة إما:

· قائمة مفصولة بفواصل تحتوي على المستخدمين والمجموعات، أو

· علامة النجمة، لتتناسب مع أي شخص؛

يمكنك إضافة "!" بادئة لاسم مستخدم أو مجموعة لعكس معنى المطابقة.

قائم على المسار الوصول للتعاليم مراقبة
استخدم acl.deny و acl.allow أقسام لديها التحكم في الوصول على أساس المسار. المفاتيح في هذه
تقبل الأقسام نمط الشجرة الفرعية (مع بناء الجملة الشامل بشكل افتراضي). المناظرة
تتبع القيم نفس بناء الجملة مثل الأقسام الأخرى أعلاه.

المجموعة
يجب أن تكون أسماء المجموعات مسبوقة بـ @ رمز. تحديد اسم المجموعة له نفس التأثير
كما تحديد جميع المستخدمين في تلك المجموعة.

يمكنك تحديد أعضاء المجموعة في ACL.مجموعات قسم. إذا لم يتم تعريف اسم المجموعة
هناك، ويعمل Mercurial تحت نظام يشبه Unix، وسيتم أخذ قائمة المستخدمين
من نظام التشغيل. وإلا، سيتم رفع استثناء.

مثال الاعداد
[خطافات]

# استخدم هذا إذا كنت تريد التحقق من قيود الوصول في وقت الالتزام
pretxncommit.acl = بيثون:hgext.acl.hook

# استخدم هذا إذا كنت تريد التحقق من قيود الوصول للسحب، والدفع،
# حزمة وخدمة.
pretxnchangegroup.acl = بيثون:hgext.acl.hook

[ACL]
# السماح أو رفض الوصول إلى التغييرات الواردة فقط إذا كان مصدرها
# المدرجة هنا، والسماح لهم بالمرور خلاف ذلك. المصدر "يخدم" للجميع
# الوصول عن بعد (http أو ssh) أو "الدفع" أو "السحب" أو "الحزمة" عندما يكون
يتم تشغيل # الأوامر ذات الصلة محليًا.
#الافتراضي: يخدم
المصادر = تخدم

[acl.deny.branches]

# تم حرمان الجميع من الفرع المجمد:
فرع مجمد = *

# تم رفض المستخدم السيئ في جميع الفروع:
* = مستخدم سيء

[acl.allow.branches]

# يُسمح لعدد قليل من المستخدمين في الفرع أ:
الفرع أ = المستخدم 1، المستخدم 2، المستخدم 3

# مسموح لمستخدم واحد فقط في الفرع-ب:
الفرع ب = المستخدم 1

# يُسمح للمستخدم الفائق في أي فرع:
* = المستخدم الفائق

# يُسمح للجميع بالاختبارات الفرعية:
فرع للاختبارات = *

[acl.deny]
# يتم فحص هذه القائمة أولاً. إذا تم العثور على تطابق، فلن يتم العثور على acl.allow
# التحقق. يتم منح كافة المستخدمين حق الوصول في حالة عدم وجود acl.deny.
# التنسيق لكلتا القائمتين: النمط الشامل = المستخدم، ...، @group، ...

# لمطابقة الجميع، استخدم علامة النجمة للمستخدم:
# نمطي/الكرة الأرضية = *

لن يكون لدى # user6 حق الوصول للكتابة إلى أي ملف:
** = المستخدم6

# المجموعة "hg-denied" لن يكون لها حق الوصول للكتابة إلى أي ملف:
** = @ تم رفض الزئبق

# لن يتمكن أحد من تغيير "DONT-TOUCH-THIS.txt" بالرغم من ذلك
# الجميع قادر على تغيير كافة الملفات الأخرى. انظر أدناه.
src/main/resources/DONT-TOUCH-THIS.txt = *

[acl.allow]
# إذا لم يكن acl.allow موجودًا، فسيتم السماح لجميع المستخدمين افتراضيًا
# acl.allow فارغ = غير مسموح للمستخدمين

# المستخدم "doc_writer" لديه حق الوصول للكتابة إلى أي ملف ضمن "docs"
# مجلد:
docs/** = doc_writer

# المستخدم "جاك" ومجموعة "المصممين" لديهم حق الوصول للكتابة إلى أي ملف
# ضمن مجلد "الصور":
الصور/** = جاك، @designers

# الجميع (باستثناء "user6" و"@hg-denied" - راجع acl.deny أعلاه)
# سيكون له حق الوصول للكتابة إلى أي ملف ضمن مجلد "الموارد".
# (باستثناء ملف واحد. راجع acl.deny):
src/main/resources/** = *

.hgtags = Release_engineer

أمثلة استخدام ال ! بادئة
لنفترض أن هناك فرعًا يجب أن يتمكن مستخدم (أو مجموعة) معين فقط من الدفع إليه، و
لا تريد تقييد الوصول إلى أي فرع آخر قد يتم إنشاؤه.

ال "!" تتيح لك البادئة منع أي شخص باستثناء مستخدم أو مجموعة معينة من الدفع
مجموعات التغييرات في فرع أو مسار معين.

في الأمثلة أدناه، سنقوم بما يلي: 1) رفض الوصول إلى الفرع "الحلقة" لأي شخص باستثناء المستخدم
"gollum" 2) منع الوصول إلى فرع "البحيرة" لأي شخص باستثناء أعضاء مجموعة "الهوبيت" 3)
رفض الوصول إلى ملف لأي شخص باستثناء المستخدم "gollum"

[acl.allow.branches]
# فارغ

[acl.deny.branches]

# 1) فقط 'gollum' يمكنه الالتزام بالفرع 'ring'؛
# لا يزال بإمكان 'gollum' وأي شخص آخر الالتزام بأي فرع آخر.
حلقة = !gollum

# 2) يمكن فقط لأعضاء مجموعة "الهوبيت" الالتزام بفرع "البحيرة"؛
# لا يزال بإمكان أعضاء "الهوبيت" وأي شخص آخر الالتزام بأي فرع آخر.
بحيرة = !@hobbit

# يمكنك أيضًا رفض الوصول بناءً على مسارات الملفات:

[acl.allow]
# فارغ

[acl.deny]
# 3) فقط "gollum" يمكنه تغيير الملف أدناه؛
# 'gollum' وأي شخص آخر لا يزال بإمكانه تغيير أي ملف آخر.
/misty/mountains/cave/ring = !gollum

صندوق اسود
قم بتسجيل أحداث المستودع في صندوق أسود لتصحيح الأخطاء

يقوم بتسجيل معلومات الحدث إلى ‎.hg/blackbox.log للمساعدة في تصحيح الأخطاء وتشخيص المشكلات. ال
يمكن تكوين الأحداث التي يتم تسجيلها عبر مفتاح التكوين blackbox.track. أمثلة:

[صندوق اسود]
المسار = *

[صندوق اسود]
المسار = الأمر، Commandfinish، CommandException، Exthook، pythonhook

[صندوق اسود]
المسار = وارد

[صندوق اسود]
# تحديد حجم ملف السجل
الحجم الأقصى = 1.5 ميجابايت
# قم بتدوير ما يصل إلى ملفات السجل N عندما يصبح الملف الحالي كبيرًا جدًا
ملفات ماكس = 3

أوامر
صندوق اسود
عرض أحداث المستودع الأخيرة:

زئبق الصندوق الأسود [الخيار]...

عرض أحداث المستودع الأخيرة

خيارات:

-ل ،--حد
عدد الأحداث المراد إظهارها (الافتراضي: 10)

بجزيلا
خطافات للتكامل مع أداة تعقب الأخطاء Bugzilla

يضيف ملحق الخطاف هذا تعليقات على الأخطاء في Bugzilla عند إجراء تغييرات تشير إلى الأخطاء
بواسطة معرف Bugzilla ينظر إليها. يتم تنسيق التعليق باستخدام آلية القالب Mercurial.

يمكن أن تتضمن مراجع الأخطاء بشكل اختياري تحديثًا لـ Bugzilla للساعات التي يقضيها
العمل على الخلل. يمكن أيضًا وضع علامة على الأخطاء بأنها ثابتة.

يتم توفير ثلاثة أوضاع أساسية للوصول إلى Bugzilla:

1. الوصول عبر واجهة Bugzilla XMLRPC. يتطلب Bugzilla 3.4 أو الأحدث.

2. تحقق من البيانات عبر واجهة Bugzilla XMLRPC وأرسل تغيير الأخطاء عبر البريد الإلكتروني إلى
واجهة البريد الإلكتروني في Bugzilla. يتطلب Bugzilla 3.4 أو الأحدث.

3. الكتابة مباشرة إلى قاعدة بيانات Bugzilla. عمليات تثبيت Bugzilla التي تستخدم MySQL فقط هي التي يتم تشغيلها
أيد. يتطلب بيثون MySQLdb.

الكتابة مباشرة إلى قاعدة البيانات تكون عرضة لتغييرات المخطط، وتعتمد على
يساهم برنامج Bugzilla بالبرنامج النصي لإرسال رسائل بريد إلكتروني لإشعار تغيير الأخطاء. يعمل هذا البرنامج النصي كـ
المستخدم الذي يقوم بتشغيل Mercurial، يجب أن يتم تشغيله على المضيف مع تثبيت Bugzilla، و
يتطلب إذنًا لقراءة تفاصيل تكوين Bugzilla ومستخدم MySQL الضروري
وكلمة المرور للحصول على حقوق الوصول الكامل إلى قاعدة بيانات Bugzilla. لهذه الأسباب هذا
يعتبر وضع الوصول الآن مهملاً، ولن يتم تحديثه لـ Bugzilla الجديد
الإصدارات المضي قدما. يتم دعم إضافة التعليقات فقط في وضع الوصول هذا.

يحتاج الوصول عبر XMLRPC إلى تحديد اسم مستخدم وكلمة مرور Bugzilla في ملف
إعدادات. تتم إضافة التعليقات تحت اسم المستخدم هذا. منذ التكوين يجب أن يكون
قابلة للقراءة من قبل جميع مستخدمي Mercurial، فمن المستحسن أن تكون حقوق هذا المستخدم
يقتصر في Bugzilla على الحد الأدنى اللازم لإضافة التعليقات. إصلاح الخلل في العلامات
يتطلب Bugzilla 4.0 والإصدارات الأحدث.

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

عناصر التكوين المشتركة لجميع أوضاع الوصول:

bugzilla.version
نوع الوصول المراد استخدامه. القيم المعترف بها هي:

كملربك

واجهة بوجزيلا XMLRPC.

xmlrpc+البريد الإلكتروني

Bugzilla XMLRPC وواجهات البريد الإلكتروني.

3.0

الوصول إلى MySQL، Bugzilla 3.0 والإصدارات الأحدث.

2.18

الوصول إلى MySQL، Bugzilla 2.18 والإصدارات الأحدث ولكن لا تتضمن الإصدار 3.0.

2.16

الوصول إلى MySQL، Bugzilla 2.16 والإصدارات الأحدث ولكن لا تتضمن الإصدار 2.18.

bugzilla.regexp
تعبير عادي لمطابقة معرفات الأخطاء للتحديث في رسالة التزام مجموعة التغييرات. هو - هي
يجب أن تحتوي على مجموعة واحدة مسماة "()". تحتوي على معرفات الأخطاء مفصولة
أحرف غير رقمية. وقد تحتوي أيضًا على مجموعة مسماة مع
رقم الفاصلة العائمة الذي يوضح ساعات العمل على الخطأ. إذا لم تكن هناك مجموعات مسماة
في الوقت الحاضر، من المفترض أن تحتوي المجموعة "()" الأولى على معرفات الأخطاء، ووقت العمل هو
غير محدث. يتطابق التعبير الافتراضي علة 1234, علة لا. 1234, علة عدد
1234, البق 1234,5678, علة 1234 و 5678 والاختلافات منها، تليها
عدد الساعات مسبوقة بـ h or ساعات، على سبيل المثال ساعات 1.5. المطابقة غير حساسة لحالة الأحرف.

bugzilla.fixregexp
تعبير عادي لمطابقة معرفات الأخطاء لوضع علامة على رسالة التزام مجموعة التغييرات.
يجب أن يحتوي هذا على مجموعة مسماة "()". ` تحتوي ال علة معرفات منفصل by
غير رقم حرفا. It قد أيضا تحتوي على a عين رأس التجميع `` مع
رقم الفاصلة العائمة الذي يوضح ساعات العمل على الخطأ. إذا لم تكن هناك مجموعات مسماة
في الوقت الحاضر، من المفترض أن تحتوي المجموعة "()" الأولى على معرفات الأخطاء، ووقت العمل هو
غير محدث. يتطابق التعبير الافتراضي إصلاحات 1234, إصلاحات علة 1234, إصلاحات البق
1234,5678, إصلاحات 1234 و 5678 واختلافاتها، يليها عدد الساعات
مسبوقة بـ h or ساعات، على سبيل المثال ساعات 1.5. المطابقة غير حساسة لحالة الأحرف.

bugzilla.fixstatus
تم إصلاح الحالة التي سيتم ضبط الخلل عليها عند وضع علامة عليها. تقصير حل.

bugzilla.fixresolution
تم إصلاح القرار الذي تم ضبط الخلل عليه عند وضع علامة عليه. تقصير ثابت.

bugzilla.style
ملف النمط الذي سيتم استخدامه عند تنسيق التعليقات.

bugzilla.template
قالب لاستخدامه عند تنسيق التعليقات. يتجاوز النمط إذا تم تحديده. فضلاً عن ذلك
بالنسبة إلى الكلمات الرئيسية Mercurial المعتادة، يحدد الامتداد ما يلي:

{حشرة}

معرف خطأ Bugzilla.

{جذر}

اسم المسار الكامل لمستودع Mercurial.

{ويبروت}

تم تجريد اسم المسار لمستودع Mercurial.

{هجويب}

عنوان URL الأساسي لتصفح مستودعات Mercurial.

الترتيب changeset {عقدة|قصيرة} in الريبو {جذر} يشير إلى علة
{خطأ}.\nالتفاصيل:\n\t{تنازلي|tabindent}

bugzilla.strip
عدد الأحرف الفاصلة للمسار المطلوب إزالتها من مقدمة Mercurial
مسار المستودع ({جذر} في القوالب) لإنتاج {ويبروت}. على سبيل المثال ،
المستودع مع {جذر} /var/local/my-project مع شريط من 2 يعطي قيمة ل
{ويبروت} of مشروعي. الافتراضي 0.

web.baseurl
عنوان URL الأساسي لتصفح مستودعات Mercurial. المشار إليها من القوالب باسم {هجويب}.

عناصر التكوين المشتركة في أوضاع الوصول إلى البريد الإلكتروني XMLRPC+ وMySQL:

bugzilla.usermap
مسار الملف الذي يحتوي على البريد الإلكتروني لمتعهد Mercurial إلى تعيينات البريد الإلكتروني لمستخدم Bugzilla.
إذا تم تحديده، فيجب أن يحتوي الملف على تعيين واحد لكل سطر:

الملتزم = مستخدم Bugzilla

انظر أيضا [خريطة المستخدم] والقسم الخاص به.

• [خريطة المستخدم] يتم استخدام القسم لتحديد تعيينات البريد الإلكتروني لمتعهد Mercurial إلى Bugzilla
البريد الالكتروني للمستخدم. أنظر أيضا bugzilla.usermap. يحتوي على إدخالات النموذج مرتكب = بجزيلا
المستخدم.

تكوين وضع الوصول إلى XMLRPC:

bugzilla.bzurl
عنوان URL الأساسي لتثبيت Bugzilla. تقصير http://localhost/bugzilla.

bugzilla.user
اسم المستخدم الذي سيتم استخدامه لتسجيل الدخول إلى Bugzilla عبر XMLRPC. تقصير البق.

bugzilla.password
كلمة المرور لتسجيل الدخول إلى Bugzilla.

يستخدم وضع الوصول إلى البريد الإلكتروني +XMLRPC عناصر تكوين وضع الوصول إلى XMLRPC، وأيضًا:

bugzilla.bzemail
عنوان البريد الإلكتروني لـ Bugzilla.

بالإضافة إلى ذلك، يجب تكوين إعدادات البريد الإلكتروني Mercurial. انظر الوثائق في
hgrc(5)، الأقسام [بريد إلكتروني] و [سمتب].

تكوين وضع الوصول إلى MySQL:

bugzilla.host
اسم المضيف لخادم MySQL الذي يحتفظ بقاعدة بيانات Bugzilla. تقصير مؤسسة الكوثر.

bugzilla.db
اسم قاعدة بيانات Bugzilla في MySQL. تقصير البق.

bugzilla.user
اسم المستخدم الذي سيتم استخدامه للوصول إلى خادم MySQL. تقصير البق.

bugzilla.password
كلمة المرور المستخدمة للوصول إلى خادم MySQL.

bugzilla.timeout
مهلة اتصال قاعدة البيانات (بالثواني). الافتراضي 5.

bugzilla.bzuser
اسم مستخدم Fallback Bugzilla لتسجيل التعليقات به، إذا لم يتمكن مرتكب مجموعة التغييرات من ذلك
يمكن العثور عليه كمستخدم Bugzilla.

bugzilla.bzdir
دليل تثبيت Bugzilla. يستخدم بشكل افتراضي الإخطار. تقصير /var/www/html/bugzilla.

bugzilla.notify
الأمر الذي يجب تشغيله لجعل Bugzilla يرسل رسائل بريد إلكتروني لإشعار تغيير الأخطاء.
بدائل من الخريطة مع 3 مفاتيح، bzdir, id (معرف الخطأ) و المستخدم (المرتكب bugzilla
بريد إلكتروني). الافتراضي يعتمد على الإصدار؛ من 2.18 أصبح "cd %(bzdir)s && perl -T
contrib/sendbugmail.pl %(id)s %(user)s".

تفعيل الامتداد:

[ملحقات]
بوزيلا =

[خطافات]
# قم بتشغيل خطاف bugzilla عند كل تغيير يتم سحبه أو دفعه هنا
incoming.bugzilla = بيثون:hgext.bugzilla.hook

تكوينات المثال:

مثال لتكوين XMLRPC. يستخدم هذا Bugzilla في http://my-project.org/bugzilla,
تسجيل الدخول كمستخدم [البريد الإلكتروني محمي] مع كلمة المرور plugh. يتم استخدامه مع أ
مجموعة من مستودعات Mercurial في /فار/محلي/hg/repos/، مع واجهة ويب في
http://my-project.org/hg.

[بوغزيلا]
بزورل=http://my-project.org/bugzilla
المستخدم =[البريد الإلكتروني محمي]
كلمة المرور = المكونات
الإصدار=xmlrpc
Template=Changeset {node|short} في {root|basename}.
{hgweb}/{webroot}/rev/{node|short}\n
{تنازل}\n
الشريط=5

[الإنترنت]
باسيرل=http://my-project.org/hg

XMLRPC + مثال لتكوين البريد الإلكتروني. يستخدم هذا Bugzilla في
http://my-project.org/bugzilla، تسجيل الدخول كمستخدم [البريد الإلكتروني محمي] مع كلمة المرور
plugh. يتم استخدامه مع مجموعة من مستودعات Mercurial في /فار/محلي/hg/repos/,
مع واجهة الويب في http://my-project.org/hg. يتم إرسال تعليقات الأخطاء إلى Bugzilla
عنوان البريد الإلكتروني [البريد الإلكتروني محمي].

[بوغزيلا]
بزورل=http://my-project.org/bugzilla
المستخدم =[البريد الإلكتروني محمي]
كلمة المرور = المكونات
الإصدار=xmlrpc+email
بزيمايل=[البريد الإلكتروني محمي]
Template=Changeset {node|short} في {root|basename}.
{hgweb}/{webroot}/rev/{node|short}\n
{تنازل}\n
الشريط=5

[الإنترنت]
باسيرل=http://my-project.org/hg

[خريطة المستخدم]
[البريد الإلكتروني محمي]=[البريد الإلكتروني محمي]

تكوين مثال MySQL. يحتوي هذا على تثبيت Bugzilla 3.2 محلي في
/opt/bugzilla-3.2. قاعدة بيانات MySQL قيد التشغيل مؤسسة الكوثر، اسم قاعدة بيانات Bugzilla هو البق
ويتم الوصول إلى MySQL باستخدام اسم مستخدم MySQL البق كلمه السر XYZZY. يتم استخدامه مع أ
مجموعة من مستودعات Mercurial في /فار/محلي/hg/repos/، مع واجهة ويب في
http://my-project.org/hg.

[بوغزيلا]
المضيف = المضيف المحلي
كلمة المرور=XYZZY
نسخة = 3.0
بزوزر=[البريد الإلكتروني محمي]
bzdir=/opt/bugzilla-3.2
Template=Changeset {node|short} في {root|basename}.
{hgweb}/{webroot}/rev/{node|short}\n
{تنازل}\n
الشريط=5

[الإنترنت]
باسيرل=http://my-project.org/hg

[خريطة المستخدم]
[البريد الإلكتروني محمي]=[البريد الإلكتروني محمي]

كل ما سبق يضيف تعليقًا إلى سجل أخطاء Bugzilla الخاص بالنموذج:

Changeset 3b16791d6642 في اسم المستودع.
http://my-project.org/hg/repository-name/rev/3b16791d6642

تغيير الالتزام بالتعليق. الخطأ 1234.

الرقيب
مسح محتوى الملف في مراجعة معينة

يأمر أمر الرقابة Mercurial بمسح كل محتوى الملف عند مراجعة معينة
بدون تحديث ال changeset التجزئة. وهذا يسمح للتاريخ الحالي بالبقاء صالحًا طوال الوقت
منع عمليات النسخ/السحب المستقبلية من تلقي البيانات المحذوفة.

تعود الاستخدامات النموذجية للرقابة إلى متطلبات أمنية أو قانونية، بما في ذلك:

* كلمات المرور والمفاتيح الخاصة ومواد التشفير
* البيانات/الأكواد/المكتبات المرخصة التي انتهت صلاحية ترخيصها
* معلومات التعريف الشخصية أو البيانات الخاصة الأخرى

يمكن للعقد الخاضعة للرقابة أن تقاطع العملية النموذجية لشركة Mercurial كلما دعت الحاجة إلى البيانات المستخرجة
أن تتحقق. بعض الأوامر مثل hg قط/hg العودة، تفشل ببساطة عندما يُطلب منك ذلك
إنتاج بيانات خاضعة للرقابة. آخرون، مثل hg تحقق من و hg تحديث، يجب أن يكون قادرًا على التسامح
البيانات الخاضعة للرقابة لمواصلة العمل بطريقة ذات معنى. مثل هذه الأوامر تتسامح فقط
مراجعات الملفات الخاضعة للرقابة إذا كان مسموحًا بها من خلال خيار التكوين "Censor.policy=ignore".

أوامر
الرقيب
hg censer -r REV [-t نص] [ملف]

خيارات:

-r ،--ريف
ملف الرقابة من المراجعة المحددة

-t ،--علامة مميزة
استبدال بيانات القبر

com.chgserver
ملحق خادم الأوامر لـ cHg (تجريبي)

'س' قناة (قراءة و كتابة)
نشر طلب ui.system() إلى العميل

"ملحق" أمر
إرفاق stdio الخاص بالعميل الذي تم تمريره بواسطة sendmsg ()

"تشدير" أمر
تغيير الدليل الحالي

"جيتبيجر" أمر
يتحقق من تمكين جهاز النداء وأي جهاز النداء يجب تنفيذه

"سيتينف" أمر
استبدل os.environ بالكامل

'تنفس الصعداء حتى' بسيطة
إعادة تحميل ملفات التكوين

الأطفال
أمر لعرض مجموعات التغييرات التابعة (مهملة)

تم إهمال هذا التمديد. يجب عليك استخدام hg سجل -r "الأطفال (REV)" بدلا من ذلك.

أوامر
الأطفال
إظهار العناصر الفرعية لمراجعة دليل العمل المعطاة أو:

أطفال الزئبق [-r REV] [ملف]

اطبع العناصر الفرعية لمراجعات دليل العمل. إذا تم تقديم المراجعة عبر
-r/--rev، ستتم طباعة العناصر الفرعية لتلك المراجعة. إذا تم إعطاء وسيطة ملف،
المراجعة التي تم فيها تغيير الملف آخر مرة (بعد مراجعة دليل العمل أو
تتم طباعة الوسيطة إلى --rev إذا تم تقديمها.

الرجاء استخدام hg سجل في حين أن:

hg children => hg log -r 'children()'
hg children -r REV => hg log -r 'children(REV)'

يرى hg مساعدة سجل و hg مساعدة revsets.children.

خيارات:

-r ،--ريف
إظهار الأطفال للمراجعة المحددة

--نمط
العرض باستخدام ملف خريطة القالب (مهمل)

-T ،--نموذج
عرض مع القالب

يخض، يحرك بعنف
أمر لعرض إحصائيات حول تاريخ المستودع

أوامر
يخض، يحرك بعنف
رسم بياني للتغييرات في المستودع:

hg churn [-d DATE] [-r REV] [--الأسماء المستعارة للملف] [ملف]

سيعرض هذا الأمر رسمًا بيانيًا يمثل عدد الأسطر التي تم تغييرها أو
المراجعات، مجمعة وفقا للنموذج المحدد. سيتم تجميع القالب الافتراضي
التغييرات من قبل المؤلف. يمكن استخدام خيار --dateformat لتجميع النتائج حسب التاريخ
بدلا من ذلك.

تعتمد الإحصائيات على عدد الخطوط التي تم تغييرها، أو بدلاً من ذلك عدد الخطوط
مطابقة المراجعات إذا تم تحديد خيار --changesets.

أمثلة:

# عرض عدد الخطوط التي تم تغييرها لكل ملتزم
hg churn -t "{author|email}"

# عرض الرسم البياني للنشاط اليومي
hg churn -f "%H" -s -c

# عرض نشاط المطورين حسب الشهر
hg churn -f "%Y-%m" -s -c

# عرض عدد الخطوط التي تتغير في كل عام
hg churn -f "%Y" -s

من الممكن تعيين عناوين بريد إلكتروني بديلة إلى عنوان رئيسي من خلال توفير ملف
باستخدام التنسيق التالي:

=

يمكن تحديد مثل هذا الملف باستخدام خيار --aliases، وإلا فسيتم تحديد ملف ‎.hgchurn
بحثت عنه في جذر دليل العمل. سيتم تقسيم الأسماء المستعارة من أقصى اليمين "=".

خيارات:

-r ،--ريف
معدل العد للمراجعة أو مجموعة المراجعة المحددة

-د،--تاريخ
معدل العد للمراجعات مطابقة لمواصفات التاريخ

-t ،--oldtemplate
قالب لتجميع مجموعات التغييرات (موقوف)

-T ،--نموذج
قالب لتجميع مجموعات التغييرات (الافتراضي: {author|email})

-F،--صيغة التاريخ
تنسيق متوافق مع strftime للتجميع حسب التاريخ

-c ، --changesets
معدل العد حسب عدد مجموعات التغييرات

-س، --نوع
الفرز حسب المفتاح (الافتراضي: الفرز حسب العدد)

- ديفستات
عرض الخطوط المضافة/المحذوفة بشكل منفصل

--اسماء مستعارة
ملف بأسماء مستعارة للبريد الإلكتروني

-أنا،--يشمل
تضمين أسماء مطابقة للأنماط المحددة

-X ،- استثناء
استبعاد الأسماء المطابقة للأنماط المحددة

[+] يمكن تحديد الخيار المحدد عدة مرات

clonebundles
الإعلان عن الحزم التي تم إنشاؤها مسبقًا لاستنساخ البذور

"clonebundles" هو امتداد من جانب الخادم يستخدم للإعلان عن وجود
ملفات الحزمة التي تم إنشاؤها مسبقًا والمستضافة خارجيًا للعملاء الذين يتم استنساخهم بحيث يتم الاستنساخ
يمكن أن تكون أسرع وأكثر موثوقية وتتطلب موارد أقل على الخادم.

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

يوفر هذا الامتداد لمشغلي الخادم القدرة على إلغاء التحميل الذي قد يكون مكلفًا
تحميل استنساخ إلى خدمة خارجية. وإليك كيف يعمل.

1. يقوم مشغل الخادم بإنشاء آلية لإتاحة ملفات الحزمة على ملف
خدمة استضافة حيث يمكن لعملاء Mercurial جلبها.

2. تتم إضافة ملف البيان الذي يسرد عناوين URL المتاحة للحزمة وبعض البيانات التعريفية الاختيارية
مستودع Mercurial على الخادم.

3. يبدأ العميل عملية استنساخ مقابل خادم مطلع على حزم الاستنساخ.

4. يرى العميل أن الخادم يعلن عن حزم مستنسخة ويقوم بإحضار البيان
قائمة الحزم المتاحة.

5. يقوم العميل بتصفية وفرز الحزم المتاحة بناءً على ما يدعمه وما يدعمه
يفضل.

6. يقوم العميل بتنزيل وتطبيق حزمة متاحة من عنوان URL المحدد للخادم.

7. يقوم العميل بإعادة الاتصال بالخادم الأصلي وإجراء ما يعادل ذلك hg سحب إلى
استرداد جميع بيانات المستودع غير الموجودة في الحزمة. (كان من الممكن تحديث المستودع
بين وقت إنشاء الحزمة ووقت بدء العميل في الاستنساخ.)

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

للعمل، يتطلب هذا الامتداد ما يلي من مشغلي الخادم:

· إنشاء ملفات مجمعة لمحتوى المستودع (عادة بشكل دوري، مثل مرة واحدة لكل ملف).
يوم).

· خادم ملفات يمكن للعملاء الوصول إليه عبر الشبكة وتعرف لغة Python كيفية التحدث إليه
من خلال مرفق معالجة URL العادي الخاص به (عادةً خادم HTTP).

· عملية للحفاظ على بيان الحزم متزامنًا مع ملفات الحزمة المتوفرة.

بالمعنى الدقيق للكلمة، استخدام خادم استضافة الملفات الثابتة ليس مطلوبًا: مشغل الخادم
يمكن استخدام خدمة ديناميكية لاسترداد بيانات الحزمة. ومع ذلك، استضافة الملفات الثابتة
الخدمات بسيطة وقابلة للتطوير وينبغي أن تكون كافية لمعظم الاحتياجات.

يمكن إنشاء ملفات الحزمة باستخدام hg حزمة يأمر. عادة hg حزمة --الكل is
تستخدم لإنتاج حزمة من المستودع بأكمله.

hg debugcreatestreamclonebundle يمكن استخدامها لإنتاج خاص متدفق استنساخ حزمة.
هذه ملفات مجمعة تتميز بالكفاءة العالية في الإنتاج والاستهلاك (اقرأ: سريع).
ومع ذلك، فهي أكبر من تنسيقات الحزم التقليدية وتتطلب دعم العملاء
المجموعة الدقيقة من تنسيقات مخزن بيانات المستودع المستخدمة بواسطة المستودع الذي قام بإنشائها.
عادةً، يمكن للخادم الأحدث تقديم البيانات المتوافقة مع العملاء الأقدم. لكن،
متدفق استنساخ بال لا تملك هذا الضمان. المخدم مشغلي حاجة إلى be علم أن
أحدث الإصدارات of زئبقي قد إنتاج متدفق استنساخ بال تتعارض مع أقدم
زئبقي إصدارات.

مشغل الخادم هو المسؤول عن إنشاء .hg/clonebundles.manifest ملف يحتوي على
قائمة ملفات الحزمة المتاحة المناسبة لاستنساخ البذور. إذا لم يحدث هذا الملف
موجودة، لن يعلن المستودع عن وجود حزم استنساخ عند العملاء
الاتصال.

يحتوي ملف البيان على قائمة إدخالات محددة بالسطر الجديد ().

يحدد كل سطر في هذا الملف حزمة متاحة. الخطوط لها التنسيق:

[ = [ = ]]

أي عنوان URL متبوعًا بقائمة اختيارية مفصولة بمسافات لوصف أزواج المفاتيح = القيمة
خصائص إضافية لهذه الحزمة. يتم ترميز كل من المفاتيح والقيم بواسطة URI.

المفاتيح المكتوبة بالأحرف الكبيرة محجوزة للاستخدام بواسطة Mercurial وهي محددة أدناه. الجميع
يمكن استخدام المفاتيح غير الكبيرة من خلال عمليات التثبيت في الموقع. مثال للاستخدام للخصائص المخصصة
هو استخدام مركز البيانات سمة لتحديد مركز البيانات الذي سيتم استضافة الملف فيه.
يمكن للعملاء بعد ذلك تفضيل خادم في مركز البيانات الأقرب إليهم.

المفاتيح المحجوزة التالية محددة حاليًا:

بوندلسبيك
سلسلة "مواصفات الحزمة" التي تصف نوع الحزمة.

هذه هي قيم السلسلة التي يتم قبولها بواسطة وسيطة "--type". hg حزمة.

يتم تحليل القيم في الوضع الصارم، مما يعني أنها يجب أن تكون من
" - " النموذج. راجع mercurial.exchange.parsebundlespec() للمزيد
تفاصيل.

hg debugbundle --النوع يمكن استخدامها لطباعة سلسلة مواصفات الحزمة لـ
ملف الحزمة. يمكن استخدام مخرجات هذا الأمر حرفيًا لقيمة
بوندلسبيك (لقد نجا بالفعل).

سيقوم العملاء تلقائيًا بتصفية المواصفات غير المعروفة أو
غير مدعوم حتى لا يحاولوا تنزيل شيء من المحتمل ألا ينطبق.

لا تؤثر القيمة الفعلية على سلوك العميل بما يتجاوز التصفية: بل سيؤثر ذلك على العملاء
لا يزال يتعرف على نوع الحزمة من رأس الملفات التي تم تنزيلها.

استعمل of مفتاح is جدا موصى به، لأنه يسمح للعملاء بالتخطي بسهولة
حزم غير مدعومة. إذا لم يتم تعريف هذا المفتاح، فقد يحاول عميل قديم تطبيقه
حزمة أنه غير قادر على القراءة.

يتطلب
ما إذا كانت إشارة اسم الخادم (SNI) مطلوبة للاتصال بعنوان URL. يسمح SNI
خوادم لاستخدام شهادات متعددة على نفس IP. إنه شائع إلى حد ما في شبكات CDN
ومقدمي الاستضافة الآخرين. إصدارات Python الأقدم لا تدعم SNI. تعريف
تتيح هذه السمة للعملاء الذين لديهم إصدارات Python الأقدم تصفية هذا الإدخال
دون مواجهة فشل SSL غير شفاف في وقت الاتصال.

إذا تم تعريف ذلك، فمن المهم الإعلان عن عنوان URL احتياطي أو عملاء غير تابعين لـ SNI
قد لا يتمكن تشغيل إصدارات Python القديمة من الاستنساخ باستخدام حزم النسخ
منشأة.

يجب أن تكون القيمة "صحيحة".

يمكن أن تحتوي البيانات على إدخالات متعددة. بافتراض أنه تم تعريف بيانات التعريف، سيتم تصفية العملاء
إدخالات من البيان الذي لا يدعمونه. الإدخالات المتبقية اختيارية
مرتبة حسب تفضيلات العميل (التجريبية.clonebundleprefers خيار التكوين). الزبون
ثم يحاول جلب الحزمة على عنوان URL الأول في القائمة المتبقية.

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

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

اللون
تلوين الإخراج من بعض الأوامر

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

الآثار
تتوفر أيضًا تأثيرات أخرى بالإضافة إلى اللون، مثل النص الغامق والمسطر. بواسطة
بشكل افتراضي، يتم استخدام قاعدة بيانات terminfo للعثور على الرموز الطرفية المستخدمة لتغيير اللون و
تأثير. إذا لم تكن معلومات المصطلح متاحة، فسيتم عرض التأثيرات باستخدام ECMA-48 SGR
وظيفة التحكم (المعروفة أيضًا باسم رموز الهروب ANSI).

التأثيرات المتوفرة في وضع terminfo هي "وميض"، و"غامق"، و"خافت"، و"معكوس"، و"غير مرئي"،
"مائل"، و"متميز"، و"تسطير"؛ في وضع ECMA-48، تكون الخيارات "غامقة" و"معكوسة"
"مائل" و"تسطير". تعتمد كيفية تقديم كل منها على المحاكي الطرفي. بعض
قد لا يكون متاحًا لنوع طرفي معين، وسيتم تجاهله بصمت.

ملصقات
يتلقى النص تأثيرات لونية اعتمادًا على التسميات الموجودة به. العديد من الزئبقي الافتراضي
الأوامر تنبعث منها النص المسمى. يمكنك أيضًا تحديد التسميات الخاصة بك في القوالب باستخدام
وظيفة التسمية، انظر hg مساعدة النماذج. قد يحتوي جزء واحد من النص على أكثر من جزء
ملصق. في هذه الحالة، ستتجاوز التأثيرات المعطاة للملصق الأخير أي تأثيرات أخرى. هذا
يتضمن تأثير "لا شيء" الخاص، والذي يبطل التأثيرات الأخرى.

التسميات عادة ما تكون غير مرئية. من أجل رؤية هذه التسميات وموقعها في
النص، استخدم الخيار العام --color=debug. قد يرتبط نفس نص الربط بـ
تسميات متعددة، على سبيل المثال

[log.changeset changeset.secret|changeset: 22611:6f0a53c8f587]

فيما يلي التأثيرات الافتراضية لبعض التسميات الافتراضية. قد تكون التأثيرات الافتراضية
تم تجاوزه من ملف التكوين الخاص بك:

[لون]
Status.modified = تسطير باللون الأزرق الغامق red_background
Status.added = أخضر غامق
Status.removed = أحمر غامق blue_background
Status.deleted = تسطير سماوي غامق
Status.unknown = تسطير غامق أرجواني
Status.ignored = أسود غامق

# "لا شيء" يوقف جميع التأثيرات
الحالة.نظيفة = لا شيء
الحالة المنسوخة = لا شيء

qseries.applied = تسطير أزرق غامق
qseries.unapplied = أسود غامق
qseries.missing = أحمر غامق

diff.diffline = جريء
diff.extending = سماوي غامق
diff.file_a = أحمر غامق
diff.file_b = أخضر غامق
diff.hunk = أرجواني
diff.deleted = أحمر
diff.inserted = أخضر
diff.changed = أبيض
diff.tab =
diff.trailingwhitespace = خلفية حمراء غامقة

# فارغ بحيث يرث نمط الملصق المحيط به
التغييرات. العامة =
التغييرات. مشروع =
التغييرات. سر =

Resolve.unresolved = أحمر غامق
Resolve.resolved = أخضر غامق

الإشارات المرجعية النشطة = الأخضر

الفروع النشطة = لا شيء
الفروع.مغلقة = أسود غامق
الفروع. التيار = أخضر
الفروع غير النشطة = لا شيء

العلامات.عادي = أخضر
tag.local = أسود غامق

rebase.rebas = الأزرق
rebase.remaining = أحمر غامق

shelve.age = سماوي
shelve.newest = أخضر غامق
shelve.name = أزرق غامق

histedit.remaining = أحمر غامق

Custom الألوان
نظرًا لوجود ثمانية ألوان قياسية فقط، تتيح لك هذه الوحدة تحديد أسماء الألوان
لفتحات الألوان الأخرى التي قد تكون متاحة لنوع المحطة الطرفية الخاصة بك، بافتراض معلومات الطرفية
وضع. على سبيل المثال:

اللون الأزرق الساطع = 12
اللون الوردي = 207
اللون البرتقالي = 202

لتعيين "أزرق ساطع" على فتحة الألوان 12 (مفيدة لـ 16 محطة لونية أكثر سطوعًا
الألوان المحددة في الثمانية العليا) و"الوردي" و"البرتقالي" إلى الألوان في 256 لونًا xterm
مكعب اللون الافتراضي. يمكن بعد ذلك استخدام هذه الألوان المحددة كأي من الألوان المحددة مسبقًا
ثمانية، بما في ذلك إلحاق "_background" لتعيين الخلفية لهذا اللون.

وسائط
افتراضيًا، سيستخدم ملحق اللون وضع ANSI (أو وضع win32 في نظام التشغيل Windows) إذا كان كذلك
يكتشف محطة. لتجاوز الوضع التلقائي (لتمكين وضع terminfo، على سبيل المثال)، قم بتعيين
خيار التكوين التالي:

[لون]
mode = terminfo

أي قيمة بخلاف "ansi" أو "win32" أو "terminfo" أو "auto" ستؤدي إلى تعطيل اللون.

لاحظ أنه في بعض الأنظمة، قد يتسبب وضع terminfo في حدوث مشكلات عند استخدام اللون مع
ملحق النداء وأقل -R. أقل مع الخيار -R سيعرض لون ECMA-48 فقط
قد تصدر الرموز ووضع terminfo أحيانًا رموزًا لا يفهمها الأقل. أنت تستطيع
يمكنك حل هذه المشكلة إما باستخدام وضع ansi (أو الوضع التلقائي)، أو باستخدام less -r (والذي سيفعل ذلك
المرور عبر جميع رموز التحكم الطرفية، وليس فقط رموز التحكم في الألوان).

في بعض الأنظمة (مثل MSYS في Windows)، قد يدعم الجهاز وضع ألوان مختلف
من جهاز النداء (يتم تفعيله عبر امتداد "البيجر"). من الممكن تحديد منفصلة
الأوضاع اعتمادًا على ما إذا كان جهاز النداء نشطًا:

[لون]
الوضع = تلقائي
pagermode = ansi

If com.pagermode لم يتم تعريف طريقة وسوف تستخدم.

أوامر
تحول
استيراد المراجعات من مستودعات VCS الأجنبية إلى Mercurial

أوامر
تحول
تحويل مستودع SCM أجنبي إلى مستودع Mercurial.:

hg تحويل [خيار]... المصدر [DEST [REVMAP]]

تنسيقات المصدر المقبولة [المعرفات]:

· زئبقي [زئبق]

· السيرة الذاتية [السيرة الذاتية]

· داركس [داركس]

· بوابة [جيت]

· التخريب [svn]

· مونوتون [متن]

· جنو آرتش [gnuarch]

· البازار [بزر]

· القوة [ص 4]

تنسيقات الوجهة المقبولة [المعرفات]:

· زئبقي [زئبق]

· التخريب [svn] (لم يتم حفظ تاريخ الفروع)

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

إذا لم يتم تحديد اسم دليل الوجهة، فسيتم تعيينه افتراضيًا على الاسم الأساسي للمصدر
مع -زئبق ملحق. إذا لم يكن مستودع الوجهة موجودًا، فسيتم إنشاؤه.

افتراضيًا، ستستخدم جميع المصادر، باستثناء Mercurial، --branchsort. الاستخدامات الزئبقية
--sourcesort للحفاظ على ترتيب أرقام المراجعة الأصلية. أوضاع الفرز لها ما يلي
تأثيرات:

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

--datesort
فرز المراجعات حسب التاريخ. تحتوي المستودعات المحولة على سجلات تغيير جيدة المظهر ولكنها كذلك
غالبًا ما يكون ترتيبها أكبر من نفس الترتيب الذي تم إنشاؤه بواسطة --branchsort.

--sourcesort
حاول الحفاظ على ترتيب مراجعات المصدر، المدعوم فقط بمصادر Mercurial.

--Closesort
حاول نقل المراجعات المغلقة إلى أقرب ما يمكن من الفروع الأصلية فقط
بدعم من مصادر الزئبقي.

If خريطة تجديد السيارة غير معطى، سيتم وضعه في الموقع الافتراضي (/.hg/shamap by
تقصير). ال خريطة تجديد السيارة هو ملف نصي بسيط يقوم بتعيين معرف التزام كل مصدر إلى ملف
معرف الوجهة لتلك المراجعة، مثل:



إذا كان الملف غير موجود، فسيتم إنشاؤه تلقائيًا. يتم تحديثه عند كل التزام منسوخ،
so hg تحول يمكن مقاطعتها ويمكن تشغيلها بشكل متكرر لنسخ الالتزامات الجديدة.

خريطة المؤلف عبارة عن ملف نصي بسيط يقوم بتعيين كل مؤلف التزام مصدر إلى وجهة ما
ارتكاب المؤلف. يعد هذا مفيدًا لأنظمة SCM المصدرية التي تستخدم تسجيلات دخول Unix لتحديد المؤلفين (على سبيل المثال:
CVS). سطر واحد لكل تعيين مؤلف وتنسيق الخط هو:

المؤلف المصدر = المؤلف الوجهة

الأسطر الفارغة والسطور التي تبدأ بـ أ # يتم تجاهلها.

خريطة الملف هي ملف يسمح بتصفية الملفات والأدلة وإعادة تعيينها. كل
يمكن أن يحتوي السطر على أحد التوجيهات التالية:

تضمين المسار/إلى/ملف أو دير

استبعاد المسار/إلى/ملف أو دير

إعادة تسمية المسار/إلى/مسار المصدر/إلى/الوجهة

خطوط التعليق تبدأ بـ #. يتطابق المسار المحدد إذا كان يساوي الاسم النسبي الكامل
من ملف أو أحد الدلائل الأصلية الخاصة به. ال تتضمن or منع التوجيه مع
ينطبق أطول مسار مطابق، لذلك لا يهم ترتيب الأسطر.

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

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

خريطة التوصيل هي ملف يسمح بإدراج السجل التركيبي، مما يسمح لك بالتحديد
آباء المراجعة. وهذا مفيد إذا كنت تريد، على سبيل المثال، إعطاء دمج التخريب اثنين
الوالدين، أو تطعيم سلسلتين منفصلتين من التاريخ معًا. يحتوي كل إدخال على مفتاح،
متبوعة بمسافة، متبوعة بواحدة أو قيمتين مفصولتين بفاصلة:

مفتاح الوالد 1، الوالد 2

المفتاح هو معرف المراجعة في نظام التحكم في المراجعة المصدر الذي يجب أن يكون والديه
تم تعديله (نفس تنسيق المفتاح في .hg/shamap). القيم هي معرفات المراجعة (في أي منهما
نظام التحكم في مراجعة المصدر أو الوجهة) الذي يجب استخدامه كآباء جدد
لتلك العقدة. على سبيل المثال، إذا قمت بدمج "release-1.0" في "trunk"، فيجب عليك ذلك
حدد المراجعة على "الجذع" باعتبارها الأصل الأول والمراجعة الموجودة على "الإصدار 1.0"
فرع كالثاني.

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

original_branch_name new_branch_name

حيث "original_branch_name" هو اسم الفرع الموجود في المستودع المصدر، و
"new_branch_name" هو اسم الفرع وهو مستودع الوجهة. لا توجد مسافة بيضاء
مسموح في أسماء الفروع. يمكن استخدام هذا (على سبيل المثال) لنقل التعليمات البرمجية في ملف واحد
المستودع من "الافتراضي" إلى فرع مسمى.

زئبقي مصدر
يتعرف مصدر Mercurial على خيارات التكوين التالية، والتي يمكنك ضبطها
سطر الأوامر مع - تكوين:

تحويل. hg.ignoreerrors
تجاهل أخطاء التكامل عند القراءة. استخدمه لإصلاح مستودعات Mercurial باستخدام
سجلات المراجعة المفقودة، عن طريق التحويل من وإلى Mercurial. الافتراضي هو خطأ.

تحويل. hg.saverev
قم بتخزين معرف المراجعة الأصلي في مجموعة التغييرات (يفرض تغيير المعرفات المستهدفة). انه يأخذ
الوسيطة المنطقية والإعدادات الافتراضية إلى False.

تحويل. hg.startrev
تحديد المراجعة الزئبقية الأولية. الافتراضي هو 0.

تحويل. hg.revs
revset يحدد المراجعات المصدر المطلوب تحويلها.

CVS مصدر
سيستخدم مصدر CVS وضع الحماية (أي نسخة مسحوبة) من CVS للإشارة إلى البداية
نقطة ما سيتم تحويله. ليست هناك حاجة للوصول المباشر إلى ملفات المستودع،
ما لم يكن المستودع بالطبع :محلي:. يستخدم التحويل دليل المستوى الأعلى في
Sandbox للعثور على مستودع CVS، ثم يستخدم أوامر CVS rlog للعثور على الملفات إليها
يتحول. هذا يعني أنه ما لم يتم توفير خريطة ملف، فإن جميع الملفات موجودة ضمن دليل البداية
سيتم تحويله، وسيتم تجاهل أي عملية إعادة تنظيم للدليل في وضع حماية CVS.

يمكن استخدام الخيارات التالية مع - تكوين:

تحويل.cvsps.cache
اضبط على خطأ لتعطيل التخزين المؤقت للسجل عن بعد، لأغراض الاختبار وتصحيح الأخطاء.
الافتراضي صحيح.

تحويل.cvsps.fuzz
حدد الحد الأقصى للوقت (بالثواني) المسموح به بين عمليات الالتزام
مستخدم متطابق ورسالة تسجيل في مجموعة تغييرات واحدة. عندما كانت ملفات كبيرة جدا
تم التحقق منه كجزء من مجموعة التغييرات، فإن الإعداد الافتراضي قد لا يكون طويلاً بما يكفي. ال
الافتراضي هو 60.

تحويل.cvsps.mergeto
حدد تعبيرًا عاديًا تتطابق معه رسائل سجل الالتزام. إذا كانت المباراة
عند حدوث ذلك، ستقوم عملية التحويل بإدراج مراجعة وهمية لدمج الفرع
حيث تظهر رسالة السجل هذه للفرع المشار إليه في التعبير العادي. الافتراضي هو
{{دمج الفرع ([-\ث]+)}}

تحويل.cvsps.mergefrom
حدد تعبيرًا عاديًا تتطابق معه رسائل سجل الالتزام. إذا كانت المباراة
عند حدوث ذلك، ستضيف عملية التحويل أحدث مراجعة على الفرع
يشار إليه في regex باعتباره الوالد الثاني لمجموعة التغييرات. الافتراضي هو
{{دمج من فرع ([-\ث]+)}}

تحويل.localtimezone
استخدم التوقيت المحلي (كما هو محدد بواسطة متغير البيئة TZ) لمجموعة التغييرات
التاريخ/الأوقات. الافتراضي هو خطأ (استخدم UTC).

هوكس.cvslog
حدد دالة Python ليتم استدعاؤها في نهاية تجميع سجل CVS. ال
يتم تمرير الوظيفة قائمة بإدخالات السجل، ويمكنها تعديل الإدخالات
في مكانها، أو إضافتها أو حذفها.

هوكس.cvschangesets
حدد دالة Python ليتم استدعاؤها بعد حساب مجموعات التغييرات من ملف
سجل CVS. يتم تمرير الوظيفة قائمة بإدخالات مجموعة التغييرات، ويمكن تعديلها
مجموعات التغييرات في مكانها، أو إضافتها أو حذفها.

يسمح أمر Mercurial الإضافي "debugcvsps" بدمج التعليمات البرمجية المضمنة لمجموعة التغييرات
يتم تشغيلها دون القيام بالتحويل. معلماته ومخرجاته مشابهة لتلك الخاصة بـ cvsps
2.1. يرجى الاطلاع على مساعدة الأمر لمزيد من التفاصيل.

تخريب مصدر
يكتشف مصدر التخريب تخطيطات الجذع/الفروع/العلامات الكلاسيكية. بشكل افتراضي، الموردة
سفن: // الريبو / المسار / يتم تحويل عنوان URL المصدر كفرع واحد. لو svn://repo/path/trunk
موجود أنه يحل محل الفرع الافتراضي. لو svn://repo/path/branches موجود، لها
يتم سرد الدلائل الفرعية كفروع محتملة. لو svn://repo/path/tags موجود ، هو
بحثت عن العلامات التي تشير إلى الفروع المحولة. تقصير جذع, الفروع و علامات القيم
يمكن تجاوزها مع الخيارات التالية. قم بتعيينها على المسارات المتعلقة بعنوان URL المصدر، أو
اتركها فارغة لتعطيل الاكتشاف التلقائي.

يمكن ضبط الخيارات التالية باستخدام - تكوين:

تحويل.svn.branches
تحديد الدليل الذي يحتوي على الفروع. الافتراضي هو الفروع.

تحويل.svn.tags
حدد الدليل الذي يحتوي على العلامات. الافتراضي هو علامات.

تحويل.svn.trunk
تحديد اسم فرع الجذع. الافتراضي هو جذع.

تحويل.localtimezone
استخدم التوقيت المحلي (كما هو محدد بواسطة متغير البيئة TZ) لمجموعة التغييرات
التاريخ/الأوقات. الافتراضي هو خطأ (استخدم UTC).

يمكن استرداد سجل المصدر بدءًا من مراجعة معينة، بدلاً من استرجاعه
تحويلها بشكل متكامل. يتم دعم تحويلات فرع واحد فقط.

تحويل.svn.startrev
تحديد رقم مراجعة بدء التخريب. الافتراضي هو 0.

بوابة مصدر
يقوم مستورد Git بتحويل الالتزامات من جميع الفروع التي يمكن الوصول إليها (المراجع في المراجع/الرؤوس) و
أجهزة التحكم عن بعد (المراجع في المراجع/أجهزة التحكم عن بعد) إلى Mercurial. يتم تحويل الفروع إلى إشارات مرجعية باستخدام الملف
نفس الاسم، مع تجريد "المراجع/الرؤوس" البادئة. يتم تحويل وحدات Git الفرعية إلى Git
إعادة الشراء في Mercurial.

يمكن ضبط الخيارات التالية باستخدام - تكوين:

تحويل.git.similarity
حدد كيفية استيراد الملفات المشابهة التي تم تعديلها في الالتزام كتسميات أو
نسخ، كنسبة مئوية بين 0 (معطل) و 100 (يجب أن تكون الملفات متطابقة). ل
مثال، 90 يعني أنه سيتم استيراد زوج الحذف/الإضافة كإعادة تسمية إذا كان أكثر من
90% من الملف لم يتغير. الافتراضي هو 50.

تحويل.git.findcopiesharder
أثناء اكتشاف النسخ، انظر إلى جميع الملفات الموجودة في نسخة العمل بدلاً من مجرد النظر إليها
تغيرت. وهذا مكلف للغاية بالنسبة للمشاريع الكبيرة، ولن يكون فعالاً إلا عندما
تحويل.git.similarity أكبر من 0. القيمة الافتراضية هي False.

تحويل.git.remoteprefix
يتم تحويل المراجع البعيدة كإشارات مرجعية باستخدام تحويل.git.remoteprefix كبادئة
تليها /. الافتراضي هو "البعيد".

تحويل.git.skipsubmodules
لا يقوم بتحويل ملفات .gitmodules على مستوى الجذر أو الملفات التي تشير إلى وضع 160000
وحدة فرعية. الافتراضي هو خطأ.

بحكم الضرورة مصدر
يمكن منح مستورد Perforce (P4) مسار مستودع p4 أو مواصفات العميل كـ
مصدر. سيقوم بتحويل جميع الملفات الموجودة في المصدر إلى مستودع Mercurial مسطح، متجاهلاً ذلك
التسميات والفروع والتكاملات. لاحظ أنه عندما يتم منحك مسار المستودع، فعادةً ما
يجب تحديد دليل هدف، لأنه بخلاف ذلك قد يتم تسمية الهدف ...-زئبق.

يمكن ضبط الخيارات التالية باستخدام - تكوين:

تحويل.p4.encoding
تحديد الترميز الذي سيتم استخدامه عند فك تشفير الإخراج القياسي لأمر Perforce
أداة سطر. الافتراضي هو ترميز النظام الافتراضي.

تحويل.p4.startrev
حدد مراجعة Perforce الأولية (رقم قائمة التغيير Perforce).

زئبقي الرحلات
سوف تتعرف وجهة Mercurial على مستودعات Mercurial الفرعية في الوجهة
الدليل، وقم بتحديث ملف .hgsubstate تلقائيًا إذا كانت الوجهة
تحتوي المستودعات الفرعية على / /.hg/shamap الملف. تحويل مستودع مع
تتطلب المستودعات الفرعية تحويل مستودع واحد في كل مرة، من الأسفل إلى الأعلى.

مثال يوضح كيفية تحويل مستودع مع مستودعات فرعية:

# لذا يعرف التحويل النوع عندما يرى وجهة غير فارغة
تم تحويل $ hg init

$ hg تحويل orig/sub1 تحويل/sub1
$ hg تحويل orig/sub2 تحويل/sub2
تحويل $ hg إلى الأصل المحول

الخيارات التالية مدعومة:

تحويل. hg.clonebranches
إرسال فروع المصدر في نسخ منفصلة. الافتراضي هو خطأ.

تحويل. hg.tagsbranch
اسم الفرع لمراجعات العلامات، الافتراضي هو الافتراضي.

تحويل. hg.usebranchnames
الحفاظ على أسماء الفروع. الافتراضي هو الصحيح.

تحويل.hg.sourcename
يسجل السلسلة المحددة كقيمة إضافية "convert_source" في كل التزام يتم إجراؤه
المستودع المستهدف. الافتراضي هو لا شيء.

الكل وجهات
تقبل جميع أنواع الوجهات الخيارات التالية:

تحويل.skiptags
لا يقوم بتحويل العلامات من الريبو المصدر إلى الريبو الهدف. الافتراضي هو
خاطئة.

خيارات:

--المؤلفون
اسم ملف تعيين اسم المستخدم (مهمل) (استخدم --authormap بدلاً من ذلك)

-س،--نوع المصدر
نوع مستودع المصدر

-د،--نوع الوجهة
نوع مستودع الوجهة

-r ،--ريف
استيراد ما يصل إلى مراجعة المصدر REV

-أ،--authormap
إعادة تعيين أسماء المستخدمين باستخدام هذا الملف

--filemap
إعادة تعيين أسماء الملفات باستخدام محتويات الملف

--ممتلىء قم بتطبيق تغييرات خريطة الملف عن طريق تحويل جميع الملفات مرة أخرى

--splicemap
لصق توليف التاريخ في مكانه

--branchmap
تغيير أسماء الفروع أثناء التحويل

--فرع
حاول فرز مجموعات التغييرات حسب الفروع

--datesort
حاول فرز مجموعات التغييرات حسب التاريخ

--sourcesort
الحفاظ على ترتيب مجموعات التغييرات المصدر

--Closesort
حاول إعادة ترتيب المراجعات المغلقة

[+] يمكن تحديد الخيار المحدد عدة مرات

إيول
إدارة الأسطر الجديدة تلقائيًا في ملفات المستودع

يتيح لك هذا الامتداد إدارة نوع نهايات الأسطر (CRLF أو LF) المستخدمة فيها
المستودع وفي دليل العمل المحلي. بهذه الطريقة يمكنك الحصول على نهايات خطوط CRLF
على Windows وLF على Unix/Mac، وبالتالي السماح للجميع باستخدام نهايات الأسطر الأصلية لنظام التشغيل الخاص بهم.

يقرأ الملحق التكوين الخاص به من إصدار .hgeol تم العثور على ملف التكوين في
جذر دليل العمل. ال .hgeol يستخدم الملف نفس بناء الجملة مثل جميع الملفات الأخرى
ملفات التكوين الزئبقي. ويستخدم قسمين، [أنماط] و [مخزن].

• [أنماط] يحدد القسم كيفية تحويل نهايات الأسطر بين العمل
الدليل والمستودع. يتم تحديد التنسيق بواسطة نمط الملف. المباراة الأولى
يتم استخدام، لذا ضع أنماطًا أكثر تحديدًا أولاً. نهايات الأسطر المتاحة هي LF, CRLFو
BIN.

الملفات ذات التنسيق المعلن CRLF or LF يتم فحصها دائمًا وتخزينها في
المستودع بهذا التنسيق والملفات التي تم الإعلان عنها لتكون ثنائية (BIN) تبقى دون تغيير.
بالإضافة إلى ذلك، محلي هو اسم مستعار للسحب في نهاية السطر الافتراضي للنظام الأساسي:
LF على Unix (بما في ذلك Mac OS X) و CRLF على ويندوز. لاحظ أن BIN (لا تفعل شيئا للخط
النهايات) هو السلوك الافتراضي لـ Mercurial؛ هناك حاجة إليه فقط إذا كنت بحاجة إلى تجاوز أ
في وقت لاحق، نمط أكثر عمومية.

اختياري [مخزن] يحدد القسم نهايات الأسطر التي سيتم استخدامها للملفات المخزنة فيها
المستودع. لديها إعداد واحد، محلي، الذي يحدد نهايات خطوط التخزين
للملفات التي تم الإعلان عنها كـ محلي في ال [أنماط] قسم. يمكن ضبطه على LF or CRLF.
الافتراضي هو LF. على سبيل المثال، هذا يعني أنه في نظام التشغيل Windows، سيتم تكوين الملفات كـ محلي (CRLF
افتراضيًا) سيتم تحويله إلى LF عند تخزينها في المستودع. تم الإعلان عن الملفات باسم LF,
CRLFالطرق أو BIN في ال [أنماط] يتم تخزين القسم دائمًا كما هو في المستودع.

تم إصدار المثال .hgeol ملف:

[أنماط]
**.py = أصلي
**.vcproj = CRLF
**.txt = أصلي
ملف تعريف = LF
**.jpg = بن

[مخزن]
أصلي = LF

ملاحظة: سيتم تطبيق القواعد أولاً عند لمس الملفات في دليل العمل، على سبيل المثال بواسطة
التحديث إلى null والعودة إلى الطرف للمس كافة الملفات.

يستخدم الملحق اختياري [eol] قسم القراءة من كل من Mercurial العادي
ملفات التكوين و .hgeol الملف، حيث يطغى الأخير على الأول. أنت تستطيع
استخدم هذا القسم للتحكم في السلوك العام. هناك ثلاثة إعدادات:

· eol.native (إفتراضي os.linesep) يمكن ضبطها على LF or CRLF لتجاوز الافتراضي
تفسير ل محلي للخروج. يمكن استخدام هذا مع hg أرشيف على يونيكس، على سبيل المثال، ل
إنشاء أرشيف حيث تكون الملفات ذات نهايات أسطر لنظام التشغيل Windows.

· eol.only-consistent (افتراضي True) يمكن ضبطه على False لتحويل الامتداد
الملفات التي تحتوي على EOLs غير متناسقة. غير متناسق يعني أن هناك كليهما CRLF و LF يقدم
في الملف. عادةً لا يتم التطرق إلى مثل هذه الملفات على افتراض وجودها
EOLs مختلطة عن قصد.

· eol.fix-Trailing-newline (افتراضي خطأ) يمكن ضبطه على صحيح للتأكد من تحويله
تنتهي الملفات بحرف EOL (إما \n or \ ص \ ن حسب الأنماط التي تم تكوينها).

يوفر التمديد الكود الذكي: و كود ذكي: المرشحات مثل المهملة
ملحق win32text يفعل. هذا يعني أنه يمكنك تعطيل win32text وتمكين eol و
ستظل عوامل التصفية الخاصة بك تعمل. ما عليك سوى استخدام هذه المرشحات حتى تقوم بإعداد ملف
.hgeol ملف.

• win32text.forbid* تم توحيد الخطافات التي يوفرها ملحق win32text في ملف
خطاف واحد اسمه eol.checkheadshook. سيقوم الخطاف بالبحث عن نهايات الأسطر المتوقعة منها
ال .hgeol الملف، مما يعني أنه يجب عليك الترحيل إلى ملف .hgeol الملف أولاً قبل استخدام ملف
صنارة صيد. eol.checkheadshook يتحقق فقط من الرؤوس، وسيتم دفع المراجعات المتوسطة غير الصالحة.
لمنعهم تماما، استخدم eol.checkallhook خطاف. من الأفضل استخدام هذه الخطافات
com.pretxnchangegroup خطاف.

يرى hg مساعدة أنماط لمزيد من المعلومات حول أنماط الكرة الأرضية المستخدمة.

com.extdiff
أمر للسماح للبرامج الخارجية بمقارنة المراجعات

يسمح لك ملحق extdiff Mercurial باستخدام برامج خارجية لمقارنة المراجعات،
أو المراجعة مع دليل العمل. يتم استدعاء برامج الفرق الخارجية بـ a
مجموعة من الخيارات القابلة للتكوين ووسيطين غير خياريين: المسارات إلى الدلائل التي تحتوي على
لقطات من الملفات للمقارنة.

يسمح لك ملحق extdiff أيضًا بتكوين أوامر diff جديدة، لذلك لا تحتاج إليها
لكتابة hg com.extdiff -p kdiff3 دائما.

[امتداد]
# إضافة أمر جديد لتشغيل جنو فرق(1) في وضع "اختلاف السياق".
cdiff = gdiff -Nprc5
## أو الطريقة القديمة:
#cmd.cdiff = gdiff
#opts.cdiff = -Nprc5

# إضافة أمر جديد يسمى meld، يقوم بتشغيل meld (لا داعي للتسمية مرتين). لو
# الملف القابل للتنفيذ للدمج غير متوفر، أداة الدمج في [أدوات الدمج]
سيتم استخدام #، إذا كان متاحا
مزيج =

# إضافة أمر جديد يسمى vimdiff، يقوم بتشغيل gvimdiff باستخدام البرنامج المساعد DirDiff
# (يرى http://www.vim.org/scripts/script.php?script_id=102) غير
# مستخدم اللغة الإنجليزية، تأكد من وضع "let g:DirDiffDynamicDiffText = 1" في
# .vimrc الخاص بك
vimdiff = gvim -f "+التالي" \
"+تنفيذ 'DirDiff' fnameescape(أرجف(0)) فناميسكيب(أرجف(1) "

يمكن أن تتضمن وسيطات الأداة متغيرات يتم توسيعها في وقت التشغيل:

$parent1، $plabel1 - اسم الملف، التسمية الوصفية للوالد الأول
$child، $clabel - اسم الملف، التسمية الوصفية للمراجعة الفرعية
$parent2، $plabel2 - اسم الملف، التسمية الوصفية للأصل الثاني
الجذر $ - جذر المستودع
$parent هو اسم مستعار لـ $parent1.

سيبحث الامتداد extdiff في أقسام [diff-tools] و[merge-tools] عن الفرق
وسيطات الأداة، عندما لا يتم تحديد أي منها في [extdiff].

[امتداد]
كدف3 =

[أدوات الفرق]
kdiff3.diffargs=--L1 '$plabel1' --L2 '$clabel' $parent $child

يمكنك استخدام -I/-X وقائمة أسماء الملفات أو الدليل كالمعتاد hg فرق أمر. ال
يقوم ملحق extdiff بعمل لقطات للملفات المطلوبة فقط، لذا فإن تشغيل امتداد diff الخارجي
سيكون البرنامج سريعًا جدًا (على الأقل أسرع من الاضطرار إلى مقارنة البرنامج بأكمله).
شجرة).

أوامر
com.extdiff
استخدم برنامجًا خارجيًا لمستودع الفرق (أو الملفات المحددة):

hg extdiff [اختياري]... [ملف]...

إظهار الاختلافات بين المراجعات للملفات المحددة باستخدام برنامج خارجي. ال
البرنامج الافتراضي المستخدم هو diff، مع الخيارات الافتراضية "-Npru".

لتحديد برنامج مختلف، استخدم الخيار -p/--program. سيتم تمرير البرنامج
أسماء اثنين من الدلائل للمقارنة. لتمرير خيارات إضافية للبرنامج، استخدم
-o/--الخيار. سيتم تمرير هذه قبل أسماء الدلائل للمقارنة.

عند تقديم وسيطتين للمراجعة، تظهر التغييرات بين تلك المراجعات. لو
يتم تحديد مراجعة واحدة فقط ثم تتم مقارنة تلك المراجعة بدليل العمل،
وعندما لا يتم تحديد أي مراجعات، تتم مقارنة ملفات دليل العمل بها
الأبوين.

خيارات:

-p ،--برنامج
برنامج المقارنة للتشغيل

-o ،--اختيار
تمرير الخيار لبرنامج المقارنة

-r ،--ريف
تنقيح

-c ،--يتغير
التغيير الذي تم عن طريق المراجعة

--رقعة قماشية
مقارنة التصحيحات لمراجعتين

-أنا،--يشمل
تضمين أسماء مطابقة للأنماط المحددة

-X ،- استثناء
استبعاد الأسماء المطابقة للأنماط المحددة

-س، --subrepos
يتكرر في المستودعات الفرعية

[+] يمكن تحديد الخيار المحدد عدة مرات

خادم
مصادقة http مع Factotum

يسمح هذا الامتداد بـ خادم(4) المنشأة في الخطة 9 من منصات Bell Labs إلى
توفير معلومات المصادقة للوصول إلى HTTP. إدخالات التكوين المحددة في
قسم المصادقة بالإضافة إلى معلومات المصادقة المقدمة في عنوان URL للمستودع
بدعم كامل. إذا لم يتم تحديد بادئة، فسيتم افتراض قيمة "*".

بشكل افتراضي، يتم تحديد المفاتيح على النحو التالي:

proto=تمرير الخدمة=بادئة hg= المستخدم= !كلمة المرور=

إذا كان ملحق Factotum غير قادر على قراءة المفتاح المطلوب، فسيتم طلب واحد
بشكل تفاعلي.

يتوفر قسم التكوين لتخصيص سلوك وقت التشغيل. بشكل افتراضي، هذه
الإدخالات هي:

[الواقعة]
قابل للتنفيذ = /bin/auth/factotum
mountpoint = /mnt/factotum
الخدمة = زئبق

يحدد الإدخال القابل للتنفيذ المسار الكامل للثنائي الواقعي. مدخل نقطة التثبيت
يحدد المسار إلى خدمة الملفات الفعلية. وأخيرًا، يتحكم إدخال الخدمة في
اسم الخدمة المستخدم عند قراءة المفاتيح.

جلب
السحب والتحديث والدمج في أمر واحد (موقوف)

أوامر
جلب
سحب التغييرات من مستودع بعيد، ودمج التغييرات الجديدة إذا لزم الأمر.:

جلب الزئبق [المصدر]

يؤدي هذا إلى العثور على جميع التغييرات من المستودع في المسار أو عنوان URL المحدد وإضافتها إليه
المستودع المحلي.

إذا أضافت التغييرات المسحوبة رأسًا فرعيًا جديدًا، فسيتم دمج الرأس تلقائيًا، وسيصبح
نتيجة الدمج ملتزمة. وبخلاف ذلك، يتم تحديث دليل العمل ليشمل
التغييرات الجديدة.

عند الحاجة إلى الدمج، يتم أولاً تحديث دليل العمل إلى الدليل المسحوب حديثًا
التغييرات. يتم بعد ذلك دمج التغييرات المحلية في التغييرات المسحوبة. لتبديل ترتيب الدمج،
استخدم --switch-parent.

يرى hg مساعدة التمور للحصول على قائمة التنسيقات الصالحة لـ -d/--date.

يعود 0 على النجاح.

خيارات:

-r ،--ريف
مراجعة محددة ترغب في سحبها

-e، --تعديل
استدعاء المحرر على رسائل الالتزام

--محرر القوة
تحرير رسالة الالتزام (مهملة)

--switch-parent
تبديل الوالدين عند الدمج

م ،--رسالة
استخدم النص كرسالة التزام

-ل ،--ملف تسجيل
قراءة رسالة الالتزام من الملف

-د،--تاريخ
سجل التاريخ المحدد كتاريخ الالتزام

-u ،--المستعمل
تسجيل المستخدم المحدد كملتزم

-e،--SSH
تحديد أمر ssh للاستخدام

--remotecmd
حدد الأمر hg ليتم تشغيله على الجانب البعيد

--غير آمن
لا تتحقق من شهادة الخادم (تجاهل تكوين web.cacerts)

[+] يمكن تحديد الخيار المحدد عدة مرات

المنافع العامة العالمية
أوامر للتوقيع والتحقق من التغييرات

أوامر
sigcheck
التحقق من جميع التوقيعات التي قد تكون موجودة لمراجعة معينة:

زئبق sigcheck REV

التحقق من جميع التوقيعات التي قد تكون هناك لمراجعة معينة

إشارة
إضافة توقيع للمراجعة الحالية أو المعطاة:

علامة hg [خيار]... [REV]...

إذا لم يتم تقديم أي مراجعة، فسيتم استخدام الأصل لدليل العمل، أو نصيحة إذا لم يتم ذلك
يتم فحص المراجعة.

• gpg.cmd يمكن استخدام إعداد التكوين لتحديد الأمر المطلوب تشغيله. يمكن أن يكون المفتاح الافتراضي
المحدد بـ gpg.key.

يرى hg مساعدة التمور للحصول على قائمة التنسيقات الصالحة لـ -d/--date.

خيارات:

-ل ، --محلي
جعل التوقيع محليا

-F، --فرض
قم بالتوقيع حتى لو تم تعديل ملف sigfile

- لا تلتزم
لا تلتزم بملف sigfile بعد التوقيع

-ك،--مفتاح
معرف المفتاح للتوقيع به

م ،--رسالة
استخدم النص كرسالة التزام

-e، --تعديل
استدعاء المحرر على رسائل الالتزام

-د،--تاريخ
سجل التاريخ المحدد كتاريخ الالتزام

-u ،--المستعمل
تسجيل المستخدم المحدد كملتزم

التوقيع
قائمة التغييرات الموقعة:

علامات الزئبق

قائمة التغييرات الموقعة

graphlog
أمر لعرض الرسوم البيانية للمراجعة من Shell (تم إهماله)

تم تضمين وظيفة هذا الامتداد في Mercurial الأساسي منذ الإصدار 2.3.
الرجاء استخدام hg سجل -G بدلا من ذلك.

يضيف هذا الامتداد خيار --graph إلى الأوامر الواردة والصادرة والسجل. عندما
يتم إعطاء الخيارات، ويظهر أيضًا تمثيل ASCII للرسم البياني للمراجعة.

أوامر
جلوج
إظهار سجل المراجعة جنبًا إلى جنب مع الرسم البياني لمراجعة ASCII:

مدونة hg [خيار]... [ملف]

اطبع سجل المراجعة جنبًا إلى جنب مع رسم بياني للمراجعة مرسوم بأحرف ASCII.

العقد المطبوعة كحرف @ هي أصول دليل العمل.

هذا هو الاسم المستعار ل hg سجل -G.

خيارات:

-F، --إتبع
اتبع سجل التغييرات، أو سجل الملف عبر النسخ وإعادة التسمية

--follow-first
اتبع فقط الأصل الأول لمجموعات تغييرات الدمج (مهملة)

-د،--تاريخ
إظهار المراجعات المطابقة لمواصفات التاريخ

-C ، - نُسخ
إظهار الملفات المنسوخة

-ك،--كلمة رئيسية
قم بإجراء بحث غير حساس لحالة الأحرف عن نص معين

-r ،--ريف
إظهار المراجعة أو المراجعة المحددة

--إزالة
تضمين المراجعات حيث تمت إزالة الملفات

م ، --فقط-يدمج
إظهار عمليات الدمج فقط (مهملة)

-u ،--المستعمل
المراجعات التي يرتكبها المستخدم

--فقط-فرع
إظهار مجموعات التغييرات فقط داخل الفرع المسمى المحدد (مهمل)

-ب،--فرع
إظهار مجموعات التغييرات داخل الفرع المحدد المحدد

-P ،--تقليم
لا تعرض المراجعة أو أي من أسلافها

-p ، --رقعة قماشية
إظهار التصحيح

-g ، --شخص سخيف
استخدم تنسيق git Extended diff

-ل ،--حد
الحد من عدد التغييرات المعروضة

-M ، - لا دمج
لا تظهر عمليات الدمج

- إحصائيات إخراج ملخص للتغييرات على غرار diffstat

-G ، --رسم بياني
إظهار المراجعة DAG

--نمط
العرض باستخدام ملف خريطة القالب (مهمل)

-T ،--نموذج
عرض مع القالب

-أنا،--يشمل
تضمين أسماء مطابقة للأنماط المحددة

-X ،- استثناء
استبعاد الأسماء المطابقة للأنماط المحددة

[+] يمكن تحديد الخيار المحدد عدة مرات

hgcia
خطافات للتكامل مع خدمة إعلام CIA.vc

من المفترض أن يتم تشغيل هذا كمجموعة تغيير أو خطاف وارد. لتكوينه، قم بتعيين
الخيارات التالية في hgrc الخاص بك:

[وكالة المخابرات المركزية]
# اسم المستخدم المسجل الخاص بوكالة المخابرات المركزية (CIA).
المستخدم = فو
# اسم المشروع في وكالة المخابرات المركزية
مشروع = فو
# الوحدة (مشروع فرعي) (اختياري)
#الوحدة = فو
# إلحاق diffstat برسالة السجل (اختياري)
#ديفستات = خطأ
# قالب لاستخدامه في رسائل السجل (اختياري)
#template = {desc}\n{baseurl}{webroot}/rev/{node}-- {diffstat}
# النمط المستخدم (اختياري)
#style = فو
# عنوان URL لخدمة إعلام CIA (اختياري)
# يمكنك استخدام mailto: عناوين URL للإرسال عبر البريد الإلكتروني، على سبيل المثال
# ميلتو:[البريد الإلكتروني محمي]
# تأكد من تعيين email.from إذا قمت بذلك.
#رابط = http://cia.vc/
# طباعة الرسالة بدلا من إرسالها (اختياري)
#الاختبار = خطأ
# عدد الخطوط المائلة المراد تجريدها من مسارات عناوين URL
#الشريط = 0

[خطافات]
# واحدة من هذه:
Changegroup.cia = بيثون:hgcia.hook
#incoming.cia = بيثون:hgcia.hook

[الإنترنت]
# إذا كنت تريد الارتباطات التشعبية (اختياري)
باسيرل = http://server/path/to/repo

hgk
تصفح المستودع بطريقة رسومية

يسمح ملحق hgk بتصفح سجل المستودع بطريقة رسومية. هو - هي
يتطلب إصدار Tcl/Tk 8.4 أو أحدث. (لا يتم توزيع Tcl/Tk مع Mercurial.)

يتكون hgk من جزأين: برنامج نصي Tcl يقوم بالعرض والاستعلام عنه
معلومات، وملحق لـ Mercurial اسمه hgk.py، والذي يوفر خطافات لـ hgk إلى
احصل على المعلومات. يمكن العثور على hgk في دليل المساهمة، ويتم شحن الامتداد
في مستودع hgext، ويجب تمكينه.

• hg عرض سيقوم الأمر بتشغيل البرنامج النصي hgk Tcl. لكي يعمل هذا الأمر، يجب أن يكون hgk
في مسار البحث الخاص بك. وبدلاً من ذلك، يمكنك تحديد المسار إلى hgk في التكوين الخاص بك
ملف:

[هك]
المسار = /الموقع/من/hgk

يمكن لـ hgk الاستفادة من الامتداد extdiff لتصور المراجعات. على افتراض أن لديك
الأمر extdiff vdiff الذي تم تكوينه بالفعل، فقط قم بإضافة:

[هك]
vdiff=vdiff

ستعرض قائمة سياق المراجعات الآن إدخالات إضافية لإطلاق vdiff عند التمرير فوق و
المراجعات المختارة.

أوامر
عرض
بدء عارض التاريخ التفاعلي:

عرض hg [-l LIMIT] [REVRANGE]

بدء تشغيل عارض التاريخ التفاعلي

خيارات:

-ل ،--حد
الحد من عدد التغييرات المعروضة

تسليط الضوء على
تسليط الضوء على بناء الجملة لـ hgweb (يتطلب Pygments)

يعتمد ذلك على مكتبة تسليط الضوء على بناء جملة Pygments: http://pygments.org/

هناك خيارات التكوين التالية:

[الإنترنت]
pygments_style = (default: colorful)
ملفات التمييز = (الافتراضي: الحجم ('<5M'))
Highlightonlymatchfilename = (خطأ افتراضي)

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

أصمت
تحرير التاريخ التفاعلي

مع تثبيت هذا الملحق، يحصل Mercurial على أمر جديد: histedit. الاستخدام كما هو
يتبع، بافتراض التاريخ التالي:

@ 3[نصيحة] 7c2fd3b9020c 2009-04-27 18:04 -0500 durin42
| أضف دلتا
|
o 2 030b686bedc4 2009-04-27 18:04 -0500 durin42
| أضف جاما
|
o 1 c561b4e977df 2009-04-27 18:04 -0500 durin42
| إضافة بيتا
|
o 0 d8d2fcd0e319 2009-04-27 18:04 -0500 durin42
أضف ألفا

لو كنت لتشغيل hg أصمت c561b4e977df، سترى الملف التالي مفتوحًا في ملفك
محرر:

اختر c561b4e977df أضف النسخة التجريبية
اختر 030b686bedc4 أضف جاما
اختر 7c2fd3b9020c أضف دلتا

# تحرير التاريخ بين c561b4e977df و7c2fd3b9020c
#
# يتم إدراج الالتزامات من الأقل إلى الأحدث
#
# الأوامر:
# ع، اختيار = استخدام الالتزام
# ه، تحرير = استخدم الالتزام، ولكن توقف عن التعديل
# f,fold = استخدم الالتزام، ولكن قم بدمجه مع ما سبق
# r, roll = مثل الطية، لكن تجاهل وصف هذا الالتزام
# د، إسقاط = إزالة الالتزام من التاريخ
# m، الفوضى = تحرير رسالة الالتزام دون تغيير محتوى الالتزام
#

في هذا الملف، الأسطر التي تبدأ بـ # يتم تجاهلها. يجب عليك تحديد قاعدة لكل منها
مراجعة في تاريخك. على سبيل المثال، إذا كنت تقصد إضافة جاما قبل النسخة التجريبية، ثم
إذا أردت إضافة دلتا في نفس النسخة التجريبية مثل النسخة التجريبية، فيمكنك إعادة تنظيم الملف ليبدو
مثله:

اختر 030b686bedc4 أضف جاما
اختر c561b4e977df أضف النسخة التجريبية
قم بطي 7c2fd3b9020c وأضف دلتا

# تحرير التاريخ بين c561b4e977df و7c2fd3b9020c
#
# يتم إدراج الالتزامات من الأقل إلى الأحدث
#
# الأوامر:
# ع، اختيار = استخدام الالتزام
# ه، تحرير = استخدم الالتزام، ولكن توقف عن التعديل
# f,fold = استخدم الالتزام، ولكن قم بدمجه مع ما سبق
# r, roll = مثل الطية، لكن تجاهل وصف هذا الالتزام
# د، إسقاط = إزالة الالتزام من التاريخ
# m، الفوضى = تحرير رسالة الالتزام دون تغيير محتوى الالتزام
#

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

إضافة بيتا
***
أضف دلتا

قم بتحرير رسالة الالتزام حسب رغبتك، ثم أغلق المحرر. على سبيل المثال، دعونا
افترض أنه تم تغيير رسالة الالتزام إلى أضف بيتا و دلتا. بعد تشغيل histedit
وأتيحت له الفرصة لإزالة أي مراجعات قديمة أو مؤقتة يحتاجها، كما يبدو التاريخ
مثله:

@ 2[نصيحة] 989b4d060121 2009-04-27 18:04 -0500 durin42
| إضافة بيتا ودلتا.
|
o 1 081603921c3f 2009-04-27 18:04 -0500 durin42
| أضف جاما
|
o 0 d8d2fcd0e319 2009-04-27 18:04 -0500 durin42
أضف ألفا

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

• تحرير ستعيدك العملية إلى موجه الأوامر، مما يسمح لك بتحرير الملفات
بحرية، أو حتى استخدامها hg سجل لارتكاب بعض التغييرات كالتزام منفصل. عندما كنت
تم ذلك، وسيتم أيضًا الالتزام بأي تغييرات متبقية غير ملتزم بها. عند الانتهاء، تشغيل hg
أصمت --استمر لإنهاء هذه الخطوة. ستتم مطالبتك برسالة التزام جديدة، ولكن
ستكون رسالة الالتزام الافتراضية هي الرسالة الأصلية لـ تحرير مراجعة إد.

• الرسالة ستمنحك العملية فرصة لمراجعة رسالة الالتزام دون تغيير
محتويات. إنه اختصار للقيام تحرير تليها على الفور hg أصمت
--متابعة`.

If أصمت يواجه تعارضًا عند نقل المراجعة (أثناء التعامل مع اختيار or طية),
سوف يتوقف بطريقة مماثلة ل تحرير مع الفارق أنه لن يطالبك بـ
ارتكاب الرسالة عند الانتهاء. إذا قررت في هذه المرحلة أنك لا تحب مقدار العمل الذي تقوم به
سيكون لإعادة ترتيب التاريخ، أو أنك ارتكبت خطأ، يمكنك استخدامها hg أصمت - أوقف
للتخلي عن التغييرات الجديدة التي أجريتها والعودة إلى الحالة التي كانت عليها قبل محاولتك ذلك
تحرير التاريخ الخاص بك.

إذا قمنا باستنساخ مستودع الأمثلة الموضح أعلاه وأضفنا أربعة تغييرات أخرى، مثل ذلك
لدينا التاريخ التالي:

@ 6[نصيحة] 038383181893 2009-04-27 18:04 -0500 ستيفان
| أضف ثيتا
|
o 5 140988835471 2009-04-27 18:04 -0500 ستيفان
| أضف إيتا
|
o 4 122930637314 2009-04-27 18:04 -0500 ستيفان
| أضف زيتا
|
o 3 836302820282 2009-04-27 18:04 -0500 ستيفان
| أضف إبسيلون
|
o 2 989b4d060121 2009-04-27 18:04 -0500 durin42
| إضافة بيتا ودلتا.
|
o 1 081603921c3f 2009-04-27 18:04 -0500 durin42
| أضف جاما
|
o 0 d8d2fcd0e319 2009-04-27 18:04 -0500 durin42
أضف ألفا

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

التكوين
يتم اقتطاع أسطر قاعدة Histedit إلى 80 حرفًا بشكل افتراضي. يمكنك تخصيص هذا
السلوك عن طريق تحديد طول مختلف في ملف التكوين الخاص بك:

[تاريخ التعديل]
linelen = 120 # اقتطاع أسطر القاعدة عند 120 حرفًا

hg أصمت يحاول اختيار المراجعة الأساسية المناسبة للاستخدام تلقائيًا. ل
قم بتغيير المراجعة الأساسية المستخدمة، وحدد مجموعة المراجعة في ملف التكوين الخاص بك:

[تاريخ التعديل]
defaultrev = فقط (.) ومشروع ()

بشكل افتراضي، يجب أن تكون كل مراجعة محررة موجودة في أوامر histedit. لازالة
المراجعة التي تحتاج إلى استخدامها قطرة عملية. يمكنك تكوين الإسقاط ليكون ضمنيًا
الالتزامات المفقودة عن طريق إضافة:

[تاريخ التعديل]
إسقاط مفقود = صحيح

أوامر
أصمت
تحرير سجل التغييرات بشكل تفاعلي:

hg histedit [خيارات] ([ANCESTOR] | --outgoing [URL])

يتيح لك هذا الأمر تحرير سلسلة خطية من مجموعات التغييرات (بما في ذلك ملف العمل
الدليل، والذي يجب أن يكون نظيفًا). أنت تستطيع:

· اختيار [لإعادة] طلب مجموعة التغييرات

· قطرة لحذف مجموعة التغييرات

· فوضى لإعادة صياغة رسالة الالتزام الخاصة بالتغييرات

· طية لدمجها مع مجموعة التغييرات السابقة

· لفة مثل الطية، ولكن تجاهل وصف هذا الالتزام

· تحرير لتحرير مجموعة التغييرات هذه

هناك عدة طرق لتحديد مجموعة التغييرات الجذرية:

· تحديد السلف مباشرة

· الاستخدام --outgoing -- سيكون أول مجموعة تغييرات خطية غير مدرجة في الوجهة.
(انظر hg مساعدة config.default-push)

· بخلاف ذلك، يتم استخدام القيمة من خيار التكوين "histedit.defaultrev" كمجموعة مراجعة لـ
حدد المراجعة الأساسية عندما لا يتم تحديد ANCESTOR. تم إرجاع المراجعة الأولى بواسطة
يتم استخدام revset. افتراضيًا، يؤدي هذا إلى تحديد السجل القابل للتحرير الفريد للملف
أصل دليل العمل.

إذا كنت تستخدم --outgoing، فسيتم إلغاء هذا الأمر إذا كانت هناك مراجعات صادرة غامضة.
على سبيل المثال، إذا كان هناك فروع متعددة تحتوي على المراجعات الصادرة.

استخدم "min(outgoing() and ::.)" أو مواصفات مجموعة المراجعة المماثلة بدلاً من --outgoing to
تحديد تعديل المراجعة المستهدفة بالضبط في مثل هذه الحالة الغامضة. يرى hg مساعدة revsets For
التفاصيل حول اختيار المراجعات.

أمثلة:

· تم إجراء عدد من التغييرات. لم تعد هناك حاجة للمراجعة 3.

ابدأ تحرير السجل من المراجعة 3:

زئبق الهستديت -r 3

يتم فتح محرر يحتوي على قائمة المراجعات، مع تحديد إجراءات محددة:

اختر 5339bf82f0ca 3 Zworgle the foobar
اختر 8ef592ce7cc4 4 أبهر الزرلوغ
اختر 0a9639fcda9d 5 لطف التكاثر

تظهر معلومات إضافية حول الإجراءات التي يمكن اتخاذها أسفل قائمة
التنقيحات.

لإزالة المراجعة 3 من السجل، سيتم تنفيذ الإجراء الخاص بها (في بداية النسخة ذات الصلة).
سطر) تم تغييره إلى "إسقاط":

أسقط 5339bf82f0ca 3 Zworgle the foobar
اختر 8ef592ce7cc4 4 أبهر الزرلوغ
اختر 0a9639fcda9d 5 لطف التكاثر

· تم إجراء عدد من التغييرات. يجب تبديل المراجعة 2 و 4.

ابدأ تحرير السجل من المراجعة 2:

زئبق الهستديت -r 2

يتم فتح محرر يحتوي على قائمة المراجعات، مع تحديد إجراءات محددة:

اختر 252a1af424ad 2 Blorb a morgwazzle
اختر 5339bf82f0ca 3 Zworgle the foobar
اختر 8ef592ce7cc4 4 أبهر الزرلوغ

لمبادلة المراجعة 2 و 4، يتم تبديل أسطرها في المحرر:

اختر 8ef592ce7cc4 4 أبهر الزرلوغ
اختر 5339bf82f0ca 3 Zworgle the foobar
اختر 252a1af424ad 2 Blorb a morgwazzle

يُرجع 0 عند النجاح، و1 إذا كان تدخل المستخدم مطلوبًا (ليس فقط من أجل "التحرير" المتعمد
الأمر، ولكن أيضًا لحل الصراعات غير المتوقعة).

خيارات:

- أوامر
قراءة تعديلات التاريخ من الملف المحدد

-c ، --استمر
متابعة التعديل الجاري بالفعل

--تحرير الخطة
تحرير قائمة الإجراءات المتبقية

-ك، --احتفظ
لا تقم بإزالة العقد القديمة بعد اكتمال التحرير

- أوقف
إحباط التعديل الجاري

-o ، --منفتح
لم يتم العثور على مجموعات التغييرات في الوجهة

-F، --فرض
قوة الصادرة حتى بالنسبة للمستودعات غير ذات الصلة

-r ،--ريف
المراجعة الأولى المراد تحريرها

[+] يمكن تحديد الخيار المحدد عدة مرات

الكلمة
توسيع الكلمات الرئيسية في الملفات المتعقبة

يعمل هذا الامتداد على توسيع نطاق RCS/CVS أو $Keywords$ المخصص ذاتيًا في الملفات النصية المتعقبة
تم تحديده بواسطة التكوين الخاص بك.

يتم توسيع الكلمات الأساسية فقط في المستودعات المحلية ولا يتم تخزينها في سجل التغيير. ال
يمكن اعتبار الآلية بمثابة راحة للمستخدم الحالي أو للأرشفة
التوزيع.

تتوسع الكلمات الرئيسية لتشمل بيانات مجموعة التغييرات المتعلقة بأحدث تغيير يتعلق بـ
أصل دليل العمل لكل ملف.

يتم التكوين في أقسام [الكلمة الرئيسية] و[مجموعة الكلمات الرئيسية] و[خرائط الكلمات الرئيسية] في hgrc
الملفات.

على سبيل المثال:

[كلمة رئيسية]
# قم بتوسيع الكلمات الرئيسية في كل ملف بايثون باستثناء تلك التي تطابق "x*"
**.py =
س* = تجاهل

[مجموعة الكلمات الرئيسية]
# تفضل svn- على خرائط الكلمات الرئيسية الافتراضية التي تشبه السيرة الذاتية
سفن = صحيح

ملاحظة: كلما كنت أكثر تحديدًا في أنماط اسم الملف الخاص بك، قل فقدان السرعة بشكل كبير
المستودعات.

بالنسبة لتخطيط قالب [keywordmaps] وعرض العرض التوضيحي للتوسيع وتشغيل التحكم hg com.kwdemo.
يرى hg مساعدة النماذج للحصول على قائمة بالقوالب والمرشحات المتاحة.

يتم توفير ثلاثة مرشحات إضافية لقالب التاريخ:

com.utcdate

"2006/09/18 15:13:13"

com.svnutcdate

"2006-09-18 15:13:13Z"

svnisodate

"2006-09-18 08:13:13 -700 (الإثنين، 18 سبتمبر 2006)"

تعيينات القالب الافتراضية (عرض مع hg com.kwdemo -d) يمكن استبدالها بالتخصيص
الكلمات الرئيسية والقوالب. مرة أخرى، تشغيل hg com.kwdemo للتحكم في نتائج التكوين الخاص بك
التغييرات.

قبل تغيير/تعطيل الكلمات الرئيسية النشطة، يجب عليك تشغيل hg kwshrink لتجنب تخزينها
الكلمات الرئيسية الموسعة في سجل التغيير.

لفرض التوسع بعد تمكينه، أو تغيير التكوين، قم بتشغيل hg kwexpand.

التوسعات التي تمتد لأكثر من سطر واحد والتوسعات المتزايدة، مثل $Log$ لـ CVS، هي
غير معتمد. يتم توسيع خريطة قالب الكلمة الرئيسية "Log = {desc}" إلى السطر الأول من الملف
وصف مجموعة التغييرات

أوامر
com.kwdemo
طباعة تكوين [keywordmaps] ومثال للتوسيع:

hg kwdemo [-d] [-f RCFILE] [TEMPLATEMAP]...

إظهار خرائط قوالب الكلمات الرئيسية الحالية أو المخصصة أو الافتراضية وتوسعاتها.

قم بتوسيع التكوين الحالي عن طريق تحديد الخرائط كوسائط واستخدام -f/--rcfile لـ
مصدر ملف hgrc خارجي.

استخدم -d/--default لتعطيل التكوين الحالي.

يرى hg مساعدة النماذج للحصول على معلومات حول القوالب والمرشحات.

خيارات:

-د، --إفتراضي
إظهار خرائط قوالب الكلمات الرئيسية الافتراضية

-F،--rcfile
قراءة الخرائط من rcfile

kwexpand
قم بتوسيع الكلمات الرئيسية في دليل العمل:

hg kwexpand [خيار]... [ملف]...

تشغيل بعد (إعادة) تمكين توسيع الكلمات الرئيسية.

يرفض kwexpand التشغيل إذا كانت الملفات المعطاة تحتوي على تغييرات محلية.

خيارات:

-أنا،--يشمل
تضمين أسماء مطابقة للأنماط المحددة

-X ،- استثناء
استبعاد الأسماء المطابقة للأنماط المحددة

[+] يمكن تحديد الخيار المحدد عدة مرات

kwfiles
إظهار الملفات التي تم تكوينها لتوسيع الكلمة الرئيسية:

hg kwfiles [خيار]... [ملف]...

قم بإدراج الملفات الموجودة في دليل العمل والتي تتطابق مع تكوين [الكلمة الرئيسية].
أنماط - رسم.

مفيد لمنع توسيع الكلمات الرئيسية غير المقصودة ولتسريع التنفيذ من خلال تضمينها
فقط الملفات المرشحة فعليًا للتوسيع.

يرى hg مساعدة الكلمة حول كيفية بناء أنماط لكل من الإدماج والاستبعاد
الملفات.

باستخدام -A/--all و -v/--verbose، تكون الرموز المستخدمة لإظهار حالة الملفات هي:

K = مرشح توسيع الكلمة الرئيسية
k = مرشح توسيع الكلمة الرئيسية (غير متتبع)
أنا = تجاهلت
أنا = تم تجاهله (لم يتم تعقبه)

خيارات:

-أ، --الكل
إظهار علامات حالة الكلمات الرئيسية لجميع الملفات

-أنا، --يتجاهل
إظهار الملفات المستبعدة من التوسعة

-u ، --مجهول
إظهار الملفات غير المعروفة (غير المتعقبة) فقط

-أنا،--يشمل
تضمين أسماء مطابقة للأنماط المحددة

-X ،- استثناء
استبعاد الأسماء المطابقة للأنماط المحددة

[+] يمكن تحديد الخيار المحدد عدة مرات

kwshrink
التراجع عن الكلمات الرئيسية الموسعة في دليل العمل:

hg kwshrink [خيار]... [ملف]...

يجب تشغيله قبل تغيير/تعطيل الكلمات الرئيسية النشطة.

يرفض kwshrink التشغيل إذا كانت الملفات المعطاة تحتوي على تغييرات محلية.

خيارات:

-أنا،--يشمل
تضمين أسماء مطابقة للأنماط المحددة

-X ،- استثناء
استبعاد الأسماء المطابقة للأنماط المحددة

[+] يمكن تحديد الخيار المحدد عدة مرات

ملفات كبيرة
تتبع الملفات الثنائية الكبيرة

تميل الملفات الثنائية الكبيرة إلى أن تكون غير قابلة للضغط بشكل كبير، وغير قابلة للاختلاف، وغير قابلة للضغط على الإطلاق
قابل للدمج. لا يتم التعامل مع هذه الملفات بكفاءة من خلال تنسيق تخزين Mercurial (revlog)،
والتي تقوم على دلتا ثنائية مضغوطة؛ تخزين الملفات الثنائية الكبيرة بشكل منتظم
تهدر ملفات Mercurial عرض النطاق الترددي ومساحة القرص وتزيد من استخدام ذاكرة Mercurial.
يعالج ملحق الملفات الكبيرة هذه المشكلات عن طريق إضافة خادم عميل مركزي
طبقة أعلى Mercurial: الملفات الكبيرة تعيش في ملف مركزي متجر خارج على الشبكة
في مكان ما، ولا يمكنك إحضار المراجعات التي تحتاجها إلا عندما تحتاج إليها.

تعمل الملفات الكبيرة من خلال الحفاظ على "ملف قائم" في ‎.hglf/ لكل ملف كبير. ال
الستاندات صغيرة (41 بايت: تجزئة SHA-1 بالإضافة إلى السطر الجديد) ويتم تعقبها بواسطة Mercurial.
يتم التعرف على مراجعات الملفات الكبيرة من خلال تجزئة SHA-1 لمحتوياتها، والتي تتم كتابتها
إلى الموقف. تستخدم الملفات الكبيرة معرف المراجعة هذا للحصول على/وضع مراجعات الملفات الكبيرة من/إلى
المتجر المركزي. وهذا يوفر مساحة القرص وعرض النطاق الترددي، حيث أنك لا تحتاج إلى ذلك
استرداد جميع المراجعات التاريخية للملفات الكبيرة عند استنساخها أو سحبها.

لبدء مستودع جديد أو إضافة ملفات ثنائية كبيرة جديدة، ما عليك سوى إضافة --large إلى ملفك hg تضيف
قيادة. فمثلا:

$ dd if=/dev/urandom of=randomdata count=2000
إضافة $ hg - بيانات عشوائية كبيرة
$ hg التزام -m "أضف بيانات عشوائية كملف كبير"

عندما تقوم بدفع مجموعة التغييرات التي تضيف/تعدل الملفات الكبيرة إلى مستودع بعيد، فسيتم حذفها
سيتم تحميل مراجعات الملف الكبير معه. لاحظ أن جهاز التحكم عن بعد Mercurial يجب أن
قم أيضًا بتمكين ملحق الملفات الكبيرة حتى يعمل هذا.

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

إذا كنت تريد سحب الملفات الكبيرة التي لا تحتاج إلى تحديثها بعد، فيمكنك استخدام السحب مع
ال --lfrev الخيار أو hg lfpull أمر.

إذا كنت تعلم أنك تقوم بالسحب من موقع غير افتراضي وتريد تنزيل كافة الملفات
الملفات الكبيرة التي تتوافق مع مجموعات التغييرات الجديدة في نفس الوقت، يمكنك سحبها باستخدام
--lfrev "سحبت ()".

إذا كنت تريد فقط التأكد من أنه سيكون لديك الملفات الكبيرة اللازمة للدمج أو إعادة التأسيس
مع الرؤوس الجديدة التي تسحبها، يمكنك السحب بها --lfrev "الرأس (تم سحبه ())" علم
لتنزيل أي ملفات كبيرة جديدة في ذهنك بشكل استباقي.

ضع في اعتبارك أن الوصول إلى الشبكة قد يكون مطلوبًا الآن للتحديث إلى مجموعات التغييرات الموجودة لديك
لم يتم تحديثه مسبقًا إلى. طبيعة ملحق الملفات الكبيرة تعني أن التحديث
لم يعد مضمونًا أن تكون عملية محلية فقط.

إذا كان لديك بالفعل ملفات كبيرة يتم تتبعها بواسطة Mercurial بدون ملحق Largefiles، فيمكنك
سوف تحتاج إلى تحويل المستودع الخاص بك للاستفادة من الملفات الكبيرة. لقد انتهى هذا
مع الالجائزة hg lfconvert أمر:

$ hg lfconvert --size 10 oldrepo newrepo

في المستودعات التي تحتوي بالفعل على ملفات كبيرة، سيتم حذف أي ملف جديد يزيد حجمه عن 10 ميجابايت
تتم إضافتها تلقائيًا كملف كبير. لتغيير هذه العتبة، قم بتعيين ملفات كبيرة.minsize in
ملف التكوين Mercurial الخاص بك إلى الحد الأدنى للحجم بالميجابايت لتتبعه كملف كبير، أو
استخدم خيار --lfsize لأمر الإضافة (أيضًا بالميجابايت):

[ملفات كبيرة]
الحجم الصغير = 2

إضافة $ hg --lfsize 2

• Largefiles.patterns يتيح لك خيار التكوين تحديد قائمة أنماط أسماء الملفات
(انظر hg مساعدة أنماط) التي يجب تتبعها دائمًا كملفات كبيرة:

[ملفات كبيرة]
الأنماط =
* .JPG
إعادة:.*\.(png|bmp)$
Library.zip
المحتوى/الصوت/*

ستتم إضافة الملفات التي تطابق أحد هذه الأنماط كملفات كبيرة بغض النظر عن حجمها
حجم.

• ملفات كبيرة.minsize و Largefiles.patterns سيتم تجاهل خيارات التكوين لأي
المستودعات لا تحتوي بالفعل على ملف كبير. لإضافة أول ملف كبير إلى ملف
مستودع، يجب عليك القيام بذلك صراحةً باستخدام العلامة --large التي تم تمريرها إلى ملف hg تضيف أمر.

أوامر
lfconvert
تحويل مستودع عادي إلى مستودع ملفات كبيرة:

hg lfconvert SOURCE DEST [ملف ...]

قم بتحويل مستودع التخزين SOURCE إلى مستودع تخزين جديد DEST، مطابق لـ SOURCE باستثناء ذلك
سيتم تحويل ملفات معينة إلى ملفات كبيرة: على وجه التحديد، أي ملف يطابق أي ملف
نمط or الذي يكون حجمه أعلى من الحد الأدنى للحجم، يتم تحويله إلى ملف كبير. ال
الحجم المستخدم لتحديد ما إذا كان سيتم تتبع الملف كملف كبير أم لا هو حجم الملف
النسخة الأولى من الملف. يمكن تحديد الحد الأدنى للحجم إما باستخدام --size أو in
التكوين كما ملفات كبيرة.حجم.

بعد تشغيل هذا الأمر، ستحتاج إلى التأكد من تمكين الملفات الكبيرة في أي مكان
كنت تنوي دفع المستودع الجديد.

استخدم --to-normal لتحويل الملفات الكبيرة مرة أخرى إلى ملفات عادية؛ بعد هذا، DEST
يمكن استخدام المستودع بدون ملفات كبيرة على الإطلاق.

خيارات:

-س،--بحجم
الحد الأدنى لحجم الملفات (MB) ليتم تحويلها إلى ملفات كبيرة

--إلى الوضع الطبيعي
تحويل من الريبو Largefiles إلى الريبو العادي

lfpull
سحب الملفات الكبيرة للمراجعات المحددة من المصدر المحدد:

hg lfpull -r REV... [-e CMD] [--remotecmd CMD] [المصدر]

اسحب الملفات الكبيرة التي يتم الرجوع إليها من مجموعات التغييرات المحلية ولكنها مفقودة محليًا، عند السحب
من مستودع بعيد إلى ذاكرة التخزين المؤقت المحلية.

إذا تم حذف SOURCE، فسيتم استخدام المسار "الافتراضي". يرى hg مساعدة عناوين المواقع لمزيد من
معلومات.

بعض الأمثلة:

· سحب الملفات الكبيرة لجميع رؤساء الفروع:

hg lfpull -r "head() وغير مغلق()"

· سحب الملفات الكبيرة على الفرع الافتراضي:

hg lfpull -r "فرع (افتراضي)"

خيارات:

-r ،--ريف
سحب الملفات الكبيرة لهذه المراجعات

-e،--SSH
تحديد أمر ssh للاستخدام

--remotecmd
حدد الأمر hg ليتم تشغيله على الجانب البعيد

--غير آمن
لا تتحقق من شهادة الخادم (تجاهل تكوين web.cacerts)

[+] يمكن تحديد الخيار المحدد عدة مرات

mq
إدارة كومة من التصحيحات

يتيح لك هذا الامتداد العمل مع مجموعة من التصحيحات الموجودة في مستودع Mercurial. إنه يدير
مجموعتان من التصحيحات - جميع التصحيحات المعروفة والتصحيحات المطبقة (مجموعة فرعية من التصحيحات المعروفة).

يتم تمثيل التصحيحات المعروفة كملفات تصحيح في دليل .hg/patches. البقع المطبقة
كلاهما ملفات التصحيح ومجموعات التغييرات.

المهام المشتركة (استخدام hg مساعدة أمر لمزيد من التفاصيل):

إنشاء تصحيح جديد qnew
استيراد التصحيح الموجود qimport

طباعة سلسلة التصحيح qseries
طباعة التصحيحات المطبقة

إضافة التصحيح المعروف إلى المكدس qpush المطبق
قم بإزالة التصحيح من المكدس المطبق qpop
تحديث محتويات أعلى التصحيح المطبق qrefresh

افتراضيًا، سيستخدم mq تصحيحات git تلقائيًا عند الحاجة لتجنب فقدان وضع الملف
التغييرات أو نسخ السجلات أو الملفات الثنائية أو إنشاء الملفات الفارغة أو حذفها. هذا السلوك
يمكن تهيئتها مع:

[مق]
git = تلقائي/احتفاظ/نعم/لا

إذا تم ضبطه على "keep"، فسوف يتبع mq تكوين القسم [diff] مع الحفاظ على الموجود
تصحيحات git على qrefresh. إذا تم التعيين على "نعم" أو "لا"، فسوف يتجاوز mq القسم [diff].
وقم دائمًا بإنشاء تصحيحات git أو تصحيحات عادية، ومن المحتمل أن تفقد البيانات في الحالة الثانية.

قد يكون من المرغوب فيه الاحتفاظ بمجموعات التغييرات mq في المرحلة السرية (انظر hg مساعدة المراحل),
والتي يمكن تمكينها بالإعداد التالي:

[مق]
سر = صحيح

ستقوم افتراضيًا بإدارة قائمة انتظار التصحيح المسماة "التصحيحات". يمكنك إنشاء أخرى،
قوائم انتظار التصحيح المستقلة مع hg qqueue أمر.

إذا كان دليل العمل يحتوي على ملفات غير ملتزم بها، فسيتم إحباط qpush وqpop وqgoto
في الحال. إذا تم استخدام -f/--force، فسيتم تجاهل التغييرات. جلسة:

[مق]
keepchanges = صحيح

اجعلها تتصرف كما لو تم تمرير --keep-changes، وسيتم تمرير التغييرات المحلية غير المتعارضة
أن يتم التسامح معها والحفاظ عليها. إذا كانت الخيارات غير متوافقة مثل -f/--force أو --exact
تم تمريره، يتم تجاهل هذا الإعداد.

يستخدم هذا الامتداد لتوفير أمر الشريط. هذا الأمر يعيش الآن في القطاع
تمديد.

أوامر
com.qapplied
طباعة التصحيحات المطبقة بالفعل:

hg qapplied [-1] [-s] [PATCH]

يعود 0 على النجاح.

خيارات:

-1، --الاخير
إظهار التصحيح المطبق السابق فقط

-س، --ملخص
طباعة السطر الأول من رأس التصحيح

com.qclone
استنساخ المستودع الرئيسي ومستودع التصحيح في نفس الوقت:

hg qclone [خيار]... المصدر [DEST]

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

تم البحث عن مستودع تصحيح المصدر في /.hg/patches بشكل افتراضي. استخدم -ص ل
تغيير.

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

العودة 0 على النجاح.

خيارات:

--يحذب استخدم بروتوكول السحب لنسخ البيانات الوصفية

-U ، --لا تحديث
لا تقم بتحديث أدلة العمل الجديدة

--غير مضغوط
استخدام النقل غير المضغوط (السريع عبر الشبكة المحلية)

-p ،--patches
موقع مستودع التصحيح المصدر

-e،--SSH
تحديد أمر ssh للاستخدام

--remotecmd
حدد الأمر hg ليتم تشغيله على الجانب البعيد

--غير آمن
لا تتحقق من شهادة الخادم (تجاهل تكوين web.cacerts)

com.qcommit
تنفيذ التغييرات في مستودع قائمة الانتظار (مهمل):

hg qcommit [خيار]... [ملف]...

تم إهمال هذا الأمر؛ يستخدم hg ارتكاب --mq بدلا من ذلك.

خيارات:

-أ، --اضف احذف
وضع علامة على الملفات الجديدة/المفقودة كمضافة/إزالة قبل الالتزام

- فرع قريب
ضع علامة على رأس الفرع على أنه مغلق

--يعدل
تعديل أصل دليل العمل

-س، --سر
استخدم المرحلة السرية للالتزام

-e، --تعديل
استدعاء المحرر على رسائل الالتزام

-أنا، - تفاعلي
استخدام الوضع التفاعلي

-أنا،--يشمل
تضمين أسماء مطابقة للأنماط المحددة

-X ،- استثناء
استبعاد الأسماء المطابقة للأنماط المحددة

م ،--رسالة
استخدم النص كرسالة التزام

-ل ،--ملف تسجيل
قراءة رسالة الالتزام من الملف

-د،--تاريخ
سجل التاريخ المحدد كتاريخ الالتزام

-u ،--المستعمل
تسجيل المستخدم المحدد كملتزم

-س، --subrepos
يتكرر في المستودعات الفرعية

[+] يمكن تحديد الخيار المحدد عدة مرات

الأسماء المستعارة: qci

com.qdelete
إزالة التصحيحات من قائمة الانتظار:

hg qdelete [-k] [التصحيح]...

يجب ألا يتم تطبيق التصحيحات، ويلزم وجود تصحيح واحد على الأقل. التصحيح الدقيق
يجب إعطاء معرفات. باستخدام -k/--keep، يتم الاحتفاظ بملفات التصحيح في التصحيح
الدليل.

لإيقاف إدارة التصحيح ونقله إلى السجل الدائم، استخدم hg com.qfinish أمر.

خيارات:

-ك، --احتفظ
احتفظ بملف التصحيح

-r ،--ريف
التوقف عن إدارة المراجعة (موقوف)

[+] يمكن تحديد الخيار المحدد عدة مرات

الأسماء المستعارة: qremove qrm

com.qdiff
اختلاف التصحيح الحالي والتعديلات اللاحقة:

hg qdiff [خيار]... [ملف]...

يُظهر الفرق الذي يتضمن التصحيح الحالي بالإضافة إلى أي تغييرات تم إجراؤها
في دليل العمل منذ آخر تحديث (وبالتالي يظهر ما سيفعله التصحيح الحالي
تصبح بعد تحديث).

استعمل hg فرق إذا كنت تريد فقط رؤية التغييرات التي تم إجراؤها منذ آخر تحديث، أو hg تصدير
qtip إذا كنت تريد رؤية التغييرات التي أجراها التصحيح الحالي دون تضمين التغييرات التي تم إجراؤها
منذ التحديث.

يعود 0 على النجاح.

خيارات:

-a، --نص
التعامل مع جميع الملفات كنص

-g ، --شخص سخيف
استخدم تنسيق git Extended diff

--nodates
حذف التواريخ من رؤوس الفرق

--noprefix
حذف البادئات a/ وb/ من أسماء الملفات

-p ، --إظهار الوظيفة
إظهار الوظيفة التي يوجد بها كل تغيير

--يعكس
إنتاج فرق يلغي التغييرات

-w ، --تجاهل - كل - المسافة
تجاهل المسافة البيضاء عند مقارنة الخطوط

-ب، - تجاهل-تغيير الفضاء
تجاهل التغييرات في مقدار المساحة البيضاء

-ب، - تجاهل الأسطر الفارغة
تجاهل التغييرات التي تكون جميع أسطرها فارغة

-U ،--موحد
عدد أسطر السياق المراد إظهارها

- إحصائيات إخراج ملخص للتغييرات على غرار diffstat

--جذر
إنتاج فروق نسبة إلى الدليل الفرعي

-أنا،--يشمل
تضمين أسماء مطابقة للأنماط المحددة

-X ،- استثناء
استبعاد الأسماء المطابقة للأنماط المحددة

[+] يمكن تحديد الخيار المحدد عدة مرات

com.qfinish
انقل التصحيحات المطبقة إلى سجل المستودع:

زئبق qfinish [-a] [REV]...

إنهاء المراجعات المحددة (المقابلة للتصحيحات المطبقة) عن طريق نقلها خارج
التحكم mq في سجل المستودع العادي.

يقبل نطاق المراجعة أو الخيار -a/--apply. إذا تم تحديد --applyd، فسيتم تحديد الكل
تتم إزالة مراجعات mq المطبقة من التحكم mq. خلاف ذلك، يجب أن تكون المراجعات المقدمة
في قاعدة كومة من البقع المطبقة.

يمكن أن يكون هذا مفيدًا بشكل خاص إذا تم تطبيق تغييراتك على مستودع رئيسي،
أو إذا كنت على وشك دفع التغييرات إلى المنبع.

يعود 0 على النجاح.

خيارات:

-a، --مُطبَّق
إنهاء كافة التغييرات المطبقة

com.qfold
قم بطي التصحيحات المسماة في التصحيح الحالي:

hg qfold [-e] [-k] [-m TEXT] [-l FILE] تصحيح...

يجب ألا يتم تطبيق التصحيحات بعد. سيتم تطبيق كل تصحيح على التوالي على التيار
التصحيح بالترتيب المعطى. إذا تم تطبيق كافة التصحيحات بنجاح، فسيتم تطبيق التصحيح الحالي
سيتم تحديثه بالتصحيح التراكمي الجديد، وسيتم حذف التصحيحات المطوية. مع
-k/--keep، لن تتم إزالة ملفات التصحيح المطوية بعد ذلك.

سيتم ربط رأس كل رقعة مطوية مع رأس التصحيح الحالي،
مفصولة بخط من * * *.

يعود 0 على النجاح.

خيارات:

-e، --تعديل
استدعاء المحرر على رسائل الالتزام

-ك، --احتفظ
احتفظ بملفات التصحيح المطوية

م ،--رسالة
استخدم النص كرسالة التزام

-ل ،--ملف تسجيل
قراءة رسالة الالتزام من الملف

com.qgoto
ادفع التصحيحات أو فرقعها حتى يصبح التصحيح المسمى أعلى المكدس:

hg qgoto [خيار]... تصحيح

يعود 0 على النجاح.

خيارات:

--حفظ التغييرات
تحمل التغيرات المحلية غير المتعارضة

-F، --فرض
الكتابة فوق أي تغييرات محلية

--لا يوجد نسخة احتياطية
لا تقم بحفظ نسخ احتياطية من الملفات

com.qguard
تعيين أو طباعة حراس التصحيح:

hg qguard [-l] [-n] [تصحيح] [-- [+GUARD]... [-GUARD]...]

يتحكم الحراس فيما إذا كان من الممكن دفع الرقعة أم لا. يتم دائمًا دفع رقعة بدون حراس. أ
يتم دفع التصحيح باستخدام حارس إيجابي ("+foo") فقط إذا كان hg qselect القيادة لديها
تفعيلها. لا يتم أبدًا دفع رقعة ذات حارس سلبي ("-foo") إذا كان hg qselect
قام الأمر بتنشيطه.

بدون أية وسائط، قم بطباعة الحراس النشطين حاليًا. مع الحجج، تعيين حراس ل
التصحيح المسمى.

ملاحظة: يتطلب تحديد الحراس السلبيين الآن "--".

لتعيين الحراس على رقعة أخرى:

hg qguard Other.patch - +2.6.17 -stable

يعود 0 على النجاح.

خيارات:

-ل ، --قائمة
قائمة كافة التصحيحات والحراس

-ن، --لا أحد
إسقاط جميع الحراس

com.qheader
اطبع رأس التصحيح العلوي أو المحدد:

زئبق qhead [التصحيح]

يعود 0 على النجاح.

com.qimport
استيراد تصحيح أو مجموعة التغييرات الموجودة:

hg qimport [-e] [-n NAME] [-f] [-g] [-P] [-r REV]... [ملف]...

يتم إدراج التصحيح في السلسلة بعد آخر تصحيح تم تطبيقه. إذا لم يكن هناك بقع لها
تم تطبيقه، يقوم qimport بإضافة التصحيح إلى السلسلة مسبقًا.

سيكون للتصحيح نفس اسم الملف المصدر إلا إذا قمت بإعطائه اسمًا جديدًا
-ن/--الاسم.

يمكنك تسجيل تصحيح موجود داخل دليل التصحيح باستخدام العلامة -e/--existing.

باستخدام -f/--force، ستتم الكتابة فوق التصحيح الموجود الذي يحمل نفس الاسم.

يمكن وضع مجموعة التغييرات الموجودة تحت التحكم mq باستخدام -r/--rev (على سبيل المثال qimport --rev .
-n patch سوف يضع المراجعة الحالية تحت سيطرة mq). باستخدام -g/--git، التصحيحات
المستورد باستخدام --rev سيستخدم تنسيق git diff. راجع موضوع تعليمات الاختلافات للحصول على المعلومات
حول سبب أهمية ذلك للحفاظ على معلومات إعادة التسمية/النسخ وتغييرات الأذونات.
استعمل hg com.qfinish لإزالة مجموعات التغييرات من التحكم MQ.

لاستيراد تصحيح من الإدخال القياسي، قم بتمرير - كملف التصحيح. عند الاستيراد من
الإدخال القياسي، يجب تحديد اسم التصحيح باستخدام علامة --name.

لاستيراد تصحيح موجود أثناء إعادة تسميته:

hg qimport -e تصحيح موجود -n اسم جديد

يُرجع 0 إذا نجح الاستيراد.

خيارات:

-e، --موجود
استيراد الملف في دليل التصحيح

-ن،--اسم
اسم ملف التصحيح

-F، --فرض
الكتابة فوق الملفات الموجودة

-r ،--ريف
وضع المراجعات الحالية تحت سيطرة MQ

-g ، --شخص سخيف
استخدم تنسيق git Extended diff

-P ، --يدفع
qpush بعد الاستيراد

[+] يمكن تحديد الخيار المحدد عدة مرات

كينيت
بدء مستودع قائمة انتظار جديد (مهمل):

زئبق كينيت [-ج]

يتم إلغاء إصدار مستودع قائمة الانتظار بشكل افتراضي. إذا تم تحديد -c/--create-repo، فسيتم تعيين qinit
سيقوم بإنشاء مستودع متداخل منفصل للتصحيحات (يمكن أيضًا تشغيل qinit -c لاحقًا لـ
تحويل مستودع التصحيح غير المُصدر إلى مستودع ذي إصدار). يمكنك استخدام qcommit ل
تنفيذ تغييرات على مستودع قائمة الانتظار هذا.

تم إهمال هذا الأمر. بدون -c، يتم تضمينه في الأوامر الأخرى ذات الصلة. مع -ج،
تستخدم hg الحرف الأول --mq بدلا من ذلك.

خيارات:

-c ، --إنشاء الريبو
إنشاء مستودع قائمة الانتظار

com.qnew
إنشاء تصحيح جديد:

hg qnew [-e] [-m TEXT] [-l FILE] تصحيح [ملف]...

يقوم qnew بإنشاء تصحيح جديد أعلى التصحيح المطبق حاليًا (إن وجد). التصحيح سيكون
تمت تهيئته مع أي تغييرات معلقة في دليل العمل. يمكنك أيضًا استخدام
-I/--include، -X/--exclude، و/أو قائمة الملفات بعد اسم التصحيح المراد إضافتها فقط
تغييرات على الملفات المطابقة للتصحيح الجديد، مع ترك الباقي كتعديلات متاحة.

-u/--user و -d/--date يمكن استخدامهما لتعيين المستخدم (المحدد) والتاريخ، على التوالي.
-U/--currentuser و-D/-currentdate يضبط المستخدم على المستخدم الحالي والتاريخ إلى التاريخ الحالي.

-e/--edit أو -m/--message أو -l/--logfile قم بتعيين رأس التصحيح بالإضافة إلى الالتزام
رسالة. إذا لم يتم تحديد أي شيء، يكون الرأس فارغًا وتكون رسالة الالتزام هي '[mq]:
رقعة'.

استخدم الخيار -g/--git للاحتفاظ بالتصحيح بتنسيق git Extended diff. قراءة الاختلافات
موضوع المساعدة لمزيد من المعلومات حول سبب أهمية ذلك للحفاظ على تغييرات الأذونات
ونسخ/إعادة تسمية المعلومات.

يُرجع 0 عند الإنشاء الناجح لتصحيح جديد.

خيارات:

-e، --تعديل
استدعاء المحرر على رسائل الالتزام

-F، --فرض
استيراد التغييرات غير الملتزم بها (مهملة)

-g ، --شخص سخيف
استخدم تنسيق git Extended diff

-U ، --المستخدم الحالي
أضف "من: "للتصحيح

-u ،--المستعمل
أضف "من: "للتصحيح

-د، --التاريخ الحالي
إضافة تاريخ: "للتصحيح

-د،--تاريخ
إضافة تاريخ: "للتصحيح

-أنا،--يشمل
تضمين أسماء مطابقة للأنماط المحددة

-X ،- استثناء
استبعاد الأسماء المطابقة للأنماط المحددة

م ،--رسالة
استخدم النص كرسالة التزام

-ل ،--ملف تسجيل
قراءة رسالة الالتزام من الملف

[+] يمكن تحديد الخيار المحدد عدة مرات

com.qnext
اطبع اسم التصحيح القابل للدفع التالي:

زئبق Qnext [-s]

يعود 0 على النجاح.

خيارات:

-س، --ملخص
طباعة السطر الأول من رأس التصحيح

com.qpop
قم بإخراج التصحيح الحالي من المكدس:

hg qpop [-a] [-f] [التصحيح | فِهرِس]

بدون وسيطة، ينبثق الجزء العلوي من حزمة التصحيح. إذا أعطيت اسم التصحيح، فإنه يحتفظ
انبثاق التصحيحات حتى يصبح التصحيح المسمى في أعلى المكدس.

بشكل افتراضي، يتم الإلغاء إذا كان دليل العمل يحتوي على تغييرات غير ملتزم بها. مع
--keep-changes، يتم الإجهاض فقط في حالة تداخل الملفات غير الملتزم بها مع الملفات المصححة. مع
-f/--force والنسخ الاحتياطي وتجاهل التغييرات التي تم إجراؤها على هذه الملفات.

العودة 0 على النجاح.

خيارات:

-a، --الكل
البوب ​​كافة البقع

-ن،--اسم
اسم قائمة الانتظار للانبثاق (مهمل)

--حفظ التغييرات
تحمل التغيرات المحلية غير المتعارضة

-F، --فرض
ننسى أي تغييرات محلية على الملفات المصححة

--لا يوجد نسخة احتياطية
لا تقم بحفظ نسخ احتياطية من الملفات

qprev
اطبع اسم التصحيح المطبق السابق:

زئبق qprev [-s]

يعود 0 على النجاح.

خيارات:

-س، --ملخص
طباعة السطر الأول من رأس التصحيح

com.qpush
ادفع التصحيح التالي إلى المكدس:

hg qpush [-f] [-l] [-a] [--نقل] [تصحيح | فِهرِس]

بشكل افتراضي، يتم الإلغاء إذا كان دليل العمل يحتوي على تغييرات غير ملتزم بها. مع
--keep-changes، يتم الإجهاض فقط في حالة تداخل الملفات غير الملتزم بها مع الملفات المصححة. مع
-f/--force والنسخ الاحتياطي والتصحيح على التغييرات غير الملتزم بها.

العودة 0 على النجاح.

خيارات:

--حفظ التغييرات
تحمل التغيرات المحلية غير المتعارضة

-F، --فرض
تنطبق على رأس التغييرات المحلية

-e، - بالضبط
قم بتطبيق التصحيح المستهدف على الأصل المسجل

-ل ، --قائمة
قائمة اسم التصحيح في نص الالتزام

-a، --الكل
تطبيق كافة التصحيحات

م ، --دمج
الدمج من قائمة انتظار أخرى (مهمل)

-ن،--اسم
اسم قائمة الانتظار المدمجة (مهمل)

--نقل أعد ترتيب سلسلة التصحيح وقم بتطبيق التصحيح فقط

--لا يوجد نسخة احتياطية
لا تقم بحفظ نسخ احتياطية من الملفات

qqueue
إدارة قوائم انتظار التصحيح المتعددة:

قائمة الانتظار hg [الخيار] [قائمة الانتظار]

يدعم التبديل بين قوائم انتظار التصحيح المختلفة، بالإضافة إلى إنشاء قوائم انتظار تصحيح جديدة
وحذف الموجودة .

سيؤدي حذف اسم قائمة الانتظار أو تحديد -l/--list إلى إظهار قوائم الانتظار المسجلة - حسب
افتراضيًا، يتم تسجيل قائمة انتظار التصحيحات "العادية". ستكون قائمة الانتظار النشطة حاليًا
تم وضع علامة "(نشط)". سيؤدي تحديد --active إلى طباعة اسم قائمة الانتظار النشطة فقط.

لإنشاء قائمة انتظار جديدة، استخدم -c/--create. يتم تنشيط قائمة الانتظار تلقائيًا، باستثناء
الحالة التي توجد فيها تصحيحات مطبقة من قائمة الانتظار النشطة حاليًا في ملف
مخزن. بعد ذلك سيتم إنشاء قائمة الانتظار وسيفشل التبديل.

لحذف قائمة انتظار موجودة، استخدم --delete. لا يمكنك حذف قائمة الانتظار النشطة حاليًا.

يعود 0 على النجاح.

خيارات:

-ل ، --قائمة
قائمة بجميع قوائم الانتظار المتاحة

--نشيط
طباعة اسم قائمة الانتظار النشطة

-c ، --يزيد
إنشاء قائمة انتظار جديدة

- إعادة تسمية
إعادة تسمية قائمة الانتظار النشطة

--حذف
حذف الإشارة إلى قائمة الانتظار

--تطهير
حذف قائمة الانتظار، وإزالة التصحيح دير

com.qrefresh
تحديث التصحيح الحالي:

hg qrefresh [-I] [-X] [-e] [-m TEXT] [-l FILE] [-s] [FILE]...

إذا تم توفير أي أنماط للملفات، فسيحتوي التصحيح المحدث على التعديلات فقط
التي تتطابق مع تلك الأنماط؛ ستبقى التعديلات المتبقية في العمل
الدليل.

إذا تم تحديد -s/--short، فسيتم تحديث الملفات المضمنة حاليًا في التصحيح فقط
مثل الملفات المطابقة وتبقى في التصحيح.

إذا تم تحديد -e/--edit، فسيقوم Mercurial بتشغيل المحرر الذي تم تكوينه حتى تتمكن من إدخال ملف
رسالة. في حالة فشل qrefresh، ستجد نسخة احتياطية لرسالتك في
.hg/last-message.txt.

يعمل hg add/remove/copy/rename كالمعتاد، على الرغم من أنك قد ترغب في استخدام تصحيحات git-style
(-g/--git أو [diff] git=1) لتتبع النسخ وإعادة التسمية. راجع موضوع المساعدة الخاص بالاختلافات للمزيد
معلومات عن تنسيق git diff.

يعود 0 على النجاح.

خيارات:

-e، --تعديل
استدعاء المحرر على رسائل الالتزام

-g ، --شخص سخيف
استخدم تنسيق git Extended diff

-س، --قصيرة
تحديث الملفات الموجودة بالفعل في التصحيح والملفات المحددة فقط

-U ، --المستخدم الحالي
إضافة/تحديث حقل المؤلف في التصحيح مع المستخدم الحالي

-u ،--المستعمل
إضافة/تحديث حقل المؤلف في التصحيح مع مستخدم معين

-د، --التاريخ الحالي
إضافة/تحديث حقل التاريخ في التصحيح بالتاريخ الحالي

-د،--تاريخ
إضافة/تحديث حقل التاريخ في التصحيح بتاريخ محدد

-أنا،--يشمل
تضمين أسماء مطابقة للأنماط المحددة

-X ،- استثناء
استبعاد الأسماء المطابقة للأنماط المحددة

م ،--رسالة
استخدم النص كرسالة التزام

-ل ،--ملف تسجيل
قراءة رسالة الالتزام من الملف

[+] يمكن تحديد الخيار المحدد عدة مرات

com.qrename
إعادة تسمية التصحيح:

hg qrename PATCH1 [PATCH2]

باستخدام وسيطة واحدة، يتم إعادة تسمية التصحيح الحالي إلى PATCH1. مع الوسيطتين، إعادة التسمية
التصحيح 1 إلى التصحيح 2.

يعود 0 على النجاح.

الأسماء المستعارة: qmv

com.qrestore
استعادة حالة قائمة الانتظار المحفوظة بواسطة المراجعة (تم إهمالها):

hg qrestore [-d] [-u] REV

تم إهمال هذا الأمر، استخدمه hg rebase بدلا من ذلك.

خيارات:

-د، --حذف
حذف إدخال الحفظ

-u ، --تحديث
تحديث دليل العمل لقائمة الانتظار

com.qsave
حفظ حالة قائمة الانتظار الحالية (مهملة):

hg qsave [-m TEXT] [-l FILE] [-c] [-n NAME] [-e] [-f]

تم إهمال هذا الأمر، استخدمه hg rebase بدلا من ذلك.

خيارات:

-c ، --ينسخ
نسخ دليل التصحيح

-ن،--اسم
نسخ اسم الدليل

-e، --فارغة
مسح ملف حالة قائمة الانتظار

-F، --فرض
نسخة القوة

م ،--رسالة
استخدم النص كرسالة التزام

-ل ،--ملف تسجيل
قراءة رسالة الالتزام من الملف

qselect
ضبط أو طباعة التصحيحات المحمية للدفع:

hg qselect [OPTION]... [GUARD]...

استخدم hg com.qguard أمر لتعيين أو طباعة الحراس على التصحيح، ثم استخدم qselect لإخبار mq
أي حراس للاستخدام. سيتم دفع الرقعة إذا لم يكن بها حراس أو أي حراس إيجابيين
تطابق الحارس المحدد حاليًا، ولكن لن يتم دفعه في حالة تطابق أي من الحراس السلبيين
الحارس الحالي . على سبيل المثال:

qguard foo.patch -- -stable (الحارس السلبي)
qguard bar.patch + مستقر (حارس إيجابي)
فحدد مستقر

يؤدي هذا إلى تنشيط الحارس "المستقر". سوف يتخطى mq foo.patch (لأنه يحتوي على قيمة سلبية
تطابق) ولكن ادفع bar.patch (لأنه يحتوي على تطابق إيجابي).

بدون أي وسيطات، تتم طباعة الحراس النشطين حاليًا. مع وسيطة واحدة، يتم تعيين نشط
حارس.

استخدم -n/--none لإلغاء تنشيط الحراس (لا حاجة إلى وسائط أخرى). عندما لا يكون هناك حراس
نشطة، يتم تخطي التصحيحات ذات الحراسة الإيجابية ويتم تخطي التصحيحات ذات الحراسة السلبية
دفعت.

يمكن لـ qselect تغيير الحراس على التصحيحات المطبقة. لا تفرقع البقع المحمية
تقصير. استخدم --pop للرجوع إلى آخر تصحيح مطبق غير محمي. يستخدم
--reapply (مما يعني --pop) للرجوع إلى التصحيح الحالي بعد ذلك، ولكن تخطي
بقع حراسة.

استخدم -s/--series لطباعة قائمة بجميع الحراس في ملف السلسلة (لا توجد وسائط أخرى
ضروري). استخدم -v لمزيد من المعلومات.

يعود 0 على النجاح.

خيارات:

-ن، --لا أحد
تعطيل جميع الحراس

-س، --سلسلة
قائمة بجميع الحراس في ملف السلسلة

- بوب انتقل إلى ما قبل التصحيح المطبق أولاً

- تطبيق
فرقع، ثم أعد تطبيق التصحيحات

com.qseries
طباعة ملف السلسلة بالكامل:

سلسلة hg [-ms]

يعود 0 على النجاح.

خيارات:

م ، --مفقود
تصحيحات الطباعة ليست في السلسلة

-س، --ملخص
طباعة السطر الأول من رأس التصحيح

com.qtop
اطبع اسم التصحيح الحالي:

زئبق كيو توب [-s]

يعود 0 على النجاح.

خيارات:

-س، --ملخص
طباعة السطر الأول من رأس التصحيح

com.qunapplied
طباعة التصحيحات التي لم يتم تطبيقها بعد:

hg qunapplied [-1] [-s] [PATCH]

يعود 0 على النجاح.

خيارات:

-1، --أول
إظهار التصحيح الأول فقط

-س، --ملخص
طباعة السطر الأول من رأس التصحيح

أبلغ
خطافات لإرسال إشعارات البريد الإلكتروني

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

أولا، قم بتمكين الامتداد كما هو موضح في hg مساعدة اضافات المتصفح، وقم بتسجيل الخطاف لك
تريد الركض. الوارد و com.changegroup يتم تشغيل الخطافات عند تلقي مجموعات التغييرات، بينما
المنتهية ولايته الخطافات مخصصة لمجموعات التغييرات المرسلة إلى مستودع آخر:

[خطافات]
# بريد إلكتروني واحد لكل مجموعة تغييرات واردة
incoming.notify = بيثون:hgext.notify.hook
# بريد إلكتروني واحد لجميع مجموعات التغييرات الواردة
Changegroup.notify = بيثون:hgext.notify.hook

# بريد إلكتروني واحد لجميع مجموعات التغييرات الصادرة
outgoing.notify = بيثون:hgext.notify.hook

هذا يسجل الخطافات. لتمكين الإخطار، يجب تعيين المشتركين ل
المستودعات. ال [المستخدمين] يقوم القسم بتعيين مستودعات متعددة لمستلم معين. ال
[إعادة النشر] يقوم القسم بتعيين مستلمين متعددين إلى مستودع واحد:

[المستخدمين]
# المفتاح هو البريد الإلكتروني للمشترك، والقيمة هي قائمة مفصولة بفواصل من أنماط الريبو
user@host = Pattern

[إعادة النشر]
# المفتاح هو نمط الريبو، والقيمة هي قائمة مفصولة بفواصل من رسائل البريد الإلكتروني للمشترك
النمط = مستخدم @ المضيف

A النمط هو الكرة مطابقة المسار المطلق للمستودع، مع دمجه اختياريًا مع ملف
تعبير revset يتم فصل تعبير revset، إذا كان موجودًا، عن الكرة الأرضية بواسطة تجزئة.
على سبيل المثال:

[إعادة النشر]
*/widgets#branch(release) = [البريد الإلكتروني محمي]

هذا يرسل إلى [البريد الإلكتروني محمي] كلما تم تغيير مجموعة على الافراج عن مشغلات فرع أ
إشعار في أي مستودع ينتهي بـ الحاجيات.

من أجل وضعها تحت إدارة المستخدم المباشرة، [المستخدمين] و [إعادة النشر] أقسام
يمكن وضعها في منفصلة hgrc ملف ومدمج حسب المرجع:

[إخطار]
config = /path/to/subscriptionsfile

لن يتم إرسال الإخطارات حتى notify.test يتم تعيين القيمة إلى خطأ؛ انظر أدناه.

يمكن تعديل محتوى الإشعارات باستخدام إدخالات التكوين التالية:

notify.test
If صواب، قم بطباعة الرسائل إلى stdout بدلاً من إرسالها. الافتراضي: صحيح.

notify.sources
قائمة مصادر التغيير مفصولة بمسافات. يتم تنشيط الإخطارات فقط عندما أ
مصدر التغييرات موجود في هذه القائمة. المصادر قد تكون:

خدمة

تم تلقي مجموعات التغييرات عبر http أو ssh

سحب

تم تلقي مجموعات التغييرات عبر hg سحب

سيفصل

تم تلقي مجموعات التغييرات عبر hg سيفصل

دفع

تم إرسال مجموعات التغييرات أو استلامها عبر hg دفع

حزمة

تم إرسال مجموعات التغييرات عبر hg سيفصل

الافتراضي: يخدم.

notify.strip
عدد الخطوط المائلة البادئة المطلوب إزالتها من مسارات عنوان URL. بشكل افتراضي، الإخطارات
المستودعات المرجعية مع مسارها المطلق. notify.strip يتيح لك تحويلها
في المسارات النسبية على سبيل المثال، notify.strip=3 سوف تتغير /طويل/مسار/مستودع
إلى مستودع. الافتراضي: 0.

notify.domain
مجال البريد الإلكتروني الافتراضي للمرسل أو المستلمين بدون مجال واضح.

notify.style
ملف النمط لاستخدامه عند تنسيق رسائل البريد الإلكتروني.

notify.template
قالب لاستخدامه عند تنسيق رسائل البريد الإلكتروني.

notify.incoming
القالب الذي سيتم استخدامه عند تشغيله كخطاف وارد، متجاوزًا notify.template.

notify.outgoing
القالب الذي سيتم استخدامه عند تشغيله كخطاف صادر، متجاوزًا notify.template.

notify.changegroup
القالب الذي سيتم استخدامه عند التشغيل كخطاف لمجموعة التغيير، متجاوزًا notify.template.

notify.maxdiff
الحد الأقصى لعدد خطوط الفرق التي سيتم تضمينها في إشعار البريد الإلكتروني. اضبط على 0 للتعطيل
الفرق، أو -1 لتشمل كل ذلك. الافتراضي: 300.

notify.maxsubject
الحد الأقصى لعدد الأحرف في سطر موضوع البريد الإلكتروني. الافتراضي: 67.

notify.diffstat
اضبط على True لتضمين diffstat قبل محتوى الاختلاف. الافتراضي: صحيح.

notify.merge
إذا كان صحيحًا، أرسل إشعارات لدمج مجموعات التغييرات. الافتراضي: صحيح.

notify.mbox
في حالة التعيين، قم بإلحاق رسائل البريد بملف mbox هذا بدلاً من إرسالها. الافتراضي: لا شيء.

notify.fromauthor
في حالة التعيين، استخدم مُرسِل مجموعة التغييرات الأولى في مجموعة التغيير لـ "من"
حقل بريد الإخطار. إذا لم يتم تعيينه، خذ المستخدم من مستودع الدفع.
الافتراضي: خطأ.

إذا تم تعيينها، فسيتم أيضًا استخدام الإدخالات التالية لتخصيص الإشعارات:

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

web.baseurl
عنوان URL لمستودع التخزين الجذري للدمج مع مسارات المستودع عند عمل المراجع. يرى
أيضا notify.strip.

بيجر
تصفح إخراج الأمر باستخدام جهاز النداء الخارجي

لتعيين جهاز النداء الذي يجب استخدامه، قم بتعيين متغير التطبيق:

[بيجر]
بيجر = أقل -FRX

إذا لم يتم تعيين أي جهاز استدعاء، فإن ملحقات جهاز النداء تستخدم متغير البيئة PAGER $. إذا لم يكن الأمر كذلك
pager.pager، ولم يتم تعيين $PAGER، ولم يتم استخدام أي جهاز استدعاء.

يمكنك تعطيل جهاز النداء لأوامر معينة عن طريق إضافتها إلى قائمة pager.ignore:

[بيجر]
تجاهل = الإصدار، المساعدة، التحديث

يمكنك أيضًا تمكين جهاز النداء لأوامر معينة فقط باستخدام pager.attend. أدناه هو
القائمة الافتراضية للأوامر التي سيتم ترحيلها إلى صفحات:

[بيجر]
الحضور = تعليق توضيحي، قطة، فرق، تصدير، سجل، سجل، qdiff

سيؤدي تعيين pager.attend إلى قيمة فارغة إلى ترحيل كافة الأوامر.

إذا كان pager.attend موجودًا، فسيتم تجاهل pager.ignore.

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

[بيجر]
حضور القط = خطأ

لتجاهل الأوامر العالمية مثل hg الإصدار or hg مساعدة، يجب عليك تحديدها في ملفك
ملف تكوين المستخدم.

للتحكم في ما إذا كان جهاز النداء سيتم استخدامه على الإطلاق لأمر فردي، يمكنك استخدامه
--بيجر= :

- استخدم حسب الحاجة: `تلقائي`.
- يتطلب النداء: "نعم" أو "على".
- منع جهاز النداء: `no` أو `off` (أي قيمة غير معروفة
سوف تعمل أيضا).

patchbomb
أمر لإرسال مجموعات التغييرات كـ (سلسلة من) رسائل البريد الإلكتروني التصحيحية

تبدأ السلسلة بمقدمة "[PATCH 0 of N]" التي تصف السلسلة
ككل.

يحتوي كل بريد إلكتروني تصحيحي على سطر موضوع "[PATCH M of N] ..."، باستخدام السطر الأول من ملف
وصف التغييرات كنص الموضوع. تحتوي الرسالة على جزأين أو ثلاثة أجزاء من النص:

· وصف التغييرات.

· [اختياري] نتيجة تشغيل diffstat على الباتش.

· التصحيح نفسه، كما تم إنشاؤه بواسطة hg تصدير.

تشير كل رسالة إلى الرسالة الأولى في السلسلة باستخدام In-Reply-To وReferences
الرؤوس، لذلك ستظهر كتسلسل في البريد المترابط وقارئات الأخبار وفي البريد
أرشيف.

لتكوين الإعدادات الافتراضية الأخرى، قم بإضافة قسم مثل هذا إلى ملف التكوين الخاص بك:

[بريد إلكتروني]
من = اسمي
إلى = المستلم 1، المستلم 2، ...
نسخة = cc1، cc2، ...
مخفية = مخفية 1، مخفية 2، ...
الرد على = عنوان 1، عنوان 2، ...

استعمل [باتتشبومب] كاسم قسم التكوين إذا كنت بحاجة إلى تجاوز global [بريد إلكتروني]
إعدادات العنوان.

ثم يمكنك استخدام ملف hg البريد الإلكتروني أمر لإرسال سلسلة من مجموعات التغييرات عبر البريد على شكل قنبلة تصحيحية.

يمكنك أيضًا تكوين خيار الطريقة في قسم البريد الإلكتروني ليكون بمثابة بريد إلكتروني
مرسل بريدي متوافق أو املأ القسم [smtp] حتى يتمكن ملحق patchbomb من ذلك
إرسال قنابل التصحيح تلقائيًا مباشرة من سطر الأوامر. راجع [البريد الإلكتروني] و[smtp]
أقسام في hgrc(5) لمزيد من التفاصيل.

افتراضيا، hg البريد الإلكتروني سوف يدفع ل إلى or CC header إذا لم تقم بتوفير واحد عبر
التكوين أو سطر الأوامر. يمكنك تجاوز هذا لعدم المطالبة مطلقًا عن طريق التكوين
قيمة فارغة:

[بريد إلكتروني]
سم مكعب =

يمكنك التحكم في التضمين الافتراضي لرسالة المقدمة باستخدام الزر patchbomb.intro
خيار التكوين. تتم دائمًا الكتابة فوق التكوين بواسطة إشارات سطر الأوامر مثل
--المقدمة و --الوصف:

[باتتشبومب]
intro=auto # تضمين رسالة مقدمة إذا كان هناك أكثر من تصحيح واحد (افتراضي)
intro=never # لا تتضمن أبدًا رسالة مقدمة
intro=always # تتضمن دائمًا رسالة مقدمة

يمكنك ضبط patchbomb ليطلب التأكيد دائمًا من خلال الإعداد patchbomb.confirm الى الحقيقة.

أوامر
البريد الإلكتروني
إرسال مجموعات التغييرات عبر البريد الإلكتروني:

البريد الإلكتروني [خيار]... [DEST]...

بشكل افتراضي، يتم إرسال الاختلافات بالتنسيق الذي تم إنشاؤه بواسطة hg تصدير، واحدة لكل رسالة. ال
تبدأ السلسلة بمقدمة "[PATCH 0 of N]" التي تصف السلسلة ككل.

يحتوي كل بريد إلكتروني تصحيحي على سطر موضوع "[PATCH M of N] ..."، باستخدام السطر الأول من ملف
وصف التغييرات كنص الموضوع. تحتوي الرسالة على جزأين أو ثلاثة أجزاء.
أولا، وصف التغييرات.

مع الخيار -d/--diffstat، إذا تم تثبيت برنامج diffstat، فستظهر نتيجة التشغيل
يتم إدراج diffstat على التصحيح.

وأخيرا، التصحيح نفسه، كما تم إنشاؤه بواسطة hg تصدير.

باستخدام الخيار -d/--diffstat أو --confirm، سيتم تقديم ملخص نهائي لك
جميع الرسائل وطلب التأكيد قبل إرسال الرسائل.

افتراضيًا، يتم تضمين التصحيح كنص في نص البريد الإلكتروني لتسهيل مراجعته. باستخدام
-a/--attach سيقوم الخيار بدلاً من ذلك بإنشاء مرفق للتصحيح. مع -i/--inline an
سيتم إنشاء المرفق المضمن. يمكنك تضمين التصحيح كنص في نص البريد الإلكتروني
وكمرفق عادي أو مضمن من خلال الجمع بين -a/--attach أو -i/--inline مع
خيار --body.

باستخدام -o/--outgoing، سيتم إنشاء رسائل بريد إلكتروني للتصحيحات غير الموجودة في الوجهة
المستودع (أو فقط تلك التي هي أسلاف المراجعات المحددة إن وجدت
متاح)

باستخدام -b/--bundle، يتم تحديد مجموعات التغييرات كـ --outgoing، ولكن تحتوي على بريد إلكتروني واحد
سيتم إرسال حزمة Mercurial الثنائية كمرفق. استخدم ال patchbomb.bundletype
خيار التكوين للتحكم في نوع الحزمة كما هو الحال مع hg حزمة --نوع.

باستخدام -m/--mbox، بدلاً من معاينة كل رسالة patchbomb في جهاز النداء أو إرسال ملف
الرسائل مباشرة، فإنه سيتم إنشاء ملف صندوق بريد UNIX مع رسائل البريد الإلكتروني التصحيحية. صندوق البريد هذا
يمكن معاينة الملف باستخدام أي وكيل مستخدم بريد يدعم ملفات UNIX mbox.

باستخدام -n/--test، سيتم تنفيذ كافة الخطوات، ولكن لن يتم إرسال البريد. سيُطلب منك ذلك
عنوان مستلم البريد الإلكتروني، والموضوع، ورسالة تمهيدية تصف التصحيحات
من قنبلة التصحيح الخاصة بك. ثم عندما يتم كل شيء، يتم عرض رسائل patchbomb. إذا كان جهاز النداء
تم تعيين متغير البيئة، وسيتم تشغيل جهاز النداء الخاص بك مرة واحدة لكل رسالة patchbomb،
حتى تتمكن من التحقق من أن كل شيء على ما يرام.

في حالة فشل إرسال البريد الإلكتروني، ستجد نسخة احتياطية من رسالتك التمهيدية للسلسلة في
.hg/last-email.txt.

يمكن تخصيص السلوك الافتراضي لهذا الأمر من خلال التكوين. (يرى hg مساعدة
patchbomb للتفاصيل)

أمثلة:

hg email -r 3000 # أرسل التصحيح 3000 فقط
hg email -r 3000 -r 3001 # إرسال التصحيحات 3000 و3001
hg email -r 3000:3005 # إرسال التصحيحات من 3000 إلى 3005
hg email 3000 # إرسال التصحيح 3000 (مهمل)

hg email -o # إرسال جميع التصحيحات ليس بشكل افتراضي
hg email -o DEST # إرسال جميع التصحيحات غير الموجودة في DEST
hg email -o -r 3000 # إرسال جميع أسلاف 3000 ليس بشكل افتراضي
hg email -o -r 3000 DEST # أرسل جميع أسلاف 3000 ليس في DEST

hg email -b # إرسال حزمة من جميع التصحيحات غير الافتراضية
hg email -b DEST # إرسال حزمة من كافة التصحيحات غير الموجودة في DEST
hg email -b -r 3000 # حزمة من جميع أسلاف 3000 ليست افتراضية
hg email -b -r 3000 DEST # حزمة من جميع أسلاف 3000 غير موجودة في DEST

hg email -o -m mbox && # إنشاء ملف mbox...
mutt -R -f mbox # ... واعرضه باستخدام mutt
hg email -o -m mbox && # إنشاء ملف mbox ...
formail -s sendmail \ # ... واستخدم formail للإرسال من mbox
-bm -t < mbox # ... باستخدام sendmail

قبل استخدام هذا الأمر، ستحتاج إلى تمكين البريد الإلكتروني في ملف hgrc. انظر [البريد الإلكتروني]
القسم hgrc(5) لمزيد من التفاصيل.

خيارات:

-g ، --شخص سخيف
استخدم تنسيق git Extended diff

--سهل
حذف رأس التصحيح hg

-o ، --منفتح
إرسال التغييرات غير موجودة في المستودع الهدف

-ب، --باقة
إرسال التغييرات غير المستهدفة كحزمة ثنائية

--bundlename
اسم الملف المرفق للحزمة (الافتراضي: الحزمة)

-r ،--ريف
مراجعة لإرسال

--فرض
يتم تشغيله حتى عندما يكون المستودع البعيد غير مرتبط (مع -b/--bundle)

--يتمركز
مجموعة تغييرات أساسية لتحديدها بدلاً من الوجهة (باستخدام -b/--bundle)

- مقدمة
أرسل بريدًا إلكترونيًا تمهيديًا لتصحيح واحد

--جسم إرسال التصحيحات كنص رسالة مضمّنة (افتراضي)

-a، --يربط
إرسال التصحيحات كمرفقات

-أنا، --في النسق
إرسال التصحيحات كمرفقات مضمنة

--bcc
عناوين البريد الإلكتروني لمستلمي النسخة الكربونية المكفوفين

-c ،--نسخة
عناوين البريد الإلكتروني لمستلمي النسخ

--تؤكد
اطلب التأكيد قبل الإرسال

-د، - ديفستات
إضافة إخراج diffstat إلى الرسائل

--تاريخ
استخدم التاريخ المحدد كتاريخ الإرسال

--desc
استخدم الملف المحدد كوصف للسلسلة

-F،--من عند
عنوان البريد الإلكتروني للمرسل

-ن، --اختبار
طباعة الرسائل التي سيتم إرسالها

م ،--mbox
كتابة الرسائل إلى ملف mbox بدلا من إرسالها

--الرد على
ينبغي إرسال ردود عناوين البريد الإلكتروني إلى

-س،--موضوع
موضوع الرسالة الأولى (مقدمة أو تصحيح واحد)

--ردا على
معرف الرسالة للرد عليها

--علم
أعلام لإضافتها في بادئات الموضوع

-t ،--ل
عناوين البريد الإلكتروني للمستلمين

-e،--SSH
تحديد أمر ssh للاستخدام

--remotecmd
حدد الأمر hg ليتم تشغيله على الجانب البعيد

--غير آمن
لا تتحقق من شهادة الخادم (تجاهل تكوين web.cacerts)

[+] يمكن تحديد الخيار المحدد عدة مرات

تطهير
أمر لحذف الملفات التي لم يتم تعقبها من دليل العمل

أوامر
تطهير
يزيل الملفات التي لم يتم تعقبها بواسطة Mercurial:

تطهير الزئبق [خيار]... [DIR]...

احذف الملفات غير المعروفة لـ Mercurial. وهذا مفيد لاختبار التغييرات المحلية وغير الملتزم بها
في شجرة مصدر نظيفة خلاف ذلك.

هذا يعني أن عملية التطهير ستحذف ما يلي افتراضيًا:

· ملفات غير معروفة: الملفات التي تحمل علامة "؟" بواسطة hg الحالة

· الدلائل الفارغة: في الواقع، يتجاهل Mercurial الدلائل ما لم تكن تحتوي على ملفات ضمنها
إدارة التحكم بالمصادر

لكنها ستترك دون مساس:

· الملفات المعدلة وغير المعدلة

· الملفات التي تم تجاهلها (ما لم يتم تحديد --all)

· تمت إضافة ملفات جديدة إلى المستودع (مع hg تضيف)

يمكن استخدام خيارات --files و --dirs للتطهير المباشر لحذف الملفات فقط
الدلائل، أو كليهما. إذا لم يتم إعطاء أي خيار، سيتم حذف كليهما.

إذا تم تقديم الدلائل في سطر الأوامر، فسيتم توفير الملفات الموجودة في هذه الدلائل فقط
اعتبر.

كن حذرًا أثناء عملية التطهير، حيث يمكنك حذف بعض الملفات التي نسيت إضافتها إليها بشكل لا رجعة فيه
المستودع. إذا كنت تريد فقط طباعة قائمة الملفات التي سيفعلها هذا البرنامج
احذف، استخدم خيار --print.

خيارات:

-a، --abort-on-err
إحباط في حالة حدوث خطأ

--الكل تطهير الملفات التي تم تجاهلها أيضًا

- الأدباء تطهير الدلائل الفارغة

- ملفات
تطهير الملفات

-p ، --مطبعة
طباعة أسماء الملفات بدلا من حذفها

-0، --print0
أسماء الملفات النهائية بـ NUL، للاستخدام مع xargs (يعني -p/--print)

-أنا،--يشمل
تضمين أسماء مطابقة للأنماط المحددة

-X ،- استثناء
استبعاد الأسماء المطابقة للأنماط المحددة

[+] يمكن تحديد الخيار المحدد عدة مرات

الأسماء المستعارة: نظيفة

rebase
أمر لنقل مجموعات من المراجعات إلى سلف مختلف

يتيح لك هذا الامتداد إعادة إنشاء مجموعات التغييرات في مستودع Mercurial موجود.

لمزيد من المعلومات: https://mercurial-scm.org/wiki/RebaseExtension

أوامر
rebase
انقل مجموعة التغييرات (والأحفاد) إلى فرع مختلف:

hg rebase [-s REV | -b REV] [-d REV] [خيار]

يستخدم Rebase الدمج المتكرر لتطعيم مجموعات التغييرات من جزء واحد من التاريخ (المصدر)
إلى أخرى (الوجهة). يمكن أن يكون هذا مفيدًا للخطية محلي التغييرات النسبية
إلى شجرة التطوير الرئيسية.

لا يمكن إعادة أساس الالتزامات المنشورة (انظر hg مساعدة المراحل). لنسخ الالتزامات، راجع hg مساعدة
تطعيم.

إذا لم تحدد مجموعة تغييرات الوجهة (-د/--ديست)، يستخدم rebase الفرع الحالي
نصيحة كوجهة. (لم يتم تعديل مجموعة تغييرات الوجهة عن طريق إعادة التأسيس، ولكنها جديدة
تتم إضافة مجموعات التغييرات كأحفادها.)

فيما يلي طرق تحديد مجموعات التغييرات:

1. حددها بوضوح باستخدام --ريف.

2. استعمال --مصدر لتحديد مجموعة التغييرات الجذرية وتضمين جميع أحفادها.

3. استعمال --يتمركز لتحديد مجموعة التغييرات؛ سيجد rebase أسلافًا وأحفادهم
والتي ليست أيضًا أسلاف الوجهة.

4. إذا لم تقم بتحديد أي منها --ريف, مصدرالطرق أو --يتمركز، سيتم استخدام rebase --يتمركز . as
في الاعلى.

سوف يقوم Rebase بتدمير مجموعات التغييرات الأصلية ما لم تستخدمها --احتفظ. وسوف تتحرك أيضا الخاص بك
الإشارات المرجعية (حتى لو قمت بذلك).

قد يتم إسقاط بعض مجموعات التغييرات إذا لم تساهم بالتغييرات (على سبيل المثال، عمليات الدمج من ملف
فرع الوجهة).

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

إذا تمت مقاطعة عملية إعادة الأساس لحل تعارض يدويًا، فيمكن الاستمرار فيها
--continue/-c أو تم إحباطه باستخدام --abort/-a.

أمثلة:

· نقل "التغييرات المحلية" (الالتزام الحالي مرة أخرى إلى نقطة التفرع) إلى طرف الفرع الحالي
بعد السحب:

hg rebase

· نقل مجموعة تغييرات واحدة إلى الفرع المستقر:

hg rebase -r 5f493448 -d مستقر

· لصق الالتزام وجميع نسله على جزء آخر من التاريخ:

hg rebase --source c0c3 --dest 4cf9

· أعد وضع كل شيء على فرع مميز بإشارة مرجعية على الفرع الافتراضي:

hg rebase --base myfeature --dest default

· انهيار سلسلة من التغييرات في التزام واحد:

hg rebase --collapse -r 1520:1525 -d .

· نقل فرع مسمى مع الحفاظ على اسمه:

hg rebase -r "branch(featureX)" -d 1.3 --keepbranches

يُرجع 0 عند النجاح، 1 إذا لم يكن هناك شيء لإعادة الأساس أو كانت هناك تعارضات لم يتم حلها.

خيارات:

-س،--مصدر
إعادة تعيين مجموعة التغييرات والأحفاد المحددة

-ب،--يتمركز
إعادة صياغة كل شيء من نقطة التفرع لمجموعة التغييرات المحددة

-r ،--ريف
إعادة صياغة هذه المراجعات

-د،--أفضل
rebase على التغييرات المحددة

--ينهار
قم بطي مجموعات التغييرات المعاد تشكيلها

م ،--رسالة
استخدام النص كرسالة التزام الانهيار

-e، --تعديل
استدعاء المحرر على رسائل الالتزام

-ل ،--ملف تسجيل
قراءة رسالة الالتزام بالانهيار من الملف

-ك، --احتفظ
احتفظ بمجموعات التغييرات الأصلية

--keepbranches
الاحتفاظ بأسماء الفروع الأصلية

-د، --فصل
(إهمال)

-أنا، - تفاعلي
(إهمال)

-t ،--أداة
تحديد أداة الدمج

-c ، --استمر
متابعة إعادة الأساس المتقطعة

-a، - أوقف
إحباط إعادة قاعدة متقطعة

--نمط
العرض باستخدام ملف خريطة القالب (مهمل)

-T ،--نموذج
عرض مع القالب

[+] يمكن تحديد الخيار المحدد عدة مرات

سجل
أوامر لتحديد التغييرات بشكل تفاعلي للالتزام/qrefresh

أوامر
com.qrecord
تسجيل تصحيح جديد بشكل تفاعلي:

hg qrecord [خيار]... تصحيح [ملف]...

يرى hg مساعدة com.qnew & hg مساعدة سجل لمزيد من المعلومات والاستخدام.

سجل
حدد بشكل تفاعلي التغييرات المراد الالتزام بها:

سجل hg [خيار]... [ملف]...

إذا تم حذف قائمة الملفات، فسيتم الإبلاغ عن جميع التغييرات بواسطة hg الحالة سيكون من المرشحين ل
تسجيل.

يرى hg مساعدة التمور للحصول على قائمة التنسيقات الصالحة لـ -d/--date.

سيُطلب منك تحديد ما إذا كنت تريد تسجيل التغييرات على كل ملف تم تعديله أم لا، وكذلك على الملفات
مع تغييرات متعددة، لكل تغيير للاستخدام. لكل استعلام، الإجابات التالية هي
ممكن:

ذ - سجل هذا التغيير
ن - تخطي هذا التغيير
هـ - قم بتحرير هذا التغيير يدويًا

الصورة - تخطي التغييرات المتبقية على هذا الملف
و - تسجيل التغييرات المتبقية على هذا الملف

د - تم، تخطي التغييرات والملفات المتبقية
أ - تسجيل كافة التغييرات على كافة الملفات المتبقية
س - إنهاء، وتسجيل أية تغييرات

؟ - عرض المساعدة

هذا الأمر غير متوفر عند تنفيذ عملية الدمج.

خيارات:

-أ، --اضف احذف
وضع علامة على الملفات الجديدة/المفقودة كمضافة/إزالة قبل الالتزام

- فرع قريب
ضع علامة على رأس الفرع على أنه مغلق

--يعدل
تعديل أصل دليل العمل

-س، --سر
استخدم المرحلة السرية للالتزام

-e، --تعديل
استدعاء المحرر على رسائل الالتزام

-أنا،--يشمل
تضمين أسماء مطابقة للأنماط المحددة

-X ،- استثناء
استبعاد الأسماء المطابقة للأنماط المحددة

م ،--رسالة
استخدم النص كرسالة التزام

-ل ،--ملف تسجيل
قراءة رسالة الالتزام من الملف

-د،--تاريخ
سجل التاريخ المحدد كتاريخ الالتزام

-u ،--المستعمل
تسجيل المستخدم المحدد كملتزم

-س، --subrepos
يتكرر في المستودعات الفرعية

-w ، --تجاهل - كل - المسافة
تجاهل المسافة البيضاء عند مقارنة الخطوط

-ب، - تجاهل-تغيير الفضاء
تجاهل التغييرات في مقدار المساحة البيضاء

-ب، - تجاهل الأسطر الفارغة
تجاهل التغييرات التي تكون جميع أسطرها فارغة

[+] يمكن تحديد الخيار المحدد عدة مرات

إعادة الربط
يعيد إنشاء الروابط الصلبة بين نسخ المستودع

أوامر
إعادة الربط
إعادة إنشاء الروابط الصلبة بين مستودعين:

إعادة ربط الزئبق [الأصل]

عندما يتم استنساخ المستودعات محليًا، سيتم ربط ملفات البيانات الخاصة بها ارتباطًا وثيقًا بحيث يمكن
استخدم فقط مساحة مستودع واحد.

ولسوء الحظ، فإن عمليات السحب اللاحقة إلى أي من المستودعين ستؤدي إلى قطع الارتباطات الثابتة لأي ملفات
تتأثر بمجموعات التغييرات الجديدة، حتى لو انتهى كلا المستودعين بسحب نفس التغييرات.

وبالمثل، فإن تمرير --rev إلى "hg clone" سيفشل في استخدام أي روابط صلبة، مما يؤدي إلى الرجوع إلى ملف
نسخة كاملة من مستودع المصدر.

يتيح لك هذا الأمر إعادة إنشاء تلك الروابط الثابتة واستعادة تلك المساحة الضائعة.

ستتم إعادة ربط هذا المستودع لمشاركة المساحة مع ORIGIN، والذي يجب أن يكون في نفس المساحة
قرص محلي. إذا تم حذف ORIGIN، فابحث عن "إعادة الارتباط الافتراضي"، ثم "افتراضي"، في [المسارات].

لا تحاول إجراء أية عمليات قراءة على هذا المستودع أثناء تشغيل الأمر. (كلاهما
سيتم قفل المستودعات ضد الكتابة.)

مخططات
توسيع المخططات باستخدام اختصارات لأسراب المستودع

يتيح لك هذا الامتداد تحديد اختصارات لعناوين URL الأصلية التي تحتوي على الكثير من المستودعات
للتصرف مثل المخطط، على سبيل المثال:

[المخططات]
الحمر = http://code.python.org/hg/

بعد ذلك يمكنك استخدامه مثل:

زئبق استنساخ py://trunk/

بالإضافة إلى ذلك، هناك دعم لبعض المخططات الأكثر تعقيدًا، على سبيل المثال المستخدمة من قبل Google
رمز:

[المخططات]
gcode = http://{1}.googlecode.com/hg/

يتم أخذ بناء الجملة من قوالب Mercurial، ولديك عدد غير محدود من المتغيرات،
بدءا من 1 {} ويستمر مع 2 {}, 3 {} وما إلى ذلك وهلم جرا. سوف تتلقى هذه المتغيرات
أجزاء من URL المقدمة، مقسمة حسب /. أي شيء لم يتم تحديده {جزء} سيتم إلحاقه فقط
إلى عنوان URL.

للراحة، يضيف الامتداد هذه المخططات بشكل افتراضي:

[المخططات]
الحمر = http://hg.python.org/
ب = https://bitbucket.org/
ب ب + سش = سش: //[البريد الإلكتروني محمي]/
gcode = https://{1}.googlecode.com/hg/
الفرن = https://{1}.kilnhg.com/Repo/

يمكنك تجاوز نظام محدد مسبقًا عن طريق تحديد نظام جديد بنفس الاسم.

شارك
مشاركة تاريخ مشترك بين عدة أدلة العمل

أوتوماتيك مجمعة الخزائن For استنساخ
عندما يكون هذا الامتداد نشطًا، hg استنساخ يمكن تهيئتها للمشاركة/التجميع تلقائيًا
التخزين عبر نسخ متعددة. هذا الوضع يحول بشكل فعال hg استنساخ إلى hg استنساخ + hg
شارك. وتتمثل فائدة استخدام هذا الوضع في الإدارة التلقائية لمسارات المتجر و
التجميع الذكي للمستودعات ذات الصلة.

ما يلي سهم. تؤثر خيارات التكوين على هذه الميزة:

share.pool

مسار نظام الملفات حيث سيتم تخزين بيانات المستودع المشترك. عندما تم تعريفها، hg استنساخ
سيستخدم تلقائيًا تخزين المستودع المشترك بدلاً من إنشاء متجر بالداخل
كل استنساخ.

share.poolnaming

كيف أسماء الدليل في share.pool شيدت.

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

"عن بعد" يعني أن الاسم مشتق من مسار المستودع المصدر أو عنوان URL. في
في هذا الوضع، تتم مشاركة التخزين فقط إذا كان المسار أو عنوان URL مطلوبًا في ملف hg استنساخ
يتطابق الأمر تمامًا مع المستودع الذي تم استنساخه من قبل.

وضع التسمية الافتراضي هو "الهوية".

أوامر
شارك
إنشاء مستودع مشترك جديد:

حصة الزئبق [-U] [-B] المصدر [DEST]

قم بتهيئة مستودع جديد ودليل عمل يشاركان تاريخه (واختياريًا
الإشارات المرجعية) مع مستودع آخر.

لاحظ أن استخدام التراجع أو الامتدادات التي تدمر/تعدل السجل (mq، rebase، إلخ).
تسبب ارتباكًا كبيرًا مع النسخ المشتركة. على وجه الخصوص، إذا شارك اثنان
يتم تحديث كل من النسخ المستنسخة لنفس مجموعة التغييرات، وأحدهما يدمر ذلك
بعد تغيير مجموعة التغييرات مع التراجع، ستتوقف النسخة الأخرى عن العمل فجأة: جميع العمليات
سيفشل مع "إحباط: دليل العمل له أصل غير معروف". الوحيد المعروف
الحل البديل هو استخدام debugsetparents على النسخة المعطلة لإعادة تعيينها إلى مجموعة التغييرات
الذي لا يزال موجودا.

خيارات:

-U ، --لا تحديث
لا تقم بإنشاء دليل العمل

-ب، --إشارات مرجعية
شارك أيضًا الإشارات المرجعية

عدم المشاركة
تحويل مستودع مشترك إلى مستودع عادي:

زئبق إلغاء المشاركة

انسخ بيانات المتجر إلى الريبو وقم بإزالة بيانات المسار المشترك.

اكتنز
حفظ واستعادة التغييرات إلى دليل العمل

يحفظ الأمر "hg shelve" التغييرات التي تم إجراؤها على دليل العمل ويعيدها
التغييرات، وإعادة تعيين دليل العمل إلى حالة نظيفة.

لاحقًا، يقوم الأمر "hg unshelve" باستعادة التغييرات المحفوظة بواسطة "hg shelve". يمكن التغييرات
يمكن استعادتها حتى بعد التحديث إلى أصل مختلف، وفي هذه الحالة يتم دمج Mercurial
ستقوم الآلات بحل أي تعارضات إذا لزم الأمر.

يمكنك الحصول على أكثر من قطعة نقدية معلقة على الرف في نفس الوقت؛ كل تغيير على الرفوف له
اسم مميز. لمزيد من التفاصيل، راجع المساعدة الخاصة بـ "hg shelve".

أوامر
اكتنز
حفظ وتخصيص التغييرات من دليل العمل:

رف زئبقي [خيار]... [ملف]...

يأخذ الرفوف الملفات التي تشير "حالة hg" إلى أنها غير نظيفة، ويحفظ التعديلات في ملف
حزمة (تغيير على الرف)، وتعود الملفات بحيث حالتها في العمل
الدليل يصبح نظيفا.

لاستعادة هذه التغييرات إلى دليل العمل، استخدم "hg unshelve"؛ هذا سيفي بالغرض
حتى لو قمت بالتبديل إلى التزام مختلف.

عند عدم تحديد أي ملفات، يقوم "hg shelve" بحفظ كافة الملفات غير النظيفة. إذا كانت ملفات محددة أو
تتم تسمية الدلائل، ويتم وضع التغييرات على تلك الملفات على الرف فقط.

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

لرؤية قائمة بالتغييرات الموجودة على الرفوف، استخدم --قائمة خيار. لكل تغيير على الرف،
سيؤدي ذلك إلى طباعة اسمه وعمره ووصفه؛ يستخدم --رقعة قماشية or - إحصائيات لمزيد من التفاصيل.

لحذف تغييرات معينة على الرفوف، استخدم --حذف. لحذف كافة التغييرات الموضوعة على الرف، استخدم
--تنظيف.

خيارات:

-أ، --اضف احذف
وضع علامة على الملفات الجديدة/المفقودة كمضافة/إزالة قبل وضعها على الرفوف

-u ، --مجهول
تخزين الملفات غير المعروفة على الرف

--تنظيف
حذف كافة التغييرات على الرف

--تاريخ
الرف مع تاريخ الالتزام المحدد

-د، --حذف
حذف التغييرات المحددة على الرفوف

-e، --تعديل
استدعاء المحرر على رسائل الالتزام

-ل ، --قائمة
قائمة الرفوف الحالية

م ،--رسالة
استخدام النص كرسالة الرف

-ن،--اسم
استخدم الاسم المحدد للالتزام على الرف

-p ، --رقعة قماشية
إظهار التصحيح

-أنا، - تفاعلي
الوضع التفاعلي، يعمل فقط أثناء إنشاء الرف

- إحصائيات إخراج ملخص للتغييرات على غرار diffstat

-أنا،--يشمل
تضمين أسماء مطابقة للأنماط المحددة

-X ،- استثناء
استبعاد الأسماء المطابقة للأنماط المحددة

[+] يمكن تحديد الخيار المحدد عدة مرات

قم بفك الرف
استعادة التغيير على الرفوف إلى دليل العمل:

زئبق إلغاء الرف [SHELVED]

يقبل هذا الأمر اسمًا اختياريًا للتغيير الموضوع على الرف المراد استعادته. إذا لم يتم إعطاء أي شيء،
يتم استخدام أحدث تغيير على الرفوف.

إذا تم تطبيق التغيير على الرفوف بنجاح، فستتغير الحزمة التي تحتوي على الرفوف
يتم نقله إلى موقع النسخ الاحتياطي (.hg/shelve-backup).

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

(بدلاً من ذلك، يمكنك استخدام - أوقف للتخلي عن الرف الذي يسبب الصراع. هذا
يعكس التغييرات التي لم يتم وضعها على الرف، ويترك الحزمة في مكانها.)

بعد إلغاء الرف بنجاح، يتم تخزين التغييرات الموضوعة على الرف في دليل النسخ الاحتياطي. فقط
يتم الاحتفاظ بأحدث النسخ الاحتياطية N. القيمة الافتراضية لـ N هي 10 ولكن يمكن تجاوزها باستخدام
shelve.maxbackups خيار التكوين.

يتم استخدام الطابع الزمني بالثواني لتحديد ترتيب النسخ الاحتياطية. أكثر من com.maxbackups النسخ الاحتياطية هي
يتم الاحتفاظ بها، إذا كان نفس الطابع الزمني يمنع من تحديد الترتيب الدقيق لها، من أجل السلامة.

خيارات:

-a، - أوقف
إحباط عملية unsheve غير مكتملة

-c ، --استمر
الاستمرار في عملية unsheve غير مكتملة

-ك، --احتفظ
احتفظ بالرف بعد فكه

-t ،--أداة
تحديد أداة الدمج

--تاريخ
تحديد تاريخ للالتزامات المؤقتة (مهمل)

قطاع
تجريد مجموعات التغييرات وأحفادهم من التاريخ

يتيح لك هذا الامتداد تجريد مجموعات التغييرات وجميع أحفادها من ملف
مخزن. راجع تعليمات الأمر للحصول على التفاصيل.

أوامر
قطاع
تجريد مجموعات التغييرات وجميع أحفادها من المستودع:

شريط hg [-k] [-f] [-B إشارة مرجعية] [-r] REV...

يقوم أمر الشريط بإزالة مجموعات التغييرات المحددة وجميع أحفادها. إذا
يحتوي دليل العمل على تغييرات متاحة، وسيتم إحباط العملية ما لم يتم تغيير --force
يتم توفير العلامة، وفي هذه الحالة سيتم تجاهل التغييرات.

إذا تم تجريد الأصل من دليل العمل، فسيتم حذف دليل العمل
سيتم تحديثه تلقائيًا إلى أحدث سلف متاح للوالد الذي تم تجريده
بعد اكتمال العملية.

يتم تخزين أي تغييرات تم تجريدها في .hg/strip-backup كحزمة (انظر hg مساعدة حزمة و
hg مساعدة سيفصل). يمكن استعادتها عن طريق الجري hg سيفصل .hg/strip-backup/BUNDLE,
حيث BUNDLE هو ملف الحزمة الذي تم إنشاؤه بواسطة الشريط. لاحظ أن أرقام المراجعة المحلية
سوف بشكل عام تكون مختلفة بعد الاستعادة.

استخدم خيار --no-backup لتجاهل حزمة النسخ الاحتياطي بمجرد اكتمال العملية.

لا تعد عملية Strip عملية إعادة كتابة للتاريخ ويمكن استخدامها في مجموعات التغييرات العامة
مرحلة. ولكن إذا تم دفع مجموعات التغييرات التي تم تجريدها إلى مستودع بعيد، فسوف تفعل ذلك
من المحتمل أن تسحبهم مرة أخرى.

العودة 0 على النجاح.

خيارات:

-r ،--ريف
مراجعة الشريط المحددة (اختياري، يمكن تحديد المراجعات بدون هذا الخيار)

-F، --فرض
فرض إزالة مجموعات التغييرات، وتجاهل التغييرات غير الملتزم بها (بدون نسخة احتياطية)

--لا يوجد نسخة احتياطية
لا يوجد نسخ احتياطية

--nobackup
لا توجد نسخ احتياطية (مهملة)

-n تم التجاهل (مهمل)

-ك، --احتفظ
لا تقم بتعديل دليل العمل أثناء الشريط

-ب،- المرجعية
قم بإزالة الدورات التي لا يمكن الوصول إليها إلا من الإشارة المرجعية المحددة

[+] يمكن تحديد الخيار المحدد عدة مرات

زرع اعضاء
الأمر لزرع مجموعات التغييرات من فرع آخر

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

يتم تسجيل البقع المزروعة في .hg/transplant/transplants، كخريطة من مجموعة التغييرات
hash إلى التجزئة الخاصة به في مستودع المصدر.

أوامر
زرع اعضاء
مجموعات تغيير الزرع من فرع آخر:

زرع الزئبق [-s REPO] [-b BRANCH [-a]] [-p REV] [-m REV] [REV]...

سيتم تطبيق مجموعات التغييرات المحددة أعلى دليل العمل الحالي مع السجل
من مجموعة التغييرات الأصلية. يتم نسخ مجموعات التغييرات وبالتالي ستظهر مرتين في الملف
التاريخ مع هويات مختلفة.

فكر في استخدام أمر الكسب غير المشروع إذا كان كل شيء موجودًا داخل نفس المستودع - فسيتم استخدامه
يدمج وعادة ما يعطي نتيجة أفضل. استخدم ملحق rebase إذا كانت مجموعات التغييرات
غير منشورة وتريد نقلها بدلاً من نسخها.

إذا تم تحديد --log، فستحتوي رسائل السجل على تعليق مُلحق بالنموذج:

(منقول من CHANGESETHASH)

يمكنك إعادة كتابة رسالة سجل التغيير باستخدام خيار --filter. ستكون حجتها
يتم استدعاؤه باستخدام رسالة سجل التغيير الحالية كـ $1 والتصحيح كـ $2.

--source/-s يحدد مستودعًا آخر لاستخدامه في تحديد مجموعات التغييرات، تمامًا كما لو كان
تم سحبها مؤقتا. إذا تم تحديد --branch/-b، فسيتم استخدام هذه المراجعات كـ
يتجه ذهنه عند تحديد مجموعات التغييرات المراد زرعها، تمامًا كما لو كانت هذه المراجعات فقط هي التي تمت
تم سحبها. إذا تم تحديد --all/-a، فستتم جميع المراجعات حتى الرؤوس المحددة
- سيتم زرع الفرع.

على سبيل المثال:

· زرع كافة التغييرات حتى REV أعلى المراجعة الحالية:

زرع الزئبق - فرع REV - الكل

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

يمكن زرع مجموعات تغييرات الدمج مباشرة عن طريق تحديد مجموعة التغييرات الأصلية المناسبة بواسطة
دعوة hg زرع اعضاء --الأبوين.

إذا لم يتم توفير أي عمليات دمج أو مراجعات، hg زرع اعضاء سيبدأ مجموعة التغييرات التفاعلية
المتصفح.

إذا فشل تطبيق مجموعة التغييرات، فيمكنك إصلاح الدمج يدويًا ثم استئناف العمل من حيث أنت
توقفت عن طريق الاتصال hg زرع اعضاء --متابعة/-ج.

خيارات:

-س،--مصدر
مجموعات تغيير الزرع من REPO

-ب،--فرع
استخدم مجموعة تغييرات المصدر هذه كرئيس

-a، --الكل
اسحب كافة مجموعات التغييرات إلى مراجعات --branch

-p ،--تقليم
تخطي REV

م ،--دمج
دمج في REV

--الأبوين
الوالدين لاختيار عند زرع الدمج

-e، --تعديل
استدعاء المحرر على رسائل الالتزام

--سجل إلحاق معلومات الزرع برسالة السجل

-c ، --استمر
الاستمرار في جلسة الزرع الأخيرة بعد إصلاح التعارضات

--منقي
تصفية مجموعات التغييرات من خلال الأمر

[+] يمكن تحديد الخيار المحدد عدة مرات

win32mbcs
السماح باستخدام مسارات MBCS مع الترميزات الإشكالية

بعض ترميزات MBCS ليست جيدة لبعض عمليات المسار (أي تقسيم المسار، الحالة
التحويل، وما إلى ذلك) بالبايتات المشفرة الخاصة به. نحن نسمي هذا الترميز (أي Shift_jis و
big5) كـ "ترميز إشكالي". يمكن استخدام هذا الامتداد لإصلاح المشكلة مع هؤلاء
الترميزات عن طريق تغليف بعض الوظائف لتحويلها إلى سلسلة Unicode قبل تشغيل المسار.

هذا الامتداد مفيد لـ:

· مستخدمو Windows اليابانيون يستخدمون ترميز Shift_jis.

· مستخدمو Windows الصينيون يستخدمون ترميز big5.

· جميع المستخدمين الذين يستخدمون مستودعًا يحتوي على أحد الترميزات التي بها مشكلات وغير حساس لحالة الأحرف
نظام الملفات.

هذا الامتداد ليس ضروريًا من أجل:

· أي مستخدم يستخدم أحرف ASCII فقط في المسار.

· أي مستخدم لا يستخدم أيًا من الترميزات الإشكالية.

لاحظ أن هناك بعض القيود على استخدام هذا الامتداد:

· يجب عليك استخدام ترميز واحد في مستودع واحد.

· إذا انتهى مسار المستودع بـ 0x5c، فلا يمكن قراءة .hg/hgrc.

· Win32mbcs غير متوافق مع ملحق Fixutf8.

بشكل افتراضي، يستخدم win32mbcs التشفير الذي يقرره Mercurial. يمكنك تحديد
الترميز عن طريق خيار التكوين:

[win32mbcs]
الترميز = sjis

إنه مفيد للمستخدمين الذين يرغبون في الالتزام برسالة سجل UTF-8.

win32text
إجراء تحويل تلقائي للسطر الجديد (مهمل)

الإهمال: يتطلب ملحق win32text من كل مستخدم تكوين الامتداد
مرارا وتكرارا لكل استنساخ حيث لا يتم نسخ التكوين عند الاستنساخ.

ولذلك قمنا ب إيول كبديل. ال إيول يستخدم نسخة تسيطر عليها
لتكوينه وبالتالي سيستخدم كل نسخة الإعدادات الصحيحة من
البداية.

لإجراء تحويل تلقائي للسطر الجديد، استخدم:

[ملحقات]
win32text =
[تشفير]
** = الكود الذكي:
# أو ** = macencode:

[فك تشفير]
** = كود ذكي:
# أو ** = macdecode:

إذا لم تقم بإجراء التحويل، للتأكد من عدم ارتكاب CRLF/CR عن طريق الصدفة:

[خطافات]
pretxncommit.crlf = بيثون:hgext.win32text.forbidcrlf
# أو pretxncommit.cr = بيثون:hgext.win32text.forbidcr

للقيام بنفس الفحص على الخادم لمنع دفع أو سحب CRLF/CR:

[خطافات]
pretxnchangegroup.crlf = بيثون:hgext.win32text.forbidcrlf
# أو pretxnchangegroup.cr = بيثون:hgext.win32text.forbidcr

زيروكونف
اكتشاف والإعلان عن المستودعات على الشبكة المحلية

سيتم الإعلان عن ملحق Zeroconf hg خدمة مثيلات عبر DNS-SD بحيث يمكن أن تكون
تم اكتشافه باستخدام hg مسارات الأمر دون معرفة عنوان الخادم.

للسماح للآخرين باكتشاف مستودعك باستخدام run hg خدمة في مستودعك:

اختبار القرص $
خدمة $ زئبق

يمكنك اكتشاف المستودعات التي تدعم Zeroconf عن طريق التشغيل hg مسارات:

مسارات الزئبق $
اختبار zc = http://example.com:8000/اختبار

استخدم hg عبر الإنترنت باستخدام خدمات onworks.net