...
Latest release version available for download is 1.4.0 (Linux, Windows), or 0.9.6 (Mac).
The most comprehensive and up-to-date documentation may be found here .
Display and navigation
All primary components of main window (image from old GoGui version) are in place and active:
...
- Select base root directory
- Select supersede directory
- CVS-related set-up:
- path to cvs command
- value for CVSROOT
- value for CVS_RSH
- SCons-related set-up:
- path to SCons commandunmigrated-wiki-markup
- [select external libraries|^extlibPathDialog.png] root directory \ [Added warning in case selected path \ != GLAST_EXT environment variable 10/16\]
- build options: compiler, debug or not, optimized or not
- extra SCons options: menu item under Options brings up dialog allowing user to add arbitrary SCons options to the command
...
- Select a package
- Display per-package information
- Release notes
- SConscript
- <package>Lib.py
- ChangeLog
- version information
- command output
- Search displayed information for string
- Repository functions
- cvs update (3 flavors)unmigrated-wiki-markup
- cvs commit \ [but maybe cannot handle containers like celestialSources properly yet\]
- check out "regular" package
- check out container
- cvs rtag Now that tag strings include the package name it is no longer necessary to support tag as well as rtag. See also the SCons-aware command-line tagger, which uses the same underlying utilities as the GoGui tag function. OBSOLETE. All tagging should be done from a SLAC Linux node
- Build functions
- Build a package
- Clean a package
- Build or clean arbitrary target(s) with arbitrary options by using input field at the bottom of the GoGui window. Only is active if full container (rather than package) is selected in the navigation pane.
- Remove package
- Exclude a package (SCons will use next version in line if there is one)
- Run a program (as of Sept 29 using setup file generated by SCons)
- Open terminal window. GoGui will look for a file called _setup.sh (setup.bat on Windows) and will run it first. This means your environment in that window is suitable for running programs with no additional setting of environment variables, etc.
- File-specific functions selected by right-click in package hierarchy
- GoGui debug output goes to msg tab by default. On Linux only, one can instead send debug messages to console by invoking as GoGui --ggDebug. When debugging GoGui invoked this way, messages go to debugger.
...
Visual representation of variants is misleading. Should disable builds of variants that our implementation of SCons will not in fact build and indicate visually which variant is the buildable one. FIXED as of Nov.6.Wiki Markup Several operations (e.g. checking out a package, excluding a package..) invalidate the set-up of the currently-running SCons process (if there is one). This needs to be clearer.- \ [Show state in SCons icon as of 0.9.2\]Wiki Markup Window does not always update spontaneously after a package is excluded (or un-excluded) to display the new state properly-. \ [Fixed as of 0.9.3\]- Fix scrolling behavior. Minor unpleasantness in base browser display: if keys are used to scroll a page at a time the highlighted package can change if the actual selected package scrolls out of view.
Wiki Markup Add visual indication of whether SCons process is running or not. [Done as of 0.9.2\]- Indicate initialization errors better. When the SCons initialization process skips a package (usually because of an error in its SConscript file) indicate graphically somehow in the file hierarchy. Messages in the global output tab can be difficult to spot.
Configure options
- select preferred debugging environmentunmigrated-wiki-markup
- (maybe) <span style="color: #ff6600">select preferred cvs diff format</span> \[No ability to configure yet, but added \-u option to improve output in select preferred cvs diff format [No ability to configure yet, but added -u option to improve output in 0.9.2\]
More functions or enhancements
- Additional file-specific functions selected by right-click in package hierarchy
Wiki Markup run Doxygen[Done as of version 0.9.6\]- Do a better job of determining which files are executable, which are editable, and which are both (e.g. scripts)
Wiki Markup capture qDebug() output in another panel of central tabbed widget.- \ [\ Done as of 0.8.8\]- implement dry-run builds and cleans (print what they would do without actually doing it). Can do this by using target field at the bottom of the GoGui window and including SCons --dry-run option.
Wiki Markup special handling for container packages (celestialSources, irfs) for various cvs operations: checkout, update, commit, -tag- \ [tag is done as of Nov. 3\].
Bugs
...
- If the specification of scons command doesn't resolve to an actual file GoGui actual file GoGui crashes. -At the very least should get rid of default and force user to supply something since this default often causes the crash.- \ [Done in 0.9.2\]