[MDEV-32928] mariadb CLI: Options recognised only as first argument, not documented Created: 2023-12-01  Updated: 2024-01-08

Status: Open
Project: MariaDB Server
Component/s: Documentation
Affects Version/s: 10.6.15
Fix Version/s: N/A

Type: Bug Priority: Minor
Reporter: Karl Levik Assignee: Ian Gilfillan
Resolution: Unresolved Votes: 0
Labels: None


 Description   

The mariadb man page does not specify that --defaults-group-suffix= is only recognised when it is the first argument. (The other two --defaults-... options do correctly specify this in the man page.)

Additionally, in the output from mariadb --help, the options --print-defaults and --no-defaults are preceded by:

"The following options may be given as the first argument:"

Perhaps "must be" would be clearer than "may be"?

Whereas the --defaults-* options are preceded by:

"The following specify which files/extra groups are read (specified before remaining options):"

Perhaps this could be said better as:

"The following specify which files/extra groups are read (must be given as the first argument):"

I found these issues in 10.6.15 and 10.6.16, but I assume later versions are also affected. Or at least I can see the issues with mariadb --help in the container version of MariaDB Server 11.3.0.


Generated at Thu Feb 08 10:35:05 UTC 2024 using Jira 8.20.16#820016-sha1:9d11dbea5f4be3d4cc21f03a88dd11d8c8687422.