Bug #1299 --server option not documented
Submitted: 16 Sep 2003 8:15 Modified: 16 Sep 2003 9:02
Reporter: [ name withheld ] Email Updates:
Status: Closed Impact on me:
None 
Category:MySQL Server: Documentation Severity:S3 (Non-critical)
Version:4.0.15 OS:n/a
Assigned to: CPU Architecture:Any
Triage: D4 (Minor)

[16 Sep 2003 8:15] [ name withheld ]
Description:
The MySQL Reference Manual does not document the --server/server= option.

(WinMySqlAdmin put it in a my.ini file, and mysqld seems to take it, 
although the allowable values and the semantics are unclear.)

How to repeat:
Search the reference manual for "--server" or "server=".

Suggested fix:
A process enhancement:

- initially:
  - set up to automatically extract a list of options from the various programs
  - manually extract the list of options that are documented

- on continuing basis:
  - (automatically) re-extract the current list of options from programs
  - (automatically) check for options not in already-document list
  - queue not-yet-documented new options for being documented
  - when option gets documented, add to already-documented list
[16 Sep 2003 9:02] Paul Dubois
This is not a server option. If you check the my.ini file,
you'll see that the option is specified in the [WinMySQLAdmin]
group, which indicates that the option applies to
WinMySQLAdmin itself. The option value can be reset
through WinMySQLAdmin's graphical interface that
allows you to select which server it should start.
[16 Sep 2003 9:34] [ name withheld ]
> This is not a server option. 

(Yeah, I just figure that out when I found registry entries including the
string "--server=xxx".) 

> if you check the my.ini file, you'll see that the option is specified in the 
> [WinMySQLAdmin] group, which indicates that the option applies to 
> WinMySQLAdmin itself. 

Doesn't the reference manual say that any option in the my.ini file is also
a command-line option for an executable?

If so, then shouldn't that command-line option be documented?
[16 Sep 2003 10:08] Paul Dubois
>Doesn't the reference manual say that any option in the my.ini
>file is also a command-line option for an executable?

That may be true, but WinMySQLAdmin is designed so that
its options can be set through its graphical interface.

>If so, then shouldn't that command-line option be documented?

In most cases, this would be true, but WinMySQLAdmin
development has slowed because it will be replaced
in the future with a better program. (Unfortunately, I
cannot offer a definite timeframe for this.)