Re: [Tinycc-devel] [PATCH] Update tcc-doc.texi: bring in line with `tcc -hh' output

[noneofyourbusiness]

remph <lhr@disroot.org> wrote:
> Just checking this with the list, if there are no amendments then I'll push
> it to mob soon
> 
> ---
>  tcc-doc.texi | 64 ++++++++++++++++++++++++++++++++++++++++++++++++----
>  tcc.c        |  8 +++----
>  2 files changed, 62 insertions(+), 10 deletions(-)
> 
> diff --git a/tcc-doc.texi b/tcc-doc.texi
> index 8d172c2a..ab85200b 100644
> --- a/tcc-doc.texi
> +++ b/tcc-doc.texi
> @@ -83,7 +83,7 @@ usage: tcc [options] [@var{infile1} @var{infile2}@dots{}] 
> [@option{-run} @var{in
>  
>  @noindent
>  @c man begin DESCRIPTION
> -TCC options are a very much like gcc options. The main difference is that TCC
> +TCC options are very much like gcc options. The main difference is that TCC
>  can also execute directly the resulting program and give it runtime
>  arguments.
>  
> @@ -185,6 +185,16 @@ Show included files.  As sole argument, print search 
> dirs.  -vvv shows tries too
>  @item -bench
>  Display compilation statistics.
>  
> +@item -pthread
> +Preprocess with @option{-D_REENTRANT}, link with @option{-lpthread}.
> +
> +@item -On
> +Pretend to optimise: set @option{-D__OPTIMIZE__} to the numeric value of n.
> +Note that TCC performs no optimisation.
this is not true - tcc performs very few optimisations, not none
what is true is that "tcc -c src.c" vs. "tcc -O2 -c src.c" can result in 
identical output
hence I would change that to
+Note that TCC performs no additional optimisation.

> +
> +@item -dt
> +With @option{-run}/@option{-E}: auto-define 'test_...' macros
> +
>  @end table
>  
>  Preprocessor options:
> @@ -199,6 +209,16 @@ include paths are: @file{/usr/local/include}, 
> @file{/usr/include}
>  and @file{PREFIX/lib/tcc/include}. (@file{PREFIX} is usually
>  @file{/usr} or @file{/usr/local}).
>  
> +@item -isystem dir
> +Specify a system include path to be added to the defaults.
> +
> +@item -nostdinc
> +Do not search the default system include paths; only search include paths
> +provided on the command line.
> +
> +@item -include file
> +Include @option{file} above each input file.
> +
>  @item -Dsym[=val]
>  Define preprocessor symbol @samp{sym} to
>  val. If val is not present, its value is @samp{1}. Function-like macros can
> @@ -210,6 +230,18 @@ Undefine preprocessor symbol @samp{sym}.
>  @item -E
>  Preprocess only, to stdout or file (with -o).
>  
> +@item -P
> +Do not output @code{#line} directives.
> +
> +@item -P1
> +Output alternative @code{#line} directives.
> +
> +@item -dD, -dM
> +Output @code{#define} directives.
> +
> +@item -Wp,-opt
> +Same as @option{-opt}.
> +
>  @end table
>  
>  Compilation flags:
> @@ -238,6 +270,15 @@ behaves like an unnamed one.
>  @item -fdollars-in-identifiers
>  Allow dollar signs in identifiers
>  
> +@item -freverse-funcargs
> +Evaluate function arguments right to left.
> +
> +@item -fgnu89-inline
> +@code{extern inline} is like @code{static inline}.
> +
> +@item -fasynchronous-unwind-tables
> +Create eh_frame section [on]
> +
>  @item -ftest-coverage
>  Create code coverage code. After running the resulting code an 
> executable.tcov
>  or sofile.tcov file is generated with code coverage.
> @@ -257,7 +298,10 @@ Note: each of the following warning options has a 
> negative form beginning with
>  
>  @table @option
>  @item -Wimplicit-function-declaration
> -Warn about implicit function declaration.
> +Warn about implicit function declaration (missing prototype).
> +
> +@item -Wdiscarded-qualifiers
> +Warn when const is dropped.
>  
>  @item -Wunsupported
>  Warn about unsupported GCC features that are ignored by TCC.
> @@ -272,7 +316,8 @@ the specified warning and turn it into an error, for 
> example
>  @option{-Werror=unsupported}.
>  
>  @item -Wall 
> -Activate some useful warnings.
> +Activate some useful warnings (@option{-Wimplicit-function-declaration},
> +@option{-Wdiscard-qualifiers}).
>  
>  @end table
>  
> @@ -288,6 +333,9 @@ Link your program with dynamic library libxxx.so or 
> static library
>  libxxx.a. The library is searched in the paths specified by the
>  @option{-L} option and @env{LIBRARY_PATH} variable.
>  
> +@item -nostdlib
> +Don't implicitly link with libc, the C runtime files, and libtcc1.
> +
>  @item -Bdir
>  Set the path where the tcc internal libraries (and include files) can be
>  found (default is @file{PREFIX/lib/tcc}).
> @@ -376,6 +424,13 @@ Misc options:
>  
>  @table @option
>  
> +@item -std=version
> +Define @code{__STDC_VERSION__}: @code{201112} if @option{version} is c11 or
> +gnu11; @code{199901} otherwise.
> +
> +@item -x[c|a|b|n]
> +Specify content of next input file: respectively C, assembly, binary, or 
> none.
> +
>  @item -M
>  Just output makefile fragment with dependencies
>  
> @@ -418,8 +473,7 @@ Pass command line to the i386/x86_64 cross compiler.
>  
>  @end table
>  
> -Note: GCC options @option{-Ox}, @option{-fx} and @option{-mx} are
> -ignored.
> +Note: GCC options @option{-fx} and @option{-mx} are ignored.
>  @c man end
>  
>  @c man begin ENVIRONMENT
> diff --git a/tcc.c b/tcc.c
> index e396a5d9..3c48d659 100644
> --- a/tcc.c
> +++ b/tcc.c
> @@ -50,6 +50,7 @@ static const char help[] =
>      "  -Dsym[=val]  define 'sym' with value 'val'\n"
>      "  -Usym        undefine 'sym'\n"
>      "  -E           preprocess only\n"
> +    "  -nostdinc    do not use standard system include paths\n"
>      "Linker options:\n"
>      "  -Ldir        add library path 'dir'\n"
>      "  -llib        link with dynamic or static library 'lib'\n"
> @@ -57,6 +58,7 @@ static const char help[] =
>      "  -shared      generate a shared library/dll\n"
>      "  -rdynamic    export all global symbols to dynamic linker\n"
>      "  -soname      set name for shared library to be used at runtime\n"
> +    "  -nostdlib    do not link with standard crt and libraries\n"
yeah, that makes more sense
I would put it before '-shared' - we can make it lexicographically ordered 
while we're at it
>      "  -Wl,-opt[=val]  set linker option (see tcc -hh)\n"
>      "Debugger options:\n"
>      "  -g           generate stab runtime debug info\n"
> @@ -73,8 +75,6 @@ static const char help[] =
>      "Misc. options:\n"
>      "  -std=version define __STDC_VERSION__ according to version 
> (c11/gnu11)\n"
>      "  -x[c|a|b|n]  specify type of the next infile (C,ASM,BIN,NONE)\n"
> -    "  -nostdinc    do not use standard system include paths\n"
> -    "  -nostdlib    do not link with standard crt and libraries\n"
>      "  -Bdir        set tcc's private include/library dir\n"
>      "  -M[M]D       generate make dependency file [ignore system files]\n"
>      "  -M[M]        as above but no other output\n"
> @@ -144,8 +144,6 @@ static const char help2[] =
>      "  -large-address-aware          set related PE option\n"
>      "  -subsystem=[console/windows]  set PE subsystem\n"
>      "  -oformat=[pe-* binary]        set executable output format\n"
> -    "Predefined macros:\n"
> -    "  tcc -E -dM - < nul\n"
>  #else
>      "  -rpath=                       set dynamic library search path\n"
>      "  -enable-new-dtags             set DT_RUNPATH instead of DT_RPATH\n"
> @@ -156,9 +154,9 @@ static const char help2[] =
>      "  -Bsymbolic                    set DT_SYMBOLIC elf tag\n"
>      "  -oformat=[elf32/64-* binary]  set executable output format\n"
>      "  -init= -fini= -Map= -as-needed -O   (ignored)\n"
> +#endif
>      "Predefined macros:\n"
>      "  tcc -E -dM - < /dev/null\n"
> -#endif
nice catch
>      "See also the manual for more details.\n"
>      ;
>

signature.asc
Description: PGP signature