.\"	$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_HEADER 1 "Dec 2, 2023" "" ""
.SH "نام (NAME)"
mkc_check_header \- بررسی و تشخیص وجود فایل سرایند
.SH "خلاصه دستور (SYNOPSIS)"
.BI mkc_check_header " [OPTIONS] <headers>"
.SH "توضیحات (DESCRIPTION)"
دستور
.B mkc_check_header
وجود فایل سرایند را بررسی می‌کند.
در نتیجه، مقدار 1 (درست) یا 0 (نادرست) را در stdout چاپ می‌کند.
آرگومان
.I headers
می‌تواند یک فایل سرایند تکی یا فهرستی از سرایندها باشد که با کاما از هم جدا شده‌اند.
در این حالت، تمام سرایندهای ذکر شده درون یک فایل .c منفرد قرار می‌گیرند و
.I "${CC}"
اجرا می‌شود.
به‌طور پیش‌فرض از
.I "$CC -c"
برای بررسی استفاده می‌شود.
به‌طور پیش‌فرض، فایل‌های موقت و حافظه نهان (کاشه) با الگوی
.RI _mkc_header_ lheader_h .{c,err,res}
درون دایرکتوری
.B MKC_CACHEDIR
ایجاد می‌شوند. در اینجا،
.I lheader_h
آخرین سرایند از فهرست جداشده با کامای
.IR headers
است.
.SH "گزینه‌ها (OPTIONS)"
.TP
.B "-h"
نمایش پیام راهنما.
.TP
.B "-e"
استفاده از
.I "$CC -E"
برای بررسی به‌جای
.IR "$CC -c" .
.TP
.B "-d"
حذف فایل‌های موقت و حافظه نهان.
.TP
.B "-D"
حذف فایل‌های حافظه نهان.
.SH "محیط (ENVIRONMENT)"
.TP
.B CC
کامپایلر. به‌طور پیش‌فرض از
.I cc
استفاده می‌شود.
.TP
.B CPPFLAGS, CFLAGS
گزینه‌های ارسال‌شده به کامپایلر.
.TP
.B MKC_VERBOSE
اگر برابر با 1 تنظیم شود، پیام‌های پرگویی (verbose) به 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_header stdint.h
   mkc_check_header getopt.h
   mkc_check_header sys/types.h,sys/stat.h,fts.h
.VE
.SH "محتوای فایل C (C FILE CONTENT)"
.VS
#include <header1.h>
 ...
#include <headerN.h>
int __fake_variable;
.VE
.SH "نویسندگان (AUTHORS)"
Aleksey Cheusov <vle@gmx.net>