From owner-freebsd-current@freebsd.org Fri Apr 6 11:25:57 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 89EAAF9DD5B for ; Fri, 6 Apr 2018 11:25:57 +0000 (UTC) (envelope-from dim@FreeBSD.org) Received: from tensor.andric.com (tensor.andric.com [87.251.56.140]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client CN "tensor.andric.com", Issuer "COMODO RSA Domain Validation Secure Server CA" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id EFAFD753C8; Fri, 6 Apr 2018 11:25:56 +0000 (UTC) (envelope-from dim@FreeBSD.org) Received: from coleburn.home.andric.com (coleburn.home.andric.com [192.168.0.15]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by tensor.andric.com (Postfix) with ESMTPSA id 69FBB44DC2; Fri, 6 Apr 2018 13:25:55 +0200 (CEST) From: Dimitry Andric Message-Id: <09A15F48-0AEA-48C5-920B-232E474B405B@FreeBSD.org> Content-Type: multipart/signed; boundary="Apple-Mail=_95A0DA1D-D80C-491D-806D-2AAD8F0B5185"; protocol="application/pgp-signature"; micalg=pgp-sha1 Mime-Version: 1.0 (Mac OS X Mail 10.3 \(3273\)) Subject: Re: clang manual page? Date: Fri, 6 Apr 2018 13:25:54 +0200 In-Reply-To: <6691B42A-E56F-4432-82FA-42BC410EC152@FreeBSD.org> Cc: Pete Wright , Steve Kargl , Conrad Meyer , freebsd-current , Ed Maste To: David Chisnall References: <20180405223852.GA43120@troutmask.apl.washington.edu> <20180406001514.GA43793@troutmask.apl.washington.edu> <347cc907-96b3-140d-5a8f-084f91283be5@nomadlogic.org> <6691B42A-E56F-4432-82FA-42BC410EC152@FreeBSD.org> 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 11:25:57 -0000 --Apple-Mail=_95A0DA1D-D80C-491D-806D-2AAD8F0B5185 Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset=us-ascii On 6 Apr 2018, at 07:20, David Chisnall wrote: >=20 > On 6 Apr 2018, at 01:30, Pete Wright wrote: >>=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 >=20 > 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? Yes, but that manual is also pretty much incomplete, so with the last import I decided to stay with the older perl doc based one. Upstream is pretty bad at writing detailed documentation, certainly in the form of man pages. With lld there wasn't even *any* form of command line documentation yet, which is why Ed slapped together a man page (that could probably still use more details). It should really be upstreamed, in Sphinx's RST format, or since they appear to gravitate towards Markdown now, maybe already in that format. For a clang man page I'd really prefer working with upstream to get some more details in there, like an exhaustive list of which -std=3D options are supported. But it's quite a lot of effort. -Dimitry --Apple-Mail=_95A0DA1D-D80C-491D-806D-2AAD8F0B5185 Content-Transfer-Encoding: 7bit Content-Disposition: attachment; filename=signature.asc Content-Type: application/pgp-signature; name=signature.asc Content-Description: Message signed with OpenPGP -----BEGIN PGP SIGNATURE----- Version: GnuPG/MacGPG2 v2.2 iF0EARECAB0WIQR6tGLSzjX8bUI5T82wXqMKLiCWowUCWsdZQgAKCRCwXqMKLiCW o/iMAKDMyrCe5xX5c+vesSqV82wWkrAiqwCgvnwsJq+rdKZj0ZFwjHON6lIMAPk= =a20P -----END PGP SIGNATURE----- --Apple-Mail=_95A0DA1D-D80C-491D-806D-2AAD8F0B5185--