git-describe - آنلاین در ابر

برنامه:

نام

git-describe - یک commit را با استفاده از آخرین برچسب قابل دسترسی از آن توصیف کنید

خلاصه

دستگاه گوارش توصیف [--همه] [--برچسب‌ها] [-- حاوی] [--abbrev= ] [ ...]
دستگاه گوارش توصیف [--همه] [--برچسب‌ها] [-- حاوی] [--abbrev= ] -- کثیف[= ]

شرح

این دستور جدیدترین برچسبی را که از یک commit قابل دسترسی است پیدا می کند. اگر برچسب اشاره می کند
به commit، سپس فقط تگ نشان داده می شود. در غیر این صورت، نام تگ را پسوند می کند
تعداد commit های اضافی در بالای شی برچسب گذاری شده و نام شی اختصاری
از جدیدترین ارتکاب

به طور پیش فرض (بدون --all یا ---tags) git describe فقط تگ های حاشیه نویسی را نشان می دهد. برای بیشتر
اطلاعات مربوط به ایجاد تگ های حاشیه نویسی را در گزینه های -a و -s ببینید git-tag(1).

OPTIONS

...
نام اشیاء را برای توصیف متعهد کنید. در صورت حذف به طور پیش فرض روی HEAD قرار می گیرد.

-- کثیف[= ]
درخت کار را توصیف کنید. یعنی توصیف HEAD و ضمیمه ها (-کثیف توسط
پیش فرض) اگر درخت کار کثیف باشد.

--همه
به جای استفاده از تگ های حاشیه نویسی شده، از هر مرجعی که در refs/space یافت می شود استفاده کنید. این
این گزینه تطبیق هر شاخه شناخته شده، شاخه ردیابی از راه دور یا برچسب سبک را امکان پذیر می کند.

-- برچسب ها
به جای استفاده از تگ های حاشیه نویسی شده، از هر تگ موجود در فضای نام refs/tags استفاده کنید.
این گزینه تطبیق یک برچسب سبک وزن (غیر حاشیه نویسی) را امکان پذیر می کند.

-- حاوی
به جای یافتن برچسبی که قبل از commit است، برچسبی را که بعد از آن می آید پیدا کنید
متعهد می شود و در نتیجه آن را شامل می شود. به طور خودکار به تگ های -- دلالت دارد.

--abbrev=
به جای استفاده از 7 رقم پیش فرض هگزا دسیمال به عنوان نام اختصاری شی، از آن استفاده کنید
ارقام، یا تعداد ارقامی که برای تشکیل یک نام شی منحصر به فرد لازم است. یک از 0 اراده
فرمت طولانی را سرکوب کنید، فقط نزدیکترین برچسب را نشان می دهد.

--نامزدها=
به جای در نظر گرفتن تنها 10 برچسب اخیر به عنوان نامزد برای توصیف
ورودی commit-ish در نظر گرفتن تا نامزدهای. در حال افزایش است بالای 10 خواهد گرفت
کمی طولانی تر است اما ممکن است نتیجه دقیق تری ایجاد کند. یک از 0 فقط باعث می شود
منطبقات دقیق باید خروجی شود.

--مطابقت کامل
فقط منطبقات دقیق را خروجی کنید (یک برچسب مستقیماً به commit ارائه شده ارجاع می دهد). این یک است
مترادف --candidates=0.

- رفع اشکال
اطلاعات مربوط به استراتژی جستجو را که به طور استاندارد به کار گرفته شده است، به طور واضح نمایش دهید
خطا نام تگ همچنان به صورت استاندارد چاپ خواهد شد.

--طولانی
همیشه فرمت طولانی (تگ، تعداد commit ها و مخفف) را خروجی بگیرید
commit name) حتی زمانی که با یک برچسب مطابقت دارد. این زمانی مفید است که می خواهید قسمت هایی از آن را ببینید
نام شی commit در خروجی "describe"، حتی زمانی که commit مورد نظر اتفاق می افتد
نسخه برچسب گذاری شده باشد. به جای اینکه فقط نام تگ را منتشر کند، چنین چیزی را توصیف می کند
commit به عنوان v1.2-0-gdeadbee (0مین commit از تگ v1.2 که به شی اشاره می کند
مرده ...).

--همخوانی داشتن
فقط برچسب هایی را در نظر بگیرید که مطابق با داده شده باشند کره(7) الگو، به استثنای "refs/tags/"
پیشوند این می تواند برای جلوگیری از نشت برچسب های خصوصی از مخزن استفاده شود.

