MicroPlanet Gravity 2.2 Release Notes

These release notes describe the functionality added to MicroPlanet Gravity for versions 2.0 through 2.2.

Note: The 2.2 Beta 6 help file has not been updated with all of the new features and information. The help file will be updated prior to final release.

Gravity 2.2 Installation Notes

Important: Gravity 2.2 database files are not compatible with those of previous versions of Gravity.  If you wish to install 2.2 for evaluation purposes and then return to a previous version, you will need to use GravityBackup.exe to create a backup of your existing installation.  The procedure for doing that is at the bottom of this document.

Changes and Bug Fixes in 2.2b6 (build 1640)

Change

Description

Crash on Windows shutdown (pure virtual function) Gravity should no longer crash if Windows shutdown is commenced when Gravity is running
Crash viewing articles If Gravity was configured either to show Full Headers or if the Path header was included in the article layout and the Path header exceeded a certain size, Gravity would crash.
Factory Icon Changed The Image Factory icon now resembles a factory.
1/3 second delay when clicking on newsgroups In previous betas, Gravity would delay a third of a second when a newsgroup was clicked on.
Hang while forwarding articles via rules Gravity would hang (deadlock) in certain circumstances when articles were forwarded using rules.
Memory Manager Change Gravity now uses the Visual C runtime library memory management again (with patches applied).  After extensive testing with SmartHeap and the VC runtime, we determined that SmartHeap did not perform appreciably better and did not return memory to Windows as it was being freed.
Headers retrieved for disabled groups Beta 6 should not retrieve disabled groups during the Server/Retrieve Headers command (or the header fetch that is enabled under Server/Properties/Operation).
Windows 2000 space bar behavior In previous betas, the space bar would not advance to the next article when at the bottom of a article.  Beta 6 resolves the problem.

 

Changes and Bug Fixes in 2.2b5 (build 1625)

Change

Description

Memory reduction for articles in thread pane 2.2b5 should use approximately 28 bytes less per header in the thread pane than previous versions.
Status bar shows part number and subject during decoding Formerly the status bar contained the newsgroup name and the server-based article number.
Ctrl+Enter Shortcut Ctrl+Enter always shows the selected message, even if you have Gravity configured to decode, launch, beep, etc... articles with lines > XX (Global Options/Preferences).
The default filter will persist between sessions Beta 4 contained a bug that would cause the default filter to not be saved between sessions.  This is fixed in beta 5.
Problem with purging and expiration of headers A number of users reported weird behavior such as Gravity re-fetching older articles and newer ones disappearing.  We believe this has been fixed in beta 5.
Forward and Back Keys The forward and back keys had a problem similar to Search Go To when Gravity was configured to open newsgroups with a single click.

Changes and Bug Fixes in 2.2b4

A fair number of bugs are fixed in this release, and a few new features were added.  The following table summarizes the changes (additions are at the top).  A number of separate bug fixes are consolidated under single entries (navigation and thread pane issues, for example).  There are still a number of un-resolved issues left for the final release (or Beta 5 if it comes to that).  If your issue was not resolved in this beta then you may want to re-submit your bug so that we can examine it again.

Additions

Description

Keyboard shortcuts for expand and collapse thread The plus and minus keys ('+' and '-') now expand the selected thread.
Keyboard shortcuts for the newsgroup, thread, and article panes The following keys take you to the respective panes:
  • 1 - newsgroup pane
  • 2 - thread pane
  • 3 - article pane

These shortcuts work whether you are zoomed or not.

New preference for opening large articles... Under Global Options/Preferences you can now instruct Gravity what to do when attempting to open articles with more than XX lines.  The choices are:
  • display the article (default behavior)
  • decode the article
  • decode and launch (view)
  • beep

This setting is primarily for users who have Gravity configured to open articles with a single click, and who inadvertently cause Gravity to retrieve and display large articles (when they really just want to select them for decoding).

