.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.TH cog-bump 1 "" "cog-bump" "دستورات کاربر"
.SH "نام (NAME)"
cog-bump \- ثبت گزارش تغییرات از آخرین برچسب تا HEAD و ایجاد برچسب جدید
.SH "خلاصه دستور (SYNOPSIS)"
\fBcog\-bump\fR [\fB\-\-version\fR] [\fB\-a\fR|\fB\-\-auto\fR] [\fB\-M\fR|\fB\-\-major\fR] [\fB\-m\fR|\fB\-\-minor\fR] [\fB\-p\fR|\fB\-\-patch\fR] [\fB\-\-pre\fR] [\fB\-\-build\fR] [\fB\-H\fR|\fB\-\-hook\-profile\fR] [\fB\-\-package\fR] [\fB\-A\fR|\fB\-\-annotated\fR] [\fB\-d\fR|\fB\-\-dry\-run\fR] [\fB\-\-skip\-ci\fR] [\fB\-\-skip\-ci\-override\fR] [\fB\-\-skip\-untracked\fR] [\fB\-\-disable\-bump\-commit\fR] [\fB\-\-include\-packages\fR] [\fB\-h\fR|\fB\-\-help\fR]
.SH "توضیحات (DESCRIPTION)"
دستور
.B cog\-bump
تغییرات پروژه (changelog) را از آخرین برچسب (tag) تا نقطه فعلی (HEAD) در قالب یک کامیت ثبت کرده و برچسب نسخه جدیدی ایجاد می‌کند.
.SH "گزینه‌ها (OPTIONS)"
.TP
\fB\-\-version\fR \fI<VERSION>\fR
تنظیم دستی نسخه هدف.
.TP
\fB\-a\fR, \fB\-\-auto\fR
پیشنهاد خودکار نسخه هدف بر اساس تاریخچه کامیت‌ها.
.TP
\fB\-M\fR, \fB\-\-major\fR
افزایش نسخه اصلی (major version).
.TP
\fB\-m\fR, \fB\-\-minor\fR
افزایش نسخه فرعی (minor version).
.TP
\fB\-p\fR, \fB\-\-patch\fR
افزایش نسخه وصله (patch version).
.TP
\fB\-\-pre\fR [\fI<PRE>\fR]
تنظیم نسخه پیش‌انتشار (مانند \*(Aqbeta.1\*(Aq).
.sp
یا افزایش نسخه بر اساس یک الگو (مانند \*(Aqbeta.*\*(Aq).
.sp
در صورت عدم ارائه مقدار، از پیش‌انتشار تعریف‌شده در \fBcog.toml\fR استفاده می‌شود.
.TP
\fB\-\-build\fR \fI<BUILD>\fR
تنظیم پسوند ساخت (build suffix).
.TP
\fB\-H\fR, \fB\-\-hook\-profile\fR \fI<HOOK_PROFILE>\fR
مشخص کردن پروفایل قلاب‌ها (hook profile) برای اجرا در هنگام ارتقای نسخه.
.TP
\fB\-\-package\fR \fI<PACKAGE>\fR
مشخص کردن بسته‌ای که باید در یک مخزن چندگانه (monorepo) ارتقا یابد.
.TP
\fB\-A\fR, \fB\-\-annotated\fR \fI<ANNOTATED>\fR
ایجاد برچسب یادداشت‌دار (annotated tag) با پیام مشخص‌شده.
.TP
\fB\-d\fR, \fB\-\-dry\-run\fR
اجرای آزمایشی: تنها نمایش نسخه هدف بدون انجام هیچ عملیاتی.
.TP
\fB\-\-skip\-ci\fR
افزودن رشته \fBskip\-ci\fR تعریف‌شده در \fBcog.toml\fR (یا مقدار پیش‌فرض \fB[skip ci]\fR) به کامیت ارتقای نسخه.
.TP
\fB\-\-skip\-ci\-override\fR \fI<SKIP_CI_OVERRIDE>\fR
بازنویسی و افزودن رشته \fBskip\-ci\fR با مقدار ارائه‌شده به کامیت ارتقای نسخه.
.TP
\fB\-\-skip\-untracked\fR
عدم توقف در صورت وجود فایل‌های پیگیری‌نشده (untracked) یا کامیت‌نشده (uncommitted).
.TP
\fB\-\-disable\-bump\-commit\fR
غیرفعال کردن ایجاد کامیت ارتقای نسخه.
.TP
\fB\-\-include\-packages\fR
ارتقای هم‌زمان بسته‌ها در ارتقای دستی نسخه.
.sp
رفتار پیش‌فرض گزینه‌های \fB\-\-patch\fR، \fB\-\-minor\fR، \fB\-\-major\fR و \fB\-\-version\fR را که فقط نسخه عمومی مخازن چندگانه (monorepos) را ارتقا می‌دهند بازنویسی می‌کند. این گزینه برای ارتقا به نسخه 1.0.0 بسیار کاربردی است.
.TP
\fB\-h\fR, \fB\-\-help\fR
نمایش پیام راهنما (مشاهده خلاصه با \*(Aq\-h\*(Aq).
.SH "همچنین ببینید (SEE ALSO)"
.BR cog (1),
.BR cog\-check (1),
.BR cog\-get\-version (1),
.BR cog\-verify (1),
.BR git (1)