From: Eric S. Raymond Date: Wed, 10 Jul 2002 22:45:41 +0000 (+0000) Subject: SGML conversion. X-Git-Tag: 2.2~9 X-Git-Url: http://thyrsus.com/gitweb/?a=commitdiff_plain;h=8a069db9930fba2a5d9eacb26117797f9cf21ee5;p=cstrings.git SGML conversion. --- diff --git a/cstrings.xml b/cstrings.xml index eb4f0b0..4d6b46e 100644 --- a/cstrings.xml +++ b/cstrings.xml @@ -1,54 +1,86 @@ -.TH CSTRINGS 1 "July 10, 1990" -.SH NAME -cstrings -- quick-and-dirty internationalization tool -.SH SYNOPSIS -cstrings [-c] [-r ranges] [-t template] [-m minlength] files... -.SH DESCRIPTION -This tool can be used to massage input C source so that literal + + + +cstrings +1 +July 10, 1990 + + +cstrings + quick-and-dirty internationalization tool + + + + + + cstrings -c + -r ranges + -t template + -m minlength + files + + + + +DESCRIPTION +This tool can be used to massage input C source so that literal strings in it are replaced by generated #define symbols, with the list of #defines prepended to the resulting source code. String literals on -#include and #define lines and in comments are skipped. -.P -If no filenames are given, standard input is filtered to standard +#include and #define lines and in comments are skipped. + +If no filenames are given, standard input is filtered to standard output. If filenames are given (and appropriate write permissions are present), each file is replaced by its converted result (the replace is done with a link(2), so the program is signal-safe). To avoid heartbreak and death threats to the author, it is recommended that you not use this feature without looking at the filtered version first to -ensure that it's what you really want. -.P -The string argument of a -r option is interpreted as a comma-separated -list of line numbers or line number ranges to which the string -filtering is to be limited. A range of the form "-" is taken to -signify all lines from line to EOF; a range of the form "-" -signifies all lines from the start of file to line . Additionally, any -range or number may be preceded by '!'; this causes filtering to be suppressed -for the lines designated. If the first character of a range option is '!', -filtering is assumed initially on for all lines, rather than off. -.P -The -t option sets the template with which string labels are generated. The -default is "G%05d". The template is sprintf'ed with a sequence number as -argument. -.P -The -m option takes a numeric argument, interpreted as a minimum length. -All strings less than that size are ignored. Note that this minimum length -defaults to 3, you must say -m 1 or -m 2 to see all short strings. -.P -The -c option suppresses the normal action and instead causes a list of -strings that would otherwise be #define-ized (each preceded by its line -number) to be emitted to stdout. If -c is used with file arguments a -report with sections headed by file names will be generated. -.P -The -c option permits you to anticipate the effects of a substitution -without having to look at the whole source file. -.P -This tool is best used by doing repeated -c runs, adding to an -r -argument until you have it down to filtering just the lines you want, -and then dropping the -c to do the actual conversion. Then you can move -the list of generated #defines to an appropriate spot with a text editor. -.SH BUGS -This program makes no effort to be intelligent about duplicate -strings. Also, it doesn't handle quoted quotes within strings. -.SH AUTHOR -Eric S. Raymond . See my WWW home page at -http://www.ccil.org/~esr/home.html for updates and other resources. +ensure that it's what you really want. + +1The string argument of a option is +interpreted as a comma-separated list of line numbers or line number +ranges to which the string filtering is to be limited. A range of the +form "<num1>-" is taken to signify all lines from line +<num1> to EOF; a range of the form "-<num2>" signifies all +lines from the start of file to line <num2>. Additionally, any +range or number may be preceded by '!'; this causes filtering to be +suppressed for the lines designated. If the first character of a range +option is '!', filtering is assumed initially on for all lines, rather +than off. + +The option sets the template with which +string labels are generated. The default is "G%05d". The template is +sprintf'ed with a sequence number as argument. + +The option takes a numeric argument, +interpreted as a minimum length. All strings less than that size are +ignored. Note that this minimum length defaults to 3, you must say + 1 or 2 to see all short +strings. + +The option suppresses the normal action and +instead causes a list of strings that would otherwise be #define-ized +(each preceded by its line number) to be emitted to stdout. If + is used with file arguments a report with sections +headed by file names will be generated. + +The option permits you to anticipate the +effects of a substitution without having to look at the whole source +file. + +This tool is best used by doing repeated +runs, adding to an -r argument until you have it down to filtering +just the lines you want, and then dropping the to +do the actual conversion. Then you can move the list of generated +#defines to an appropriate spot with a text editor. + +BUGS +This program makes no effort to be intelligent about duplicate +strings. Also, it doesn't handle quoted quotes within strings. + + +AUTHOR +Eric S. Raymond <esr@snark.thyrsus.com>. See my WWW home +page at http://www.tuxedo.org/~esr/ for +updates and other resources. +