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

برنامه:

نام

git-notes - یادداشت های شی را اضافه یا بررسی کنید

خلاصه

دستگاه گوارش یادداشت ها [لیست [ ]]
دستگاه گوارش یادداشت ها اضافه کردن [-f] [--allow-empty] [-F | -m | (-c | -C) ] [ ]
دستگاه گوارش یادداشت ها کپی [-f] (-stdin | )
دستگاه گوارش یادداشت ها اضافه کردن [--allow-empty] [-F | -m | (-c | -C) ] [ ]
دستگاه گوارش یادداشت ها ویرایش [--اجازه دادن-خالی] [ ]
دستگاه گوارش یادداشت ها نشان دادن [ ]
دستگاه گوارش یادداشت ها ادغام [-v | -q] [-s ]
دستگاه گوارش یادداشت ها ادغام --commit [-v | -q]
دستگاه گوارش یادداشت ها ادغام --abort [-v | -q]
دستگاه گوارش یادداشت ها حذف [--نادیده-نبود] [--stdin] [ ...]
دستگاه گوارش یادداشت ها هرس [-n | -v]
دستگاه گوارش یادداشت ها دریافت رفر

شرح

یادداشت های متصل به اشیاء را بدون دست زدن به اشیا اضافه می کند، حذف می کند یا می خواند
خودشان

به طور پیش‌فرض، یادداشت‌ها در refs/notes/commits ذخیره و خوانده می‌شوند، اما این پیش‌فرض می‌تواند
لغو شد. بخش OPTIONS، CONFIGURATION و ENVIRONMENT را در زیر ببینید. اگر این رفر
وجود ندارد، هنگامی که برای اولین بار برای ذخیره یک یادداشت مورد نیاز باشد، بی سر و صدا ایجاد می شود.

یک استفاده معمولی از یادداشت ها تکمیل پیام commit بدون تغییر commit است
خود یادداشت ها را می توان توسط دستگاه گوارش ورود به سیستم به همراه پیام اصلی commit. به
این یادداشت ها را از پیام ذخیره شده در شی commit متمایز کنید، یادداشت ها هستند
تورفتگی مانند پیام، پس از یک خط بدون تورفتگی که می گوید "یادداشت ها ( ):" (یا
"یادداشت:" برای refs/notes/commits).

یادداشت ها را می توان با استفاده از --notes به وصله های آماده شده با git format-patch نیز اضافه کرد
گزینه. چنین یادداشت هایی به عنوان یک تفسیر وصله پس از یک خط جداکننده سه خط تیره اضافه می شوند.

برای تغییر اینکه کدام یادداشت نشان داده می شود دستگاه گوارش ورود به سیستم، پیکربندی "notes.displayRef" را در اینجا ببینید
گیت(1).

به "یادداشت ها. بازنویسی" مراجعه کنید. "پیکربندی برای راهی برای انتقال یادداشت ها در میان دستورات
که بازنویسی متعهد می شود.

دستورات فرعی

