The `--autodesktop` flag is only useful when installing Qt6 for mobile
or wasm. There is no need to have an additional desktop Qt installation
for any Qt5 mobile or wasm installs. This updates the docs to reflect
that.
* Update Mac CI pipelines to use MacOS-12
The MacOS-10.15 CI runners are now deprecated, and will begin brownouts in August. See discussion here: https://github.com/actions/virtual-environments/issues/5583
MacOS-11 is also available, in case there are any issues with 12.
* drop non-functional qt
* add warnings about Qt < 6.2 to docs
* specify Qt 6.2.4 as the minimum for ios
This adds the `-c | --config` flag to the CLI section of the documentation.
This problem was discovered while investigating #488. It does not attempt to fix that issue.
This changes the CLI so that the `target` parameter for `install-src`,
`install-doc`, and `install-example` is now ignored, and "desktop" is
substituted for anything the user inputs. The only valid option here
is "desktop" anyway, so the user should be forgiven for trying to input
anything else.
It may be better to remove `target` from the parameter list, but that's
a big change to the interface that could break a lot of dependent code.
This adds a note to `docs/cli.rst` in the section on the `--external`
flag that suggests use of the "7-zip" extractor, and links to the
7-zip website and to package managers that can install it.
This is meant to allow CI builds to run successfully when the mirror link in `cli.rst` is broken. It accomplishes this by changing the link into an html 'code' tag. The link is not meant to be clicked on; it is meant to be typed as a command line argument. This change makes the intention more explicit.
It may be better to replace the link with a working URL, perhaps one of the links in the settings.ini file.
This removes the terms 'target OS' and 'target variant' from the docs,
and replaces them with 'host' and 'target', as they are referred to in
the program help text and code.
At some point, it looks like the file `docs/cli.rst` got misaligned with
the actual command line interface, and this change fixes that.
This moves the `version` subcommand into the 'generic commands' section.
This adds several command line options to `aqt install-qt` that were
missing from the docs, and removes `--version`, which is not an option
for `aqt install-qt`.
This change causes anything in the docs that a user should type in a
console, like a command, an option, or an argument, to be formatted as
monospaced code.
This fixes the broken links to the 'Available Qt Versions` wiki page.
It also adds links to 'List Qt Command' in the documentation for the
'Qt Install Command'.
* Rename duplicate labels
When using 'sphinx.ext.autosectionlabel', labels are automatically
generated with the same name as the title of each section.
This change renames the manually created labels so that they do not
clash with the autogenerated labels, and silences the warnings
triggered by them.
* Extend title underlines
This silences the warning about the title underlines being too short.
* Add blank line after "code-block" directive
Silences this warning:
WARNING: Error in "code-block" directive: maximum 1 argument(s) allowed, 9 supplied.
* Add blank line where required by sphinx docstring
Silences this warning: WARNING: Unexpected indentation.
* Revert "Rename duplicate labels"
This reverts commit 442d2d81
* Add explicit labels for `cli.rst` sections
* Disable sphinx.ext.autosectionlabel
* Turn off html static path
The '_static' path is not being used, and it doesn't even exist, which
triggers a warning. This change silences that warning.
* Fix label for 'qt installation command'