4. Working under Windows
| Liite C. How to Contribute |

## 4. Working under Windows

If you are using Windows you have to install Cygwin or a similar program to simulate Linux to be able to install the programs used in writing. This chapter will tell you how to install Cygwin on Windows and what packages needed to work on the GIMP manual.

The first thing to do is downloading the ”setup.exe” from http://www.cygwin.com/ and save it on your computer. You need this program every time you have to do changes in Cygwin, so save it on a place easily to find, e.g. ”D:/cygwin/cygwin.exe”.

Open the program setup.exe by double-clicking on it. This will open the start window. Click on the ”Next” button to open a window where you have to choose how to install Cygwin. The default setting is ”Install from Internet”. This means that the downloaded files will be saved on your computer before the files will be used to install Cygwin. This is the easiest way to do it.

In the next window you have to choose where to install Cygwin on your computer. The default is C:\cygwin which is a good choice. Normally you also choose the installation for all users.

If you marked the ”Download without Installing” in the previous window you will instead get a window where you determines where to save the files. This window will be the next window if you install from internet.

The next window is how the computer is connected to internet. Normally you choose the default setting.

In the window ”Choose A Download Site” you will find lots of sites to download from. You may choose any of those starting with ”http://”, but it is a good rule to select one near you. The installation program makes a folder with the same name as the site you downloads from. If you change site, all the previous downloads will be downloaded again in the new folder. That is not a problem. Normally the program remember the last site used the next time you open it.

The next window lists all package categories available in Cygwin. A package contains programs or program parts to be used in Cygwin. You do not need all of them. As you see, every category is followed by a symbol and the word ”Default”. This means that the installer will only load the packages necessary to run a minimum version of Cygwin. So go on and press the ”Next” button and admire the progress of the downloading in the next window.

When downloading and installing is finished your copy of Cygwin is ready to be adapted to GIMP.

### 4.1. Adapting Cygwin to use with GIMP documentation tools

I am not able to guarantee that the procedure described here will work for you. It is a resume of the way I did it. Tested on Windows XP and Windows 7.

To be sure that Cygwin will use your language and the char code used in GIMP documentation I changed the batch file used to open Cygwin. (After saving a copy of the original batch file.) If you used the default installation you will find the batch file in `C:/cygwin/Cygwin.bat`. Rewrite the batch file to

@echo off
C:
chdir C:\cygwin\bin
set LANG=[language-code].UTF-8
bash --login -i

If you have put Cygwin in another location than the default, you have to write the new path instead of ”C:\cygwin\bin” above. You may find your language code in http://gcc.gnu.org/onlinedocs/libstdc++/manual/localization.html.

Then you are ready for the next step. Open ”cygwin/startup.exe ” and click on ”Next” until you reach the package window. You need the following packages:

Devel/automake 1.12
Devel/gettext-devel
Devel/gettext
Libs/libxml2
Libs/libxml2-devel
Interpreters/m4
Devel/make
Devel/pkg-config
Libs/libxslt
Libs/libxslt-devel
Python/python
Python/python-libxml2
Python/python-libxslt
Text/docbook-xml45
Graphics/ImageMagic
....../wget
....../dblatex
....../pngcrush

The first package to be installed is the ”automake 1.12” in the ”Devel” category. Click on the + mark in front of the category's name (Devel) to open the package list. Search down the rightmost column to find the package name ”automake 1.12”. Click once on the word ”Skip”. The text will change to ”1.12.3-1” which is the version number for the chosen package. Do the same with the other packages in the list above. Some packages will be marked ”Keep” instead of ”Skip ”. This means that these packages already are installed. Do not alter these settings unless you know for certain that this package should be deleted, or reloaded, or something else.

When you have marked all packages to be added to Cygwin you press ”Next”. You will then be told that the packages you selected needs some additional packages. Accept this. When you reaches the end of the updating, your Cygwin copy is ready for all that stuff mentioned in the start of this side.

Some packages, especially those needed for PDF, can't be found with setup.exe. You can try installing them from sources. You can use "wget url-to-the-package" to download the wanted package, but, as you have to know the url, the best way is browsing the web under Windows; download the package (usually a .tar.gz file) and copy-paste into the Cygwin folder.

Then run `tar -xvzf your-package` to decompress the package.

Go into the new folder and read the INSTALL file for instructions about installation.

| Huomaa
pngnq cannot be installed from sources under Cygwin (dark problems with the libz library).

If you run into problems as mysterious error messages and so one, feel free to ask for help on the mailing list mentioned on the top of this page.

3. Annexes |  | Liite D. Tone Mapping and Shadow Recovery Using GIMP’s ‘Colors/Exposure’

Report an error in the bug tracker