start-domain:

Can someone explain the Mac OS X comment:

Note – On the Mac OS X platform, processes can bind to the same port. To avoid this problem, do not start multiple domains with the same port number at the same time.

That can't really be true, right?

--verbose doesn't open a separate console window, right?

And can't you kill the server on Windows using CTRL-C?

Change the description to something like:

Detailed server startup and log messages are displayed to the console window and the start-domain command waits until the server is stopped. If the domain is later restarted by using the restart-domain command (e.g., issued from a different console window), messages continue to be displayed in this console window. You can kill the server by typing CTRL-C, or get a thread dump for the server by using CTRL-\ (UNIX) or CTRL-Break (Windows). Added.

(Byron, that's correct, right?)

Use this for --upgrade:

Upgrade the server from a previous release. The server process is started, the configuration is modified to be compatible with this release of Enterprise Server, and the server process terminates. Normally, if start-domain detects that the configuration is from an older release of Enterprise Server, the domain is upgraded automatically before being started. Users should not need to use this option explicitly. DONE

stop-domain:

stop-domain takes all the asadmin utility options and is supported in local or remote mode. If you specify a host name, it assumes you're operating in remote mode and you must correctly authenticate to the remote server. In local mode you normally do not need to authenticate to the server if you're running as the same user who started the server. DONE

restart-domain:

Like stop-domain, works in either local or remote mode. Added the descriptive text.

If the domain is stopped, restart-domain works like start-domain (you're not asked).

I don't believe the paragraph about using start-domain to restart the domain is true.