This describes the installation of Ciao after downloading the Windows binary (i.e., precompiled) distribution. It includes the installation of libraries and manuals and applies to Windows 95/98/NT/2000/XP systems. This is the simplest Windows installation, since it requires no compilation and is highly recommended. However, it is also possible to compile Ciao from the source distribution on these systems (please refer to Installing Ciao from the source distribution for details).
Please follow these steps (below we use the terms folder and directory interchangeably):
This will create there a folder whose name reflects the Ciao version. Due to limitations of Windows related to file associations, do not put Ciao too deep in the folder hierarchy. For unpacking you will need a recent version of a zip archive manager -- there are many freely available such as WinZip, unzip, pkunzip, etc. (see for example www.winzip.com). Some users have reported some problems with version 6.2 of WinZip, but no problems with, e.g., version 7. With WinZip, simply click on “Extract” and select the extraction folder as indicated above.
If you have a previous version of Ciao installed, make sure you do not have any Ciao applications (including, e.g., a toplevel shell) running, or the extraction process may not be able to complete. You may also want to delete the entire folder of the previous installation to save space.
This will update the windows registry (the file ciao(.reg) lists the additions) and also create some .bat files which may be useful for running Ciao executables from the command line. It also creates initialization scripts for the emacs editor. The actions performed by the installation script are reported in the installation window.
Official relases for the latest emacs versions can be downloaded from https://www.gnu.org/software/emacs/#Obtaining (See the gnu/emacs and gnu/windows/emacs directories in FTP mirrors). You can find answers to frequently asked questions (FAQ) about emacs in general at http://www.gnu.org/software/emacs/manual/efaq.html and about the Windows version at http://www.gnu.org/software/emacs/manual/efaq-w32.html.
You need to tell emacs how to load the Ciao mode automatically when editing and how to access the on-line documentation:
After the actions and registry changes performed by the installation procedure, you should check that the following should work correctly:
Also, the following documentation-related actions should work:
Finally, if emacs is installed, after starting it (double-clicking on the emacs icon or from the Start menu) the following should work:
Note: when using emacs it is very convenient to swap the locations of the (normally not very useful) Caps Lock key and the (very useful in emacs) Ctrl key on the keyboard. How to do this is explained in the emacs frequently asked questions FAQs (see the emacs download instructions for their location).
If you find that everything works but emacs cannot start the Ciao toplevel you may want to check if you can open a normal Windows shell within emacs (just do M-x shell). If you cannot, it is possible that you are using some anti-virus software which is causing problems. See http://www.gnu.org/software/emac/windows/faq3.html#anti-virus for a workaround.
In some Windows versions it is possible that you had to change the first backslashes in the ciao-mode-init.el file in the Ciao Directory. E.g., assuming you have installed in drive c:, instances of c:\ need to be changed to c:/. For example: c:\prolog/ciao-1.7p30Win32/shell/ciaosh.bat should be changed to c:/prolog/ciao-1.7p30Win32/shell/ciaosh.bat.
The cmds folder contains a number of utilities, documented in the manual in Miscellaneous Standalone Utilities. In the Win32 distribution these utilities are not compiled by the installation process. You can create the executable for each of them when needed by compiling the corresponding .pl file.
If you would like to install Ciao on a server machine, used by several clients, the following steps are recommended:
The standard installation procedure updates the windows registry so that Ciao executables (ending in .cpx) are directly executable as CGIs under Microsoft's IIS, i.e., so that you make applications written in Ciao available on the WWW (see the pillow library for specific support for this task). In the event you re-install IIS, you probably would lose the entries in the registry which allow this. In that case, processing the file ciao.reg produced during the installation (or simply reinstalling Ciao) will add those entries again.
To uninstall Ciao under Windows, simply delete the directory in which you put the Ciao distribution. If you also want to delete the registry entries created by the Ciao installation (not strictly needed) this must currently be done by hand. The installation leaves a list of these entries in the file ciao.reg to aid in this task. Also, all the register entries contain the word ciao. Thus, to delete all Ciao entries, run the application regedit (for example, by selecting Run from the Windows Start menu), search (^F) for ciao in all registry entries (i.e., select all of Keys, Values, and Data in the Edit->Find dialog), and delete each matching key (click on the left window to find the matching key for each entry found).