.\"	$NetBSD$
.\"
.\" Copyright (c) 2009-2020 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 "Jan 28, 2020" "" ""
.SH NAME
mkc_check_custom \- run user's custom checks.
.SH SYNOPSIS
.BI mkc_check_custom " [-r] sourcefile"
.br
.BI mkc_check_custom " cmd [args...]"
.br
.BI mkc_check_custom " -h"
.SH DESCRIPTION
If
.I cmd
is executable
.B mkc_check_custom
runs
.IR "cmd args" .
Otherwise it tries to compile
.IR sourcefile
and output 1 if compilation succeeded and 0 otherwise.
If -r option was applied it runs a compiled program.
What type of compiler to use depends on
.I sourcefile
extension. '.c' corresponds to
.I ${CC}
(C language), '.cc', '.cxx', '.C' and '.cpp' correspond to
.I ${CXX}
(C++ language).
.SH OPTIONS
.TP
.B "-h"
Display help message.
.TP
.B "-r"
Run executable compiled from
.IR sourcefile .
.TP
.BI "-p " text
Prefix of the generated cache file. The default is "custom".
.TP
.BI "-n " text
Name part of the generated cache file.
.br
The default is `basename <sourcefile>`.
.TP
.BI "-m " text
Message
.B mkc_check_custom
outputs.
.br
The default is "custom test sourcefile_or_cmd".
.TP
.BI -s
.B mkc_check_custom 
outputs an exit status of
.IR "cmd args" .
.TP
.BI -d
Delete cache files.
.TP
.BI -e
Print 0 if compiler/cmd print something to stderr.
.TP
.B -b
Print yes/no instead of 1/0.
.SH ENVIRONMENT
.TP
.B CC
C compiler
.TP
.B CXX
C++ compiler
.TP
.B CPPFLAGS
Preprocessor flags for C and C++
.TP
.B CFLAGS
Compilation flags for C
.TP
.B CXXFLAGS
Compilation flags for C++
.TP
.B LDFLAGS
Additional linker flags
.TP
.B LDADD
Additional objects
.TP
.B MKC_VERBOSE
If set to 1, verbose messages are output to stderr.
.TP
.B MKC_SHOW_CACHED
If set to 1 and MKC_VERBOSE is set to 1, cached results
are output to stderr.
.TP
.B MKC_CACHEDIR
Directory where temporary and cache files are created.
If unset they are created in a current directory.
.TP
.B MKC_NOCACHE
All results are cached unless MKC_NOCACHE variable is set
to 1.
.TP
.B MKC_DELETE_TMPFILES
If set to 1, temporary files are removed.
.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>