New warning for deleting an article Gravity now will warn when trying to permanently delete an article (Del).  Like other warnings, this can be disabled.
URL highlighting Some additional refinement was made to the URL highlighting (maybe one day it will satisfy everyone?)
Auto-close for the search window when switching servers Formerly Gravity would not let you switch servers when the search window was open.  That is still the case, but now Gravity will allow you to close the window from the warning dialog.
Decode jobs added back to Image Factory waiting queue If a decode job fails because of a lost connection then it is added back to the waiting job queue.
New Retry button in the Image Factory You can now retry decode jobs from within the Image Factory with the new Retry button.
"New articles in thread" indicator for collapsed threads Collapsed threads that contain new articles are now indicated visually with a "Swiss Army Knife-like" symbol.
Servers in the VCR dialog are sorted The list of available servers is now sorted in the VCR selection dialog.
Bug Fix Description
Multi-part decoding slowdown Users who configured Gravity to mark decoded articles as read experienced a massive slowdown when multi-part articles were being decoded and the articles were not in the currently open newsgroup.
Search Go To Article command The Go To Article command has been fixed.  In previous betas, Go To Article would switch to All Articles, select the article, but then the display was refreshed again and the default view was loaded, causing the article to disappear.
Malfunctioning  Rule Condition "Cross-posted to more than X groups" The "cross-posted to more than X groups" command was not working in b3.
Navigation Corrections A number of changes were made to correct problems with the operation of navigation commands, including the space bar, N, B, etc...
Thread Command Behavior Various thread commands (delete, ignore, etc...) caused incorrect results in the thread pane.  As far as we know, all of these have been resolved.
Data Loss on very large posts Very large text posts would be posted with truncated text.  This could occur if either the user typed a very large message or if they pasted in a large amount of text.
Invalid registration code The invalid registration code error message now includes more instruction about possible causes and what to do to obtain a lost key.
Clicking in bozo bin when no entry is selected Clicking in the bozo bin list when no entry was selected would cause a crash.
Bozo Bin Expiration Editing the Bozo Bin and clicking OK would result in all timestamps being reset in the Bozo Bin - the net effect was that they were not counting down properly.
Pin and Link Filter Buttons The Pin and Link filter buttons now have transparent backgrounds for most environments.
Rule Editor The rule editor would insert "or" in the wrong location within a rule and it would have to be manually edited.
Kill Thread toolbar button The button would be improperly disabled in certain conditions (such as if the currently selected article was marked as read).
Duplicate Tagged Jobs Tagged jobs were being re-submitted on re-connection (although this did not result in extra retrieval, it was confusing).
VCR command line option The VCR command line option works now even if Gravity is already running.
Rule Editor Blank Line The rule editor window was inserting a blank line.
Subscribe Dialog The Subscribe dialog would indicate that bodies were being stored when in fact only headers were being stored.
Save as Draft The formatting of items that are saved as draft has been improved.
URL highlighting under Windows 2000 URL highlighting under Windows 2000 was completely random thanks to an incompatibility in the rich edit control that Microsoft introduced.  MicroPlanet recoded the highlighting code to work around this incompatibility.

Changes and Bug Fixes in 2.2b3

The changes in b3 are fairly minor in scope, although some very troublesome problems have been fixed.  There are still a lot of outstanding issues that are being addressed, so if your issue does not appear on this list it does not mean that we will not get to it.

Change

Description

