diff options
author | Peter Breitenlohner <peb@mppmu.mpg.de> | 2009-11-26 12:35:03 +0000 |
---|---|---|
committer | Peter Breitenlohner <peb@mppmu.mpg.de> | 2009-11-26 12:35:03 +0000 |
commit | 8774983250625aa5257e374e94f95bc377b1c3f1 (patch) | |
tree | 800a6ae3c26a3aee6941ede1c71dad222bfb6a81 /Build/source/README.coding | |
parent | cd9f80c57b12f7aaa4ad1e07898aaa93b0df5bc3 (diff) |
rm getnonfreefonts-sys (dangling symlink)
git-svn-id: svn://tug.org/texlive/trunk@16175 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Build/source/README.coding')
-rw-r--r-- | Build/source/README.coding | 18 |
1 files changed, 9 insertions, 9 deletions
diff --git a/Build/source/README.coding b/Build/source/README.coding index fe7edbd3209..e2254ef0bed 100644 --- a/Build/source/README.coding +++ b/Build/source/README.coding @@ -8,7 +8,7 @@ Ideally, building all of TL with '--enable-compiler-warnings=max' should produce no (gcc) compiler warnings at all. In spite of considerable efforts into that direction we are still far from that goal and there are reasons that we may never fully reach it. Below are some rules about declarations -(of functions and variables) and the use of const. These rules should be +(of functions and variables) and the use of `const'. These rules should be applied to all parts of the TL tree, except in some of those maintained independently. @@ -19,11 +19,11 @@ independently. ----------------------------------------------- The TL build system no longer supports pre-ANSI C compilers. Thus all functions prototypes and definitions must conform to the ANSI C standard -(including 'void' in the declaration of functions that take no parameters). +(including `void' in the declaration of functions that take no parameters). 1.2. Static ----------- -Functions used in only one file must be declared 'static'; no prototype is +Functions used in only one file must be declared `static'; no prototype is required except as forward declaration. 1.3. Extern @@ -32,7 +32,7 @@ Functions used in several files require (extern) prototypes to be provided by a header files. That header must be included in the file defining the function and in all files using that function -- this is the only way to guarantee consistency between definition and use of functions. No more -'extern's sprinkled throughout the C code (with or without comment where +`extern's sprinkled throughout the C code (with or without comment where that function is defined). 1.4. Variables @@ -47,23 +47,23 @@ exectly one file. 2.1. Function parameters ------------------------ Ideally, a function parameter not modified by the function should be -declared as const. This is important in particiular for strings ('char *') +declared as const. This is important in particiular for strings (`char *') because frequently string literals are used as actual arguments. Note, -however, that a 'char **' value is not assignment compatible with a 'const -char **' variable. Getting all 'const's right often is quite involved but +however, that a `char **' value is not assignment compatible with a `const +char **' variable. Getting all `const's right often is quite involved but usually can be done. There are, however, a few notable exceptions: the X11 headers are full of declarations that ought to use const but do not and the same is true to some extent for zlib. 2.2. What must be avoided ------------------------- -The compiler warnings 'assignment/initialization/passing arg/return discards +The compiler warnings `assignment/initialization/passing arg/return discards qualifiers...' must be avoided under all circumstances, except when caused by X11 headers/macros or third party code. 2.3. What should be avoided --------------------------- -A type cast, e.g., from 'const char *' to 'char *' doesn't solve any +A type cast, e.g., from `const char *' to `char *' doesn't solve any problems, depending on warning options it only may hide them. Therefore such casts should be avoided whenever possible but some such casts may be unavoidable. |