darcs - آنلاین در ابر

برنامه:

نام

دارک - یک سیستم کنترل بازنگری پیشرفته

خلاصه

دارک فرمان <استدلال|[گزینه های]>...

کجاست؟ دستورات و مربوط به آنها استدلال هستند

دارک کمک [<دارک_فرمان> [دارک_دستور فرعی]]
دارک اضافه کردن <پرونده|فهرست راهنما> ...
دارک برداشتن <پرونده|فهرست راهنما> ...
دارک حرکت <منبع>...مقصد>
دارک جایگزین کردن <قدیمی>جدید>پرونده> ...
دارک برگرداندن [پرونده|فهرست راهنما] ...
دارک بازگرداندن
دارک چه خبر [پرونده|فهرست راهنما] ...
دارک رکورد [پرونده|فهرست راهنما] ...
دارک ثبت نشده
دارک اصلاح [پرونده|فهرست راهنما] ...
دارک تضادهای علامت
دارک برچسب [نام برچسب]
دارک setpref <ترجیح>ارزش>
دارک تفاوت [پرونده|فهرست راهنما] ...
دارک ورود به سیستم [پرونده|فهرست راهنما] ...
دارک حاشیه نویسی [پرونده|فهرست راهنما] ...
دارک ناحیه
دارک آزمون [[مقدار دهی اولیه] فرمان]
دارک نشان محتویات [پرونده] ...
دارک نشان فایل ها [پرونده|فهرست راهنما] ...
دارک نشان شاخص
دارک نشان تر و تازه
دارک نشان مخزن
دارک نشان نویسندگان
دارک نشان برچسب ها
دارک نشان Patch-index-all
دارک نشان فایل های patch-index
دارک نشان patch-index-status
دارک نشان Patch-index-test
دارک کشیدن [مخزن] ...
دارک رفتن و آوردن [مخزن] ...
دارک از بین بردن
دارک عقبگرد [پرونده|فهرست راهنما] ...
دارک فشار [مخزن]
دارک ارسال [مخزن]
دارک درخواست <پچ فایل>
دارک کلون کردن <مخزن> [فهرست راهنما>]
دارک مقداردهی اولیه [<فهرست راهنما>]
دارک بهینه سازی تمیز
دارک بهینه سازی HTTP
دارک بهینه سازی ترتیب مجدد
دارک بهینه سازی enable-patch-index
دارک بهینه سازی disable-patch-index
دارک بهینه سازی فشرده کردن
دارک بهینه سازی فشرده سازی نکردن
دارک بهینه سازی پیوند مجدد
دارک بهینه سازی تر و تازه
دارک بهینه سازی ارتقاء
دارک بهینه سازی نهانگاه <فهرست راهنما> ...
دارک تعمیر
دارک تبدیل دارک-2 <منبع> [مقصد>]
دارک تبدیل صادرات
دارک تبدیل واردات [<فهرست راهنما>]
دارک تخفیف کشیدن [مخزن] ...
دارک تخفیف درخواست <پچ فایل>
دارک تخفیف تعلیق
دارک تخفیف لغو تعلیق
دارک تخفیف از بین بردن
دارک تخفیف ورود به سیستم

شرح

Darcs یک سیستم کنترل بازنگری رایگان و متن باز است. این است:

· توزیع شده: هر کاربر به مجموعه دستورات کامل دسترسی دارد و مرزهای بین را حذف می کند
سرور و کلاینت یا committer و non-committer.

· تعاملی: یادگیری Darcs آسان است و استفاده از آن کارآمد است زیرا از شما سؤال می پرسد
در پاسخ به دستورات ساده، انتخاب هایی را در جریان کار به شما می دهد. شما می توانید انتخاب کنید
یک تغییر را در یک فایل ثبت کنید، در حالی که دیگری را نادیده بگیرید. همانطور که از بالادست به روز می کنید، شما
می تواند نام هر پچ را بررسی کند، حتی "تفاوت" کامل را برای وصله های جالب.

· هوشمند: در اصل توسط فیزیکدان دیوید راندی توسعه یافته است، دارک بر اساس منحصر به فرد است
جبر وصله ها این هوشمندی به شما این امکان را می‌دهد تا به خواسته‌های در حال تغییر پاسخ دهید
در غیر این صورت ممکن نخواهد بود. درباره شاخه های خود به خود با دارک بیشتر بدانید.

OPTIONS

گزینه های مختلف با دستورات مختلف دارک پذیرفته می شوند. هر فرمان مهم ترین است
گزینه ها در فهرست شده اند دستورات بخش. برای یک لیست کامل از همه گزینه های پذیرفته شده توسط a
دستور خاص، Darcs را اجرا کنید فرمان --کمک'.

انتخاب وصله ها:
گزینه --patches وصله هایی با نام مطابق با عبارت منظم *extended* را به دست می دهد.
دیدن regex(7) برای جزئیات. گزینه --matches وصله هایی را به دست می دهد که با یک منطقی مطابقت دارند
عبارت (بولی): یک یا چند عبارت ابتدایی که با گروه بندی (پرانتز) ترکیب شده اند.
و عملگرهای متمم (نه)، ربط (و) و منفصل (یا). سی
علامت گذاری برای عملگرهای منطقی (!، && و ||) نیز می تواند استفاده شود.

