برگ ۶ · دفتر روش

دفتری که با یک میز و یک کلید شروع شد

فرمان‌خانه از یک عادت کوچک شروع شد: نوشتن فرمان‌هایی که هر روز از نو فراموش می‌شوند. هر برگه در این دفتر از همان جنس است، با یک تفاوت: پیش از ثبت، سه بار آزمایش می‌شود. یک بار روی مک، یک بار روی لینوکس، و یک بار با نام فایلی که فاصله و نویسهٔ فارسی دارد.

سه بازبینی

  1. بازبینی دستور. خود فرمان در یک پوستهٔ تازه و بدون هیچ تنظیم شخصی اجرا می‌شود. اگر به فایل پیکربندی وابسته باشد، یا حذف می‌شود یا صریح نوشته می‌شود که وابسته است.
  2. بازبینی دام. ستون دام تنها وقتی نوشته می‌شود که خودمان آن را دیده باشیم. دام‌هایی که از شنیده‌ها می‌آیند، در دفتر جایی ندارند.
  3. بازبینی فارسی. فرمان یک بار دیگر با نام فایل فارسی، با نیم‌فاصله و با فاصله اجرا می‌شود. بیشتر خطاهای فارسی در همین مرحله بیرون می‌آیند.

آنچه این دفتر نیست

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

منابعی که به آن‌ها تکیه می‌کنیم

برای معنای کدهای خروج و رفتار پوسته، به مستندات پروژهٔ گنو و صفحهٔ راهنمای بش تکیه می‌کنیم. برای ابزارهای پایه، صفحهٔ راهنمای همان سیستم و متن استاندارد پوزیکس راهنما هستند. پیوندهای بیرونی در همین صفحه آمده‌اند و در برگه‌های دیگر تکرار نمی‌شوند:

تصحیح و بازبینی

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

چرا این دفتر جداگانه نوشته شد

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

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