The command line options themselves were removed in commit
168313bed9, wherein someone clearly didn't
do the full research.
Specifically, the SDL_net-based implementation of the network API never
supported or used these options. Only libana did.
This option has never been supported in any tagged release of Wesnoth:
* added in e5b3951054
* changed to only print a warning in c8699e2f05
(cherry picked from commit 6576293228)
This is intended to be used instead of the Game Version dialog's
clipboard text report in the event that Wesnoth cannot reach the
titlescreen or the dialog for some reason.
Unlike the --version info dump, it performs various calls to the
filesystem API which have potential side-effects on the environment
(namely, creating a user data directory structure if none existed before
running the command). It seems highly improper for a program's --version
switch to perform any actions other than printing text to its parent
terminal, hence I thought it would be better to add a new switch with a
more active phrasing, also reflected in its accompanying documentation.
Ultimately, this and its UI counterpart should be used by 1.14 players
as part of the bug reporting process, preferably as a mandatory step
before submitting new reports on GH or the forums.
This does several things:
- Make the formatting consistent, using underline instead of <angle brackets> for all arguments
- Add many missing switches; some experimental/dev ones are still not listed though
- Ensure all switches are listed in alphabetical order
- Fix some inaccurate details
- Minor fixes to the output of --help
In addition, the following additional switches now force a console on Windows:
--nogui
--logdomains
--path
--render-image
--screenshot
--data-path
--userdata-path
--userconfig-path
--version
Together with the --server option they allow starting several clients
that all join the server automatically.
When these options are used, preferences are not saved.
man page updated, hope I didn't miss anything.
...as well as from the manpages since it is no longer required
(some small leftovers, especially at unit tests are still there,
someone else has to test those)