The infamous decoding bug is fixed. Many USENET posts have an improperly encoded last line (the length indicator does not match the actual length of the line).  In those cases, Gravity was rejecting the last line.  For some file types, the discarded data was scarcely noticeable.  For other types (such as ZIP files), the viewer would fail to open them altogether because of an invalid checksum.
Focus remains in the thread pane. In earlier 2.2 betas, many navigational commands caused focus to switch from the thread pane to the article pane.  This was driving people crazy, but a few people liked it.  There is now an option on the Preference tab if you want to stick with it. 
Image Factory "Move To Top" button now has a keyboard accelerator. You can now use the keyboard to move items to the top.  Just hit Alt-P.
New Un-Protect Article Accelerator You can unprotect articles with Ctrl+Shift+L (protect is Ctrl-L).
Low disk space warning is optional There is a checkbox on the Global Options/Decode tab that allows disabling of the low disk space check when decoding.  For some reason, on some systems the amount of free disk space is improperly calculated.  If this is the case for you, use the checkbox to disable the "feature."
New memory manager This build has a completely different memory manager (MicroQuill's SmartHeap).  We were dissatisfied with the runtime library memory manager.
URL highlighting/launching Some problems with URL highlighting and launching have been corrected in this release (particularly when URLs are enclosed in parenthesis (was that spelled right???)).

 

Changes in Gravity 2.2

Gravity 2.2 includes all fixes from previous versions plus the following new functionality:

Change

Description

VCR tool for processing multiple servers. The VCR allows you to select groups from any of your defined news servers and cycle through and retrieve the headers, bodies, process rules, and so forth. You can start the process right away, or you can schedule it to occur at a later time (such as at midnight). Gravity can optionally exit when all of the jobs have completed.


The VCR remembers its settings from previous runs, but you can also save VCR settings to a file and re-use them later. Gravity has a new command line switch (/vcrfile: ) that allows you to start Gravity with the VCR running.

New Navigation Commands A whole new navigation menu was added and some article navigation commands were migrated from the Article menu. The new navigation commands are:
  • Skip to next unread article
  • Skip to next unread in thread
  • Skip to next unread local
  • Back (move to previously viewed article)
  • Forward (move to article that was viewed after this one)

There is a new Navigation tab in Global Options that allows you to control how certain navigation commands work when you are offline or online.

News Server Nicknames Each server now has both a server nickname and a server address. If no server address is specified, Gravity attempts to connect to the server nickname. Server nicknames allow you to define the same news server multiple times by giving it multiple nicknames. The server nickname maps directly to a Windows file system directory, so each server must have a distinct nickname.
Retrieval Improvements
  • New settings to allow Gravity to re-establish dropped connections and retry failed connection attempts.
  • The Retrieve tagged for selected groups command allows you to retrieve tagged articles for the groups selected within the newsgroup pane.
  • A new server property (Server/Properties/Operation/Server creates messages out of order) can be used with news servers that are part of server farms. Enabling the option causes Gravity to keep requesting articles that appear to be missing.
  • A new server property (Server/Properties/Operation/Limit headers) can be used to specify that Gravity should not retrieve more than a specified number of headers from any group during header retrieval. This limit can be overridden on a per-newsgroup basis.
  • The Retrieve Limited Number of Headers… command has been added to the newsgroup menu. This command allows you to specify a number of headers to retrieve or to specify that all should be retrieved.
  • A new newsgroup retrieval property has been added to the General tab to allow you to disable automatic retrieval of the group when headers are retrieved for the entire server.
New Toolbar Buttons
  • Retrieve Tagged Articles
  • Skip to the next unread article
  • Skip to next unread in thread
  • Skip to next unread local
  • Back to the previously viewed article 
  • Forward to the article that was viewed after the current one
Threading
  • You can now choose between threading headers based on only the message-id or both the message-id and subject. This setting is contained on the Global Options/Display tab.
  • The threading algorithm is faster.
Storage
  • The option to NOT store headers for newsgroups has been removed. The reasons for removing it include: 
    1. the underlying code for dealing with the absence of headers was very complex
    2. in 2.1 a number of major problems surfaced after the final release even though there were thousands of downloads in the public beta, which convinced us that very few people used that mode, and
    3. while there was a minor benefit in terms of reduced hard disk consumption, many commands would result in re-downloading the information, which is confusing and wasteful. Hence we decided to eliminate it to simplify the code and put effort into other areas.

    Major changes were made to the way Gravity stores and accesses data. These changes were made to reduce the likelihood of corruption and to make recovering from corrupted files easier. 

    The Global Settings file has been broken into a set of individual files (ArtIDs.dat, Bozo.dat, Filters.dat, Ignore.dat, Options.dat, Rules.dat, Score Colors.dat, Scores.dat, Watch.dat). Additionally, the Server Settings file has been split into a number of files (Crosspost.dat, Decode.dat, Outbox.dat, Print.dat, ServerIDs.dat, Tags.dat). 

    All of the global and server level .dat files employ a backup strategy. When a file is written, it is first renamed to a .bak extension and then the new file is written. After the new file is successfully written, the backup (.bak) file is removed. If Gravity attempts to open a file and finds a file with a .bak extension present, then it knows that a previous save attempt failed and automatically reverts to the backed up version. 

    Finally, in addition to the individual server files identified above, all information about subscribed groups is contained in individual group files, which have a “. g” extension. Previously Gravity stored some vital group information in the Server Settings file, and if the data within that file that contained the subscribed group list got corrupted then the entire server was lost. In 2.2, the most that will be lost if a group becomes corrupted is the single group.

Rules Rules now have optional expiration that allows a rule to be disabled if it does not fire within a prescribed number of days.
Scoring Score entries now have optional expiration so that unused entries can be removed if they are not encountered. This automatic maintenance helps to reduce the overhead of score processing.
Bozo Bin
  • In previous versions of Gravity, the Bozo Bin was implemented as a rule with large regular expressions. As the Bozo Bin grew, the performance diminished and the likelihood of the huge regular expression getting corrupted increased. In 2.2, the Bozo Bin is simply a list rather than a rule.
  • The bozo bin also supports expiration. If a bozo is not encountered within the specified number of days it is removed from the list.
  • There is a new command (Tools/Apply bozo bin to the current group) that allows the bozo bin to be manually applied to the currently open newsgroup.
Outbox The Outbox now has automatic expiration settings that you can enable to automatically clean up the Outbox.
Image Gallery There are two new options for the Image Gallery:
  • Shrink image to fit window
  • Enlarge image to fit window
Misc
  • You can now create trace files from within Gravity using the new Trace File command on the file menu. After enabling tracing, you must disconnect from the server and re-connect for the tracing to take affect.
  • The Search DejaNews command now points to the main DejaNews web page (www.deja.com).
  • Three server properties were moved to the new Group tab. These properties are 1) Get list of new groups upon connecting, 2) Display new groups after retrieval, and 3) Update server count.
  • Gravity can be instructed to let a news server create the message-id for posted articles by disabling Server/Properties/Posting/When posting, Gravity should generate the message-id for the server.
  • When defining a display filter, you can specify that the filter will include the entire thread if any article matches the filter. Use this option, for example, if you want to show the entire thread for threads that contain any unread articles.
  • A new option has been added to Global Options/Display to allow threading by either message-id and subject or purely by message-id (pure threading).