فهرست
شی یادداشت ها را برای یک شی معین فهرست کنید. اگر هیچ شیئی داده نشده است، فهرستی از همه را نشان دهید
یادداشت اشیاء و اشیایی که آنها حاشیه نویسی می کنند (در قالب "
object>"). اگر دستور فرعی داده نشود، این دستور فرعی پیش فرض است.

اضافه کردن
اضافه کردن یادداشت برای یک شی داده شده (به طور پیش فرض به HEAD). اگر شی از قبل دارای یادداشت باشد، لغو شود
(از -f برای بازنویسی یادداشت های موجود استفاده کنید). با این حال، اگر از افزودن به صورت تعاملی استفاده می کنید
(استفاده از یک ویرایشگر برای تهیه محتوای یادداشت ها)، سپس - به جای سقط کردن -
یادداشت های موجود در ویرایشگر باز می شوند (مانند دستور فرعی ویرایش).

کپی کنید
یادداشت های شی اول را روی شی دوم کپی کنید. اگر شی دوم را لغو کنید
قبلاً یادداشت‌هایی دارد، یا اگر شی اولی هیچ یادداشتی نداشته باشد (از -f برای بازنویسی یادداشت‌های موجود استفاده کنید
به شی دوم). این دستور فرعی معادل است: git notes add [-f] -C $(git
لیست یادداشت ها )

در حالت --stdin، خطوط را با فرمت بگیرید

SP [ SP ] LF

روی ورودی استاندارد، و یادداشت ها را از هر کدام کپی کنید به متناظر آن
. (اختیاری نادیده گرفته می شود تا دستور بتواند ورودی را بخواند
به قلاب پس از بازنویسی داده شده است.)

ضمیمه کردن
به یادداشت های یک شی موجود اضافه کنید (به طور پیش فرض HEAD). یک یادداشت جدید ایجاد می کند
در صورت نیاز اعتراض کنید

ویرایش کنید
یادداشت ها را برای یک شی معین ویرایش کنید (به طور پیش فرض HEAD).

نشان
نت‌ها را برای یک شی معین نشان دهید (پیش‌فرض HEAD).

ادغام کردن
یادداشت های داده شده ref را با یادداشت های فعلی ref ادغام کنید. این تلاش خواهد کرد تا ادغام شود
تغییرات ایجاد شده توسط یادداشت های داده شده (به نام "راه دور") از زمان ادغام پایه (در صورت وجود)
را به یادداشت های جاری ref (به نام "محلی").

در صورت بروز تضاد و استراتژی برای حل خودکار یادداشت های متضاد (نگاه کنید به
بخش "راهبردهای ادغام یادداشت ها") داده نشده است، از حل کننده "دستی" استفاده می شود.
این حل کننده یادداشت های متناقض را در یک درخت کاری ویژه بررسی می کند
(.git/NOTES_MERGE_WORKTREE)، و به کاربر دستور می دهد تضادها را به صورت دستی حل کند
آنجا. پس از اتمام، کاربر می تواند ادغام با را نهایی کند دستگاه گوارش یادداشت ها ادغام کردن
--مرتکب شدن، یا ادغام با را لغو کنید دستگاه گوارش یادداشت ها ادغام کردن -- سقط.

برداشتن
یادداشت های مربوط به اشیاء داده شده را حذف کنید (به طور پیش فرض HEAD). هنگام دادن صفر یا یک شی
از خط فرمان، این معادل تعیین یک پیام یادداشت خالی به
دستور فرعی را ویرایش کنید

پروانه
تمام یادداشت‌ها را برای اشیاء غیرقابل دسترس/غیرقابل دسترسی حذف کنید.

دریافت رفر
چاپ یادداشت های فعلی ref. این یک راه آسان برای بازیابی یادداشت های فعلی فراهم می کند
ref (به عنوان مثال از اسکریپت).

OPTIONS

-f، -- نیرو
هنگام اضافه کردن یادداشت به یک شی که قبلاً یادداشت دارد، یادداشت های موجود را بازنویسی کنید
(به جای سقط).

-m ، --پیام=
از پیام یادداشت داده شده (به جای درخواست) استفاده کنید. اگر چندین گزینه -m داده شود،
مقادیر آنها به عنوان پاراگراف های جداگانه به هم متصل می شوند. خطوطی که با # شروع می شوند و خالی هستند
خطوطی غیر از یک خط بین پاراگراف ها حذف خواهند شد.

-اف ، --file=
پیام یادداشت را از فایل داده شده بگیرید. استفاده کنید - برای خواندن پیام یادداشت از
ورودی استاندارد خطوطی که با # شروع می‌شوند و خطوط خالی به غیر از یک خط بین
پاراگراف ها حذف خواهند شد.

-C ، --reuse-message=
شی blob داده شده (به عنوان مثال، یادداشت دیگری) را به عنوان پیام یادداشت در نظر بگیرید. (از git استفاده کنید
کپی یادداشت ها به جای کپی کردن یادداشت ها بین اشیا.)

-ج ، --reedit-message=
پسندیدن -C، اما با -c ویرایشگر فراخوانی می شود تا کاربر بتواند یادداشت را بیشتر ویرایش کند
پیام

--اجازه-خالی
اجازه دهید یک شی یادداشت خالی ذخیره شود. رفتار پیش فرض به صورت خودکار است
حذف یادداشت های خالی

--مرجع
درخت نت ها را در آن دستکاری کنید . این نادیده می گیرد GIT_NOTES_REF و
پیکربندی "core.notesRef". ref زمانی که با آن شروع می شود نام ref کامل را مشخص می کند
refs/notes/; وقتی با notes/ شروع می شود، refs/ و در غیر این صورت refs/notes/ پیشوند است
برای تشکیل نام کامل مرجع.

--نادیده گرفتن-غایب
درخواست حذف یادداشت‌ها از شیئی که این کار را نمی‌کند، خطا در نظر نگیرید
یادداشت هایی به آن پیوست داشته باشید.

--stdin
همچنین نام اشیاء را بخوانید تا یادداشت ها را از ورودی استاندارد حذف کنید (هیچ
دلیل اینکه نمی توانید این را با نام اشیاء از خط فرمان ترکیب کنید).

-n، --dry-run
چیزی را حذف نکنید؛ فقط نام اشیایی را گزارش کنید که یادداشت های آنها حذف می شود.

-s ، --استراتژی=
هنگام ادغام یادداشت ها، تضاد یادداشت ها را با استفاده از استراتژی داده شده حل کنید. به شرح زیر
استراتژی‌ها شناسایی می‌شوند: «دستی» (پیش‌فرض)، «مال ما»، «آنها»، «اتحادیه» و
"cat_sort_uniq". این گزینه پیکربندی "notes.mergeStrategy" را لغو می کند
تنظیمات. برای کسب اطلاعات بیشتر در مورد هر یک، بخش "راهبردهای ادغام یادداشت ها" را در زیر ببینید
استراتژی ادغام یادداشت ها

--مرتکب شدن
نهایی کردن یک در حال پیشرفت دستگاه گوارش یادداشت ها ادغام کردن. وقتی مشکل را حل کردید از این گزینه استفاده کنید
درگیری دارد که دستگاه گوارش یادداشت ها ادغام کردن ذخیره شده در git/NOTES_MERGE_WORKTREE. این اصلاح می کند
commit ادغام جزئی ایجاد شده توسط دستگاه گوارش یادداشت ها ادغام کردن (ذخیره شده در git/NOTES_MERGE_PARTIAL.)
با افزودن یادداشت‌ها در git/NOTES_MERGE_WORKTREE. یادداشت ها در ref ذخیره می شوند
.git/NOTES_MERGE_REF symref به commit حاصل به روز می شود.

-- سقط
لغو/بازنشانی در حال انجام دستگاه گوارش یادداشت ها ادغام کردن، یعنی یک یادداشت با تضادها ادغام می شود. این
به سادگی تمام فایل های مربوط به ادغام یادداشت ها را حذف می کند.

-q، --آرام
هنگام ادغام یادداشت ها، بی سر و صدا عمل کنید.

-v، -- پرحرف
هنگام ادغام یادداشت ها، بیشتر پرحرف باشید. هنگام هرس کردن یادداشت ها، نام همه اشیاء را گزارش کنید
یادداشت ها حذف می شوند

بحث

یادداشت های commit حباب هایی هستند که حاوی اطلاعات اضافی درباره یک شی (معمولاً اطلاعات) هستند
برای تکمیل پیام یک commit). این حباب ها از یادداشت های refs گرفته شده اند. یک یادداشت مرجع است
معمولاً شاخه ای که حاوی "فایل هایی" است که مسیرهای آن نام اشیاء برای اشیاء است
آنها توصیف می کنند، با برخی از جداکننده های دایرکتوری به دلایل عملکرد [1].

