Copyedit building the GUI

Author: Tom-Willemsen

doc/Client.md

@@ -6,7 +6,7 @@
 :glob:
 :titlesonly:
 
-client/GUI-Getting-Started
+client/GUI-Building
 client/GUI-Coding
 client/GUI-Testing
 client/GUI-Eclipse

doc/Script-Generator.md

@@ -22,7 +22,7 @@ script_generator/*
 | Standalone app build directories | `base/uk.ac.isis.scriptgenerator/*` |
 
 ## Eclipse build
-To build and run the app through eclipse, the script generator product is found in `base\uk.ac.stfc.isis.scriptgenerator.client.product`. The instructions for setting up eclipse and loading the target platform (necessary for the script generator) are found in the instructions for the [main IBEX GUI setup](/client/getting_started/Building-the-GUI)
+To build and run the app through eclipse, the script generator product is found in `base\uk.ac.stfc.isis.scriptgenerator.client.product`. The instructions for setting up eclipse and loading the target platform (necessary for the script generator) are found in the instructions for the [main IBEX GUI setup](/client/build/Building-the-GUI)
 
 {#scriptgenerator_enable_perspective}
 ### Adding the perspective into the client

doc/client/GUI-Building.md

@@ -0,0 +1,8 @@
+# Building
+
+```{toctree}
+:glob:
+:titlesonly:
+
+build/*
+```

doc/client/GUI-Getting-Started.md

@@ -11,6 +11,15 @@ The following pages also contain GUI troubleshooting information for specific pr
 troubleshooting/*
 ```
 
+## Display resolution & scaling
+
+If the GUI loads up but items are the wrong size, you may need to change your display settings. The exact settings that
+you need may vary from computer to computer. This is a common issue on Windows 10 machines due to the OS' scaling
+setting for text, icons etc. that is meant to ensure they do not look too small on high screen resolutions. 
+
+Generally a resolution of 1920 x 1080 with a scaling factor of 100% should look correct on standard screens. You can
+increase both of those settings slightly if you feel like the display elements look uncomfortably small.
+
 ## IBEX appears fullscreen with top menu items hidden
 
 Solution: right click inside any OPI and select "exit full screen".
@@ -95,7 +104,6 @@ Add `Eclipse-BundleShape: dir` in the `MANIFEST.MF`; see the `.opis` `MANIFEST.M
 This makes the maven build build the directory into a directory rather than a jar, which is sometimes necessary to let eclipse then "see" the files natively on the filesystem. If you look in the `plugins/` folder of a built client you should see a folder for `.opis` but a `.jar` for most other ibex modules - except for a few that need to be built as directories, as you may be finding.
 
 
-
 ## Other issues
 ### Remote debugging with Eclipse
 The following has been done to ensure that it is possible to debug the IBEX GUI running on any particular instrument:

doc/client/GUI-Troubleshooting.md

@@ -122,8 +122,13 @@ Sometimes when you check out a new branch in the ibex GUI repository, you won't
 
 1. In Eclipse, remove all the projects from the workspace and close Eclipse.
 1. Then, while checked out to the branch you want to see the changes on, perform a `git clean -fdx && git reset HEAD --hard` to reset the git repository. This will remove any changes you have made to the branch.
-1. Restart Eclipse and repeat the steps to get the GUI working from [Building the GUI](../getting_started/Building-the-GUI).
+1. Restart Eclipse and repeat the steps to get the GUI working from [Building the GUI](../build/Building-the-GUI).
 
 ## Build fails with `[ERROR] Failed to resolve target definition ... targetplatform.target: Could not find "org.eclipse.e4.tools.spies.feature.feature.group..." in the repositories of the current location`
 
 This probably means that our pinned target has gone out of date and needs updating. Open the Eclipse IDE and click on `org.eclipse.tools/latest` and click `update` this should fail and show `Unable to locate installable unit ...`. To fix this remove the plugin and then add it from the `software site `, work with `org.eclipse.e4.core.tools.update - http://download.eclipse.org/e4/snapshots/org.eclipse.e4.tools/latest` then you add `Eclipse E4 - All Spies`.
+
+## Validation error in target platform `jython` manifests
+
+Make sure that `-Djdk.util.zip.disableZip64ExtraFieldValidation=true` is included in `eclipse.ini` (located right next
+to the `eclipse.exe` executable).