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>. |