Index: doc/man/cfa.1 =================================================================== --- doc/man/cfa.1 (revision 7bd1bb544ce1bc6e33ef4d25b9399f1a7094a812) +++ doc/man/cfa.1 (revision 7dafb7b135da66032fbd090d190c88d338699333) @@ -11,6 +11,6 @@ .\" Created On : Wed Jul 26 22:34:47 2017 .\" Last Modified By : Peter A. Buhr -.\" Last Modified On : Thu Jul 27 10:29:29 2017 -.\" Update Count : 44 +.\" Last Modified On : Wed Sep 2 17:59:53 2020 +.\" Update Count : 78 .\" .\" nroff -man cfa.1 @@ -23,10 +23,14 @@ .ds Cf "Cforall .\" -.TH cfa 1 2017-07-27 cfa-\*(Mg +.TH CFA 1 "2020-09-2" cfa-\*(Mg "\*(Cf Project" .SH NAME -cfa \- \*(Cf Translator and Runtime Library +cfa \- \*(Cf project translator and runtime library to enhance C .SH SYNOPSIS -cfa [gcc-options] [C/\*(Cf source-files] [assembler/loader files] +cfa [cfa/gcc-options] + [cfa/c source-files] + [assembler/loader files] .SH DESCRIPTION +\*(Cf (C-for-all) is an open-source project extending ISO C with modern safety and productivity features, while still ensuring backwards compatibility with C and its programmers. + The cfa command compiles C and \*(Cf source files and links C/\*(Cf object files named on the command line. @@ -34,11 +38,12 @@ The cfa command introduces a translator pass over the specified source files after the C preprocessor but before the C compilation. The translator converts -new \*(Cf constructs into C statements. The cfa command also provides the -runtime library, which is linked with each \*(Cf application. +new \*(Cf constructs into C statements. The cfa command also provides a fully +concurrent (user-level threads) runtime library, which is linked with the +\*(Cf application. The command line options depend on the particular C compiler used (gcc/clang supported). As with most C compilers, the output is sent to the file a.out(5) unless the -o option is present on the command line. See the reference pages -for gcc(1) for more information. +for gcc(1) for more information on command line options. .SH OPTIONS When multiple conflicting options appear on the command line, e.g., @@ -50,29 +55,33 @@ All of the options available to the gcc compiler are available to the cfa translator. The following gcc flags are implicitly turned on: -.IP -std=gnu99 3 -The 1999 C standard plus GNU extensions. -.IP -fgnu89-inline -Use the traditional GNU semantics for inline routines in C99 mode, which allows inline routines in header files. +.IP "-std=gnu11" 3 +The 2011 C standard plus GNU extensions. +.IP "-fgnu89-inline" +Use the traditional GNU semantics for inline routines in C11 mode, which allows inline routines in header files. +.IP "-imacros stdbool.h" +Include stdbool.h to get defines for bool/true/false. +.IP "-latomic -lm" +Provide access to double-wide CAS instruction and math library. .LP The following additional options are available: -.IP -CFA 3 +.IP "-CFA" 3 Only the C preprocessor and the \*(Cf translator steps are performed and the transformed program is written to standard output, which makes it possible to examine the code generated by the \*(Cf translator. The generated code starts with the standard \*(Cf prelude. -.IP -debug +.IP "-debug" The program is linked with the debugging version of the runtime system. The debug version performs runtime checks to help during the debugging phase of a \*(Cf program, but can substantially slow program execution. The runtime checks should only be removed after the program is completely debugged. .B This option is the default. -.IP -nodebug +.IP "-nodebug" The program is linked with the non-debugging version of the runtime system, so the execution of the program is faster. .I However, no runtime checks or asserts are performed so errors usually result in abnormal program behaviour or termination. -.IP -help +.IP "-help" Information about the set of \*(Cf compilation flags is printed. -.IP -nohelp +.IP "-nohelp" Information about the set of \*(Cf compilation flags is not printed. .B This option is the default. -.IP -quiet +.IP "-quiet" The \*(Cf compilation message is not printed at the beginning of a compilation. -.IP -noquiet +.IP "-noquiet" The \*(Cf compilation message is printed at the beginning of a compilation. .B This option is the default. @@ -81,13 +90,13 @@ available. These variables allow conditional compilation of programs that must work differently in these situations. -.IP __CFA_MAJOR__ 3 +.IP "__CFA_MAJOR__" 3 is available during preprocessing and its value is the major version number of \*(Cf. -.IP __CFA_MINOR__ +.IP "__CFA_MINOR__" is available during preprocessing and its value is the minor version number of \*(Cf. -.IP __CFA_PATCH__ +.IP "__CFA_PATCH__" is available during preprocessing and its value is the patch level number of \*(Cf. .IP "__CFA__, __CFORALL__, and __cforall" are always available during preprocessing and have no value. -.IP __CFA_DEBUG__ +.IP "__CFA_DEBUG__" is available during preprocessing if the -debug compilation option is specified. @@ -116,16 +125,18 @@ .SH REFERENCES .HP 3 -\*(Cf Reference and Rational Manual +.I \*(Cf Home Page .br -http://plg.uwaterloo.ca/~cforall/refrat.pdf +https://cforall.uwaterloo.ca .HP .I \*(Cf User Manual .br -http://plg.uwaterloo.ca/~cforall/user.pdf +https://cforall.uwaterloo.ca/doc/user.pdf +.SH BUILDS +Nightly builds are available here https://cforall.uwaterloo.ca/jenkins .SH BUGS -Bugs should be reported to trac@plg.cs.uwaterloo.ca. +Bugs reportss are available here https://cforall.uwaterloo.ca/trac .SH COPYRIGHT \*(Cf is covered under the licence agreement in the distribution. .SH AUTHORS Andrew Beach, Richard Bilson, Peter A. Buhr, Thierry Delisle, Glen Ditchfield, -Rodolfo G. Esteves, Aaron Moss, Rob Schluntz +Rodolfo G. Esteves, Aaron Moss, Rob Schluntz, Mubeen Zulfiqar