.TH GRCAT 1 .SH "نام (NAME)" grcat \- خواندن از ورودی استاندارد، رنگ‌آمیزی آن و نوشتن در خروجی استاندارد .SH "خلاصه دستور (SYNOPSIS)" .B grcat .I "configuration" .SH "توضیحات (DESCRIPTION)" .I "configuration" نام یک فایل پیکربندی است. دایرکتوری‌های ~/.grc/، /usr/local/share/grc/، /usr/share/grc/ برای یافتن این فایل (به همین ترتیب) جستجو می‌شوند. اگر فایل پیدا نشود، فرض می‌شود که مسیر مطلق یک فایل پیکربندی در مکانی دیگر است. فایل پیکربندی از مدخل‌هایی تشکیل شده است، یکی به ازای هر عبارت باقاعده (regexp)؛ مدخل‌ها با خطوطی جدا می‌شوند که اولین نویسهٔ آن‌ها غیرحرفی-عددی است (به جز #). خطوطی که با # آغاز می‌شوند یا خطوط خالی نادیده گرفته می‌شوند. هر مدخل از چند خط تشکیل شده است. هر خط به این صورت است: .I keyword=value که در آن keyword یکی از موارد زیر است: .BR regexp "،" .BR colours "،" .BR command "،" .BR concat "،" .BR skip "،" .BR count ". تنها .BR regexp اجباری است، اما به خودی خود مفهوم چندانی ندارد مگر اینکه دست‌کم یکی از کلیدواژه‌های .BR colour یا .BR command را نیز مشخص کنید. .I regexp عبارت باقاعده برای تطبیق است. .I colours فهرستی از رنگ‌ها است که با کاما از یکدیگر جدا شده‌اند (می‌توانید تنها یک رنگ را مشخص کنید)، هر رنگ برای یک گروه مشخص‌شده در regexp. .I command دستوری است که هنگام تطبیق regexp اجرا می‌شود. خروجی آن با stdout عادی مخلوط خواهد شد؛ اگر می‌خواهید جلوی نمایش آن را بگیرید از هدایت‌کننده‌ها ( >/dev/null) استفاده کنید. .I replace بدین معناست که تطبیق عبارت باقاعده با مقدار جایگزین خواهد شد؛ تمام عبارات باقاعدهٔ پیشین بر روی متن اصلی ارزیابی می‌شوند، و تمام عبارات باقاعدهٔ پسین بر روی متن جایگزین‌شده ارزیابی خواهند شد. .I skip می‌تواند .BR yes "،" یا .BR no باشد؛ اگر yes باشد، از خط تطبیق‌یافته صرف‌نظر می‌شود و در خروجی نمایش داده نخواهد شد. پیش‌فرض no است. .I count یکی از کلمات زیر است: .BR once "،" .BR more "،" یا .BR stop ". .BR once بدین معناست که در صورت تطبیق regexp، اولین وقوع آن رنگ‌آمیزی می‌شود و برنامه با سایر regexpها ادامه می‌یابد. .BR more بدین معناست که اگر چندین تطبیق از regexp در یک خط وجود داشته باشد، همهٔ آن‌ها رنگ‌آمیزی خواهند شد. .BR stop بدین معناست که regexp رنگ‌آمیزی شده و برنامه به خط بعدی می‌رود (یعنی سایر regexpها را نادیده می‌گیرد). عبارات باقاعده از بالا به پایین ارزیابی می‌شوند؛ این امر امکان استفاده از عبارات تو در تو و هم‌پوشان را فراهم می‌سازد (برای مثال، همه‌چیز داخل پرانتز را با یک رنگ، رنگ‌آمیزی می‌کنید و چنانچه عبارت بعدی با متن درون پرانتز تطبیق یابد، آن نیز رنگ‌آمیزی خواهد شد). .SH "گزینه‌ها (OPTIONS)" تاکنون گزینه‌ای وجود ندارد. .SH "همچنین ببینید (SEE ALSO)" .BR grc "(1) .SH "نویسندگان (AUTHORS)" نوشته‌شده توسط Radovan Garab\('ik