diff options
Diffstat (limited to 'doc')
| -rw-r--r-- | doc/MANUAL.adoc | 40 |
1 files changed, 20 insertions, 20 deletions
diff --git a/doc/MANUAL.adoc b/doc/MANUAL.adoc index 20f21ee0..cb66609a 100644 --- a/doc/MANUAL.adoc +++ b/doc/MANUAL.adoc @@ -75,7 +75,7 @@ These options only apply when you invoke ccache as ``ccache''. When invoked as a compiler (via a symlink as described in the previous section), the normal compiler options apply and you should refer to the compiler's documentation. -*`-c, --cleanup`*:: +*`-c`*, *`--cleanup`*:: Clean up the cache by removing old cached files until the specified file number and cache size limits are not exceeded. This also recalculates the @@ -85,37 +85,37 @@ compiler options apply and you should refer to the compiler's documentation. cleanup is mostly useful if you manually modify the cache contents or believe that the cache size statistics may be inaccurate. -*`-C, --clear`*:: +*`-C`*, *`--clear`*:: Clear the entire cache, removing all cached files, but keeping the configuration file. -*`--dump-manifest`*=_PATH_:: +*`--dump-manifest`* _PATH_:: - Dump manifest file at PATH in text format. This is only useful when + Dump manifest file at _PATH_ in text format. This is only useful when debugging ccache and its behavior. -*`-k, --get-config`*=_KEY_:: +*`-k`* _KEY_, *`--get-config`* _KEY_:: Print the value of configuration option _KEY_. See <<_configuration,CONFIGURATION>> for more information. -*`--hash-file`*=_PATH_:: +*`--hash-file`* _PATH_:: - Print the hash (160 bit BLAKE2b) of the file at PATH. This is only useful + Print the hash (160 bit BLAKE2b) of the file at _PATH_. This is only useful when debugging ccache and its behavior. -*`-h, --help`*:: +*`-h`*, *`--help`*:: Print an options summary page. -*`-F, --max-files`*=_N_:: +*`-F`* _NUM_, *`--max-files`* _NUM_:: - Set the maximum number of files allowed in the cache. Use 0 for no limit. - The value is stored in a configuration file in the cache directory and - applies to all future compilations. + Set the maximum number of files allowed in the cache to _NUM_. Use 0 for no + limit. The value is stored in a configuration file in the cache directory + and applies to all future compilations. -*`-M, --max-size`*=_SIZE_:: +*`-M`* _SIZE_, *`--max-size`* _SIZE_:: Set the maximum size of the files stored in the cache. _SIZE_ should be a number followed by an optional suffix: k, M, G, T (decimal), Ki, Mi, Gi or @@ -128,24 +128,24 @@ compiler options apply and you should refer to the compiler's documentation. Print statistics counter IDs and corresponding values machine-parsable (tab-separated) format. -*`-o, --set-config`*=_KEY=VALUE_:: +*`-o`* _KEY=VALUE_, *`--set-config`* _KEY_=_VALUE_:: Set configuration option _KEY_ to _VALUE_. See <<_configuration,CONFIGURATION>> for more information. -*`-p, --show-config`*:: +*`-p`*, *`--show-config`*:: Print current configuration options and from where they originate (environment variable, configuration file or compile-time default) in human-readable format. -*`-x, --show-compression`*:: +*`-x`*, *`--show-compression`*:: Print cache compression statistics. See <<_cache_compression,CACHE COMPRESSION>> for more information. This can potentionally take a long time since all files in the cache need to be visited. -*`-X, --recompress`*=_LEVEL_:: +*`-X`* _LEVEL_, *`--recompress`* _LEVEL_:: Recompress the cache using compression level _LEVEL_. The level can be an integer, with the same semantics as the @@ -156,16 +156,16 @@ compiler options apply and you should refer to the compiler's documentation. visited. Only files that are currently compressed with a different level than _LEVEL_ will be recompressed. -*`-s, --show-stats`*:: +*`-s`*, *`--show-stats`*:: Print a summary of configuration and statistics counters in human-readable format. -*`-V, --version`*:: +*`-V`*, *`--version`*:: Print version and copyright information. -*`-z, --zero-stats`*:: +*`-z`*, *`--zero-stats`*:: Zero the cache statistics (but not the configuration options). |