Changes in Gravity 2.12 (build 1020)

Version 2.12 has a single change to compensate for a bug in the C Runtime Library that came with Microsoft Visual C++ 6.0 (part of Microsoft Visual Studio):

Change

Description

2.12 was re-compiled with a patched version the C Runtime library.  Microsoft Visual C++ 6.0 (including service packs 1 through 3) include a bug in the small heap memory manager that will cause Gravity to crash on large groups.  Gravity has been re-compiled with a corrected runtime library.

 

Changes In Gravity 2.11 (build 1016)

Version 2.11 is being released to provide fixes for a few of the most common issues with Gravity 2.1.  This release is not meant to be a major release or include new functionality and is free to all registered users of 2.X.  The next Gravity release (2.2), which is being developed now, will include new functionality.

Change

Description

mfc42.dll, msvcrt.dll, msvcp50.dll, _grvlib.dll no longer required Gravity 2.11 no longer requires the installation of these files.  This has a number of benefits related  to compatibility and support.  In particular, 2.11 is not dependent upon whatever dlls other products install in the Windows system directory.
Crash in kernel32.dll fixed Some people were experiencing crashes in kernel32.dll due to improperly encoded graphics files.  2.11 handles these files without problems.
Image Factory position properly restored The Image Factory position was not being properly restored if Gravity was closed when the factory was in a minimized state.  Version 2.11 properly saves the state of the Image Factory upon shutdown.
Article pane properly displays the References header In 2.1, if you included the References header in the article pane layout, it would not display.  2.11 correctly displays the References header.
DejaNews button The DejaNews button on the toolbar now points to the main site URL for DejaNews (www.dejanews.com).  Earlier versions pointed to a page that no longer exists.

Gravity 2.1 Installation Notes

Before you run version 2.1, there are some important things to note. First, the database is not backwards compatible with previous versions. Once you run the program, certain information will be in a new format that older versions of Gravity cannot read. If you are upgrading from an older version of Gravity and want to save your existing database, you can run the utility called "gravitybackup.exe" which is in the Gravity 2.1 package. The install program will ask whether you want to run this backup program as part of the install process.

 

Major New Functionality in version 2.1

New Feature Description
   
Scoring
  • A new scoring system has been added for assigning relevance values to article headers. Essentially, you indicate keywords that add or lower the score for each article header. These scores can in turn be manipulated by rules. When you add a score entry, you have the options to specify whether the phrase is a wildcard, regular expression or a plain text phrase. You can indicate whether the phrase can appear in the From header, Subject header, or both. Finally, you can indicate whether the phrase has to appear as a whole word, or whether it can appear as a part of a word.
  • Add a score for the current group by hitting the ‘S’ key.
  • In addition to specifying scores for individual groups, you can specify scores for wildcard expressions such as “alt.binaries.*”
  • A new column has been added to the thread pane – Score. You can sort by score.
  • Threads can be sorted by their score. In other words, you can sort the most important threads to the top and the least important to the bottom of the list. The thread score value is based on the article with the highest score within the thread.
  • A new command has been added to allow immediate re-scoring of the current group.
  • Score ranges can have associated background colors. Generally, you will want to use “Define Custom Colors” in the color selection dialog to achieve good results.
