| Index: gperf/src/gperf/3.0.1/gperf-3.0.1-src/tests/test-6.exp |
| =================================================================== |
| --- gperf/src/gperf/3.0.1/gperf-3.0.1-src/tests/test-6.exp (revision 0) |
| +++ gperf/src/gperf/3.0.1/gperf-3.0.1-src/tests/test-6.exp (revision 0) |
| @@ -0,0 +1,135 @@ |
| +GNU 'gperf' generates perfect hash functions. |
| + |
| +Usage: ../src/gperf [OPTION]... [INPUT-FILE] |
| + |
| +If a long option shows an argument as mandatory, then it is mandatory |
| +for the equivalent short option also. |
| + |
| +Output file location: |
| + --output-file=FILE Write output to specified file. |
| +The results are written to standard output if no output file is specified |
| +or if it is -. |
| + |
| +Input file interpretation: |
| + -e, --delimiters=DELIMITER-LIST |
| + Allow user to provide a string containing delimiters |
| + used to separate keywords from their attributes. |
| + Default is ",". |
| + -t, --struct-type Allows the user to include a structured type |
| + declaration for generated code. Any text before %% |
| + is considered part of the type declaration. Key |
| + words and additional fields may follow this, one |
| + group of fields per line. |
| + --ignore-case Consider upper and lower case ASCII characters as |
| + equivalent. Note that locale dependent case mappings |
| + are ignored. |
| + |
| +Language for the output code: |
| + -L, --language=LANGUAGE-NAME |
| + Generates code in the specified language. Languages |
| + handled are currently C++, ANSI-C, C, and KR-C. The |
| + default is C. |
| + |
| +Details in the output code: |
| + -K, --slot-name=NAME Select name of the keyword component in the keyword |
| + structure. |
| + -F, --initializer-suffix=INITIALIZERS |
| + Initializers for additional components in the keyword |
| + structure. |
| + -H, --hash-function-name=NAME |
| + Specify name of generated hash function. Default is |
| + 'hash'. |
| + -N, --lookup-function-name=NAME |
| + Specify name of generated lookup function. Default |
| + name is 'in_word_set'. |
| + -Z, --class-name=NAME Specify name of generated C++ class. Default name is |
| + 'Perfect_Hash'. |
| + -7, --seven-bit Assume 7-bit characters. |
| + -l, --compare-lengths Compare key lengths before trying a string |
| + comparison. This is necessary if the keywords |
| + contain NUL bytes. It also helps cut down on the |
| + number of string comparisons made during the lookup. |
| + -c, --compare-strncmp Generate comparison code using strncmp rather than |
| + strcmp. |
| + -C, --readonly-tables Make the contents of generated lookup tables |
| + constant, i.e., readonly. |
| + -E, --enum Define constant values using an enum local to the |
| + lookup function rather than with defines. |
| + -I, --includes Include the necessary system include file <string.h> |
| + at the beginning of the code. |
| + -G, --global-table Generate the static table of keywords as a static |
| + global variable, rather than hiding it inside of the |
| + lookup function (which is the default behavior). |
| + -P, --pic Optimize the generated table for inclusion in shared |
| + libraries. This reduces the startup time of programs |
| + using a shared library containing the generated code. |
| + -Q, --string-pool-name=NAME |
| + Specify name of string pool generated by option --pic. |
| + Default name is 'stringpool'. |
| + --null-strings Use NULL strings instead of empty strings for empty |
| + keyword table entries. |
| + -W, --word-array-name=NAME |
| + Specify name of word list array. Default name is |
| + 'wordlist'. |
| + -S, --switch=COUNT Causes the generated C code to use a switch |
| + statement scheme, rather than an array lookup table. |
| + This can lead to a reduction in both time and space |
| + requirements for some keyfiles. The COUNT argument |
| + determines how many switch statements are generated. |
| + A value of 1 generates 1 switch containing all the |
| + elements, a value of 2 generates 2 tables with 1/2 |
| + the elements in each table, etc. If COUNT is very |
| + large, say 1000000, the generated C code does a |
| + binary search. |
| + -T, --omit-struct-type |
| + Prevents the transfer of the type declaration to the |
| + output file. Use this option if the type is already |
| + defined elsewhere. |
| + |
| +Algorithm employed by gperf: |
| + -k, --key-positions=KEYS |
| + Select the key positions used in the hash function. |
| + The allowable choices range between 1-255, inclusive. |
| + The positions are separated by commas, ranges may be |
| + used, and key positions may occur in any order. |
| + Also, the meta-character '*' causes the generated |
| + hash function to consider ALL key positions, and $ |
| + indicates the "final character" of a key, e.g., |
| + $,1,2,4,6-10. |
| + -D, --duplicates Handle keywords that hash to duplicate values. This |
| + is useful for certain highly redundant keyword sets. |
| + -m, --multiple-iterations=ITERATIONS |
| + Perform multiple choices of the -i and -j values, |
| + and choose the best results. This increases the |
| + running time by a factor of ITERATIONS but does a |
| + good job minimizing the generated table size. |
| + -i, --initial-asso=N Provide an initial value for the associate values |
| + array. Default is 0. Setting this value larger helps |
| + inflate the size of the final table. |
| + -j, --jump=JUMP-VALUE Affects the "jump value", i.e., how far to advance |
| + the associated character value upon collisions. Must |
| + be an odd number, default is 5. |
| + -n, --no-strlen Do not include the length of the keyword when |
| + computing the hash function. |
| + -r, --random Utilizes randomness to initialize the associated |
| + values table. |
| + -s, --size-multiple=N Affects the size of the generated hash table. The |
| + numeric argument N indicates "how many times larger |
| + or smaller" the associated value range should be, |
| + in relationship to the number of keys, e.g. a value |
| + of 3 means "allow the maximum associated value to |
| + be about 3 times larger than the number of input |
| + keys". Conversely, a value of 1/3 means "make the |
| + maximum associated value about 3 times smaller than |
| + the number of input keys". A larger table should |
| + decrease the time required for an unsuccessful |
| + search, at the expense of extra table space. Default |
| + value is 1. |
| + |
| +Informative output: |
| + -h, --help Print this message. |
| + -v, --version Print the gperf version number. |
| + -d, --debug Enables the debugging option (produces verbose |
| + output to the standard error). |
| + |
| +Report bugs to <bug-gnu-gperf@gnu.org>. |
| |