.\"	$NetBSD$
.\"
.\" Copyright (c) by Aleksey Cheusov (vle@gmx.net)
.\" Absolutely no warranty.
.\"
.\" ------------------------------------------------------------------
.de VS \" Verbatim Start
.ft CW
.nf
.ne \\$1
..
.de VE \" Verbatim End
.ft R
.fi
..
.\" ------------------------------------------------------------------
.TH MKC_CHECK_CUSTOM 1 "Dec 2, 2023" "" ""
.SH "نام (NAME)"
mkc_check_custom \- اجرای بررسی‌های سفارشی کاربر
.SH "خلاصه دستور (SYNOPSIS)"
.BI mkc_check_custom " [-r] sourcefile"
.br
.BI mkc_check_custom " cmd [args...]"
.br
.BI mkc_check_custom " -h"
.SH "توضیحات (DESCRIPTION)"
اگر
.I cmd
قابل اجرا باشد،
.B mkc_check_custom
دستور
.IR "cmd args"
را اجرا می‌کند.
در غیر این صورت تلاش می‌کند
.IR sourcefile
را کامپایل کند و در صورت موفقیت کامپایل 1 و در غیر این صورت 0 را در خروجی چاپ کند.
اگر گزینه -r اعمال شده باشد، برنامه کامپایل‌شده را اجرا می‌کند.
اینکه چه نوع کامپایلری استفاده شود به پسوند
.I sourcefile
بستگی دارد؛ پسوند '.c' متناظر با
.I ${CC}
(زبان C)، و '.cc' ،'.cxx' ،'.C' و '.cpp' متناظر با
.I ${CXX}
(زبان ++C) هستند.
.SH "گزینه‌ها (OPTIONS)"
.TP
.B "-h"
نمایش پیام راهنما.
.TP
.B "-r"
اجرای فایل اجرایی کامپایل‌شده از
.IR sourcefile .
.TP
.BI "-p " text
پیشوند فایل حافظه پنهان (کش) تولیدشده. پیش‌فرض "custom" است.
.TP
.BI "-n " text
بخش نام در فایل حافظه پنهان تولیدشده.
.br
پیش‌فرض `basename <sourcefile>` است.
.TP
.BI "-m " text
پیامی که
.B mkc_check_custom
در خروجی چاپ می‌کند.
.br
پیش‌فرض "custom test sourcefile_or_cmd" است.
.TP
.BI -s
دستور
.B mkc_check_custom 
کد وضعیت خروج
.IR "cmd args"
را در خروجی چاپ می‌کند.
.TP
.BI -d
حذف فایل‌های حافظه پنهان و فایل‌های موقت.
.TP
.BI -D
حذف فایل‌های حافظه پنهان.
.TP
.BI -e
اگر کامپایلر یا cmd چیزی در stderr چاپ کند، مقدار 0 را چاپ می‌کند.
.TP
.B -b
چاپ yes/no به جای 1/0.
.SH "محیط (ENVIRONMENT)"
.TP
.B CC
کامپایلر C
.TP
.B CXX
کامپایلر ++C
.TP
.B CPPFLAGS
فلگ‌های پیش‌پردازنده برای C و ++C
.TP
.B CFLAGS
فلگ‌های کامپایل برای C
.TP
.B CXXFLAGS
فلگ‌های کامپایل برای ++C
.TP
.B LDFLAGS
فلگ‌های پیونددهنده اضافی
.TP
.B LDADD
اشیای پیوند (objects) اضافی
.TP
.B MKC_VERBOSE
اگر روی 1 تنظیم شود، پیام‌های پرگویی به stderr ارسال می‌شوند.
.TP
.B MKC_SHOW_CACHED
اگر روی 1 تنظیم شود و MKC_VERBOSE نیز 1 باشد، نتایج ذخیره‌شده در حافظه پنهان به stderr ارسال می‌شوند.
.TP
.B MKC_CACHEDIR
دایرکتوری که فایل‌های موقت و حافظه پنهان در آن ایجاد می‌شوند.
اگر تنظیم نشده باشد، در دایرکتوری فعلی ایجاد می‌شوند.
.TP
.B MKC_NOCACHE
همه نتایج ذخیره می‌شوند مگر اینکه متغیر MKC_NOCACHE روی 1 تنظیم شده باشد.
.TP
.B MKC_DELETE_TMPFILES
اگر روی 1 تنظیم شود، فایل‌های موقت حذف می‌شوند.
.SH "مثال‌ها (EXAMPLES)"
.VS
   mkc_check_custom alloca_in_stdlib.c
   mkc_check_custom custom_checks/cxx_foo_test.cc
   mkc_check_custom /full/path/to/yacc_need_liby
.VE
.SH "نویسنده (AUTHOR)"
Aleksey Cheusov <vle@gmx.net>