Re: clang manual page?

On 6 Apr 2018, at 20:39, Steve Kargl <sgk_at_troutmask.apl.washington.edu> wrote:
> 
> On Fri, Apr 06, 2018 at 01:25:54PM +0200, Dimitry Andric wrote:
>> 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.
>> 
> 
> Index: clang.1
> ===================================================================
> --- clang.1	(revision 332114)
> +++ clang.1	(working copy)
> _at__at_ -128,15 +128,72 _at__at_
> .UNINDENT
> .INDENT 0.0
> .TP
> -.B \-std=<language>
> -Specify the language standard to compile for.
> +.B \-std=<value>
> +Specify the language standard to enforce.
> +
> +A partial list of validate
> +.B <value>
> +for the C programming language is
> +.INDENT 7.0
> +.INDENT 3.5
> +\fIc89\fP     ISO/IEC 9899:1990
> +.sp
> +\fIc90\fP     ISO/IEC 9899:1990
> +.sp
> +\fIc99\fP     ISO/IEC 9899:1999
> +.sp
> +\fIc11\fP     ISO/IEC 9899:2011
> +.sp
> +\fIc17\fP     Working draft for ISO/EIC 9899:2017
> +.sp
> +\fIgnu89\fP   ISO/IEC 9899:1990 with GNU extensions
> +.sp
> +\fIgnu90\fP   ISO/IEC 9899:1990 with GNU extensions
> +.sp
> +\fIgnu99\fP   ISO/IEC 9899:1999 with GNU extensions
> +.sp
> +\fIgnu11\fP   ISO/IEC 9899:2011 with GNU extensions
> +.sp
> +\fIgnu17\fP   Draft for ISO/EIC 9899:2017 with GNU extensions
> .UNINDENT
> +.UNINDENT
> +
> +A partial list of validate
> +.B <value>
> +for the C++ programming language is
> +.INDENT 7.0
> +.INDENT 3.5
> +\fIc++98\fP   ISO/IEC 14882:1998 with amendments
> +.sp
> +\fIc++03\fP   ISO/IEC 14882:2003 with amendments
> +.sp
> +\fIc++11\fP   ISO/IEC 14882:2011 with amendments
> +.sp
> +\fIc++14\fP   ISO/IEC 14882:2014 with amendments
> +.sp
> +\fIc++17\fP   ISO/IEC 14882:2017 with amendments
> +.sp
> +\fIc++2a\fP   Draft ISO/IEC 14882:2020
> +.sp
> +\fIgnu++98\fP ISO/IEC 14882:1998 with amendments and GNU extensions
> +.sp
> +\fIgnu++03\fP ISO/IEC 14882:2003 with amendments and GNU extensions
> +.sp
> +\fIgnu++11\fP ISO/IEC 14882:2011 with amendments and GNU extensions
> +.sp
> +\fIgnu++14\fP ISO/IEC 14882:2014 with amendments and GNU extensions
> +.sp
> +\fIgnu++17\fP ISO/IEC 14882:2017 with amendments and GNU extensions
> +.sp
> +\fIgnu++2a\fP Draft ISO/IEC 14882:2020 with GNU extensions
> +.UNINDENT
> +.UNINDENT
> +.UNINDENT
> .INDENT 0.0
> .TP
> .B \-stdlib=<library>
> Specify the C++ standard library to use; supported options are libstdc++ and
> libc++. If not specified, platform default will be used.
> -.UNINDENT
> .INDENT 0.0
> .TP
> .B \-rtlib=<library>

Thanks for the diff, but the man page is generated from a .rst source,
so it will have to be changed there instead.  I will submit an analogous
patch upstream for the rst file.

-Dimitry