Bug #1299 --server option not documented

• Submitted: 16 Sep 2003 8:15
• Modified: 16 Sep 2003 9:02
• Reporter: [ name withheld ]
• Status: Closed
• Category: MySQL Server: Documentation
• Severity: S3 (Non-critical)
• Version: 4.0.15
• OS: n/a
• CPU Architecture: Any

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