@feerrenrut,
While at commenting and refactoring to increase readability, this NSIS file might also benefit from a little linting, such as indenting blocks and removing useless double quotes in !include directives.
I've tried to adhere to the current style for consistency, but I can restyle the whole thing if you so wish.

I've tried to adhere to the current style for consistency, but I can restyle the whole thing if you so wish.

I'd prefer that a restyle was done in a separate PR. If you are willing to do the testing, I'll happily take it.

However, NVDA still speaks through the process. I think the main use case for this argument is for mass unattended installations. Would you be willing to extend this to also tell the temporary copy to be set to no-speech?

Currently minimal is also automatically set when NVDA starts on secure screens (see nvda.pyw around line 234). Wouldn't it be better to keep minimal as is so just suppress startup sound of the launcher and modify installSilent to suppress startup sound of the launcher and set NVDA to no speech??

@lukaszgo1 wrote:

Wouldn't it be better to keep minimal as is so just suppress startup sound of the launcher and modify installSilent to suppress startup sound of the launcher and set NVDA to no speech??

I agree.

@feerrenrut wrote:

I'd prefer that a restyle was done in a separate PR. If you are willing to do the testing, I'll happily take it.

I'll prepare the two PRs (--install-silent and restyle) as based upon the result of merging this one.

Currently the userguide has the following explanations:

--minimal	No sounds, no interface, no start message, etc.
--install	Installs NVDA (starting the newly installed copy)
--install-silent	Silently installs NVDA (does not start the newly installed copy)

I'm sure you are both aware of this already, but for completeness. From https://techterms.com/definition/silent_install

A silent install is the installation of a software program that requires no user interaction. It is a convenient way to streamline the installation process of a desktop application.

Since our docs are not very specific, and most people will expect "install-silent" to produce no UI at all, graphical, speech, or otherwise. I'd make that the option that controls this.

On the other hand the docs for --minimal specifically mentions "no interface", speech is a user interface. Perhaps it is enough to update the docs to be more clear. But it leaves us with an odd spread of options.

The main use cases I am aware of are:

• Sys-admin who wants to automatically install NVDA to many machines without the installation causing any disruption. For this NVDA should produce no sound, display no GUI, complete without interaction, and exit when installation is complete.
• A user who wants to install NVDA on a computer, but continue using their old version once installation is complete. For this NVDA should display a GUI, should provide speech, should provide launcher startup sound, but should exit when installation is complete.