aboutsummaryrefslogtreecommitdiffstatshomepage
path: root/configure.local.example
diff options
context:
space:
mode:
authorIngo Schwarze <schwarze@openbsd.org>2020-02-05 15:12:11 +0000
committerIngo Schwarze <schwarze@openbsd.org>2020-02-05 15:12:11 +0000
commit902cd39eea04826a46097ae7cd4ccecc3411bcb1 (patch)
tree3649bca1c911343d3ee75d071a32f77996888a39 /configure.local.example
parent5cf1df732d93997f3e216c27332ceb45638b8f43 (diff)
downloadmandoc-902cd39eea04826a46097ae7cd4ccecc3411bcb1.tar.gz
mandoc-902cd39eea04826a46097ae7cd4ccecc3411bcb1.tar.zst
mandoc-902cd39eea04826a46097ae7cd4ccecc3411bcb1.zip
No longer try to ask make(1) what the default compiler is, just use "cc".
That line was a bad idea in the first place, it tried to be too clever, and it failed in different ways on different platforms. Even when it succeeded, what make(1) considered the default wasn't always useful. Having a simple and robust default and asking users to override it when needed is better.
Diffstat (limited to 'configure.local.example')
-rw-r--r--configure.local.example25
1 files changed, 9 insertions, 16 deletions
diff --git a/configure.local.example b/configure.local.example
index 4a456aad..bfb2e3fd 100644
--- a/configure.local.example
+++ b/configure.local.example
@@ -1,4 +1,4 @@
-# $Id: configure.local.example,v 1.36 2019/03/06 10:18:58 schwarze Exp $
+# $Id: configure.local.example,v 1.37 2020/02/05 15:12:11 schwarze Exp $
#
# Copyright (c) 2014-2019 Ingo Schwarze <schwarze@openbsd.org>
#
@@ -28,6 +28,14 @@
# --- user settings relevant for all builds ----------------------------
+# By default, "cc" is used as the C compiler, but it can be overridden.
+# For example, the system compiler in SunOS 5.9 may not provide <stdint.h>,
+# which may require this line:
+CC=gcc
+
+# IBM AIX may need:
+CC=xlc
+
# For -Tutf8 and -Tlocale operation, mandoc(1) requires <locale.h>
# providing setlocale(3) and <wchar.h> providing wcwidth(3) and
# putwchar(3) with a wchar_t storing UCS-4 values. Theoretically,
@@ -268,21 +276,6 @@ BINM_CATMAN=mcatman # default is "catman"
# Do not set these variables unless you really need to.
-# You can manually override the compiler to be used.
-# But that's rarely useful because ./configure asks your make(1)
-# which compiler to use, and that answer will hardly be wrong.
-
-CC=cc
-
-# Because the system compiler may not provide <stdint.h>,
-# SunOS 5.9 may need:
-
-CC=gcc
-
-# IBM AIX may need:
-
-CC=xlc
-
# Normally, leave CFLAGS unset. In that case, -g will automatically
# be used, and various -W options will be added if the compiler
# supports them. If you define CFLAGS manually, it will be used