Fossil SCM
Improved header comment provides addition documentation for the "translate.c" compilation tool. No changes to code.
Commit
7e5f3062354c41918d53a5271b5b71e440c23206
Parent
b4c97d76a7ec6ad…
1 file changed
+15
+15
| --- src/translate.c | ||
| +++ src/translate.c | ||
| @@ -30,10 +30,25 @@ | ||
| 30 | 30 | ** |
| 31 | 31 | ** This tool allows us to put raw HTML, without the special codes, in |
| 32 | 32 | ** the middle of a C program. This program then translates the text |
| 33 | 33 | ** into standard C by inserting all necessary backslashes and other |
| 34 | 34 | ** punctuation. |
| 35 | +** | |
| 36 | +** Enhancement #1: | |
| 37 | +** | |
| 38 | +** If the last non-whitespace character prior to the first "@" of a | |
| 39 | +** @-block is "=" or "," then the @-block is a string literal initializer | |
| 40 | +** rather than text that is to be output via cgi_printf(). Render it | |
| 41 | +** as such. | |
| 42 | +** | |
| 43 | +** Enhancement #2: | |
| 44 | +** | |
| 45 | +** Comments of the form: "/* @-comment: CC" cause CC to become a | |
| 46 | +** comment character for the @-substitution. Typical values for CC are | |
| 47 | +** "--" (for SQL text) or "#" (for TCL script) or "//" (for C++ code). | |
| 48 | +** Lines of subsequent @-blocks that begin with CC are omitted from the | |
| 49 | +** output. | |
| 35 | 50 | ** |
| 36 | 51 | */ |
| 37 | 52 | #include <stdio.h> |
| 38 | 53 | #include <ctype.h> |
| 39 | 54 | #include <stdlib.h> |
| 40 | 55 |
| --- src/translate.c | |
| +++ src/translate.c | |
| @@ -30,10 +30,25 @@ | |
| 30 | ** |
| 31 | ** This tool allows us to put raw HTML, without the special codes, in |
| 32 | ** the middle of a C program. This program then translates the text |
| 33 | ** into standard C by inserting all necessary backslashes and other |
| 34 | ** punctuation. |
| 35 | ** |
| 36 | */ |
| 37 | #include <stdio.h> |
| 38 | #include <ctype.h> |
| 39 | #include <stdlib.h> |
| 40 |
| --- src/translate.c | |
| +++ src/translate.c | |
| @@ -30,10 +30,25 @@ | |
| 30 | ** |
| 31 | ** This tool allows us to put raw HTML, without the special codes, in |
| 32 | ** the middle of a C program. This program then translates the text |
| 33 | ** into standard C by inserting all necessary backslashes and other |
| 34 | ** punctuation. |
| 35 | ** |
| 36 | ** Enhancement #1: |
| 37 | ** |
| 38 | ** If the last non-whitespace character prior to the first "@" of a |
| 39 | ** @-block is "=" or "," then the @-block is a string literal initializer |
| 40 | ** rather than text that is to be output via cgi_printf(). Render it |
| 41 | ** as such. |
| 42 | ** |
| 43 | ** Enhancement #2: |
| 44 | ** |
| 45 | ** Comments of the form: "/* @-comment: CC" cause CC to become a |
| 46 | ** comment character for the @-substitution. Typical values for CC are |
| 47 | ** "--" (for SQL text) or "#" (for TCL script) or "//" (for C++ code). |
| 48 | ** Lines of subsequent @-blocks that begin with CC are omitted from the |
| 49 | ** output. |
| 50 | ** |
| 51 | */ |
| 52 | #include <stdio.h> |
| 53 | #include <ctype.h> |
| 54 | #include <stdlib.h> |
| 55 |