To start Nebulous, type the following command:
java -Xmx256m Nebulous/nebulous
The -Xmx256m option gives Java a 256 MB heap. If you have a large project, increase the number appropriately.
Quick Load creates a project by 1) getting a list of files and file patterns and then 2) recursively scan the all the directories in the current working directory, which should be the tutorial directory. These files are then displayed by Nebulous.
If you need to add files in a different directory that is not a subdirectory of the present working directory, you can append a full path to the prefix of the file pattern.
The rest of the tutorial quickly covers the other miscellaneous features of the Aspect Browser.
The other two buttons, one with two buttons pointing outwards and the other pointing inwards, changes the thickness of the file panels without changing the scale. These two buttons are useful for expanding or contracting the file panels without changing the scale for viewing conveniences.
The order of the file panels and the layout of the file panels can also be modified. In the File Panels menu, you can change the order of the file panels in respect to alphabetical order or file size.
The layout of the directory panels can be changed too. A directory panel is a larger window that contains the file panels, usually representing the directory itself. The directory panels can be displayed one at time, display its immediate subdirectories too, or display all of its subdirectories recursively.
If this does not work, then you did not install Aspect Browser correctly. Refer to the installation instructions.
If Nebulous does not launch, make sure you can launch it by itself as shown in the previous section. Your CLASSPATH or Java installation might not be correct.
|Starts Aspect Emacs||M-x ab-mode||Starts Aspect Emacs|
|Starts Nebulous||C-c n||Launches Nebulous, the java graphical part of Aspect Browser. This command manually launches Nebulous, but you should never need to use this feature because Aspect Emacs automatically lauches Nebulous.|
|Adds Aspect||C-c a||Aspect Emacs will prompt you to enter an aspect pattern (regular expression). Both Nebulous and Aspect Emacs will highlight text that matches this pattern.|
|Hides Pattern||C-c h||Aspect Emacs will prompt you to enter a pattern you want to hide. All highlights in both Nebulous and Aspect Emacs that are associated with this pattern will disappear.|
|Show Pattern||C-c h||Just like hide, but it shows the highlights again in both Aspect Emacs and in Nebulous.|
|Show Pattern||C-c m||Places a bookmark at the present line of code the Emac's cursor is on. You can leave a history of multiple book markers and use Nebulous's traversal feature to visit them all in order starting with the most recent book mark.|