Rules
  • There is a new rule condition that allows the rule to examine the score.
  • There is a new rule action to adjust the score of an article.
  • You can specify that a rule applies to newsgroups that match a wildcard expression (alt.binaries.* for example)
  • You can control the order that rules are evaluated by moving them up and down within the main rules dialog.
  • When you create a Rule with the Alert action, the action indicates the group of the matching article.
  • There is now a “Replace rules with same name” option for Importing rules.
  • Rule conditions can be copied from another rule by using the “Insert From…” button on the rule condition page.
Image Gallery The operation of the Image Gallery has been substantially overhauled and it is much easier to organize your decoded images. In particular, the Gallery can be used to view directories that contain files that were not decoded by Gravity. The Image Gallery automatically synchronizes its view with the files in the viewed directory, and in general implements Explorer-like drag and drop semantics. The new features include:
  • The directory bar now functions as a most recently used list of directories that you have viewed. Each time you open a directory for viewing, it appears at the top of the list.
  • A new toolbar button has been added to allow easy filing using a most recently moved-to directory list. This list is similar to the Move To toolbar button in Microsoft Outlook.
  • In the thumbnail view, positioning the mouse over an image that Gravity decoded will cause a tool tip (bubble help) to pop up with the subject of the article.
  • In the Image Gallery, when the display adjusts its size or position to accommodate an image, the mouse cursor is automatically repositioned so that it is over the button that was clicked (e.g. Next).
  • An option has been added to the Image Gallery that allows the user to turn off automatic viewing even when the user hits the ‘v’ key in Gravity.
  • The Image Gallery now supports drag and drop. When you use the Move To button, Gravity will keep track of the image’s From, Subject, and so forth. If you drag the file out of Gravity and into Explorer or the desktop, then Gravity removes the file from its internal description database.
  • The Image Gallery now has Waiting and Done indicators in the status bar which correspond to what is in the Image Factory.
  • The Image Gallery has a progress bar in the status bar that shows the download progress of the current image being fetched for display.
  • The Image Gallery has a Protect command that marks an Image as read only (this read only status is not implemented using the file system read only attribute).
  • The Image Gallery now provides a command for launching the Image Factory (Ctrl-I).
  • The Image Gallery now has popup menus.
View Filtering
  • Filter definitions now allow the specification of the sort order.
  • Each newsgroup can have its own default view filter.
  • A button has been added to the filter bar for setting the current filter to the default for the group you are viewing.
Image Factory
  • Articles with multiple attachments generate multiple Result window items.
  • The Delete From Disk command removes the deleted item’s thumbnail if one exists.
  • A Priority View (Ctrl+Shift+V) command has been added to allow you to automatically insert an article into the top of the queued jobs in the Image Factory. If you invoke the command on an article that is already queued up, that article is moved to the top of the queue.
Retrieval
  • A new server property setting has been added “Verify local headers when retrieving new header,” which can be disabled to speed the retrieval of headers. If your purging options are set aggressively and headers are removed prior to when they would be removed at the server, then this is a good option.
  • A "Verify Local Headers" command has been added to the Newsgroup pane context menu to allow manual checking for expired articles.
  • A new server property, “Retrieve headers for group automatically after subscribe,” has been added.
  • Secure Password Authentication (SPA) is now supported for connecting to servers such as netnews.msn.com.
  • Dialup Networking passwords are now encrypted when stored in the registry.
  • A /socket command line option has been added that causes Gravity to log the communication between itself and the news server. The files are named GRAVXXXX.TRC and are created in the Gravity program directory.
Thread Pane
  • Articles with the same subject and articles that have a common ancestor (based on references) now appear as one tree within the thread display.
  • When sorted by thread, the threads themselves can be sorted by score.
  • The background color can be set for score ranges.
Article Pane
  • A new command “Mute Quoted Text”, has been added to allow quoted text to be toggled on and off within the article display. This is particularly helpful if you are following a thread and have already read the quoted material.
  • Paging down within the article pane (using the Space key) maintains a couple of lines of text from the previous page.
Printing
  • Top, bottom, left, and right margins can be set.
  • The print font and color can be controlled.
  • Full headers can be explicitly included or omitted for each article.
Signature Stripping
  • Gravity now automatically removes signatures that are in the standard format (dash dash space carriage return) from replies and followups.
Update Notification
  • A new tab has been added to the Global options that allows Gravity to automatically check the MicroPlanet web site for newer versions of Gravity.  By default, the software will check every 7 days.  The number of days between checks can be adjusted or the check can be disabled altogether.  When a new version is found, Gravity displays a notification that describes the new version.