هر تغییر نت ها یک commit جدید در نت های مشخص شده ایجاد می کند. بنابراین شما می توانید
تاریخچه یادداشت ها را با فراخوانی، به عنوان مثال، git log -p notes/commits بررسی کنید. در حال حاضر
پیام commit فقط ثبت می کند که کدام عملیات باعث به روز رسانی و commit شده است
نویسندگی طبق قوانین معمول تعیین می شود (نگاه کنید به git-commit(1)). این جزئیات
ممکن است در آینده تغییر کند.

همچنین مجاز است که یک یادداشت ref مستقیماً به یک شی درخت اشاره کند، در این صورت
تاریخچه نت ها را می توان با git log -p -g خواند .

NOTES ادغام استراتژی ها

استراتژی ادغام یادداشت‌های پیش‌فرض «دستی» است که یادداشت‌های متضاد را در a بررسی می‌کند
درخت کاری ویژه برای حل تداخل یادداشت ها (.git/NOTES_MERGE_WORKTREE) و دستورات
کاربر برای حل تضادها در آن درخت کاری. پس از اتمام، کاربر می تواند هر دو
نهایی کردن ادغام با دستگاه گوارش یادداشت ها ادغام کردن --مرتکب شدن، یا ادغام با را لغو کنید دستگاه گوارش یادداشت ها ادغام کردن
-- سقط.