- --patches=regex مترادف --matches='name regex' - --hash=HASH مترادف برای
--matches='hash HASH' - --from-patch و --to-patch مترادف های --from-match='name...
و --to-match='name... - --from-patch و --to-match می توانند بدون مشکل با هم ترکیب شوند:
«دارک تغییرات --from-patch='html.*documentation' --to-match='date 20040212'`

عبارات بولی اولیه زیر پشتیبانی می شوند:

- exact - یک رشته تحت اللفظی را در برابر نام پچ بررسی کنید. - نام - به طور منظم چک کنید
عبارت در برابر نام پچ - نویسنده - یک عبارت منظم را در برابر آن بررسی کنید
نام نویسنده. - hunk - یک عبارت منظم را در برابر محتویات یک پچ hunk بررسی کنید. -
نظر - یک عبارت منظم را در برابر پیام ورود بررسی کنید. - هش - مطابقت با هش کامل
یا پیشوندی برای پچ. - تاریخ - مطابقت با تاریخ وصله. - لمس - مطابقت مسیرهای فایل برای a
پچ

در اینجا برخی از نمونه ها:

darcs annotate --summary --match 'exact "رفع مشکل 17: استفاده از حافظه پویا
تخصیص."
darcs annotate --summary -- match 'name issue17'
darcs annotate --summary --match 'name "^[Rr]esolve issue17\>"'
darcs annotate --summary --match 'نویسنده "دیوید راندی"'
darcs annotate --summary --match 'author droundy'
darcs annotate --summary --match 'author [ایمیل محافظت شده]'
darcs annotate --summary --match 'hunk "foo = 2"'
darcs annotate --summary --match 'hunk "^instance .* Foo where$"'
darcs annotate --summary --match 'Comment "جلوگیری از بن بست"'
darcs annotate --summary -- match 'hash c719567e92c3b0ab9eddd5290b705712b8b918ef'
darcs annotate --summary -- match 'hash c7195'
darcs annotate --summary --match 'date "2006-04-02 22:41"'
darcs annotate --خلاصه --مطابقت با "تاریخ "دیروز وقت چای"
darcs annotate --summary --match 'touch src/foo.c'
darcs annotate --summary --match 'touch src/'
darcs annotate --summary --match 'src/*.(c|h)"'

دستورات

دارک کمک [<دارک_فرمان> [دارک_دستور فرعی]]
بدون آرگومان، «darcs help» فهرست دسته‌بندی‌شده‌ای از دستورات darcs و a را چاپ می‌کند
شرح مختصری از هر کدام با یک آرگومان اضافی، «darcs help foo» چاپ می‌کند
راهنمایی دقیق در مورد دستور darcs foo.

تغییر دادن و پرس و جو la کارگر کپی:
دارک اضافه کردن <پرونده|فهرست راهنما> ...
به طور کلی یک مخزن شامل هر دو فایلی است که باید نسخه کنترل شوند (مانند
کد منبع) و فایل هایی که دارک باید نادیده بگیرد (مانند فایل های اجرایی کامپایل شده از
کد منبع). دستور «darcs add» برای اینکه به Darcs بگوید کدام فایل‌ها را نسخه کند استفاده می‌شود
کنترل.

هنگامی که یک پروژه موجود برای اولین بار به مخزن دارک وارد می شود، معمول است
«darcs add -r *» یا «darcs record -l» را اجرا کنید تا همه فایل‌های منبع اولیه را به دارک اضافه کنید.

افزودن پیوندهای نمادین (پیوندهای نمادین) پشتیبانی نمی شود.

Darcs تمام فایل‌ها و پوشه‌هایی را که به نظر «خسته‌کننده» هستند، نادیده می‌گیرد. گزینه "-- خسته کننده".
این رفتار را نادیده می گیرد.

اگر فایل دیگری در همان پوشه دارای نام مشابه باشد، Darcs فایلی را اضافه نمی کند، به جز
برای مورد گزینه «--case-ok» این رفتار را لغو می کند. ویندوز و OS X معمولا
از سیستم‌های فایلی استفاده کنید که اجازه نمی‌دهند فایل‌های یک پوشه به‌جز حروف کوچک، همنام باشند
(به عنوان مثال، «ReadMe» و «README»). اگر از «--case-ok» استفاده شود، مخزن ممکن است باشد
غیر قابل استفاده در آن سیستم ها!

دارک برداشتن <پرونده|فهرست راهنما> ...
دستور «darcs remove» عمدتاً برای تقارن با «darcs add» وجود دارد، زیرا
راه عادی برای حذف یک فایل از کنترل نسخه، به سادگی حذف آن از روی است
درخت کار این دستور فقط در موارد غیرعادی که فرد بخواهد مفید است
یک وصله حذف را بدون حذف کپی در درخت کار (که می تواند
دوباره اضافه شد).

توجه داشته باشید که اعمال یک پچ حذف در یک مخزن (مثلاً با کشیدن وصله) این کار را انجام می دهد
همیشه درخت کاری آن مخزن را تحت تأثیر قرار دهید.

دارک حرکت <منبع>...مقصد>
Darcs نمی تواند به طور قابل اعتمادی بین فایلی که حذف شده و فایل جدید اضافه شده تمایز قائل شود.
و یک فایل در حال انتقال بنابراین دارک همیشه اولی را فرض می کند و آن را فراهم می کند
دستور "darcs mv" به Darcs اطلاع می دهد که چه زمانی شما دومی را می خواهید. این دستور نیز خواهد بود
فایل را در درخت کاری جابجا کنید (برخلاف «darcs remove»)، مگر اینکه قبلاً انجام شده باشد
منتقل شد

اگر فایل دیگری در همان پوشه دارای نام مشابه باشد، Darcs نام فایلی را تغییر نخواهد داد.
به جز مورد گزینه «--case-ok» این رفتار را لغو می کند. ویندوز و OS X
معمولاً از سیستم‌های فایلی استفاده می‌کنند که به فایل‌ها اجازه نمی‌دهند یک پوشه هم نام داشته باشند به جز
برای case (به عنوان مثال، «ReadMe» و «README»). اگر از «--case-ok» استفاده شود، مخزن
ممکن است در آن سیستم ها غیر قابل استفاده باشد!

دارک جایگزین کردن <قدیمی>جدید>پرونده> ...
علاوه بر وصله های مبتنی بر خط، دارک از فرم محدودی از واژگان پشتیبانی می کند
جایگزینی فایل‌ها به‌عنوان دنباله‌ای از کلمات و هر یک از موارد قدیمی در نظر گرفته می‌شوند
کلمه با کلمه جدید جایگزین می شود. این در نظر گرفته شده است تا راهی تمیز برای تغییر نام a
تابع یا متغیر چنین تغییر نام هایی معمولاً روی خطوط در سراسر منبع تأثیر می گذارد
کد، بنابراین یک پچ مبتنی بر خط سنتی بسیار محتمل است که با موارد دیگر تضاد داشته باشد
شاخه هایی که نیاز به ادغام دستی دارند.

فایل ها بر اساس یک قانون ساده نشانه گذاری می شوند: کلمات رشته هایی از نشانه معتبر هستند
کاراکترها، و همه چیز بین آنها (نقطه نگاری و فضای خالی) کنار گذاشته می شود. توسط
پیش‌فرض، کاراکترهای رمز معتبر حروف، اعداد و خط زیر هستند (یعنی
«[A-Za-z0-9_]»). اما اگر توکن قدیمی و/یا جدید حاوی خط فاصله یا
نقطه، هر دو خط فاصله و نقطه معتبر تلقی می شوند (یعنی «[A-Za-z0-9_.-]».

مجموعه کاراکترهای معتبر را می توان با استفاده از گزینه «--token-chars» سفارشی کرد. در
آرگومان باید با پرانتز احاطه شود. اگر خط فاصله بین دو رخ دهد
کاراکترهای موجود در مجموعه، به عنوان یک محدوده مجموعه در نظر گرفته می شود. به عنوان مثال، در اکثر مناطق
«[AZ]» همه حروف بزرگ را نشان می‌دهد. اگر کاراکتر اول یک caret باشد، معتبر است
نشانه ها مکمل کاراکترهای باقی مانده در نظر گرفته می شوند. مثلا،
«[^:\n]» می‌تواند برای مطابقت دادن فیلدها در passwd(5)، جایی که رکوردها و فیلدها هستند
به ترتیب با خطوط جدید و دو نقطه از هم جدا می شوند.

اگر استفاده از «--token-chars» را انتخاب می کنید، به شدت تشویق می شوید که این کار را انجام دهید
همواره. عواقب استفاده از وصله های متعدد جایگزین با متفاوت
آرگومان های «-token-chars» در یک فایل به خوبی آزمایش نشده و به خوبی درک نشده اند.

به‌طور پیش‌فرض، اگر توکن جدید از قبل وارد شده باشد، دارک از انجام جایگزینی خودداری می‌کند
استفاده کنید، زیرا جایگزین ها از موجود قابل تشخیص نیستند
نشانه ها این رفتار را می توان با ارائه گزینه «--force» لغو کرد، اما یک
تلاش برای «بازگرداندن Darcs» پچ به‌دست‌آمده بر این توکن‌های موجود تأثیر می‌گذارد.

محدودیت ها:

توکنایزر فایل‌ها را به‌عنوان رشته‌های بایتی در نظر می‌گیرد، بنابراین برای «--token-chars» امکان‌پذیر نیست.
شامل کاراکترهای چند بایتی، مانند بخش‌های غیر ASCII UTF-8. به همین ترتیب،
تلاش برای جایگزینی یک کاراکتر "بالا بیت" از یک رمزگذاری یونی بایت نیز منجر به این خواهد شد
جایگزینی همان بایت در فایل هایی با کدهای مختلف. به عنوان مثال، یک حاد
a از ISO 8859-1 نیز با آلفای ISO 8859-7 مطابقت دارد.

به دلیل محدودیت در قالب فایل پچ، آرگومان های «--token-chars» نمی توانند شامل شوند
فضای خالی به معنای واقعی کلمه برای مثال، «[^ \n\t]» نمی تواند برای اعلام همه کاراکترها استفاده شود
به جز فاصله، تب و خط جدید که در یک کلمه معتبر هستند، زیرا حاوی a است
فضای تحت اللفظی

برخلاف POSIX regex(7) عبارات براکت، کلاس های کاراکتر (مانند `[[:alnum:]]`)
توسط "--token-chars" پشتیبانی نمی شوند و به صورت بی صدا به عنوان یک مجموعه ساده از
کاراکتر باشد.

دارک برگرداندن [پرونده|فهرست راهنما] ...
دستور "darcs revert" ثبت نشده را کنار می‌زند درخت کار را تغییر می‌دهد. همانطور که با
«دارک رکورد»، از شما سؤال می شود که کدام هانک (تغییرها) را باید برگردانید. سوئیچ «--همه».
می توان برای جلوگیری از چنین تحریکی استفاده کرد. اگر فایل ها یا دایرکتوری ها مشخص شده اند، موارد دیگر
بخش هایی از درخت کار برگردانده نمی شوند.

به طور تصادفی چیزی را که می‌خواستید نگه دارید برگردانید (مثلاً تایپ کردن «darcs
rev -a» به جای «darcs rec -a»)، می‌توانید بلافاصله «darcs unrevert» را اجرا کنید
آن را بازیابی کنید. این تنها در صورتی تضمین می شود که مخزن از آن زمان تغییر نکرده باشد
"darcs revert" اجرا شد.

دارک بازگرداندن
Unrevert یک فرمان نجات است در صورتی که به طور تصادفی چیزی را که می خواستید برگردانید
keep (به عنوان مثال، تایپ کردن «darcs rev -a» به جای «darcs rec -a»).

اگر مخزن از زمان بازگردانی تغییر کرده باشد، ممکن است این دستور شکست بخورد.
Darcs قبل از اجرای یک فرمان تعاملی درخواست تأیید می کند
قطعاً از بازگشت مجدد جلوگیری کنید.

دارک چه خبر [پرونده|فهرست راهنما] ...
دستور "darcs whatsnew" تغییرات ثبت نشده درخت کار را فهرست می کند. اگر شما
مجموعه ای از فایل ها و دایرکتوری ها را مشخص کنید، فقط تغییرات ثبت نشده آن فایل ها و
دایرکتوری ها فهرست شده اند.

با گزینه «--summary»، تغییرات به یک خط در هر فایل، با
یادگاری برای نشان دادن ماهیت و میزان تغییر. «--جستجو-برای-افزودنها».
گزینه باعث می شود کاندیدهای «darcs add» در خروجی خلاصه گنجانده شوند.
خلاصه یادگاری به شرح زیر است:

* "A f" و "A d/" به ترتیب به معنی یک فایل یا فهرست اضافه شده هستند. * 'R f' و 'R d/'
به ترتیب به معنی یک فایل یا فهرست حذف شده است. * "M f -N +M rP" به معنای تغییر یافته است
فایل، با خطوط «N» حذف شده، «M».
خطوط اضافه شده و جایگزین‌های واژگانی «P». * 'f -> g' به معنی یک فایل جابجا شده یا
فهرست راهنما. * "af" و "ad/" به ترتیب به معنی یک فایل جدید، اما اضافه نشده یا
دایرکتوری، هنگام استفاده از «--look-for-adds».

یک علامت تعجب (!) مانند «R! foo.c` به این معنی است که هنک به آن شناخته شده است
درگیری با یک قطعه در وصله دیگر. عبارت "تکراری".
به این معنی است که هانک با یک هانک در پچ دیگر یکسان است.

به طور پیش‌فرض، «darcs whatsnew» از قالب داخلی Darcs برای تغییرات استفاده می‌کند. برای دیدن برخی
زمینه (خطوط بدون تغییر) در اطراف هر تغییر، از گزینه «--unified» استفاده کنید. برای مشاهده
تغییرات در فرمت معمولی "diff"، از دستور "darcs diff" استفاده کنید. اما توجه داشته باشید که
"darcs whatsnew" سریعتر است.

اگر دستوری وجود نداشته باشد، این دستور ناموفق خارج می شود (وضعیت خروج غیر صفر را برمی گرداند).
تغییرات ثبت نشده

کپی برداری تغییرات میان la کارگر کپی کنید و la مخزن:
دارک رکورد [پرونده|فهرست راهنما] ...
دستور "darcs record" برای ایجاد یک پچ از تغییرات درخت کار استفاده می شود.
اگر مجموعه ای از فایل ها و دایرکتوری ها را مشخص کنید، از تغییرات سایر فایل ها صرفنظر می شود.

هر پچ یک نام، یک توضیح اختیاری، یک نویسنده و یک تاریخ دارد.

Darcs یک ویرایشگر متن را راه اندازی می کند (به "محیط کمک Darcs" مراجعه کنید) بعد از تعامل
انتخاب، به شما اجازه می دهد نام پچ (خط اول) و توضیحات پچ را وارد کنید
(خطوط بعدی).

نام پچ باید یک جمله کوتاه باشد که به طور مختصر پچ را توصیف کند، مانند
"افزودن رسیدگی به خطا به حلقه رویداد اصلی." می توانید آن را از قبل با «-m» تهیه کنید
گزینه ای است که در این صورت هیچ ویرایشگر متنی راه اندازی نمی شود، مگر اینکه از آن استفاده کنید
گزینه «--edit-long-comment».

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

تفاوت فنی بین نام پچ و توضیحات پچ، مطابقت با آن است
پرچم `-p` فقط روی نام های پچ انجام می شود.

در نهایت، گزینه «--logfile» به شما امکان می‌دهد فایلی را تهیه کنید که از قبل حاوی فایل باشد
نام پچ و توضیحات پچ این در صورتی مفید است که یک رکورد قبلی شکست بخورد و از آن خارج شود
یک فایل "darcs-record-0".

