From f84d8f0ce51cab59302d17046f350e23e4e3673c Mon Sep 17 00:00:00 2001
From: Ed Maste <emaste@FreeBSD.org>
Date: Mon, 23 Jul 2018 19:39:20 +0000
Subject: [PATCH] arch.7: Clarify architecture-specific macro use

Compilers may define multiple variants of architecture-specific macros
(for example, both __x86_64 and __x86_64__).  Add a note that the macros
documented in arch.7 are the preferred ones for FreeBSD.

Sponsored by:	The FreeBSD Foundation
---
 share/man/man7/arch.7 | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/share/man/man7/arch.7 b/share/man/man7/arch.7
index e7f8b013d695..6aa58210eb82 100644
--- a/share/man/man7/arch.7
+++ b/share/man/man7/arch.7
@@ -26,7 +26,7 @@
 .\"
 .\" $FreeBSD$
 .\"
-.Dd February 5, 2018
+.Dd July 23, 2018
 .Dt ARCH 7
 .Os
 .Sh NAME
@@ -342,6 +342,10 @@ Architecture-specific macros:
 .It riscv64sf   Ta Dv __riscv, Dv __riscv_xlen == 64
 .It sparc64     Ta Dv __sparc64__
 .El
+.Pp
+Compilers may define additional variants of architecture-specific macros.
+The macros above are preferred for use in
+.Fx .
 .Ss Important Xr make 1 variables
 Most of the externally settable variables are defined in the
 .Xr build 7