-- همیشه
نمایش شی commit مختصر منحصر به فرد به عنوان بازگشتی.

--اولین والد
با مشاهده یک commit ادغام، فقط اولین کامیت والد را دنبال کنید. این زمانی مفید است که
شما مایلید تگ های شاخه های ادغام شده در تاریخچه ارتکاب هدف مطابقت نداشته باشید.

مثال ها

با چیزی مانند درخت فعلی git.git، دریافت می کنم:

[torvalds@g5 git]$ git توصیف والد
نسخه 1.0.4-14-g2414721

یعنی رئیس فعلی شاخه "والد" من بر اساس v1.0.4 است، اما از آنجایی که تعداد کمی دارد
commits علاوه بر آن، توصیف تعداد commit های اضافی ("14") و
نام شی اختصاری برای خود commit ("2414721") در پایان.

تعداد commit های اضافی تعداد commit هایی است که با "git" نمایش داده می شود
log v1.0.4..parent". پسوند هش "-g" + مخفف 7 کاراکتر برای tip commit است.
والد (که 2414721b194453f058079d897d13c4e377f92dc6 بود). پیشوند "g" مخفف آن است
"git" و برای اجازه دادن به توصیف نسخه یک نرم افزار بسته به SCM استفاده می شود
نرم افزار با مدیریت می شود. این در محیطی که افراد ممکن است از موارد مختلف استفاده کنند مفید است
SCM ها

انجام یک دستگاه گوارش توصیف در یک نام تگ فقط نام تگ را نشان می دهد:

[torvalds@g5 git]$ git توصیف نسخه 1.0.4
v1.0.4

با --all، دستور می تواند از سر شاخه ها به عنوان مرجع استفاده کند، بنابراین خروجی نشان می دهد
مسیر مرجع نیز:

[torvalds@g5 git]$ git توصیف --all --abbrev=4 v1.0.5^2
tags/v1.0.0-21-g975b

[torvalds@g5 git]$ git توصیف --all --abbrev=4 HEAD^
heads/lt/describe-7-g975b

با تنظیم --abbrev روی 0، می توان از این دستور برای یافتن نزدیکترین تگ نام بدون هیچ گونه استفاده کرد
پسوند:

[torvalds@g5 git]$ git توصیف --abbrev=0 v1.0.5^2
tags/v1.0.0

توجه داشته باشید که پسوندی که اگر امروز این دستورات را تایپ کنید ممکن است طولانی تر از مقدار باشد
وقتی لینوس این دستورات را اجرا کرد، در بالا مشاهده کرد، زیرا مخزن Git شما ممکن است دارای commit های جدیدی باشد
نام اشیاء آنها با 975b شروع می شود که در آن زمان وجود نداشت و پسوند "-g975b" به تنهایی
ممکن است برای رفع ابهام از این تعهدات کافی نباشد.

جستجو استراتژی

برای هر تعهد ارائه شده، دستگاه گوارش توصیف ابتدا به دنبال برچسبی می گردد که دقیقاً تگ می کند
که متعهد می شوند. برچسب‌های حاشیه‌نویسی همیشه بر برچسب‌های سبک ترجیح داده می‌شوند، و برچسب‌هایی با
تاریخ های جدیدتر همیشه بر برچسب هایی با تاریخ های قدیمی تر ترجیح داده می شوند. اگر تطابق دقیق باشد
پیدا شد، نام آن خروجی خواهد شد و جستجو متوقف خواهد شد.

اگر مطابقت دقیق پیدا نشد، دستگاه گوارش توصیف از طریق تاریخچه commit به عقب برمی گردیم
commit اجدادی را پیدا کنید که برچسب گذاری شده است. تگ جد خروجی همراه خواهد بود
با مخفف SHA-1 ورودی commit-ish. اگر --اولین والد سپس مشخص شد
پیاده روی فقط اولین والد هر commit را در نظر می گیرد.

اگر در طول پیاده روی چندین تگ پیدا شد، برچسبی که کمترین تعداد را دارد، متعهد می شود
متفاوت از ورودی commit-ish انتخاب و خروجی خواهد شد. در اینجا کمترین متعهد هستند
different به عنوان تعداد commit هایی تعریف می شود که با تگ git log..input نشان داده می شود
کمترین تعداد تعهد ممکن خواهد بود.

GIT

بخشی از دستگاه گوارش(1) سوئیت

با استفاده از خدمات onworks.net از git-describe آنلاین استفاده کنید