کاربران می توانند یک استراتژی ادغام خودکار را از بین موارد زیر با استفاده از یکی انتخاب کنند
گزینه -s/--strategy یا پیکربندی notes.mergeStrategy بر این اساس:

"ما" به طور خودکار یادداشت های متناقض را به نفع نسخه محلی حل می کند (یعنی
یادداشت های فعلی رفرنس).

"آنها" به طور خودکار تداخل یادداشت ها را به نفع نسخه راه دور حل می کند (یعنی
یادداشت‌های داده‌شده ref در حال ادغام در یادداشت‌های فعلی ref).

"اتحادیه" به طور خودکار تضاد یادداشت ها را با به هم پیوستن محلی و راه دور حل می کند
نسخه ها

«cat_sort_uniq» شبیه «اتحاد» است، اما علاوه بر الحاق کلمه محلی و
در نسخه های راه دور، این استراتژی همچنین خطوط حاصل را مرتب می کند و خطوط تکراری را حذف می کند
از نتیجه این معادل اعمال خط لوله پوسته "cat | sort | uniq" است
نسخه های محلی و راه دور این استراتژی در صورتی مفید است که یادداشت‌ها از یک خط مبتنی بر خط پیروی کنند
قالبی که در آن فرد می خواهد از خطوط تکراری در نتیجه ادغام جلوگیری کند. توجه داشته باشید که اگر هر کدام
نسخه محلی یا راه دور حاوی خطوط تکراری قبل از ادغام است، اینها نیز خواهند بود
حذف شده توسط این یادداشت استراتژی ادغام.

مثال ها

می‌توانید از یادداشت‌ها برای اضافه کردن حاشیه‌نویسی با اطلاعاتی که در آن زمان در دسترس نبودند استفاده کنید
commit نوشته شد

$ git notes add -m 'تست شده توسط: Johannes Sixt[ایمیل محافظت شده]>' 72a144e2
$ git show -s 72a144e
[...]
امضا شده توسط: جونیو سی هامانو[ایمیل محافظت شده]>

یادداشت:
تست شده توسط: یوهانس سیکست[ایمیل محافظت شده]>

در اصل، یک یادداشت یک حباب Git معمولی است و هر نوع (غیر) قالبی پذیرفته می شود. شما
می تواند به صورت باینری با استفاده از فایل های دلخواه یادداشت ایجاد کند دستگاه گوارش هش شی:

$ سی سی *.c
$ blob=$(git hash-object -w a.out)
$ git notes --ref=built add --allow-empty -C "$blob" HEAD

(شما نمی توانید به سادگی از git notes --ref=built add -F a.out HEAD استفاده کنید زیرا اینطور نیست
باینری-ایمن.) البته، نمایش یادداشت های بدون فرمت متنی با
دستگاه گوارش ورود به سیستم، بنابراین اگر از چنین یادداشت هایی استفاده می کنید، احتمالاً باید هدف خاصی بنویسید
ابزاری برای انجام کار مفید با آنها

پیکربندی

core.notesRef
یادداشت ها برای خواندن و دستکاری به جای refs/notes/commits رجوع می کنند. باید یک
نام مرجع نام اختصار این تنظیم را می توان از طریق محیط و
خط فرمان.

notes.mergeStrategy
کدام استراتژی ادغام را به طور پیش‌فرض هنگام حل تداخل یادداشت‌ها انتخاب کنید. باید یکی باشه
کتابچه راهنمای کاربر، مال ما، آنها، اتحادیه، یا cat_sort_uniq. پیش‌فرض به حالت دستی. به «ادغام یادداشت‌ها» مراجعه کنید
استراتژی ها" بخش بالا برای اطلاعات بیشتر در مورد هر استراتژی.

این تنظیمات را می توان با عبور از گزینه --strategy لغو کرد.