Miscellaneous
  • The list of servers on the Server menu is kept sorted.
  • Numerous usability requests were implemented.

 

Major New Functionality in version 2.0

New Feature Description
   
New Image Gallery The Image Gallery has been completely revamped. The former functionality is still available under View/Image Factory. The new Image Gallery includes all of the following functionality:
  • Can display common formats such as GIF, JPEG, BMP, etc...
  • Allows the images to be viewed as thumbnails. The thumbnail size can be specified.
  • Has a customizable toolbar.
  • Has a directory bar that the user can use to see images in the various decode output directories.
  • A Session button that allows the user to restrict the view to the Images that have been decoded in the current session.
  • First, Last, Previous, and Next Navigation.
  • Enlarge and Reduce images.
  • A command to set the viewed image as the Windows desktop wallpaper.
  • A command to spawn a new window with the current image.
  • Commands to move and delete images.
  • Slideshow capabilitities. The user can view a slideshow of all images, or tagged images.
  • Images can be sorted on various criteria.
  • The image window automatically sizes according to the image size.
Improved Subscribe Dialog with Newsgroup Sampling The Subscribe To Newsgroup dialog has been improved significantly. Among the improvements:
  • The dialog can be sized so that long group names are easily visible. The orientation of the available and selected groups is improved.
  • Multiple items in the Selected Groups pane can be edited at once.
  • Groups can be sampled rather than subscribed. Sampled groups are removed at the end of the session or when the user switches to another news server..
Server Switching Users can now switch between different news servers without having to exit and restart Gravity. Servers can be added and removed from the Server menu. The caption bar always indicates the current server and newsgroup.
Improved View Filters The view filters have been improved so that the user can construct advanced filters using all of the conditions available for rules. Thus, users can have views such as "all undecoded Cindy Crawford pictures" or "All replies to me."
Import/Export Newsrc Gravity now supports importing and exporting the newsgroup information to the standard NEWSRC format.
Customizable Toolbar Gravity now has a new toolbar that the user can customize. The toolbar has the new "cool" look supported by IE4 and can be modified using drag and drop similar to the way MS Office applications work.
Multi-Selection In the Newsgroup Pane The newsgroup pane supports multi-selection, so commands available to operate on a single newsgroup can be applied to multiple newsgroups (e.g., catch-up, unsubscribe, apply a rule manually, etc...).
New Per-Group Settings A number of settings can now be made on a per-newsgroup basis,, including:
  • Full Name
  • Email Address
  • Decode Directory
  • Custom Headers

Custom Headers

Arbitrary custom headers can be specified when posting an article, e.g., "x-no-archive: yes".
Outbox Supports Re-Edit and Draft The outbox now supports re-editing items that have already been sent. Compositions can be saved as drafts.
New Decoding Options The following new decoding options have been provided:
  • Remove decoded items on exit. This is great if you are more into viewing the images than archiving them.
  • Output 4DOS compatible description files.
  • Use the new Image Gallery to view binaries.
Support For news: and nntp: URL Gravity now supports the news: and nntp: URLs. When clicking on one of these URLs in a web browser, Gravity will attempt to bring up the group for sampling if it is not already subscribed.
HTML Suppression Gravity now has an option to strip out the HTML part of articles that are posted with both text and html body parts.

Backing Up and Restoring Previous Versions of Gravity

When you install Gravity over previous versions, Gravity will automatically convert your existing database to a new format.  During the setup process, you are given an opportunity to create a backup of your previous database and settings so that you can restore them if necessary.  If you backed up your database and settings, the steps for restoring a previous version are:

  1. Print out these instructions (they will get removed by step 2).
  2. Use the Control Panel Add/Remove Programs feature to remove MicroPlanet Gravity.
  3. Re-install the older version you want to restore (e.g. 1.1 or 2.0). Be careful to re-install into the directory where it was previously installed.  During installation of the previous version, you will be asked if you want to run Gravity. Answer "No" to this question and exit the install process. 
  4. Locate the directory where the backup was made. The default location is c:\Program files\Gravity\Backup.  Run GravityBackup.exe from that directory to restore the backup file (.grv) that you created. 
  5. Run your older copy of Gravity to confirm that it performs correctly.

Note : When you upgrade from 1.1 or 2.0 to Gravity 2.2, the installation script renames the directory to "Gravity" from "Anawave Gravity." If, after restoring your previous version, you no longer need the backup program and file that was created, then you should remove the Gravity directory so that future versions of Gravity can install properly.