diff --git a/sqlexplorer/README.md b/sqlexplorer/README.md new file mode 100644 index 0000000..4209413 --- /dev/null +++ b/sqlexplorer/README.md @@ -0,0 +1,31 @@ + + +# Eclipse SQL Explorer v3.7 + +## Code changes + +This version of SQL Explorer has been migrated from [Sourceforge](https://sourceforge.net/projects/eclipsesql/) in +October 2018; as well as fixng a few bugs, the code has been refactored to simplify development and deployment - +where previously each database driver was implemented in a separate plugin and the plugins were combined for +deployment via a feature, these have been removed and the drivers integrated into the one plugin. + +Older and more esoteric database support (eg Informix) has been dropped, although the code is still available in the +master branch and would be straightforward to integrate. The databases supported are: + +* Oracle +* MySQL +* Microsoft SQL Server + +## Releases +Currently, the only release is as a plugin for manual deployment. This could change, depending on +whether there is demand (or someone wants to support it). + +To use this release: +1. Shut down Eclipse +2. In the Eclipse application directory +a. find the `features` directory and delete all `net.sourceforge.sqlexplorer*` files & directories. +b. find the `plugins` directory and delete all `net.sourceforge.sqlexplorer*` files & directories. +3. Download the .jar from the Releases page at GitHub and place it in the `plugins` directory +4. Start Eclipse with the `-clean` command line argument +After the first time with `-clean` you can start Eclipse normally. + diff --git a/sqlexplorer/README.txt b/sqlexplorer/README.txt deleted file mode 100644 index 5a51bda..0000000 --- a/sqlexplorer/README.txt +++ /dev/null @@ -1,76 +0,0 @@ - - -Eclipse SQL Explorer v3.5.0 -=========================== - -Upgrading from Previous Versions (Plugin and RCP) -================================================= -When you start Eclipse for the first time after installing a new version, you MUST use the --clean command line argument to eclipse; this resets cached information in Eclipse that can -cause problems. - - -Upgrading from Previous Releases (Plugin Only) -============================================== -Before upgrading (including from beta versions) you must remove previous installations -of SQLExplorer; to do this, locate your Eclipse directory and delete: - - Folders to delete - ----------------- - features/net.sourceforge.sqlexplorer_3.5.0.* - plugins/net.sourceforge.sqlexplorer.help_3.5.0.* - plugins/net.sourceforge.sqlexplorer_3.5.0.* - - Files to delete - --------------- - plugins/net.sourceforge.sqlexplorer.db2_3.5.0.*.jar - plugins/net.sourceforge.sqlexplorer.mysql_3.5.0.*.jar - plugins/net.sourceforge.sqlexplorer.oracle_3.5.0.*.jar - plugins/net.sourceforge.sqlexplorer.postgresql_3.5.0.*.jar - - -JRE Version (RCP Users) -======================= -SQLExplorer 3.5.0 requires that the JRE is at least v5.0 (aka JRE 1.5); if you are still using -JRE 1.4 this is not necessarily - simply download the "SQLExplorer RCP (inc JRE)" version. - - -JRE Version (Plugin Users) -========================== -SQLExplorer 3.5.0 requires that the JRE is at least v5.0 (aka JRE 1.5); if you are still using -JRE 1.4 this is not necessarily a problem, even if the software you develop using Eclipse has -to target 1.4 because Eclipse can run using a /different/ JRE to the one used to compile, run, -and debug your application(s). - -There are two ways to do this, which one you choose depends on whether you want to use your -new JRE5.0 for more than just running Eclipse. - -Option A - JRE5.0 is *only* used to run Eclipse ------------------------------------------------ -Install the JRE into a subdirectory of your Eclipse installation directory called "jre"; note -that the default installation path includes version numbers etc - the folder must be called -simply "jre". To be clear, you should have a directory layout like this: - - c:\eclipse\ - eclipse.exe - jre\ - bin\ - javaw.exe - -Every time Eclipse starts it looks for a "jre" folder and will use that by default. You do -NOT need to have the JRE on the system PATH or be referenced from anywhere so you can be -reasonably assured that the JRE you develop against (eg v1.4) has not been replaced. - - -Option B - JRE5.0 is used for Eclipse and other programs, just not always -------------------------------------------------------------------------- -Install the JRE in the default place and use the -vm parameter when starting Eclipse; eg, -under Windows, modify your shortcut like so: - - c:\eclipse\eclipse.exe -vm "c:\Program Files\Java\jre_1.5.0_13\bin\javaw.exe" - -NOTE: This is actually how you are recommended to start Eclipse because if your OS path -is changed you might get unexpected results if you find that your JRE does too. - - - diff --git a/sqlexplorer/build.properties b/sqlexplorer/build.properties index 9e9af12..b12c8b4 100644 --- a/sqlexplorer/build.properties +++ b/sqlexplorer/build.properties @@ -13,7 +13,7 @@ src.includes = .classpath,\ preferences.ini,\ META-INF/,\ config.ini,\ - README.txt,\ + README.md,\ test/,\ license.txt,\ plugin.properties @@ -31,7 +31,7 @@ bin.includes = default_drivers.xml,\ lib/log4j.jar,\ lib/rowset.jar,\ lib/dom4j.jar,\ - README.txt,\ + README.md,\ lib/hibernate3.2.4.sp1.jar,\ license.txt,\ plugin.properties,\