Update tcc-doc.texi: bring in line with `tcc -hh' output

remph committed 1 year ago

Commit f8bd1361 parent f6385c02 files · +62 −8Browse files

Unified · Split

2 files

tcc-doc.texi +59 −5
tcc.c +3 −3

 @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.
 @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 additional optimisation.
+@item -dt
+With @option{-run}/@option{-E}: auto-define 'test_...' macros
 @end table
 Preprocessor options:
 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
 @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:
 @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.
 @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.
 @option{-Werror=unsupported}.
 @item -Wall
-Activate some useful warnings.
+Activate some useful warnings (@option{-Wimplicit-function-declaration},
+@option{-Wdiscard-qualifiers}).
 @end table
 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}).
 @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
 @end table
-Note: GCC options @option{-Ox}, @option{-fx} and @option{-mx} are
+Note: GCC options @option{-fx} and @option{-mx} are ignored.
-ignored.
 @c man end
 @c man begin ENVIRONMENT

tcc.c+3−3

     "  -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"
+    "  -nostdlib    do not link with standard crt and libraries\n"
     "  -r           generate (relocatable) object file\n"
-    "  -shared      generate a shared library/dll\n"
     "  -rdynamic    export all global symbols to dynamic linker\n"
+    "  -shared      generate a shared library/dll\n"
     "  -soname      set name for shared library to be used at runtime\n"
     "  -Wl,-opt[=val]  set linker option (see tcc -hh)\n"
     "Debugger options:\n"
     "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"

Update tcc-doc.texi: bring in line with `tcc -hh' output

Keyboard shortcuts

General

Issues and pull requests

Issues, pull requests and Inbox

Repository code