Initial setup wizard (overview)
(POSIX specific)
On the first start of TheIDE, user is presented with a wizard-style dialog, which goal is to help user easily set up everything necessary to run TheIDE. This dialog can be also invoked later using command line option -install or from the Setup menu. For more detailed and illustrated description see a step by step description of the wizard.
The wizard lets user select how the source codes should be managed and updated, currently supporting four methods:
Local copy of sources that reside in /usr/share/upp (or equivalent). It is assumed that those are maintained and updated by a package management software.
Read-only assemblies in /usr/share/upp. Again, these files should be updated by package manager. This choice also assumes that user will never need to alter the U++ sources.
SVN based assemblies. This option checks out the U++ sources from SVN repository and sets up the assemblies on top of them.
No repositories. This option is for users who prefer to manage the sources manually.
If SVN based assembly is chosen, user has further options to set up the SVN server: either the default mirror on code.google.com or custom setup. The custom setup allows to set up repository address, user and password. Also user can choose one of three modes of synchronization:
Always get the newest sources available.
Synchronize the sources with the version of TheIDE (useful for example when TheIDE is updated to stable release versions by package manager).
Manual updates.
Last part of settings is dedicated to the assemblies to be created. The settings are fully editable. To save user some typing, substitution variables $(SRC) and $(OUT) can be set and used in settings.
The entire process is designed with two main goals:
To be as simple as possible and user-friendly even for newbies.
To be flexible enough, so that skilled users are not restricted in any way.
The author used all his imagination and common sense to meet those goals. For the first one, newbie user can just hit Finish and start exploring TheIDE right away. On the other hand, the dialog should be flexible enough to serve not only for managing U++ sources, but also any other project, no matter if it is U++ based or not.
Clicking Finish button at any time results into applying and saving all the choices (and safe defaults for any skipped steps). The Cancel button results into leaving the wizard immediately without saving anything.
Additional notes:
It is safe to run installation wizard multiple times.
Only the latest setting is used for automatic updates.
If there already are some assemblies, they are not deleted, only if the name matches, then it is overwritten.
The effects of installation can be reverted using -uninstall command line option.
|