هر وصله معمولاً از طریق آدرس ایمیل (مثلاً «فرد
وبلاگ ها[ایمیل محافظت شده]>`). Darcs در چندین جا به دنبال این رشته نویسنده است:
گزینه «--author»، فایل‌های «_darcs/prefs/author» (در مخزن) و
`~/.darcs/author` (در فهرست اصلی شما)، و متغیرهای محیطی
«$DARCS_EMAIL» و «$EMAIL». اگر هیچ‌کدام از این موارد وجود نداشته باشد، دارک از شما درخواست می‌کند
رشته نویسنده و نوشتن آن در `~/.darcs/author`. توجه داشته باشید که اگر بیش از یک مورد دارید
آدرس ایمیل، شما می توانید همه آنها را در `~/.darcs/author"، یک نویسنده در هر خط. دارک ها
همچنان از شما یک نویسنده درخواست می کند، اما به شما امکان می دهد از لیست یا به انتخاب کنید
جایگزین را تایپ کنید

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

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

اگر رکورد را با گزینه «--pipe» اجرا کنید، تاریخ وصله از شما خواسته می شود.
نویسنده، و نظر طولانی. کامنت طولانی تا پایان فایل یا ادامه خواهد داشت
stdin می رسد (ctrl-D در سیستم های Unixy، ctrl-Z در سیستم های دارای سیستم عامل مایکروسافت).

این رابط برای برنامه نویسی دارک ها، به ویژه برای نوشتن مخزن در نظر گرفته شده است
اسکریپت های تبدیل دستورات بیشتر به عنوان یک راهنمای مفید در نظر گرفته شده اند (از اسکریپت
به آنها نیازی نخواهد داشت)، تا به شما در درک قالب ارائه ورودی کمک کند.
در اینجا نمونه‌ای از ظاهر درخواست‌های «--pipe» آمده است:

امروز چندم است؟ دوشنبه 15 نوامبر 13:38:01 EST 2004
نویسنده کیست؟ دیوید راندی
لاگ چیست؟ یک یا چند خط نظر

اگر یک فرمان آزمایشی با «darcs setpref» تعریف شده باشد، تلاش برای ضبط یک پچ
باعث می شود دستور تست در یک کپی تمیز از درخت کار اجرا شود (یعنی
از جمله فقط تغییرات ثبت شده). اگر آزمایش ناموفق باشد، به شما پیشنهاد می شود که آن را سقط کنید
عملیات ثبت

گزینه «--set-scripts-executable» باعث می شود تا اسکریپت ها در قسمت قابل اجرا شوند
قبل از اجرای آزمایش، یک کپی از درخت کار تمیز کنید. به "کلون دارک" برای یک مراجعه کنید
توضیح اکتشافی اسکریپت

اگر فرمان آزمایشی شما به طرز خسته کننده ای کند است (مثلاً «ساخت همه») و چندین مورد را ضبط می کنید
وصله‌های پشت سر هم، ممکن است بخواهید از «--no-test» برای رد کردن همه آزمایش‌ها به جز آزمایش نهایی استفاده کنید.

برای مشاهده برخی زمینه ها (خطوط بدون تغییر) در اطراف هر تغییر، از گزینه «--unified» استفاده کنید.

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

دارک اصلاح [پرونده|فهرست راهنما] ...
اصلاح یک پچ "پیش نویس" را با اضافات یا بهبودها به روز می کند که منجر به ایجاد یک تک می شود
پچ "تمام شده".

به‌طور پیش‌فرض، «اصلاح» به شما پیشنهاد می‌کند تغییرات اضافی را ثبت کنید. اگر در عوض می خواهید
تغییرات را حذف کنید، از پرچم "--unrecord" استفاده کنید.

هنگام ضبط یک پچ پیش نویس، ایده خوبی است که نام را با «DRAFT:» شروع کنید. چه زمانی
انجام شد، آن را با «darcs amend --edit-long-comment» حذف کنید. متناوبا، برای تغییر
نام وصله بدون شروع ویرایشگر، از پرچم «--name»/`-m» استفاده کنید:

darcs amend --match 'name "DRAFT: foo"' --name 'foo2'

مانند «darcs record»، اگر اصلاح را با فایل‌ها به عنوان آرگومان فراخوانی کنید، فقط از شما سؤال می‌شود
در مورد تغییرات آن فایل ها بنابراین برای اصلاح یک پچ به foo.c با بهبود در
bar.c، شما اجرا می کنید:

darcs amend --match 'touch foo.c' bar.c

اصلاح وصله توسعه دهنده دیگر معمولاً ایده بدی است. برای اصلاح فقط بخواهید
در مورد وصله‌های خود به‌طور پیش‌فرض، می‌توانید چیزی مانند «Amend match David» را اضافه کنید
گرد به «~/.darcs/defaults"، جایی که "دیوید راندی" نام شماست.

دارک تضادهای علامت
Darcs برای یکسان سازی تغییرات در همان قسمت از یک فایل منبع، به راهنمایی انسانی نیاز دارد.
هنگامی که یک درگیری برای اولین بار رخ می دهد، دارک حالت اولیه و هر دو گزینه را به حالت اضافه می کند
درخت کار، با نشانگرهای `vvv`، `=====`، `* * *` و `^ ^ ^` مشخص شده است، به عنوان
به شرح زیر است:

ووووووو
حالت اولیه
=============
انتخاب اول.
*************
انتخاب دوم.
^^^^^^^^^

با این حال، ممکن است این نشانگرها را بدون اینکه واقعاً حل شوند، برگردانید یا به صورت دستی حذف کنید
درگیری در این مورد، «تعارض علامت دارک» برای نشان دادن محل قرار گرفتن آنها مفید است
درگیری های حل نشده همچنین اگر «darcs application» با نامیده شود مفید است
«--apply-conflicts»، که در آن تداخل ها در ابتدا علامت گذاری نشده اند.

اگر از پرچم «--dry-run» استفاده نکنید، هر گونه تغییر ثبت نشده در درخت کار انجام خواهد شد.
با اجرای این دستور برای همیشه گم شوید! از شما برای تایید خواسته می شود
قبل از اینکه این اتفاق بیفتد

مستقیم اصلاح of la مخزن:
دارک برچسب [نام برچسب]
دستور 'darcs tag' وضعیت مخزن فعلی را نامگذاری می کند، به طوری که به راحتی می تواند باشد
بعدا به آن اشاره شد هر وضعیت *مهم* باید برچسب گذاری شود. به ویژه خوب است
تمرین کنید تا هر نسخه پایدار را با یک عدد یا نام رمز برچسب گذاری کنید. مشاوره در مورد آزادی
شماره گذاری را می توان در یافتhttp://producingoss.com/en/development-cycle.html>.

برای بازتولید وضعیت یک مخزن «R» در تگ «t»، از دستور «darcs clone» استفاده کنید.
- t R` را تگ کنید. دستور «darcs show tags» همه برچسب‌ها را در مخزن فعلی فهرست می‌کند.

برچسب زدن همچنین مزایای عملکرد قابل توجهی را ارائه می دهد: زمانی که Darcs به یک اشتراک مشترک می رسد
برچسبی که به همه وصله‌های پیشین بستگی دارد، می‌تواند به سادگی پردازش را متوقف کند.

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

به‌طور پیش‌فرض، یک تگ کل وضعیت مخزن را در زمان ایجاد تگ نام‌گذاری می‌کند. اگر
از گزینه --ask-deps استفاده می شود، وصله هایی که باید به عنوان بخشی از تگ درج شوند
به صراحت انتخاب شده است.

دستور «darcs tag» گزینه «--pipe» را می‌پذیرد، که همانطور که در زیر توضیح داده شد رفتار می‌کند
"رکورد دارک".

دارک setpref <ترجیح>ارزش>
وقتی روی پروژه با چندین مخزن و مشارکت کننده کار می کنید، گاهی اوقات چنین است
مطلوب است که یک اولویت به طور مداوم در کل پروژه تنظیم شود. این امر توسط
در نظر گرفتن یک مجموعه ترجیحی با «darcs setpref» به عنوان یک تغییر ثبت نشده، که پس از آن می تواند
ثبت شود و سپس مانند هر پچ دیگری با آن رفتار شود.

ترجیحات معتبر عبارتند از:

* test -- یک فرمان پوسته که تست های رگرسیون را اجرا می کند * predist -- یک فرمان پوسته به
اجرا قبل از "darcs dist" * boringfile -- مسیر یک فایل خسته کننده با کنترل نسخه *
binariesfile -- مسیر یک فایل باینری تحت کنترل نسخه

به عنوان مثال، پروژه ای با استفاده از ابزارهای خودکار گنو، با هدف "ساخت تست" برای انجام
تست‌های رگرسیون، ممکن است تست رگرسیون یکپارچه دارک را با موارد زیر فعال کنند
فرمان:

تست darcs setpref 'conf && ./configure && make && make test'

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

پرس و جو la مخزن:
دارک تفاوت [پرونده|فهرست راهنما] ...
دستور "darcs diff" دو نسخه از درخت کار جریان را با هم مقایسه می کند
مخزن بدون گزینه، درختان کار بکر (ثبت شده) و ثبت نشده هستند
مقایسه کرد. این از دستور «darcs whatsnew» سطح پایین‌تری دارد، زیرا a را خروجی می‌دهد
تفاوت خط به خط و همچنین کندتر است. مانند «darcs whatsnew»، اگر مشخص کنید
فایل ها یا دایرکتوری ها، تغییرات به فایل های دیگر فهرست نشده است. دستور همیشه استفاده می کند
یک ابزار تفاوت خارجی

با گزینه «--patch»، مقایسه بین درختان کار با و انجام خواهد شد
بدون اون پچ وصله *بعد از* پچ انتخاب شده در هیچ یک از آنها وجود ندارد
درختان کار مقایسه شده گزینه های «--from-patch» و «--to-patch» به مجموعه اجازه می دهند
از تکه‌ها در درختان کار «قدیمی» و «جدید» که باید به طور جداگانه مشخص شوند.

تگ های مرتبط و گزینه های تطبیق نیز درک می شوند، به عنوان مثال، "darcs diff --from-tag".
1.0 --to-tag 1.1`. همه این گزینه‌ها مرتب‌سازی مجموعه پچ را فرض می‌کنند، بنابراین نتایج
ممکن است تحت تأثیر عملیاتی مانند «darcs optimize --reorder» قرار گیرد.

تفاوت(1) با آرگومان های «-rN» فراخوانی می شود. گزینه «--unified» باعث می شود «-u» باشد
گذشت به تفاوت(1). یک آرگومان اضافی را می توان با استفاده از «--diff-opts»، مانند
«--diff-opts=-ud» یا «--diff-opts=-wU9».

گزینه «--diff-command» را می توان برای تعیین یک ابزار جایگزین، مانند
meld (GNOME) یا opendiff (OS X). آرگومان ها ممکن است گنجانده شوند که با فضای خالی از هم جدا شده اند.
مقدار توسط یک پوسته تفسیر نمی شود، بنابراین ساختارهای پوسته را نمی توان استفاده کرد. در
آرگومان های % 1 و % 2 باید گنجانده شوند، اینها جایگزین دو درخت کار می شوند
در حال مقایسه شدن در صورت استفاده از این گزینه، «--diff-opts» نادیده گرفته می شود.

دارک ورود به سیستم [پرونده|فهرست راهنما] ...
دستور «darcs log» وصله‌هایی را که مخزن فعلی را تشکیل می‌دهند فهرست می‌کند یا
با `--repo`، یک مخزن راه دور. بدون گزینه یا آرگومان، همه وصله ها خواهند بود
ذکر شده.

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

هنگامی که "--from-tag"، "--from-patch" یا "--from-match" داده می شود، از آن زمان فقط وصله می شود
برچسب یا پچ لیست شده است. به طور مشابه، «--to-tag»، «--to-patch» و «--to-match»
گزینه ها لیست را به وصله های قدیمی تر محدود می کنند.

گزینه‌های «--آخر» و «--max-count» هر دو تعداد وصله‌های فهرست‌شده را محدود می‌کنند. در
اولی قبل از فیلترهای دیگر اعمال می شود، در حالی که دومی بعد از فیلترهای دیگر اعمال می شود.
برای مثال «darcs log foo.c --max-count 3» سه وصله آخری را که
روی foo.c تأثیر می‌گذارد، در حالی که «darcs log --last 3 foo.c» از سه وصله آخر،
فقط مواردی را چاپ کنید که foo.c را تحت تأثیر قرار می دهند.

سه فرمت خروجی وجود دارد. پیش فرض «--قابل خواندن برای انسان» است. همچنین می توانید انتخاب کنید
«--context»، که قالب داخلی است (همانطور که در بسته‌های پچ دیده می‌شود) که می‌تواند باشد
خواندن مجدد توسط Darcs (به عنوان مثال "darcs clone --context").

در نهایت، «--xml-output» وجود دارد که XML معتبر را منتشر می کند... مگر اینکه متادیتای وصله ای باشد.
(نویسنده، نام یا توضیحات) حاوی یک کاراکتر غیر ASCII است و در a ثبت شده است
محلی غیر UTF8

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

دارک حاشیه نویسی [پرونده|فهرست راهنما] ...
دستور "darcs annotate" دو عملیات غیر مرتبط را ارائه می دهد. هنگامی که به یک
فایل، وصله ای را پیدا می کند که آخرین بار هر خط را در آن فایل اصلاح کرده است. وقتی تماس گرفته شود
روی یک پچ (مثلاً با استفاده از «--patch»)، نمایش داخلی آن را چاپ می‌کند
پچ

گزینه «--summary» منجر به یک حاشیه نویسی خلاصه شده وصله، شبیه به «darcs» می شود.
whatsnew`. روی حاشیه نویسی فایل تاثیری ندارد.

به طور پیش فرض، خروجی در قالب قابل خواندن توسط انسان است. گزینه «--machine-readable» می تواند
برای تولید خروجی برای پس پردازش ماشین استفاده شود.

دارک ناحیه
"darcs dist" یک بایگانی فشرده در فهرست اصلی مخزن ایجاد می کند.
حاوی وضعیت ثبت شده درخت کار (تغییرات ثبت نشده و "_darcs".
دایرکتوری مستثنی هستند). این فرمان تطبیق‌کننده‌ها را می‌پذیرد تا یک آرشیو از برخی ایجاد کند
حالت مخزن گذشته، به عنوان مثال «--tag».

به‌طور پیش‌فرض، آرشیو (و دایرکتوری سطح بالا در بایگانی) همین‌ها را دارد
به عنوان مخزن نامگذاری کنید، اما می‌توان آن را با گزینه «--dist-name» لغو کرد.

اگر یک دستور predist تنظیم شده باشد (به «darcs setpref» مراجعه کنید)، آن فرمان بر روی آن اجرا خواهد شد
وضعیت ثبت شده قبل از بایگانی برای مثال، پروژه‌های ابزار خودکار آن را روی آن تنظیم می‌کنند
"اتصال خودکار && automake".

اگر از «--zip» استفاده شود، تطبیق‌ها و دستور predist نادیده گرفته می‌شوند.

دارک آزمون [[مقدار دهی اولیه] فرمان]
تست را روی وضعیت ثبت شده فعلی مخزن اجرا کنید. با توجه به هیچ استدلالی، از آن استفاده می کند
تست مخزن پیش‌فرض (به «darcs setpref» مراجعه کنید. با توجه به یک استدلال، آن را درمان می کند
به عنوان یک فرمان آزمایشی با توجه به دو آرگومان، اولی یک دستور اولیه و
دومی تست است (یعنی کد خروج از دستور اول وارد نشده است
حساب برای تعیین موفقیت آزمون). اگر "--خطی" یا "--نصف" داده شود
پرچم‌گذاری می‌کند، سعی می‌کند جدیدترین نسخه را در مخزن پیدا کند که آزمایشی را پشت سر گذاشته است.

«--linear» جستجوی خطی را از سر شروع می‌کند و از سر فاصله می‌گیرد. این
بهترین استراتژی زمانی است که تست خیلی سریع اجرا شود یا پچ مورد نظر شما نزدیک باشد
سر.

«--bisect» جستجوی باینری انجام می دهد. این استراتژی زمانی بهترین است که آزمون بسیار آهسته اجرا شود
یا وصله ای که به دنبال آن هستید احتمالاً در گذشته دور مخزن است.

«--backoff» شروع به جستجو از سر می‌کند و بیشتر و بیشتر به گذشته می‌پرد
تا زمانی که آزمون موفق شود سپس یک جستجوی دودویی را در زیر مجموعه‌ای از موارد نادیده گرفته شده انجام می‌دهد
تکه ها این استراتژی به خوبی کار می کند مگر اینکه وصله مورد نظر شما در آن باشد
گذشته دور مخزن

با این فرض که شکست یکنواخت است، «--خطی» و «--نصف»
نتیجه مشابه (یکنواخت به این معنی است که هنگام دور شدن از سر، نتیجه آزمایش است
فقط یک بار از "شکست" به "ok" تغییر می کند.) اگر شکست یکنواخت نیست، هر یک از آنها
تکه هایی که تست را شکست می دهند به صورت تصادفی یافت می شوند.

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

دارک نشان فایل ها [پرونده|فهرست راهنما] ...
دستور «darcs show files» آن فایل‌ها و دایرکتوری‌ها را در درخت کار فهرست می‌کند
که تحت کنترل نسخه هستند. این دستور در درجه اول برای اهداف برنامه نویسی است. پایان
کاربران احتمالاً «darcs whatsnew --summary» را می خواهند.

اگر فایلی اضافه شده باشد اما ضبط نشده باشد "در انتظار" است. به طور پیش فرض، فایل های معلق
(و دایرکتوری ها) لیست شده اند. گزینه «--no-pending» از این امر جلوگیری می کند.

به‌طور پیش‌فرض «دارک‌ها فایل‌ها را نشان می‌دهند» هم فایل‌ها و هم دایرکتوری‌ها را فهرست می‌کند، اما نام مستعار «darcs».
نمایش مانیفست فقط فایل‌ها را فهرست می‌کند. «--فایل ها»، «--دایرکتوری ها»، «--بدون فایل» و
"--no-directories" این رفتار را اصلاح می کند.

به طور پیش فرض ورودی ها یک در هر خط هستند (یعنی خط جدید جدا شده است). این می تواند مشکلاتی ایجاد کند
اگر خود فایل ها حاوی خطوط جدید یا سایر کاراکترهای کنترلی باشند. برای دور زدن
این، گزینه «--null» به جای آن از کاراکتر null استفاده می کند. تفسیر فیلمنامه
خروجی از این دستور نیاز به درک این اصطلاح دارد. 'xargs -0' چنین دستوری است.

به عنوان مثال، برای فهرست کردن فایل‌های کنترل‌شده نسخه بر اساس اندازه:

دارک ها فایل ها را نشان می دهد -0 | xargs -0 ls -ldS

دارک نشان شاخص
دستور «darcs show index» همه فایل‌ها و دایرکتوری‌های تحت کنترل نسخه را فهرست می‌کند
به همراه هش‌های آن‌ها که در «_darcs/index» ذخیره شده‌اند. برای فایل ها، فیلدها مطابقت دارند
به اندازه فایل، sha256 از محتوای فایل فعلی و نام فایل.
دارک نشان تر و تازه
دستور «darcs show pristine» همه فایل‌ها و دایرکتوری‌های تحت کنترل نسخه را فهرست می‌کند
به همراه هش های نسخه های بکر آنها. برای فایل ها، فیلدها مطابقت دارند
اندازه فایل، sha256 از محتوای فایل بکر و نام فایل.
دارک نشان مخزن
دستور "darcs show repo" آمار مربوط به مخزن فعلی را نمایش می دهد.
اجازه دادن به اسکریپت های شخص ثالث برای دسترسی به این اطلاعات بدون بازرسی «_darcs».
به طور مستقیم (و بدون شکستن زمانی که قالب «_darcs» تغییر می کند).

به طور پیش فرض، تعداد وصله ها نشان داده می شود. اگر این داده ها مورد نیاز نیست، استفاده کنید
«--no-files» برای تسریع این دستور از O(n) به O(1).

به طور پیش فرض، خروجی در قالب قابل خواندن توسط انسان است. گزینه «--xml-output» می تواند باشد
برای تولید خروجی برای پس پردازش ماشین استفاده می شود.

دارک نشان نویسندگان
دستور «darcs show authors» نویسندگان مخزن فعلی را به صورت مرتب شده فهرست می کند
با تعداد وصله های ارائه شده با گزینه «--verbose» این دستور
به سادگی نویسنده هر پچ را (بدون تجمع یا مرتب سازی) لیست می کند.

نام نویسنده یا آدرس ایمیل ممکن است در طول زمان تغییر کند. برای اینکه به دارک بگوییم چندتایی است
رشته های نویسنده به یک فرد اشاره دارد، یک فایل ".authorspellings" در آن ایجاد کنید
ریشه درخت کار هر خط در این فایل با قانون یک نویسنده شروع می شود
نام و آدرس، و ممکن است با یک لیست با کاما جدا شده از منظم توسعه یافته دنبال شود
اصطلاحات. خطوط خالی و خطوطی که با دو خط تیره شروع می شوند نادیده گرفته می شوند. در
قالب ".authorspelling" را می توان با این الگو توصیف کرد:

نام [, regexp ]*

برخی از مشکلات در مورد کاراکترهای خاص وجود دارد: فضاهای سفید حذف می شوند، اگر
شما در استفاده از regexp نیاز به فضا دارید [ ]. از آنجا که کاما به عنوان یک جداکننده عمل می کند، شما باید این کار را انجام دهید
اگر می خواهید در regexp از آن فرار کنید. توجه داشته باشید که «.authorspelling» از Extended regular استفاده می کند
عبارات بنابراین +،؟ و غیره متاکراکترهایی هستند و برای بودن باید از آنها فرار کنید
به معنای واقعی کلمه تفسیر شده است.

هر پچ با رشته نویسنده که با آدرس متعارف یا هر یک از آنها مطابقت دارد
regexps مرتبط اثر آن نویسنده در نظر گرفته می شود. همه تطبیق است
حساس به حروف بزرگ و جزئی (می تواند با یک رشته فرعی مطابقت داشته باشد). از ^,$ برای مطابقت با کل استفاده کنید
رشته در regexps

در حال حاضر این مرحله متعارف سازی فقط در «نویسندگان نمایش دارک» انجام می شود. دیگر
دستوراتی مانند "darcs log" از رشته های نویسنده به طور کلمه به کلمه استفاده می کنند.

یک نمونه فایل «.authorspelling» این است:

-- این یک نظر است.
فرد نورک[ایمیل محافظت شده]>
جان اسناگ[ایمیل محافظت شده]>، جان، snagge@، js@(si|mit).edu
چاک جونز، جونیور[ایمیل محافظت شده]>، cj\+[ایمیل محافظت شده]

دارک نشان برچسب ها
دستور tags لیستی از تمام تگ های موجود در مخزن را در خروجی استاندارد می نویسد.

کاراکترهای Tab (نویسه ASCII 9) در نام تگ ها برای بهتر شدن به فاصله تغییر می کنند
قابلیت همکاری با ابزارهای پوسته اگر این اتفاق بیفتد یک هشدار چاپ می شود.

دارک نشان Patch-index-all
دستور "darcs show patch-index all" تمام اطلاعات موجود در پچ ایندکس را فهرست می کند
دارک نشان فایل های patch-index
دستور «darcs show patch-index files» همه فایل‌های فعلی ثبت‌شده در فهرست را فهرست می‌کند
پچ شاخص
دارک نشان patch-index-status
«دارک‌ها گزارش‌های پچ-index-وضعیت را نشان می‌دهند» در صورتی که نمایه وصله همگام باشد، خارج از
همگام سازی کنید، یا وجود ندارد
دارک نشان Patch-index-test
«darcs show patch-index-test» شاخص پچ را آزمایش می کند

کپی برداری تکه میان مخازن با کارگر کپی کنید به روز رسانی:
دارک کشیدن [مخزن] ...
Pull برای آوردن وصله های ساخته شده در مخزن دیگر به مخزن فعلی استفاده می شود
(یعنی یا در دایرکتوری فعلی، یا مشخص شده با
گزینه `--repodir`). Pull به شما این امکان را می دهد که همه یا برخی از وصله های موجود را بیاورید
در آن مخزن اما نه در این. Pull آرگومان هایی را می پذیرد که نشانی های اینترنتی از آن هستند
که باید کشیده شود، و وقتی بدون آرگومان فراخوانی شود، pull از مخزن استفاده خواهد کرد
که اخیراً یا هل داده اید یا کشیده اید.

رفتار پیش‌فرض (`--union`) این است که هر وصله‌ای را که در هر یک از آنها وجود دارد، بکشید
مخازن مشخص شده اگر پرچم "--تقاطع" را مشخص کنید، فقط دارک ها مشخص می شوند
آن وصله هایی را که در همه مخازن منبع وجود دارد را بکشید. اگر مشخص کنید
پرچم «--مکمل»، دارک ها فقط عناصری را در اولین مخزن می کشند که این کار را انجام نمی دهند.
در هر یک از مخازن باقی مانده وجود دارد.

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

برای توضیح دقیق بسیاری از گزینه‌ها، «darcs help application» را ببینید.

دارک رفتن و آوردن [مخزن] ...
Fetch شبیه «کشش» است با این تفاوت که هیچ وصله‌ای روی جریان اعمال نمی‌کند
مخزن درعوض، پچ بسته‌ای ایجاد می‌کند که می‌توانید بعداً با آن اعمال کنید
"اعمال"

رفتار Fetch اساساً شبیه به کشش است، بنابراین لطفاً با کمک مشورت کنید
برای دانستن بیشتر "کشیدن"

دارک از بین بردن
Obliterate به طور کامل وصله های ضبط شده را از مخزن محلی شما حذف می کند. تغییرات
در کپی کاری شما لغو می شود و وصله ها در تغییرات شما نشان داده نمی شوند
دیگر فهرست کنید مراقب باشید که می توانید کد ارزشمند را با حذف کردن از دست بدهید!

یکی از راه های ذخیره وصله های حذف شده استفاده از پرچم -O است. پچ باندل خواهد بود
به صورت محلی ایجاد شده است، که می توانید بعداً با «darcs» در مخزن خود اعمال کنید
اعمال`.

دارک عقبگرد [پرونده|فهرست راهنما] ...
بازگشت به عقب برای خنثی کردن اثرات برخی تغییرات از وصله های موجود در مخزن استفاده می شود.
تغییرات انتخاب شده در نسخه کاری شما لغو می شوند، اما مخزن باقی مانده است
بدون تغییر ابتدا به شما پیشنهاد داده می شود که کدام وصله را لغو کنید، سپس کدام تغییر را انجام دهید
در وصله ها برای لغو.

قبل از انجام "بازگشت"، ممکن است بخواهید به طور موقت تغییرات کار خود را لغو کنید
کپی کنید (در صورت وجود) و برای استفاده بعدی ذخیره کنید. برای انجام این کار، می توانید «revert» را اجرا کنید، سپس
'rollback' را اجرا کنید، یک پچ را ضبط کنید و برای بازگرداندن تغییرات ذخیره شده، 'unrevert' را اجرا کنید
کپی کاری شما

دارک فشار [مخزن]
فشار مخالف کشش است. Push به شما این امکان را می دهد که پچ ها را از جریان فعلی کپی کنید
مخزن به یک مخزن دیگر.

اگر پرچم «--apply-as» را بدهید، darcs از sudo برای اعمال وصله ها به عنوان یک
کاربر متفاوت این می تواند مفید باشد اگر می خواهید سیستمی را راه اندازی کنید که در آن چندین کاربر استفاده کنند
می توانید همان مخزن را تغییر دهید، اما شما نمی خواهید به آنها اجازه دسترسی کامل به نوشتن را بدهید.
این در برابر مهاجمان مخرب ماهر ایمن نیست، اما حداقل می تواند از شما محافظت کند
مخزن از کاربران دست و پا چلفتی، نالایق یا تنبل.

Darcs push به‌طور پیش‌فرض داده‌های وصله را قبل از ارسال به کنترل از راه دور فشرده می‌کند
مکان از طریق ssh. این تا زمانی کار می کند که دارک از راه دور قدیمی تر از نسخه نباشد
2.5. اگر خطاهایی دریافت کردید که نشان‌دهنده یک پچ باندل خراب است، باید دوباره امتحان کنید
گزینه «--no-compress» برای ارسال داده ها به صورت غیر فشرده (که بسیار زیاد است
برای تکه های بزرگ کندتر است، اما همیشه باید کار کند).

دارک ارسال [مخزن]
Send برای تهیه بسته‌ای از وصله‌ها استفاده می‌شود که می‌توانند روی یک هدف اعمال شوند
مخزن Send URL مخزن را به عنوان آرگومان می پذیرد. وقتی تماس گرفته شود
بدون آرگومان، send از جدیدترین مخزن استفاده خواهد کرد که یا فشار داده شده است
به، کشیده شده یا فرستاده شده به. به‌طور پیش‌فرض، پچ باندل در یک فایل ذخیره می‌شود
شما می توانید مستقیماً آن را از طریق پست ارسال کنید.

پرچم‌های «--output»، «--output-auto-name» و «--to» تعیین می‌کنند که دارک با چه کاری انجام می‌دهد.
پچ باندل پس از ایجاد آن. اگر آرگومان «--output» ارائه کنید، پچ
بسته نرم افزاری در آن فایل ذخیره می شود. اگر «--output-auto-name» را مشخص کنید، بسته پچ
در فایلی با نامی که به طور خودکار تولید می شود ذخیره می شود. اگر یک یا چند نفر بدهید
آرگومان‌های «--to»، بسته‌ای از وصله‌ها به آن مکان‌ها ارسال می‌شود. مکان ها ممکن است
یا آدرس های ایمیل یا url هایی باشند که پچ باید از طریق HTTP به آنها ارسال شود.

اگر پرچم «--mail» را ارائه کنید، دارک به محتویات آن نگاه خواهد کرد
فایل «_darcs/prefs/email» در مخزن هدف (در صورت وجود) و ارسال پچ
از طریق ایمیل به آن آدرس در این مورد، می توانید از گزینه «--cc» برای تعیین استفاده کنید
گیرندگان اضافی بدون نادیده گرفتن آدرس ایمیل پیش فرض مخزن.

اگر «_darcs/prefs/post» در مخزن هدف وجود داشته باشد، darcs در URL آپلود خواهد شد.
موجود در آن فایل، که ممکن است URL 'mailto:' یا URL 'http://' باشد. که در
در حالت دوم، پچ به آن URL پست می شود.

اگر آدرس ایمیل مرتبط با مخزن وجود نداشته باشد، darcs از شما درخواست می کند
یک آدرس ایمیل

از پرچم «--subject» برای تنظیم موضوع ایمیل ارسالی استفاده کنید. اگر این کار را نکنید
یک موضوع را در خط فرمان ارائه کنید، دارک ها یکی را بر اساس نام آنها می سازند
پچ ها در بسته پچ

برای تنظیم سرصفحه های In-Reply-To و References از پرچم «--in-reply-to» استفاده کنید.
ایمیل ارسال شود. به‌طور پیش‌فرض هیچ عنوان اضافی اضافه نمی‌شود، بنابراین ایمیل وجود نخواهد داشت
توسط خوانندگان نامه به عنوان پاسخ تلقی می شود.

اگر می‌خواهید توضیحات یا توضیحی را به همراه بسته‌ای از پچ‌ها اضافه کنید،
باید پرچم «--edit-description» را مشخص کنید، که باعث باز شدن دارک ها می شود.
ویرایشگری که با آن می توانید پیامی بنویسید تا با وصله های خود همراه شود.

اگر می خواهید از دستوری متفاوت از دستور پیش فرض برای ارسال ایمیل استفاده کنید، شما
باید یک خط فرمان با گزینه «--sendmail-command» مشخص کنید. خط فرمان
می تواند حاوی برخی از مشخص کننده های قالب باشد که با مقادیر واقعی جایگزین می شوند. پذیرفته شده
مشخص‌کننده‌های قالب عبارتند از «%s» برای موضوع، «%t» برای به، «%c» برای cc، «%b» برای بدنه
نامه، «%f» برای از، «%a» برای بسته پچ و همان مشخص‌کننده‌ها در
حروف بزرگ برای مقادیر رمزگذاری شده با URL. علاوه بر این، می توانید «%<» را به انتهای آن اضافه کنید
خط فرمان اگر فرمان انتظار پیام ایمیل کامل را در ورودی استاندارد داشته باشد. به عنوان مثال
خطوط فرمان برای evolution و msmtp به شکل زیر است:

تکامل "mailto:%T?subject=%S&attach=%A&cc=%C&body=%B"
msmtp -t %

گزینه های «--author» را با آدرس برگشتی که «darcs send» می کند اشتباه نگیرید
برای پچ باندل خود تنظیم کنید.

برای مثال، اگر دو آدرس ایمیل A و B دارید:

* اگر از «--author A» استفاده می کنید اما دستگاه شما برای ارسال نامه از آن پیکربندی شده است
آدرس B به طور پیش فرض، سپس آدرس برگشتی در پیام شما B خواهد بود. * اگر شما
از «--from A» استفاده کنید و سرویس گیرنده ایمیل شما از تنظیم آن پشتیبانی می کند
از: آدرس خودسرانه (برخی از سرویس گیرندگان ایمیل غیر یونیکس، به ویژه،
ممکن است از این پشتیبانی نکند)، سپس آدرس برگشتی A خواهد بود. اگر این کار را انجام دهد
این را پشتیبانی نمی کند، آدرس برگشتی B خواهد بود. * اگر هیچ کدام را ارائه نکنید
«--from» و نه «--author» سپس بازگشت
آدرس B خواهد بود.

علاوه بر این، مگر اینکه دستور sendmail را با «--sendmail-command» مشخص کنید، darcs
با استفاده از دستور ایمیل پیش فرض در رایانه شما ایمیل می فرستد. این دستور پیش فرض است
توسط اسکریپت "پیکربندی" تعیین می شود. بنابراین، در برخی از سیستم‌عامل‌های غیر یونیکس، «--from» است
به احتمال زیاد اصلا کار نمی کند

دارک درخواست <پچ فایل>
دستور «darcs application» یک پچ بسته را می گیرد و سعی می کند آن را در آن قرار دهد
مخزن فعلی علاوه بر فراخوانی مستقیم آن در بسته‌های ایجاد شده توسط «darcs».
send»، به صورت داخلی توسط «darcs push» در انتهای راه دور یک اتصال SSH استفاده می شود.

اگر هیچ فایلی ارائه نشده باشد، بسته از ورودی استاندارد خوانده می شود.

اگر به جای پچ باندل، ایمیلی به Darcs داده شود، بسته را به عنوان MIME جستجو می کند.
پیوست به آن ایمیل در حال حاضر اگر مرز MIME بازنویسی شود، شکست خواهد خورد.
مانند Courier و Mail.app.

اگر «--پاسخ [ایمیل محافظت شده]گزینه ` استفاده می شود، و بسته نرم افزاری به یک متصل می شود
ایمیل، Darcs گزارشی (که نشان دهنده موفقیت یا شکست است) برای فرستنده ارسال می کند
بسته نرم افزاری (فیلد «به»). استدلال به noreply آدرسی است که گزارش ارائه خواهد کرد
به نظر می رسد از FROM سرچشمه می گیرد.

برای مثال، گزینه «--cc» باعث می شود که گزارش به آدرس دیگری CC'd شود
`--سی سی [ایمیل محافظت شده],[ایمیل محافظت شده]`. استفاده از «--cc» بدون
«--پاسخ» تعریف نشده است.

اگر می خواهید از دستوری متفاوت از دستور پیش فرض برای ارسال نامه استفاده کنید، نیاز دارید
برای تعیین خط فرمان با گزینه «--sendmail-command». خط فرمان می تواند
حاوی فرمت تعیین‌کننده «%t» برای به است و می‌توانید «%<» را به انتهای آن اضافه کنید
خط فرمان اگر فرمان انتظار نامه کامل را در ورودی استاندارد داشته باشد. مثلا،
خط فرمان msmtp به شکل زیر است:

msmtp -t %

If gpg(1) نصب شده است، می‌توانید از «--verify pubring.gpg» برای رد کردن بسته‌هایی که
با کلیدی در «pubring.gpg» امضا نمی‌شوند.

اگر «--test» ارائه شود و یک آزمایش تعریف شده باشد (به «darcs setpref» مراجعه کنید)، بسته
در صورت عدم موفقیت آزمون پس از اعمال آن، رد می شود. در این صورت ایمیل رد می شود
از «--پاسخ» شامل خروجی تست می شود.

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

گزینه «--external-merge» به شما امکان می دهد این تضادها را با استفاده از یک ادغام خارجی حل کنید
ابزار در گزینه، «%a» با جد مشترک (پایه ادغام)، «% 1» جایگزین می‌شود
با نسخه اول، «%2» با نسخه دوم، و «%o» با مسیری که در آن
محتوای حل شده شما باید برود. به عنوان مثال، برای استفاده از ابزار ادغام تصویری xxdiff
شما باید مشخص کنید: `--external-merge='xxdiff -m -O -M %o %1 %a %2'`

گزینه «--allow-conflicts» علامت‌گذاری تضاد را رد می‌کند. این زمانی مفید است که شما
می خواهید یک مخزن را فقط به عنوان یک دسته از وصله ها در نظر بگیرید، مانند استفاده از «دارک pull».
--union` برای دانلود پچ های همکاران خود قبل از آفلاین شدن.

این می تواند تغییرات ثبت نشده در درخت کار را خراب کند و شما را مجبور به حل آن کند
بلافاصله درگیری به سادگی رد بسته هایی که تعارضات حل نشده را معرفی می کنند،
با استفاده از گزینه «--dont-allow-conflicts». این را به صورت پیش فرض در push-based قرار دهید
گردش کار به شدت توصیه می شود.

برخلاف اکثر دستورات Darcs، «darcs application» پیش‌فرض «--all» است. استفاده کنید
گزینه «--تعاملی» برای انتخاب وصله‌هایی که از یک بسته نرم افزاری اعمال شوند.

دارک کلون کردن <مخزن> [فهرست راهنما>]
Clone یک کپی از یک مخزن ایجاد می کند. آرگومان دوم اختیاری a را مشخص می کند
فهرست مقصد برای کپی جدید؛ اگر حذف شود از منبع استنباط می شود
محل.

به طور پیش‌فرض Darcs هر پچ را از مخزن اصلی کپی می‌کند. این یعنی
کپی کاملا مستقل از اصل است. می توانید روی مخزن جدید کار کنید
حتی زمانی که نسخه اصلی غیر قابل دسترسی است. اگر از مخزن اصلی انتظار دارید
در دسترس باقی بماند، می‌توانید از «--lazy» استفاده کنید تا از کپی کردن وصله‌ها تا زمانی که نیاز نیست، اجتناب کنید
("کپی در صورت تقاضا"). این به ویژه هنگام کپی کردن یک مخزن راه دور با آن مفید است
یک تاریخ طولانی که شما به آن اهمیت نمی دهید.

هنگام شبیه‌سازی محلی، Darcs به طور خودکار در صورت امکان از پیوند سخت استفاده می‌کند. همچنین
به عنوان صرفه جویی در زمان و فضا، این امکان انتقال یا حذف مخزن اصلی را فراهم می کند
بدون تاثیر بر روی کپی پیوند سخت مستلزم آن است که کپی روی همان باشد
فایل سیستم به عنوان مخزن اصلی، و اینکه سیستم فایل از پیوند سخت پشتیبانی می کند.
این شامل NTFS، HFS+ و همه سیستم‌های فایل یونیکس همه منظوره (مانند ext، UFS) می‌شود.
و ZFS). FAT از لینک های سخت پشتیبانی نمی کند.

هنگام شبیه‌سازی از یک مکان دور، دارک به دنبال بسته‌ها می‌گردد و سعی می‌کند از آن استفاده کند
ایجاد شده توسط "darcs optimize http" در مخزن راه دور. بسته ها یک فایل بزرگ تکی هستند
که می تواند به جای بسیاری از فایل های کوچک بارگیری شود، که باعث می شود شبیه سازی سریعتر شود
HTTP

Darcs clone تغییرات ثبت نشده را در درخت کاری مخزن منبع کپی نمی کند.

می توانید یک مخزن را در یک url ssh کپی کنید، در این صورت مخزن جدید همیشه
کامل باشد

اغلب مطلوب است که یک کپی از یک مخزن تهیه کنید که برخی از وصله ها را حذف کند. برای
به عنوان مثال، اگر نسخه‌ها برچسب‌گذاری شوند، «darcs clone --tag .» یک کپی از
مخزن مانند آخرین نسخه.

یک وضعیت مخزن بدون برچسب هنوز می تواند به طور واضح توسط یک فایل زمینه شناسایی شود.
همانطور که توسط "darcs log --context" ایجاد شده است. با توجه به نام چنین فایلی، `--context`
گزینه یک مخزن ایجاد می کند که فقط شامل وصله های آن زمینه است.
زمانی که کاربر اشکالی را در نسخه منتشر نشده پروژه شما گزارش می دهد، توصیه می شود
راه برای فهمیدن اینکه دقیقاً چه نسخه‌ای را اجرا می‌کردند این است که آنها را شامل a
فایل زمینه در گزارش اشکال.

همچنین می‌توانید با استفاده از «--to-patch» یا «--to-match» از یک حالت بدون برچسب کپی کنید.
گزینه‌هایی که وصله‌های *پس از* اولین وصله منطبق را حذف می‌کنند. چون اینها
گزینه‌ها مجموعه وصله‌ها را به‌عنوان یک توالی مرتب در نظر می‌گیرند، ممکن است نتایج متفاوتی دریافت کنید
پس از مرتب سازی مجدد با «darcs optimize»، بنابراین برچسب گذاری ترجیح داده می شود.

گزینه «--set-scripts-executable» باعث می شود تا اسکریپت ها در قسمت قابل اجرا شوند
درخت کار اسکریپت هر فایلی است که با یک shebang ("#!") شروع می شود.

اداره کردن مخازن:
دارک مقداردهی اولیه [<فهرست راهنما>]
دستور «darcs Initialize» دایرکتوری فعلی را به یک مخزن دارک تبدیل می کند.
هر فایل و دایرکتوری فرعی موجود به تغییرات ذخیره نشده تبدیل می شود: آنها را با «darcs» ضبط کنید
ضبط --look-for-adds`.

این دستور دایرکتوری «_darcs» را ایجاد می‌کند که ابرداده‌های کنترل نسخه را ذخیره می‌کند.
همچنین شامل تنظیمات هر مخزن در `_darcs/prefs/` می باشد که می توانید در مورد آنها مطالعه کنید
در دفترچه راهنمای کاربر

به طور پیش فرض، وصله های مخزن جدید در معناشناسی darcs-2 قرار دارند. با این حال آن است
امکان ایجاد یک مخزن در معناشناسی darcs-1 با پرچم "--darcs-1" وجود دارد،
اگرچه این به جز برای به اشتراک گذاری وصله ها با پروژه ای که استفاده می کند توصیه نمی شود
وصله در معناشناسی darcs-1.

Initialize معمولا به اختصار "init" گفته می شود.

دارک بهینه سازی تمیز
این دستور فایل های منسوخ شده داخل مخزن را حذف می کند.
دارک بهینه سازی HTTP
استفاده از این گزینه "بسته های مخزن" را ایجاد می کند که می تواند به طور چشمگیری سرعت خود را افزایش دهد
عملکرد زمانی که کاربر یک "کلون دارک" از مخزن را از طریق HTTP انجام می دهد. برای استفاده
از بسته ها، مشتریان باید دارای دارک حداقل نسخه 2.10 باشند.

دارک بهینه سازی ترتیب مجدد
این دستور وصله های اخیر (آنهایی که در آخرین تگ گنجانده نشده اند) را به قسمت منتقل می کند
"front"، مقداری که یک فرمان از راه دور معمولی برای دانلود نیاز دارد را کاهش می دهد. آی تی
همچنین باید زمان CPU مورد نیاز برای برخی عملیات را کاهش دهد.
دارک بهینه سازی enable-patch-index
ایجاد پچ ایندکس، یک ساختار داده داخلی که دستورات مورد نیاز را تسریع می کند
برای دانستن اینکه چه وصله هایی یک فایل داده شده را لمس می کنند. مانند حاشیه نویسی و ثبت نام.
دارک بهینه سازی disable-patch-index
حذف و نگهداری از پچ ایندکس از مخزن متوقف شود.
دارک بهینه سازی فشرده کردن
به طور پیش‌فرض وصله‌ها با zlib (RFC 1951) فشرده می‌شوند تا فضای ذخیره‌سازی کاهش یابد (و
دانلود) اندازه. در شرایط استثنایی، ممکن است ترجیح داده شود از آن اجتناب شود
فشرده سازی در این مورد می توان از گزینه «--dont-compress» استفاده کرد (مثلاً با «darcs
رکورد`) برای جلوگیری از فشرده سازی.

دستورات "darcs optimize uncompress" و "darcs optimize compres" را می توان برای
اطمینان حاصل کنید که وصله های موجود در مخزن فعلی به ترتیب فشرده نشده یا فشرده نشده اند
فشرده شده
دارک بهینه سازی فشرده سازی نکردن
به طور پیش‌فرض وصله‌ها با zlib (RFC 1951) فشرده می‌شوند تا فضای ذخیره‌سازی کاهش یابد (و
دانلود) اندازه. در شرایط استثنایی، ممکن است ترجیح داده شود از آن اجتناب شود
فشرده سازی در این مورد می توان از گزینه «--dont-compress» استفاده کرد (مثلاً با «darcs
رکورد`) برای جلوگیری از فشرده سازی.

دستورات "darcs optimize uncompress" و "darcs optimize compres" را می توان برای
اطمینان حاصل کنید که وصله های موجود در مخزن فعلی به ترتیب فشرده نشده یا فشرده نشده اند
فشرده شده
دارک بهینه سازی پیوند مجدد
دستور «darcs optimize relink» وصله‌های سختی را که مخزن فعلی دارد، پیوند می‌دهد
مشترک با همتایان خود همتایان آن مخازنی هستند که در فهرست شده اند
«_darcs/prefs/sources»، یا با گزینه «--sibling» تعریف شده است (که می توان از آن استفاده کرد
چندین بار).

Darcs به طور خودکار از پیوندهای سخت استفاده می کند، بنابراین به ندرت به این دستور نیاز است. بیشتر است
اگر از «cp -r» به جای «darcs clone» برای کپی کردن یک مخزن استفاده کرده باشید، یا اگر
همان پچ را از یک مخزن راه دور به چندین مخزن محلی کشید.
دارک بهینه سازی تر و تازه
این دستور فرمت `_darcs/pristine.hashed/` را به روز می کند که متفاوت بود
قبل از دارک 2.3.1.
دارک بهینه سازی ارتقاء
مخازن قدیمی را به فرمت هش شده پیش فرض فعلی تبدیل کنید.
دارک بهینه سازی نهانگاه <فهرست راهنما> ...
این دستور فایل های منسوخ شده درون کش جهانی را حذف می کند. یک یا چند مورد طول می کشد
دایرکتوری ها به عنوان آرگومان ها، و به صورت بازگشتی همه مخازن موجود در آنها را جستجو می کند
دایرکتوری ها سپس تمام فایل‌های موجود در کش جهانی را که متعلق به آن‌ها نیستند، حذف می‌کند
مخازن وقتی هیچ دایرکتوری داده نمی شود، مخازن خانه کاربر را جستجو می کند
دایرکتوری.

همچنین به طور خودکار کش جهانی را به فرمت سطلی (پیش‌فرض) منتقل می‌کند.

دارک تعمیر
دستور "darcs repair" تلاش می کند تا خرابی موجود در مخزن فعلی را برطرف کند.
در حال حاضر فقط می تواند آسیب به درخت بکر را ترمیم کند، جایی که بیشتر است
فساد رخ می دهد. این دستور با اعمال متوالی عبارت، یک درخت بکر را بازسازی می کند
وصله های موجود در مخزن به یک درخت خالی.

پرچم "--dry-run" این عملیات را فقط خواندنی می کند و باعث می شود دارک ها ناموفق را ترک کنند.
(با وضعیت خروج غیر صفر) اگر بکر بازسازی شده با فعلی متفاوت باشد
تر و تازه.

دارک تبدیل دارک-2 <منبع> [مقصد>]
این دستور یک مخزن را که از پچ معنایی قدیمی «darcs-1» استفاده می کند به a تبدیل می کند
مخزن جدید با معنای «darcs-2» فعلی.

اخطار: مخزن تولید شده توسط این دستور توسط Darcs 1.x قابل درک نیست
وصله ها را نمی توان بین مخازن در قالب های darcs-1 و darcs-2 رد و بدل کرد.

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

دارک تبدیل صادرات
این دستور شما را قادر می سازد تا مخازن دارک را به git صادر کنید.

برای صادرات یکباره می توانید از دستور العمل استفاده کنید:

مخزن سی دی $
$ git init ../mirror
صادرات دارک تبدیل دلار | (cd ../mirror && git fast-import)

برای صادرات افزایشی با استفاده از marksfiles:

مخزن سی دی $
$ git init ../mirror
$ ../mirror/git.marks را لمس کنید
$ دارک تبدیل صادرات --read-marks darcs.marks --write-marks darcs.marks
| (cd ../mirror && git fast-import --import-marks=git.marks
--export-marks=git.marks)

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

همچنین، توجه داشته باشید که صادرات یک مخزن دارک به git دقیقاً وفادار نخواهد بود
اگر مخزن دارک دارای تضاد باشد، شرایط تاریخچه وجود دارد.

محدودیت ها:

* دایرکتوری های خالی توسط پروتکل صادرات سریع پشتیبانی نمی شوند. * یونیکد
نام فایل ها در حال حاضر به درستی مدیریت نمی شوند.
دیدن http://bugs.darcs.net/issue2359 .

دارک تبدیل واردات [<فهرست راهنما>]
این دستور مخازن git را به مخازن جدید دارک وارد می کند. گزینه های بیشتر
پذیرفته می شوند (به «darcs help init» مراجعه کنید).

برای تبدیل یک مخزن git به یک دارک جدید، می توانید اجرا کنید:
$ (cd gitrepo && git fast-export --all) | دارک تبدیل واردات darcsmirror

اخطار: مخازن git با شاخه ها نتایج عجیب و غریبی تولید می کنند،
با مسئولیت خود استفاده کنید

واردات افزایشی با marksfiles در حال حاضر پشتیبانی نمی شود.

دارک تخفیف کشیدن [مخزن] ...
پچ ها را از یک مخزن دیگر کپی و اعمال کنید و هر وصله محلی آن را به حالت تعلیق درآورید
درگیری
دارک تخفیف درخواست <پچ فایل>
یک پچ باندل را اعمال کنید و هر گونه وصله محلی را که در تضاد هستند به حالت تعلیق درآورید.
دارک تخفیف تعلیق
وصله ها را انتخاب کنید تا در پایان مخزن به حالت تعلیق حرکت کنید.

دارک تخفیف لغو تعلیق
وصله های انتخاب شده برای بازیابی از حالت تعلیق تا انتهای مخزن.

دارک تخفیف از بین بردن
وصله ای را که در حال حاضر معلق است پاک کنید.

دارک تخفیف ورود به سیستم
تغییرات تعلیق شده را فهرست کنید.

محیط زیست

صفحه اصلی و اطلاعات برنامه
تنظیمات برگزیده برای هر کاربر در $HOME/.darcs (در یونیکس) یا %APPDATA%/darcs (در ویندوز) تنظیم شده است.
این نیز محل پیش فرض کش است.

DARCS_EDITOR، سردبیر، دیداری و تدوین
برای ویرایش توضیحات وصله نظر ایمیل، Darcs یک ویرایشگر خارجی را فراخوانی می کند. شما
ویرایشگر ترجیحی را می توان به عنوان هر یک از متغیرهای محیطی $DARCS_EDITOR تنظیم کرد،
$DARCSEDITOR، $VISUAL یا $EDITOR. اگر هیچ کدام از اینها تنظیم نشده باشد، سردبیر(1) استفاده می شود.

DARCS_PAGER و PAGER
Darcs گاهی اوقات یک پیجر را فراخوانی می کند که خروجی آن بیش از حد طولانی باشد که نمی تواند روی صفحه نمایش داده شود.
Darcs از پیجر مشخص شده توسط $DARCS_PAGER یا $PAGER استفاده خواهد کرد. اگر هیچکدام تنظیم نشده باشند،
صفحه(1) استفاده خواهد شد.

DARCS_DONT_COLOR، DARCS_ALWAYS_COLOR، DARCS_ALTERNATIVE_COLOR و DARCS_DO_COLOR_LINES
اگر ترمینال دنباله های فرار رنگ ANSI را درک کند، دارک ها برخی را برجسته می کنند
کلمات کلیدی و جداکننده ها هنگام چاپ پچ ها. این را می توان با تنظیم خاموش کرد
متغیر محیطی DARCS_DONT_COLOR تا 1. اگر از پیجری استفاده می‌کنید که اتفاقاً متوجه می‌شود
رنگ‌های ANSI، مانند «کمتر -R»، دارک‌ها را می‌توان همیشه مجبور کرد تا خروجی را با تنظیم برجسته کنند.
DARCS_ALWAYS_COLOR به 1. اگر رنگ‌ها را نمی‌بینید، می‌توانید DARCS_ALTERNATIVE_COLOR را روی 1 تنظیم کنید،
و darcs از کدهای ANSI برای فیلم های پررنگ و معکوس به جای رنگ ها استفاده می کنند. علاوه بر این،
یک حالت بسیار رنگارنگ وجود دارد که به طور پیش فرض فعال نیست و می توان آن را فعال کرد
با DARCS_DO_COLOR_LINES

DARCS_DONT_ESCAPE_TRAILING_SPACES و DARCS_DONT_ESCAPE_TRAILING_CR
به طور پیش فرض دارک ها (در صورت امکان با برجسته کردن) از هر نوع فاصله در انتها فرار می کنند
خطوط هنگام نمایش محتویات پچ اگر این را نمی‌خواهید، می‌توانید آن را خاموش کنید
تنظیم DARCS_DONT_ESCAPE_TRAILING_SPACES روی 1. یک مورد خاص فقط برای حمل وجود دارد
برمی گرداند: DARCS_DONT_ESCAPE_TRAILING_CR

DARCS_DONT_ESCAPE_ANYTHING، DARCS_DONT_ESCAPE_ISPRINT، DARCS_DONT_ESCAPE_8BIT،
DARCS_DONT_ESCAPE_EXTRA و DARCS_ESCAPE_EXTRA
هنگام چاپ محتویات پچ در ترمینال، Darcs باید از کاراکترهای خاصی فرار کند.
کاراکترهایی مانند بک اسپیس می توانند محتوای پچ را از کاربر و غیره پنهان کنند
توالی کاراکترها حتی در برخی موارد می توانند در صورت ترمینال دستورات را به پوسته هدایت کنند
اجازه می دهد

دارک‌ها به‌طور پیش‌فرض فقط به کاراکترهای ASCII 7 بیتی قابل چاپ (شامل فاصله) و
دو کاراکتر کنترلی تب و خط جدید. تمام اکتت های دیگر به صورت نقل قول چاپ می شوند
(به عنوان `^ ` یا `\ `).

Darcs پشتیبانی محدودی از مناطق محلی دارد. اگر لوکال سیستم یک بایت باشد
رمزگذاری کاراکتر، مانند رمزگذاری های لاتین، می توانید متغیر محیط را تنظیم کنید
DARCS_DONT_ESCAPE_ISPRINT به 1 و darcs همه موارد قابل چاپ را در حال حاضر نمایش می دهد
محلی سیستم به جای آنهایی که فقط ASCII. توجه: این در حال حاضر روی برخی کار نمی کند
اگر darcs با GHC 6.4 یا جدیدتر کامپایل شده باشد، معماری ها. برخی از کنترل های غیر ASCII
ممکن است کاراکترها چاپ شوند و احتمالاً ترمینال را جعل کنند.

برای رمزگذاری کاراکترهای چند بایتی، همه چیز کمتر روان است. اگر تنظیم کنید UTF-8 کار خواهد کرد
DARCS_DONT_ESCAPE_8BIT به 1، اما غیرقابل چاپ خارج از محدوده ASCII 7 بیتی وجود ندارد
دیگر فرار کرد به عنوان مثال، کاراکترهای کنترل اضافی از Latin-1 ممکن است ترمینال شما را ترک کنند
به لطف محتویات پچ. کاراکترهای فضایی خارج از محدوده 7 بیتی ASCII هیچ هستند
دیگر تشخیص داده می شود و در انتهای خطوط به درستی از آن خارج نمی شود.

به‌عنوان آخرین راه‌حل، می‌توانید DARCS_DONT_ESCAPE_ANYTHING را روی 1 تنظیم کنید. سپس هر چیزی را که انجام نمی‌دهد
مجموعه‌های کد تلنگر باید کار کنند، و همه زنگ‌ها و سوت‌ها در ترمینال شما نیز کار خواهند کرد. این
اگر خروجی را به پیجر یا خارجی لوله کنید، متغیر محیطی نیز می تواند مفید باشد
فیلتری که بهتر از دارک می داند چگونه با کدگذاری شما کار کند. توجه داشته باشید که همه در حال فرار،
از جمله فرار ویژه از هر فاصله انتهایی خط، با این کار خاموش می شود
تنظیم می باشد.

دو متغیر محیطی وجود دارد که می توانید تنظیم کنید تا به طور صریح به دارک ها بگویید فرار نکنند یا
هشت گانه فرار آنها DARCS_DONT_ESCAPE_EXTRA و DARCS_ESCAPE_EXTRA هستند. ارزش های آنها
باید رشته‌هایی متشکل از هشت تای مورد نظر باشد. انجام فرار می گیرد
تقدم بر عدم فرار کاراکترهای فضایی هنوز در انتهای خطوط فرار می کنند
اگر چه. متغیر محیطی ویژه DARCS_DONT_ESCAPE_TRAILING_CR فرار را خاموش می کند
بازگشت آخرین بار در خط (سبک DOS).

DARCS_TMPDIR و TMPDIR
Darcs اغلب دایرکتوری های موقت ایجاد می کند. به عنوان مثال، دستور "darcs diff" ایجاد می کند
دو تا برای درختان کاری که باید متفاوت باشند. به طور پیش فرض دایرکتوری های موقت در ایجاد می شوند
دایرکتوری / tmp، یا اگر وجود ندارد، در _darcs (در مخزن فعلی). این میتواند باشد
با تعیین دایرکتوری دیگر در فایل _darcs/prefs/tmpdir یا
متغیر محیطی $DARCS_TMPDIR یا $TMPDIR.

DARCS_KEEP_TMPDIR
اگر متغیر محیطی DARCS_KEEP_TMPDIR تعریف شده باشد، دارک آن را حذف نخواهد کرد
دایرکتوری های موقتی که ایجاد می کند. این در درجه اول برای اشکال زدایی خود Darcs در نظر گرفته شده است،
اما همچنین می تواند مفید باشد، به عنوان مثال، برای تعیین اینکه چرا اولویت تست شما (به Darcs مراجعه کنید
setpref`) هنگام اجرای «darcs record» ناموفق است، اما هنگام اجرای دستی کار می کند.

DARCS_EMAIL و EMAIL
هر وصله معمولاً از طریق آدرس ایمیل (مثلاً «فرد
وبلاگ ها[ایمیل محافظت شده]>`). دارک در چندین جا به دنبال این رشته نویسنده است: the
گزینه «--author»، فایل های «_darcs/prefs/author» (در مخزن) و
`~/.darcs/author` (در فهرست اصلی شما)، و متغیرهای محیطی `$DARCS_EMAIL`
و '$EMAIL'. اگر هیچ‌کدام از آن‌ها وجود نداشته باشد، Darcs از شما می‌خواهد یک رشته نویسنده و
آن را به `~/.darcs/author`. توجه داشته باشید که اگر بیش از یک آدرس ایمیل دارید، می توانید
همه آنها را در `~/.darcs/author"، یک نویسنده در هر خط. دارک همچنان از شما درخواست می کند
یک نویسنده است، اما به شما امکان می دهد از لیست انتخاب کنید یا یک جایگزین را تایپ کنید.

ارسال پست الکترونیکی
در یونیکس، دستور «darcs send» بر آن تکیه دارد ارسال پست الکترونیکی(8). "--sendmail-command" یا
متغیر محیطی $SENDMAIL را می توان برای ارائه یک مسیر صریح به این برنامه استفاده کرد.
در غیر این صورت مکان های استاندارد /usr/sbin/sendmail و /usr/lib/sendmail محاکمه خواهد شد.

DARCS_SLOPPY_LOCKS
اگر در برخی از سیستم های فایل با خطایی از نوع:

darcs: takeLock [...]: atomic_create [...]: عملیات پشتیبانی نشده

ممکن است بخواهید صادرات DARCS_SLOPPY_LOCKS=درست را امتحان کنید.

DARCS_SSH
مخازن به شکل [user@]host:[dir] به عنوان مخازن راه دور در نظر گرفته می شوند که
Darcs با برنامه خارجی دسترسی دارد SSH(1).

متغیر محیطی $DARCS_SSH را می توان برای تعیین یک کلاینت جایگزین SSH استفاده کرد.
آرگومان ها ممکن است گنجانده شوند که با فضای خالی از هم جدا شده اند. مقدار با a تفسیر نمی شود
پوسته، بنابراین ساختارهای پوسته را نمی توان استفاده کرد. به ویژه، امکان پذیر نیست
نام برنامه حاوی فضای خالی با استفاده از نقل قول یا فرار است.

DARCS_SCP و DARCS_SFTP
هنگام خواندن از یک مخزن راه دور، Darcs سعی می کند «حالت انتقال دارک» را در آن اجرا کند.
میزبان راه دور اگر میزبان راه دور فقط Darcs 1 را نصب کرده باشد، شکست می خورد
Darcs را اصلاً نصب کرده باشید یا فقط SFTP را مجاز کنید.

اگر حالت انتقال ناموفق باشد، Darcs دوباره روشن می‌شود scp(1) و sftp(1). دستورات فراخوانی شده
را می توان با متغیرهای محیطی $DARCS_SCP و $DARCS_SFTP به ترتیب سفارشی کرد،
که مانند $DARCS_SSH رفتار می کنند. اگر انتهای راه دور فقط به sftp اجازه می دهد، تنظیمات را امتحان کنید
DARCS_SCP=sftp.

SSH_PORT
اگر این متغیر محیطی تنظیم شود، به عنوان شماره پورت برای همه تماس‌های SSH استفاده می‌شود
ساخته شده توسط Darcs (هنگام دسترسی به مخازن راه دور از طریق SSH). اگر SSH شما مفید است
سرور روی پورت پیش فرض اجرا نمی شود و کلاینت SSH شما پشتیبانی نمی کند
ssh_config(5). کاربران OpenSSH احتمالا ترجیح می دهند چیزی مانند «Host» قرار دهند
*.example.net پورت 443` به آنها ~ / .ssh / پیکربندی فایل.

HTTP_PROXY، HTTPS_PROXY، FTP_PROXY، ALL_PROXY و NO_PROXY
اگر Darcs با libcurl ساخته شده باشد، متغیرهای محیطی HTTP_PROXY، HTTPS_PROXY و
FTP_PROXY را می توان روی URL یک پروکسی در فرم تنظیم کرد

[پروتکل://] [:بندر]

در این صورت libcurl از پروکسی برای پروتکل مرتبط (HTTP، HTTPS و
FTP). متغیر محیطی ALL_PROXY می تواند برای تنظیم یک پراکسی برای همه libcurl ها استفاده شود
درخواست.

اگر متغیر محیطی NO_PROXY لیستی از نام هاست جدا شده با کاما است، دسترسی به
آن هاست ها پروکسی های تعریف شده توسط متغیرهای بالا را دور خواهند زد. مثلاً کاملاً است
رایج برای جلوگیری از درخواست های پروکسی به ماشین های موجود در شبکه محلی با

NO_PROXY=localhost,*.localdomain

برای سازگاری با سیاهگوش و همکاران، معادل های کوچک این متغیرهای محیطی
(به عنوان مثال $http_proxy) نیز درک می شوند و در اولویت به حروف بزرگ استفاده می شوند
نسخه ها

اگر Darcs با libcurl ساخته نشده باشد، همه این متغیرهای محیطی بی‌صدا نادیده گرفته می‌شوند.
و هیچ راهی برای استفاده از پروکسی وب وجود ندارد.

DARCS_PROXYUSERPWD
اگر Darcs با libcurl ساخته شده است، و شما از یک پروکسی وب استفاده می کنید که نیاز دارد
احراز هویت، می توانید متغیر محیطی $DARCS_PROXYUSERPWD را روی نام کاربری تنظیم کنید
و رمز عبور مورد انتظار توسط پروکسی که با یک دونقطه جدا شده است. این متغیر محیطی است
اگر Darcs با libcurl ساخته نشده باشد، بی‌صدا نادیده گرفته می‌شود.

DARCS_GET_FOO و DARCS_APPLY_FOO
هنگام تلاش برای دسترسی به یک مخزن با URL شروع به foo://، darcs را فراخوانی می کند
برنامه مشخص شده توسط متغیر محیطی DARCS_GET_FOO (در صورت تعریف) برای دانلود هر کدام
فایل، و فرمان مشخص شده توسط متغیر محیطی DARCS_APPLY_FOO (در صورت تعریف)
هنگام فشار دادن به آدرس اینترنتی foo://.

این روش همه راه‌های دیگر برای دریافت نشانی‌های اینترنتی «foo://xxx» را لغو می‌کند.

توجه داشته باشید که هر دستور باید طوری ساخته شود که محتوای دانلود شده را به آن ارسال کند
STDOUT، و آرگومان بعدی آن باید URL باشد. در اینجا چند نمونه وجود دارد که باید
کار برای DARCS_GET_HTTP:

واکشی -q -o -
حلقه -s -f
سیاهگوش -منبع
wget -q -O -

جدای از این گونه نمونه‌های اسباب‌بازی، احتمالاً باید بحث را دستکاری کنید
قبل از انتقال آن به برنامه واقعی واکشی. به عنوان مثال، مشکل را در نظر بگیرید
دسترسی خواندن به یک مخزن در یک اشتراک CIFS (SMB) بدون امتیازات نصب:

صادرات DARCS_GET_SMB='smbclient -c get'
دارک ها smb://fs/twb/Desktop/hello-world را دریافت می کنند

دستور بالا به چند دلیل کار نخواهد کرد. در مرحله اول، دارک آن را پاس می کند
آرگومان با `smb:` شروع می شود که smbclient آن را نمی فهمد. دوم، میزبان
و share `//fs/twb` باید به عنوان یک آرگومان جداگانه برای مسیر ارائه شود
"رومیزی/سلام جهان". ثالثاً، smbclient مستلزم این است که «get» و مسیر یکپارچه باشند
آرگومان (از جمله فاصله)، به جای دو آرگومان مجزا. در نهایت، smbclient's
دستور "get" فایل را روی دیسک می نویسد، در حالی که دارک انتظار دارد که به صورت استاندارد چاپ شود
خروجی.

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

در ادامه مثال smbclient، یک اسکریپت اجرایی ایجاد می کنیم
`~/.darcs/libexec/get_smbبا مطالب زیر:

#!/ bin / bash -e
IFS=/ خواندن فایل اشتراک میزبان <<<'${1#smb://}'
smbclient //$host/$share -c 'get $file -'

و در نهایت می توانیم بگوییم

صادرات DARCS_GET_SMB=~/.darcs/libexec/get_smb
دارک ها smb://fs/twb/Desktop/hello-world را دریافت می کنند

دستور APPLY با یک فایل patch darcs که در ورودی استاندارد آن لوله شده است فراخوانی می شود.

DARCS_CONNECTION_TIMEOUT
حداکثر زمانی را که دارک اجازه می‌دهد و اتصال طول می‌کشد را بر حسب ثانیه تنظیم کنید. اگر متغیر
مشخص نشده است پیش فرض 30 ثانیه است. این گزینه فقط با curl کار می کند.

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