Installation

These instructions assume you have already installed a Java run-time environment, and are using some flavour of Windows.

1. Save the downloaded Zip file somewhere on a local hard disk.
2. Unpack the Zip file into a directory of your choice, for example C:\Software\Sock. We will refer to this directory as $sock-home.
3. Sock may be started either by opening $sock-home in Explorer and double-clicking sock.jar, or by executing a command such as

   java -jar $sock-home/sock.jar

   It is not necessary (and not recommended) to put any of the Sock jar files on your classpath.
4. Sock takes a few seconds to load. If you have not yet installed a licence for Sock you will see a licence agreement which you need to accept: either click the Accept button using your mouse, or using the keyboard press Ctrl-Tab then space.
5. You should see a window like this:

   

6. A specification file may be selected from the File menu or by dragging a file from Explorer.
7. The HTML output from Sock includes icons that look like this: . The purpose of these is to allow the original source file to be opened at the corresponding place by dragging this icon on to the 'Edit' button of Sock (see also the web edit example). This requires Sock to be configured for your particular editor, which is done by editing the $sock-home/sock.ini file as described in the comments within the file.
8. For further information on using Sock see the user manual found in $sock-home/docs/user-guide.html.