readme spelling
MODIFY
README.md
README.md
@@ -21,8 +21,8 @@ You can contribute to this project. All classes and most methods are commented.
![Build Status](https://ci.inria.fr/pharo-ci-jenkins2/job/PharoLauncher/buildStatus/icon?job=PharoLauncher)
## Motivations
-In the past I had several folders with images everywhere on my HD. Sometimes with the VM, sometimes without. Lots of image searching as you can imagine.
-Now, my HD is now much cleaner - all images are in a central place and I need only one icon/starter on the desktop to open. PharoLauncher is also a very handy tool to download specific image update versions if you want to reproduce or fix Pharo bugs. I also associated one of the unused laptop keys with PharoLauncher - so the world of Smalltalk is just one click away...
+In the past, I had several folders with images everywhere on my HD. Sometimes with the VM, sometimes without. Lots of image searching as you can imagine.
+Now, my HD is now much cleaner - all images are in a central place and I need only one icon/starter on the desktop to open. PharoLauncher is also a convenient tool to download specific image update versions if you want to reproduce or fix Pharo bugs. I also associated one of the unused laptop keys with PharoLauncher - so the world of Smalltalk is just one click away...
## How to install?
Download latest stable Pharo Launcher from [http://files.pharo.org/pharo-launcher](http://files.pharo.org/pharo-launcher).
@@ -35,40 +35,40 @@ For Linux and Mac, there are both 32-bits (x86) and 64-bits (x64) bundles.
Just launch the Pharo launcher app.
Usually for "end user experience" the launcher opens in full world mode - so you do not see Pharo background/world menu - only the launcher.
-Initially on a new computer the right side with local images is empty. On the left side are the template images that are available on the web. Note that there are refresh buttons at the top of the list.
+Initially, on a new computer, the right side with local images is empty. On the left side are the template images that are available on the web. Note that there are refresh buttons at the top of the list.
-Click "Refresh" in the left list to fetch all available template lists from the web.
+Click "Refresh" on the left list to fetch all available template lists from the web.
-Select the template image you like and download it. For instance you can download "Pharo6.0" -> "60528" which is the latest image as of today. Note that also the images from contribution CI are available.
+Select the template image you like and download it. For instance, you can download "Pharo6.0" -> "60528" which is the latest image as of today. Note that also the images from contribution CI are available.
So you can easily download "Artefact", "Moose", ... images if you like.
The launcher will download the image into a specific directory somewhere in your users home directory (you can configure whereby clicking the Settings button at the bottom of the window).
Each image gets its own folder. Use the "Show in folder" menu item if you want to open this location.
-After download you can "Launch" the image from the context menu in the right list. This will open the new image and close the launcher image. So you are ready to start working.
+After download, you can "Launch" the image from the context menu in the right list. This will open the new image and close the launcher image. So you are ready to start working.
## Where are my images?
Launcher files are considered as user documents and so, they are stored in the user document folder, i.e.:
- *$HOME/Documents/Pharo* on OS X,
- *$HOME/My Documents/Pharo* on windows,
-- *$HOME/Pharo* on Linux (some linux distributions provide a document folder but some others not, so we put it in the HOME directory in all cases).
+- *$HOME/Pharo* on Linux (some Linux distributions provide a document folder but some others not, so we put it in the HOME directory in all cases).
In this folder, you will find your images and virtual machines needed to run images.
### What does the Pharo launcher to launch an image?
To run an image, Pharo launcher needs to determine the appropriate virtual machine to run it and fetch it from the web if it is not available.
The process is as following:
1. determine the image format version
-2. find (and optionnaly fetch) a compatible VM (a VM able to run this image format) and run the image to get its Pharo version number
-3. find (and optionnaly fetch) the appropriate VM for this specific Pharo image version. Sources files are also downloaded with the VM when applicable.
+2. find (and optionally fetch) a compatible VM (a VM able to run this image format) and run the image to get its Pharo version number
+3. find (and optionally fetch) the appropriate VM for this specific Pharo image version. Sources files are also downloaded with the VM when applicable.
4. run the image with the appropriate VM
## How would I make my own templates available via Pharo Launcher?
There are different ways:
-- The easiest way would be to add a CI job on https://ci.inria.fr/pharo-contribution/. This job should archive a zip file with your image and the changes file. Then you will be able to browse your image as a template from *Pharo contribution Jenkins* / *<your job name>* / *Latest sucessful build*.
-- Another way is to create a fresh image from the *Templates* panel, launche the image, add what you want in the image, save it and then convert the image to a template : right-click on the image on the right panel (*Existing images*) and select *Create Template*. The newly created template will appear in the *Templates* panel under the *Downloaded templates* category.
+- The easiest way would be to add a CI job on https://ci.inria.fr/pharo-contribution/. This job should archive a zip file with your image and the changes file. Then you will be able to browse your image as a template from *Pharo contribution Jenkins* / *<your job name>* / *Latest successful build*.
+- Another way is to create a fresh image from the *Templates* panel, launch the image, add what you want in the image, save it and then convert the image to a template: right-click on the image on the right panel (*Existing images*) and select *Create Template*. The newly created template will appear in the *Templates* panel under the *Downloaded templates* category.
## Things to know:
-At the bottom there is a button to open a settings browser with specific settings for PharoLauncher. There is an option that enables the IDE again - so you can inspect the code or fix a bug.
+At the bottom, there is a button to open a settings browser with specific settings for PharoLauncher. There is an option that enables the IDE again - so you can inspect the code or fix a bug.
If it does not launch on your box then set a breakpoint in PhLImage>>launch to debug.

readme spelling