kthlnkeating · shabiel · Oct 27, 2014 · Oct 27, 2014 · Oct 29, 2014 · Oct 29, 2014
diff --git a/MToolsFeatureProject/feature.xml b/MToolsFeatureProject/feature.xml
@@ -1,11 +1,11 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<feature
-      id="gov.va.vista.mtools"
-      label="MTools Feature"
-      version="1.1.7"
-      provider-name="US Department of Veterans Affairs">
-
-   <license url="http://www.apache.org/licenses/LICENSE-2.0">
+<?xml version="1.0" encoding="UTF-8"?>
+<feature
+      id="gov.va.vista.mtools"
+      label="MTools Feature"
+      version="1.1.10"
+      provider-name="US Department of Veterans Affairs">
+
+   <license url="http://www.apache.org/licenses/LICENSE-2.0">
       Copyright 2013 US Department of Veterans Affairs
 
    Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);
@@ -18,88 +18,88 @@
    distributed under the License is distributed on an &quot;AS IS&quot; BASIS,
    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
    See the License for the specific language governing permissions and
-   limitations under the License.
-   </license>
-
-   <requires>
-      <import plugin="org.apache.log4j" version="1.2.8" match="greaterOrEqual"/>
-      <import plugin="org.eclipse.ui" version="3.7.0" match="greaterOrEqual"/>
-      <import plugin="org.eclipse.core.runtime" version="3.7.0" match="greaterOrEqual"/>
-      <import plugin="org.eclipse.core.resources" version="3.7.101" match="greaterOrEqual"/>
-      <import plugin="org.eclipse.ui.ide" version="3.7.0" match="greaterOrEqual"/>
-      <import plugin="org.eclipse.jface.text" version="3.7.2" match="greaterOrEqual"/>
-      <import plugin="org.eclipse.ui.editors" version="3.7.0" match="greaterOrEqual"/>
-      <import plugin="org.eclipse.ui.views" version="3.6.0" match="greaterOrEqual"/>
-      <import plugin="org.eclipse.ui.console" version="3.5.100" match="greaterOrEqual"/>
-      <import plugin="gov.va.med.iss.connection" version="0.1.5" match="greaterOrEqual"/>
-      <import plugin="org.eclipse.debug.core" version="3.7.1" match="greaterOrEqual"/>
-      <import plugin="org.eclipse.core.runtime.compatibility" version="3.2.100" match="greaterOrEqual"/>
-      <import plugin="org.eclipse.debug.ui" version="3.7.102" match="greaterOrEqual"/>
-      <import plugin="org.eclipse.ui.workbench.texteditor" version="3.7.0" match="greaterOrEqual"/>
-      <import plugin="gov.va.med.iss.debug.core" version="0.1.8" match="greaterOrEqual"/>
-      <import plugin="gov.va.med.iss.meditor" version="0.1.10" match="greaterOrEqual"/>
-      <import plugin="org.eclipse.core.filebuffers" version="3.5.200" match="greaterOrEqual"/>
-   </requires>
-
-   <plugin
-         id="gov.va.med.iss.connection"
-         download-size="0"
-         install-size="0"
-         version="0.0.0"/>
-
-   <plugin
-         id="gov.va.med.iss.meditor"
-         download-size="0"
-         install-size="0"
-         version="0.0.0"/>
-
-   <plugin
-         id="gov.va.med.iss.debug.core"
-         download-size="0"
-         install-size="0"
-         version="0.0.0"
-         unpack="false"/>
-
-   <plugin
-         id="gov.va.med.iss.debug.ui"
-         download-size="0"
-         install-size="0"
-         version="0.0.0"
-         unpack="false"/>
-
-   <plugin
-         id="us.pwc.vista.eclipse.tools"
-         download-size="0"
-         install-size="0"
-         version="0.0.0"
-         unpack="false"/>
-
-   <plugin
-         id="us.pwc.vista.mlib"
-         download-size="0"
-         install-size="0"
-         version="0.0.0"
-         unpack="false"/>
-
-   <plugin
-         id="us.pwc.vista.eclipse.core"
-         download-size="0"
-         install-size="0"
-         version="0.0.0"
-         unpack="false"/>
-
-   <plugin
-         id="us.pwc.vista.eclipse.server"
-         download-size="0"
-         install-size="0"
-         version="0.0.0"
-         unpack="false"/>
-
-   <plugin
-         id="us.pwc.vista.eclipse.wizard"
-         download-size="0"
-         install-size="0"
-         version="0.0.0"
-         unpack="false"/>
-
-</feature>
+   limitations under the License.
+   </license>
+
+   <requires>
+      <import plugin="org.apache.log4j" version="1.2.8" match="greaterOrEqual"/>
+      <import plugin="org.eclipse.ui" version="3.7.0" match="greaterOrEqual"/>
+      <import plugin="org.eclipse.core.runtime" version="3.7.0" match="greaterOrEqual"/>
+      <import plugin="org.eclipse.core.resources" version="3.7.101" match="greaterOrEqual"/>
+      <import plugin="org.eclipse.ui.ide" version="3.7.0" match="greaterOrEqual"/>
+      <import plugin="org.eclipse.jface.text" version="3.7.2" match="greaterOrEqual"/>
+      <import plugin="org.eclipse.ui.editors" version="3.7.0" match="greaterOrEqual"/>
+      <import plugin="org.eclipse.ui.views" version="3.6.0" match="greaterOrEqual"/>
+      <import plugin="org.eclipse.ui.console" version="3.5.100" match="greaterOrEqual"/>
+      <import plugin="gov.va.med.iss.connection" version="0.1.5" match="greaterOrEqual"/>
+      <import plugin="org.eclipse.debug.core" version="3.7.1" match="greaterOrEqual"/>
+      <import plugin="org.eclipse.core.runtime.compatibility" version="3.2.100" match="greaterOrEqual"/>
+      <import plugin="org.eclipse.debug.ui" version="3.7.102" match="greaterOrEqual"/>
+      <import plugin="org.eclipse.ui.workbench.texteditor" version="3.7.0" match="greaterOrEqual"/>
+      <import plugin="gov.va.med.iss.debug.core" version="0.1.8" match="greaterOrEqual"/>
+      <import plugin="gov.va.med.iss.meditor" version="0.1.10" match="greaterOrEqual"/>
+      <import plugin="org.eclipse.core.filebuffers" version="3.5.200" match="greaterOrEqual"/>
+   </requires>
+
+   <plugin
+         id="gov.va.med.iss.connection"
+         download-size="0"
+         install-size="0"
+         version="0.0.0"/>
+
+   <plugin
+         id="gov.va.med.iss.meditor"
+         download-size="0"
+         install-size="0"
+         version="0.0.0"/>
+
+   <plugin
+         id="gov.va.med.iss.debug.core"
+         download-size="0"
+         install-size="0"
+         version="0.0.0"
+         unpack="false"/>
+
+   <plugin
+         id="gov.va.med.iss.debug.ui"
+         download-size="0"
+         install-size="0"
+         version="0.0.0"
+         unpack="false"/>
+
+   <plugin
+         id="us.pwc.vista.eclipse.tools"
+         download-size="0"
+         install-size="0"
+         version="0.0.0"
+         unpack="false"/>
+
+   <plugin
+         id="us.pwc.vista.mlib"
+         download-size="0"
+         install-size="0"
+         version="0.0.0"
+         unpack="false"/>
+
+   <plugin
+         id="us.pwc.vista.eclipse.core"
+         download-size="0"
+         install-size="0"
+         version="0.0.0"
+         unpack="false"/>
+
+   <plugin
+         id="us.pwc.vista.eclipse.server"
+         download-size="0"
+         install-size="0"
+         version="0.0.0"
+         unpack="false"/>
+
+   <plugin
+         id="us.pwc.vista.eclipse.wizard"
+         download-size="0"
+         install-size="0"
+         version="0.0.0"
+         unpack="false"/>
+
+</feature>
diff --git a/MToolsUpdateSiteProject/artifacts.jar b/MToolsUpdateSiteProject/artifacts.jar
diff --git a/MToolsUpdateSiteProject/content.jar b/MToolsUpdateSiteProject/content.jar
diff --git a/MToolsUpdateSiteProject/features/gov.va.vista.mtools_1.1.10.jar b/MToolsUpdateSiteProject/features/gov.va.vista.mtools_1.1.10.jar
diff --git a/MToolsUpdateSiteProject/features/gov.va.vista.mtools_1.1.6.jar b/MToolsUpdateSiteProject/features/gov.va.vista.mtools_1.1.6.jar
diff --git a/MToolsUpdateSiteProject/features/gov.va.vista.mtools_1.1.7.jar b/MToolsUpdateSiteProject/features/gov.va.vista.mtools_1.1.7.jar
diff --git a/MToolsUpdateSiteProject/features/gov.va.vista.mtools_1.1.8.jar b/MToolsUpdateSiteProject/features/gov.va.vista.mtools_1.1.8.jar
diff --git a/MToolsUpdateSiteProject/features/gov.va.vista.mtools_1.1.9.jar b/MToolsUpdateSiteProject/features/gov.va.vista.mtools_1.1.9.jar
diff --git a/...ugins/gov.va.med.iss.connection_1.0.0.jar → ...ugins/gov.va.med.iss.connection_1.1.0.jar b/...ugins/gov.va.med.iss.connection_1.0.0.jar → ...ugins/gov.va.med.iss.connection_1.1.0.jar
diff --git a/...ugins/gov.va.med.iss.connection_0.1.9.jar → ...ugins/gov.va.med.iss.connection_1.1.1.jar b/...ugins/gov.va.med.iss.connection_0.1.9.jar → ...ugins/gov.va.med.iss.connection_1.1.1.jar
diff --git a/MToolsUpdateSiteProject/plugins/gov.va.med.iss.debug.core_0.2.2.jar b/MToolsUpdateSiteProject/plugins/gov.va.med.iss.debug.core_0.2.2.jar
diff --git a/MToolsUpdateSiteProject/plugins/gov.va.med.iss.debug.core_1.0.0.jar b/MToolsUpdateSiteProject/plugins/gov.va.med.iss.debug.core_1.0.0.jar
diff --git a/MToolsUpdateSiteProject/plugins/gov.va.med.iss.debug.ui_0.2.1.jar b/MToolsUpdateSiteProject/plugins/gov.va.med.iss.debug.ui_0.2.1.jar
diff --git a/MToolsUpdateSiteProject/plugins/gov.va.med.iss.debug.ui_1.0.0.jar b/MToolsUpdateSiteProject/plugins/gov.va.med.iss.debug.ui_1.0.0.jar
diff --git a/MToolsUpdateSiteProject/plugins/gov.va.med.iss.meditor_0.1.13.jar b/MToolsUpdateSiteProject/plugins/gov.va.med.iss.meditor_0.1.13.jar
diff --git a/MToolsUpdateSiteProject/plugins/gov.va.med.iss.meditor_1.0.0.jar b/MToolsUpdateSiteProject/plugins/gov.va.med.iss.meditor_1.0.0.jar
diff --git a/MToolsUpdateSiteProject/plugins/us.pwc.vista.eclipse.core_1.0.2.jar b/MToolsUpdateSiteProject/plugins/us.pwc.vista.eclipse.core_1.0.2.jar
diff --git a/MToolsUpdateSiteProject/plugins/us.pwc.vista.eclipse.core_1.0.3.jar b/MToolsUpdateSiteProject/plugins/us.pwc.vista.eclipse.core_1.0.3.jar
diff --git a/MToolsUpdateSiteProject/plugins/us.pwc.vista.eclipse.core_1.1.0.jar b/MToolsUpdateSiteProject/plugins/us.pwc.vista.eclipse.core_1.1.0.jar
diff --git a/MToolsUpdateSiteProject/plugins/us.pwc.vista.eclipse.server_1.0.1.jar b/MToolsUpdateSiteProject/plugins/us.pwc.vista.eclipse.server_1.0.1.jar
diff --git a/MToolsUpdateSiteProject/plugins/us.pwc.vista.eclipse.server_1.0.2.jar b/MToolsUpdateSiteProject/plugins/us.pwc.vista.eclipse.server_1.0.2.jar
diff --git a/MToolsUpdateSiteProject/plugins/us.pwc.vista.eclipse.tools_1.1.2.jar b/MToolsUpdateSiteProject/plugins/us.pwc.vista.eclipse.tools_1.1.2.jar
diff --git a/MToolsUpdateSiteProject/plugins/us.pwc.vista.eclipse.tools_1.1.3.jar b/MToolsUpdateSiteProject/plugins/us.pwc.vista.eclipse.tools_1.1.3.jar
diff --git a/MToolsUpdateSiteProject/plugins/us.pwc.vista.eclipse.wizard_1.0.1.jar b/MToolsUpdateSiteProject/plugins/us.pwc.vista.eclipse.wizard_1.0.1.jar
diff --git a/MToolsUpdateSiteProject/plugins/us.pwc.vista.mlib_1.0.2.jar b/MToolsUpdateSiteProject/plugins/us.pwc.vista.mlib_1.0.2.jar
diff --git a/MToolsUpdateSiteProject/plugins/us.pwc.vista.mlib_1.0.3.jar b/MToolsUpdateSiteProject/plugins/us.pwc.vista.mlib_1.0.3.jar
diff --git a/MToolsUpdateSiteProject/site.xml b/MToolsUpdateSiteProject/site.xml
@@ -1,7 +1,7 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<site>
-   <feature url="features/gov.va.vista.mtools_1.1.7.jar" id="gov.va.vista.mtools" version="1.1.7">
-      <category name="gov.va.vista.eclipse"/>
-   </feature>
-   <category-def name="gov.va.vista.eclipse" label="VistA Tools"/>
-</site>
+<?xml version="1.0" encoding="UTF-8"?>
+<site>
+   <feature url="features/gov.va.vista.mtools_1.1.10.jar" id="gov.va.vista.mtools" version="1.1.10">
+      <category name="gov.va.vista.eclipse"/>
+   </feature>
+   <category-def name="gov.va.vista.eclipse" label="VistA Tools"/>
+</site>
diff --git a/README.md b/README.md
@@ -0,0 +1,118 @@
+# Introduction
+This package lets you edit M Routines and Look at globals using Eclipse. It also includes a non-functional terminal and Debugging capabilities which are close to being done but are not quite there yet.
+
+# Installation
+## Requirements
+ - Recent Eclipse. Tested on Luna, Kepler, and Juno.
+ - Java 1.7 or Java 1.8. YOU MUST CHECK FOR THAT USING YOUR OS'S COMMAND LINE.
+ ECLISPE DOES NOT WARN YOU IF IT CAN'T LOAD IT. Use `java -version` to find out
+ what version you have.
+ - DOES NOT WORK ON MACS. Joel Ivey's version works, but I have to make
+   instructions for it.
+
+## How to install
+### Eclipse
+ - Download the latest Eclipse IDE from http://eclipse.org. Any version-type is
+   fine. Download the smallest one.
+ - To install Eclipse, all you need to do is unzip the downloaded folder in a
+   place you can remember and open the Eclipse file (Eclipse.exe on Windows,
+   eclipse on Linux)
+ - On Eclipse, Menu Help > Install New Software...
+ - Click Add
+ - Enter `M-tools` in first field and `https://raw.githubusercontent.com/shabiel/M-Tools-Project/master/MToolsUpdateSiteProject/` on the next.
+ - Click on Next, Next, Accept the license, Finish.
+ - Override the warning about unsigned content.
+
+### VISTA
+ - Log into VISTA as a programmer in Programming Mode
+ - Create a user that has XUPROG and XUPROGMODE. If you use the OSEHRA Test
+ runner or the OSEHRA virtual machine, you will already have the System Manager
+ user (AC;VC: SM1234;SM1234!!!) that has that permission. I won't cover how to
+ create a user here.
+ - Get and Install this KID build: https://raw.githubusercontent.com/shabiel/M-Tools/T12/M-Editor%20For%20Eclipse%20XT_7.3_101%20not%20yet%20released/XT73P101T12.kid
+ - Get the file first: On Linux, type:
+ ```
+ cd /tmp/
+ wget https://raw.githubusercontent.com/shabiel/M-Tools/T12/M-Editor%20For%20Eclipse%20XT_7.3_101%20not%20yet%20released/XT73P101T12.kid
+ $gtm_dist/mumps -dir
+
+ GTM>D ^XPDIL,^XPDI
+
+ Enter a Host File: /tmp/XT73P101T12.kid
+
+ KIDS Distribution saved on Apr 17, 2015@16:20:41
+ Comment: T12: Added the correct version of XUSRB1
+
+ This Distribution contains Transport Globals for the following Package(s):
+ XT*7.3*101
+ Distribution OK!
+
+ Want to Continue with Load? YES//
+ GTM>D ^XPDIL,^XPDI
+
+ Enter a Host File: /tmp/XT73P101T12.kid
+
+ KIDS Distribution saved on Apr 17, 2015@16:20:41
+ Comment: T12: Added the correct version of XUSRB1
+
+ This Distribution contains Transport Globals for the following Package(s):
+ XT*7.3*101
+ Distribution OK!
+
+ Want to Continue with Load? YES//
+
+ Select INSTALL NAME:    XT*7.3*101     Loaded from Distribution    4/17/15@16:54
+ :11
+      => T12: Added the correct version of XUSRB1  ;Created on Apr 17, 2015@16:
+
+ This Distribution was loaded on Apr 17, 2015@16:54:11 with header of 
+    T12: Added the correct version of XUSRB1  ;Created on Apr 17, 2015@16:20:41
+    It consisted of the following Install(s):
+      XT*7.3*101
+ Checking Install for Package XT*7.3*101
+
+ Install Questions for XT*7.3*101
+
+
+
+ Want KIDS to INHIBIT LOGONs during the install? NO// 
+ Want to DISABLE Scheduled Options, Menu Options, and Protocols? NO// 
+```
+
+
+# Brief Usage Tutorial
+ 1. Make sure that you have a VistALink port open on your VISTA environment. Cache users can use the XOBU SITE SETUP MENU to start a port. GT.M users need to use a xinetd listener that invokes `GTMLNX^XOBVTCP`.
+ 2. Menu Window > Preferences > VistA. Give the server a name and add its ip address and port number for your VistALink port.
+ 3. Hit OK, OK.
+ 4. Open M Prespective by Window > Open Prespective > Other > VistA. You may need to resize your prespective by "restoring" the Windows.
+ 5. Create a new Project, or import a git repository. You can google the latter. For the first, File > New > Project > General > Project. Choose a name and hit okay. 
+ 6. On the Project Exlporer on your upper left corner, right click on the Project, choose Properties, then choose VistA. Type in the name *exactly* of your VistA server that you set up in Step 2. Hit OK.
+ 7. Click on Menu VistA > Connect to VistA. You should see a screen asking you for the access and verify code. If you don't see this screen, you need to check all your settings, down to whether you can even connect to the VistALink port from netcat or telnet. Also, YOU MUST USE A USER WHO HAS THE KEY XUPROGMODE.
+ 8. Once you are signed in, you can use the VistA menu or the ugly green M button to load a routine. Saving is done using the regular Eclipse Save. To create a new routine Menu File > New > VistA Routine.
+
+ That's it.
+
+ There is detailed usage documentation in the repository.
+
+# Linux Notes
+Linux is always finicky. So here's my set-up that I am sure works.
+
+ - I have Ubuntu 14.04 x64.
+ - Install Oracle Java 7 or 8. Make sure it's set to be the default java
+   implementation in the system. My memory tells me that OpenJDK didn't work; but
+   it should be tried again.
+ - Eclipse Luna x64.
+
+# Plug-in Development guidance
+
+MTools imported as an Eclipse project.
+
+Can be ran via opening the plugin.xml of a given projecting and clicking run or debug in the upper right corner.
+
+Or alternatively just to copy the files from /MtoolsUpdateSiteProject/plugins (the 3 jar plugin files) into $ECLIPSE_HOME/dropins.
+
+Can also use the project 'MToolsUpdateSite' to create and deploy p2 update site later (as is done in RASR).
+
+
+Notes:
+Refer to /MiscDependencies and /docs for complete installation details.
diff --git a/README.txt b/README.txt
diff --git a/gov.va.med.iss.connection/.project b/gov.va.med.iss.connection/.project
@@ -1,28 +1,28 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<projectDescription>
-	<name>gov.va.med.iss.connection</name>
-	<comment></comment>
-	<projects>
-	</projects>
-	<buildSpec>
-		<buildCommand>
-			<name>org.eclipse.jdt.core.javabuilder</name>
-			<arguments>
-			</arguments>
-		</buildCommand>
-		<buildCommand>
-			<name>org.eclipse.pde.ManifestBuilder</name>
-			<arguments>
-			</arguments>
-		</buildCommand>
-		<buildCommand>
-			<name>org.eclipse.pde.SchemaBuilder</name>
-			<arguments>
-			</arguments>
-		</buildCommand>
-	</buildSpec>
-	<natures>
-		<nature>org.eclipse.pde.PluginNature</nature>
-		<nature>org.eclipse.jdt.core.javanature</nature>
-	</natures>
-</projectDescription>
+<?xml version="1.0" encoding="UTF-8"?>
+<projectDescription>
+	<name>gov.va.med.iss.connection</name>
+	<comment></comment>
+	<projects>
+	</projects>
+	<buildSpec>
+		<buildCommand>
+			<name>org.eclipse.jdt.core.javabuilder</name>
+			<arguments>
+			</arguments>
+		</buildCommand>
+		<buildCommand>
+			<name>org.eclipse.pde.ManifestBuilder</name>
+			<arguments>
+			</arguments>
+		</buildCommand>
+		<buildCommand>
+			<name>org.eclipse.pde.SchemaBuilder</name>
+			<arguments>
+			</arguments>
+		</buildCommand>
+	</buildSpec>
+	<natures>
+		<nature>org.eclipse.pde.PluginNature</nature>
+		<nature>org.eclipse.jdt.core.javanature</nature>
+	</natures>
+</projectDescription>