- issue210: umongo-osx-all_1-6-1.zip corrupted ?

README.rst

@@ -0,0 +1,90 @@
+=======================
+UMONGO, the MongoDB GUI
+=======================
+
+.. header:: UMONGO, the MongoDB GUI
+.. footer:: Copyright (C) 2010 EdgyTech LLC.
+
+About
+-----
+
+This version of UMongo is provided as free software by EdgyTech LLC.
+UMongo is open source, and sources can be seen at https://github.com/agirbal/umongo .
+The libraries used by UMongo either have an open source license, or are proprietary and owned by EdgyTech LLC.
+
+Download
+--------
+
+All binaries are available from:
+http://www.edgytech.com/umongo
+
+Install and Run
+---------------
+
+Windows
+^^^^^^^
+
+Steps:
+
+- place archive file where is preferred (for example, in your downloads folder)
+- extract the archive (right-click “Extract All”)
+- open the extracted folder and double-click umongo (type Application)
+
+Linux
+^^^^^
+
+Steps:
+
+- place archive file where is preferred (for example, in your downloads folder)
+- extract the archive (right-click “Extract Here”)
+- open the extracted folder and double-click launch-umongo.sh, or execute launch-umongo.sh in a terminal
+
+Mac OSX
+^^^^^^^
+
+**If your Mac tells you that the application is damaged**, go to "system preferences / security and privacy / General" and make sure that "allow applications downloaded from" is set to "anywhere".
+
+Steps:
+
+- place archive file where is preferred and extract it (for example, in your downloads folder)
+- extract the archive (double-click the file)
+- open the extracted folder and double-click umongo.app
+
+Command line
+^^^^^^^^^^^^
+
+On any platform you can run UMongo from the command line.
+Open a terminal and go to UMongo's directory in which umongo.jar is present and run::
+
+    > java -jar umongo.jar
+
+Using a Proxy
+-------------
+
+Often times your client machine cannot directly connect to the MongoDB hosts.
+One easy trick is to use a ``SOCKS`` proxy based on SSH tunnel to connect transparently::
+
+    > ssh -D 9000 -i key.pem hostThatCanConnectToDB -N
+
+Then make sure you select a ``SOCKS`` proxy of "localhost:9000" in the connection settings.
+
+Building UMongo
+---------------
+
+To compile:
+
+-   go to the base directory and run::
+
+    > ant jar
+
+To package the application:
+
+-   go to the ``package`` folder and run::
+
+    > ./package.sh
+
+To set the version:
+
+- change the version number in ``manifest.mf`` prior to compile / package
+
+

package/osx/package.sh

@@ -28,7 +28,7 @@ function package_build {
     mkdir -p $app/Contents/Resources/Java/lib
 	cp ../lib/*.jar $app/Contents/Resources/Java/lib
     cp ./common-files/* $app/Contents/Resources/Java/
-    cp ../README $appdir/
+    cp ../README.rst $appdir/
     mkdir $appdir/plugins
 
 	zip -r ${appdir}.zip $appdir

package/package.sh

@@ -21,7 +21,7 @@ function package_build {
 	cp ../dist/umongo.jar $appdir/
 	mkdir $appdir/lib
 	cp ../lib/*.jar $appdir/lib/
-    cp ../README $appdir/
+    cp ../README.rst $appdir/
 	mkdir $appdir/plugins
 
 	zip -r ${appdir}.zip $appdir