From owner-freebsd-current@freebsd.org Fri Apr 6 05:20:51 2018 Return-Path: Delivered-To: freebsd-current@mailman.ysv.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mailman.ysv.freebsd.org (Postfix) with ESMTP id 3C801F80637 for ; Fri, 6 Apr 2018 05:20:51 +0000 (UTC) (envelope-from theraven@FreeBSD.org) Received: from theravensnest.org (theravensnest.org [46.226.110.62]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client CN "theravensnest.org", Issuer "Let's Encrypt Authority X3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id BEC168508D; Fri, 6 Apr 2018 05:20:50 +0000 (UTC) (envelope-from theraven@FreeBSD.org) Received: from [192.168.1.65] (host86-156-0-78.range86-156.btcentralplus.com [86.156.0.78]) (authenticated bits=0) by theravensnest.org (8.15.2/8.15.2) with ESMTPSA id w365KRGk017312 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=NO); Fri, 6 Apr 2018 05:20:28 GMT (envelope-from theraven@FreeBSD.org) X-Authentication-Warning: mail: Host host86-156-0-78.range86-156.btcentralplus.com [86.156.0.78] claimed to be [192.168.1.65] Content-Type: text/plain; charset=us-ascii Mime-Version: 1.0 (Mac OS X Mail 10.3 \(3273\)) Subject: Re: clang manual page? From: David Chisnall In-Reply-To: <347cc907-96b3-140d-5a8f-084f91283be5@nomadlogic.org> Date: Fri, 6 Apr 2018 06:20:41 +0100 Cc: sgk@troutmask.apl.washington.edu, Conrad Meyer , freebsd-current Content-Transfer-Encoding: quoted-printable Message-Id: <6691B42A-E56F-4432-82FA-42BC410EC152@FreeBSD.org> References: <20180405223852.GA43120@troutmask.apl.washington.edu> <20180406001514.GA43793@troutmask.apl.washington.edu> <347cc907-96b3-140d-5a8f-084f91283be5@nomadlogic.org> To: Pete Wright X-Mailer: Apple Mail (2.3273) X-BeenThere: freebsd-current@freebsd.org X-Mailman-Version: 2.1.25 Precedence: list List-Id: Discussions about the use of FreeBSD-current List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 06 Apr 2018 05:20:51 -0000 On 6 Apr 2018, at 01:30, Pete Wright wrote: >=20 >=20 > On 04/05/2018 17:15, Steve Kargl wrote: >> This assumes that a gcc(1) is available on the system. >>=20 >> % man gcc >> No manual entry for gcc >>=20 >> If the system compiler is clang/clang++, then it ought to be >> documented better than it currently is. Ian's suggests for >> 'clang --help' is even worse >>=20 >> % clang --help | grep -- -std >> -cl-std=3D OpenCL language standard to compile for. >> -std=3D Language standard to compile for >> -stdlib=3D C++ standard library to use >>=20 >> Does =3D=3D ? >>=20 > a quick google search turns up the following additional information: >=20 > "clang supports the -std option, which changes what language mode = clang uses. The supported modes for C are c89, gnu89, c99, gnu99, c11, = gnu11, c17, gnu17, and various aliases for those modes. If no -std = option is specified, clang defaults to gnu11 mode. Many C99 and C11 = features are supported in earlier modes as a conforming extension, with = a warning. Use |-pedantic-errors| to request an error if a feature from = a later standard revision is used in an earlier mode." >=20 > https://clang.llvm.org/docs/UsersManual.html I believe that the clang user manual referenced here is written in = Sphynx, which is able to generate mandoc output as well as HTML. = Perhaps we should incorporate the generated file in the next import? David