یادداشت. mergeStrategy
کدام استراتژی ادغام را انتخاب کنید هنگام انجام یک یادداشت ادغام در refs/notes/ . این
کلیتر "notes.mergeStrategy" را لغو می کند. به "راهبردهای ادغام یادداشت ها" مراجعه کنید
بخش بالا برای اطلاعات بیشتر در مورد هر استراتژی موجود.

notes.displayRef
کدام ref (یا refs، اگر یک glob یا مشخص شده بیش از یک بار)، علاوه بر پیش فرض
تنظیم شده توسط core.notesRef یا GIT_NOTES_REF، برای خواندن یادداشت ها هنگام نمایش پیام های commit
با دستگاه گوارش ورود به سیستم خانواده دستورات این تنظیم را می توان روی دستور لغو کرد
خط یا توسط GIT_NOTES_DISPLAY_REF متغیر محیطی. دیدن گیت(1).

یادداشت ها.بازنویسی
هنگام بازنویسی با (در حال حاضر اصلاح یا تغییر پایه)، اگر این متغیر است
false، git یادداشت ها را از نسخه اصلی به commit بازنویسی شده کپی نمی کند. پیش فرض به
درست است، واقعی. همچنین به "notes.rewriteRef" در زیر مراجعه کنید.

این تنظیم را می توان با استفاده از GIT_NOTES_REWRITE_REF متغیر محیطی.

notes.rewriteMode
هنگام کپی کردن یادداشت ها در حین بازنویسی، اگر commit هدف قبلاً یک علامت داشته باشد، چه باید کرد
توجه داشته باشید. باید یکی از رونویسی، الحاق، cat_sort_uniq، یا نادیده گرفته شود. پیش فرض به
به هم پیوستن

این تنظیم را می توان با متغیر محیطی GIT_NOTES_REWRITE_MODE لغو کرد.

notes.rewriteRef
هنگام کپی کردن یادداشت ها در حین بازنویسی، مرجع (کاملاً واجد شرایط) یادداشت های آن را مشخص می کند
باید کپی شود ممکن است یک glob باشد، در این صورت یادداشت ها در تمام داوری های منطبق خواهند بود
کپی شده همچنین می توانید چندین بار این پیکربندی را مشخص کنید.

مقدار پیش فرض ندارد. شما باید این متغیر را برای فعال کردن note پیکربندی کنید
بازنویسی

را می توان با GIT_NOTES_REWRITE_REF متغیر محیطی.

محیط زیست

GIT_NOTES_REF
از کدام مرجع به جای refs/notes/commits، یادداشت‌ها را دستکاری کنید. این موضوع را نادیده می گیرد
تنظیم core.notesRef.

GIT_NOTES_DISPLAY_REF
فهرستی از ref‌ها یا glob‌های محدود شده با دو نقطه که نشان می‌دهد کدام مرجع، علاوه بر
پیش فرض از core.notesRef یا GIT_NOTES_REF، برای خواندن یادداشت ها هنگام نمایش commit
پیام ها. این تنظیمات notes.displayRef را لغو می کند.

برای داورهایی که وجود ندارند، اما گلوبی که مطابقت ندارند، هشدار صادر خواهد شد
هر داوری در سکوت نادیده گرفته می شود.

GIT_NOTES_REWRITE_MODE
هنگام کپی کردن یادداشت ها در حین بازنویسی، اگر commit هدف قبلاً یک علامت داشته باشد، چه باید کرد
توجه داشته باشید. باید یکی از رونویسی، الحاق، cat_sort_uniq، یا نادیده گرفته شود. این نادیده می گیرد
تنظیم core.rewriteMode.

GIT_NOTES_REWRITE_REF
هنگام بازنویسی commit ها، که یادداشت ها را از نسخه اصلی به commit بازنویسی شده کپی کنید.
باید فهرستی از refs یا glob با دو نقطه مشخص باشد.

اگر در محیط تنظیم نشده باشد، لیست یادداشت هایی که باید کپی کنید به آن بستگی دارد
یادداشت ها.بازنویسی و تنظیمات notes.rewriteRef.

GIT

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

NOTES

1. نام مسیرهای مجاز دارای فرم هستند ab/cd/ef/.../abcdef...: دنباله ای از دایرکتوری
نام دو رقم هگزا دسیمال که هر کدام یک نام فایل به همراه بقیه رقم ها را به دنبال دارد
شناسه شی

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