Date: Fri, 6 Apr 2018 13:25:54 +0200 From: Dimitry Andric <dim@FreeBSD.org> To: David Chisnall <theraven@FreeBSD.org> Cc: Pete Wright <pete@nomadlogic.org>, Steve Kargl <sgk@troutmask.apl.washington.edu>, Conrad Meyer <cem@freebsd.org>, freebsd-current <freebsd-current@freebsd.org>, Ed Maste <emaste@freebsd.org> Subject: Re: clang manual page? Message-ID: <09A15F48-0AEA-48C5-920B-232E474B405B@FreeBSD.org> In-Reply-To: <6691B42A-E56F-4432-82FA-42BC410EC152@FreeBSD.org> References: <20180405223852.GA43120@troutmask.apl.washington.edu> <CAG6CVpUpj7B6ujUSCUkznCBKSGKcuM2czZ=VBgKK%2Bkm5wFwfmg@mail.gmail.com> <20180406001514.GA43793@troutmask.apl.washington.edu> <347cc907-96b3-140d-5a8f-084f91283be5@nomadlogic.org> <6691B42A-E56F-4432-82FA-42BC410EC152@FreeBSD.org>
next in thread | previous in thread | raw e-mail | index | archive | help
--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 <theraven@FreeBSD.org> wrote: >=20 > On 6 Apr 2018, at 01:30, Pete Wright <pete@nomadlogic.org> 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<value> OpenCL language standard to compile for. >>> -std=3D<value> Language standard to compile for >>> -stdlib=3D<value> C++ standard library to use >>>=20 >>> Does <value> =3D=3D <language>? >>>=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--
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?09A15F48-0AEA-48C5-920B-232E474B405B>