Bug #85386
Updated by Sybille Peters over 6 years ago
Note: Closed for now, until researched further. Initially noticed that documentation partly does not fit behaviour or may be a little difficult to understand. There seems to be also an issue with inconsistency of some options and the help output. *1. Example: 1. Some commands have --dry-run in their help message and some do not* not * cleanup:deletedrecords : does not * cleanup:multiplereferencedfiles : does Weird that deletedrecords should suddenly not support dry-run >> this needs to be researched further, not really a problem of the docs, though. https://github.com/TYPO3/TYPO3.CMS/blob/TYPO3_8-7/typo3/sysext/lowlevel/README.rst In TYPO3 7 there where some common options so you could execute the commands without problems in a loop using a generic commmand line, e.g. <pre><code class="text"> line. 2. Usage: for tag in $tags;do if [[ $cmd == fix ]];then # fix php ./typo3/cli_dispatch.phpsh lowlevel_cleaner $tag -r -s -v 2 --AUTOFIX --YES --refindex update else # dry-run php ./typo3/cli_dispatch.phpsh lowlevel_cleaner $tag -r -s -v 2 --dryrun fi done </code></pre> Having --dryrun *and* --AUTOFIX makes absolutely no sense, so it is better now, but it should be easier to use. *2. Usage:* <pre><code class="text"> help [options] [--] [<command_name>] Arguments: command The command to execute command_name The command name [default: "help"] </code></pre> Not very inuitive * where is 'command' in the usage at the top? *3. 3. Two different help messages with help and --help.* --help. The output with --help is confusing (--help is documented), the output of help is better. Maybe better to document only help (and not --help and remove that) --help) e.g <pre><code class="text"> php ./typo3/sysext/core/bin/typo3 help cleanup:multiplereferencedfiles </code></pre>