MacHouse Software


   Last updated: March 28, 2011






VersionsX - User's Guide


Mac software VersionsX







1. Installing and uninstalling VersionsX

Please read the README file that comes with the application.  Or click here to download one.


2. Introduction

What is VersionsX?  VersionsX is designed for software developers to document version history over multiple software titles.



Mac software VersionsX

Screenshot 2-1



The main window comes largely in two parts.  The left-hand side of the window will let you deal with different software titles.  (See Screenshot 2-1.)  Clicking on the New button, for example, you can create a new software profile.  The right-hand side of the window is the area where you create/edit/delete version profiles over a particular software title that is selected on the application drop-down menu.

When you document a software version, your goal is publish its information.  Click on the Publish on the main window.  A new window will give you information on the selected version along with information on the software developer and information on the software title.  (See Screenshot 2-2.)



Mac software VersionsX

Screenshot 2-2



3. Preferences

When you first launch any new application, it's always a good idea for you to open Preferences.  Okay, why not?  In order to open Preferences, choose Preferences on the toolbar (See Screenshot 3-1.)  You can also open Preferences by choosing Preferences under VersionsX on the menu bar. 



Mac software VersionsX

Screenshot 3-1


Mac software VersionsX

Screenshot 3-2



The first tab is Settings1.  Currently, there are about a dozen checkboxes.  They are descriptive.  If you need more information on a particular checkbox, simply place your Mouse pointer over it.  And its help tag will give you detailed description.  (See Screenshot 3-2.)

Switching to Settings2, there are three boxes.  (See Screenshot 3-3.)  Softing software list is used to sort the names of software titles on the application drop-down menu.  When creating/editing a software version determines what happens when you select a software version in the version list of the main window.  For example, with <li> enabled in Preferences, selecting a software version in the list will enable the <li> checkbox below the version history edit field.  The third box similar.  The checkboxes inside this box corresponds to the checkboxes on the Publish window.



Mac software VersionsX

Screenshot 3-3


Mac software VersionsX

Screenshot 3-4



Under the Developer tab, you can store information on the software developer.  (See Screenshot 3-4.)  This information will appear on the Publish window.

The way the date is stated is not universal across the globe.  Under the Formats, you can choose which date format will most suit you.  (See Screenshot 3-5.)



Mac software VersionsX

Screenshot 3-5


Mac software VersionsX

Screenshot 3-6



Under the Categories tab, you can list up software categories.  (See Screenshot 3-6.)  This list is used every time you create a new software profile.  If you want to add a new software category, first, select a row on the listbox where to insert a new one.  Then enter a name in the edit field at the bottom after enabling the Edit checkbox.  Finally, press the Return key to finalize an insertion.

You can add any number of attachments to a particular software title so that you can have quick access to them.  The settings under the Export tab (See Screenshot 3-7.) applies to those attached files if they are graphic files.  And VersionsX lets you export image files in different formats.



Mac software VersionsX

Screenshot 3-7


Mac software VersionsX

Screenshot 3-8



Under the System files tab, you can quickly locate the application folder in the system volume.  (See Screenshot 3-8.)  Under this tab, you can also set your default web browser.  The default web browser will be launched when you document a version history and then click on the Show button on the main window.  In order to set a default web browser, simply drag and drop an application icon directly onto the edit field as shown in Screenshot 3-8.  Currently, VersionsX only supports four web browsers: Safari, Camino, Firefox and Opera.


4. Using VersionsX


4-1 Software profiles

When you launch VersionsX for the first time, you will find out that the application drop-down menu is empty.  (See Screenshot 4-1.)  So is the top listbox.  Since you cannot select a software title, the New button inside the Software version box remains disabled.  So your first task is create a new software profile.  Click on the New button below the application drop-down menu.  And a new window will spring up.



Mac software VersionsX

Screenshot 4-1


Mac software VersionsX

Screenshot 4-2



First, enter the name of the software title.  The minimum number of characters is 4.  If the name is valid, you will see a green symbol to the right.  (See Screenshot 4-2.)  Furthermore, VersionsX will automatically finds out in real time whether or not there already exists a software title sharing the same name that you have entered.  If the software name is already used, you will see a red symbol.  Subsequently, the Add button at the bottom will be put into disabled.



Mac software VersionsX

Screenshot 4-3


Mac software VersionsX

Screenshot 4-4



When you write short and long descriptions, you may want to turn on the Count checkbox.  If you enable it, VersionsX will automatically count the number of letters (top) and the number of words (bottom).  (See Screenshot 4-3.)  This is a nice feature because some web sites like (former VersionTracker) sets the maximum number of letters you can type.

Another neat feature that you will see on this window is the URL verification.  When you enter a URL in the edit field for Web site, VersionsX will get on the Internet and see if this URL is currently accessible.  If it is accessible, then you will see a green symbol to the right.  (See Screenshot 4-4.)  Since VersionsX checks up the validity of the given URL every several seconds, you may find that you cannot smoothly type up words.  If that's the case, then disable the URL verification checkbox.  (See Screenshot 4-5.)  And VersionsX will stop validating the URL.  Consequently, you will be able to smoothly complete short/long descriptions and other fields.



Mac software VersionsX

Screenshot 4-5


Mac software VersionsX

Screenshot 4-6



When you are finished, simply click on the Add button.  You can leave it incomplete because you can always come back by selecting a software title on the drop-down menu and choose the Edit button on the main window to finish it up.  Likewise, you can delete an existing software profile by selecting one on the drop-down menu and clicking on the Delete button.

Once you have one or more software profiles, you will notice that the New button inside the Software version box is no longer grayed out.  (See Screenshot 4-6.)  That means you can create version profiles for the selected software title.



    Next page >>