GIT-FMT-MERGE-MSG(1) Git Manual GIT-FMT-MERGE-MSG(1)

git-fmt-merge-msg - تولید پیام ادغام استاندارد در گیت

git fmt-merge-msg [-m <message>] [--into-name <branch>] [--log[=<n>] | --no-log]
git fmt-merge-msg [-m <message>] [--log[=<n>] | --no-log] -F <file>

فهرست اشیاء ادغام‌شده را از ورودی استاندارد (stdin) دریافت کرده و یک پیام کامیت مناسب برای استفاده در کامیت ادغام تولید می‌کند، که معمولاً به عنوان آرگومان <merge-message> به دستور git merge ارسال می‌شود.

این دستور بیشتر برای استفاده داخلی اسکریپت‌هایی در نظر گرفته شده است که به صورت خودکار git merge را فراخوانی می‌کنند.

--log[=<n>]

علاوه بر نام شاخه‌ها، پیام گزارش (log) را با توضیحات یک‌خطی حاصل از کامیت‌های واقعی در حال ادغام پر می‌کند. حداکثر به تعداد <n> کامیت از هر والد ادغام استفاده خواهد شد (در صورت حذف <n>، مقدار پیش‌فرض ۲۰ است). این گزینه بر متغیر پیکربندی merge.log ارجحیت دارد.

--no-log

توضیحات یک‌خطی کامیت‌های واقعی در حال ادغام را در فهرست درج نمی‌کند.

--summary, --no-summary

مترادف‌هایی برای --log و --no-log؛ این گزینه‌ها منسوخ شده‌اند و در آینده حذف خواهند شد.

-m <message>, --message <message>

از <message> به جای نام شاخه‌ها برای سطر اول پیام لاگ استفاده می‌کند. برای استفاده همراه با --log.

--into-name <branch>

پیام ادغام را به گونه‌ای آماده می‌کند که گویی ادغام در شاخه <branch> انجام می‌شود، به جای نام شاخه واقعی که ادغام در آن صورت می‌گیرد.

-F <file>, --file <file>

فهرست اشیاء ادغام‌شده را به جای ورودی استاندارد (stdin) از <file> دریافت می‌کند.

merge.branchdesc

علاوه بر نام شاخه‌ها، پیام لاگ را با متن توضیحات شاخه مرتبط با آن‌ها پر می‌کند. مقدار پیش‌فرض false است.

merge.log

علاوه بر نام شاخه‌ها، پیام لاگ را حداکثر با تعداد مشخص‌شده‌ای از توضیحات یک‌خطی حاصل از کامیت‌های واقعی در حال ادغام پر می‌کند. مقدار پیش‌فرض false است، و true مترادفی برای ۲۰ است.

merge.suppressDest

با افزودن یک الگو (glob) منطبق با نام شاخه‌های یکپارچه‌سازی به این متغیر پیکربندی چندمقداره، در پیام ادغام پیش‌فرضی که برای ادغام در این شاخه‌های یکپارچه‌سازی محاسبه می‌شود، عبارت "into <branch-name>" از عنوان آن حذف خواهد شد.

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

merge.summary

مترادفی برای merge.log؛ این متغیر منسوخ شده است و در آینده حذف خواهد شد.

$ git fetch origin master
$ git fmt-merge-msg --log <$GIT_DIR/FETCH_HEAD

چاپ یک پیام لاگ که ادغام شاخه "master" از ریموت "origin" را توصیف می‌کند.

git-merge(1)

بخشی از مجموعه git(1)

2026-06-29 Git 2.55.0