== Steps to Translate OSGeo4W-setup.exe ==

 * checkout local copy of setup files from Subversion, for example:
   {{{
     svn co https://svn.osgeo.org/osgeo4w/trunk/setup/ setup --username yourname
   }}}
 * copy '''res_en.rc''' and rename the file for your new language in the form '''res_[lang].rc''', such as:
   {{{
     res_ja.rc
   }}}
 * open your new '''res_[lang].rc''' file in a text editor and edit:
   * modify line!#1 and !#2 for your new language
     * use appropriate code identifier for your international characters ([http://msdn.microsoft.com/en-us/library/dd317756%28VS.85%29.aspx microsoft documentation])
   * replace English installer text in all CONTROL, CAPTION, LTEXT, RTEXT objects, such as:
      {{{
        CAPTION "OSGeo4W Setup - Choose Installation Type"

        translated to:

        CAPTION "OSGeo4Wセットアップ－インストールタイプの選択"
      }}}
     * be careful of making sure that the interface accelerators are kept, such as ''"(&D)"'':
       {{{
          CONTROL "&Download Without Installing",

          translated to:

          CONTROL "インストールせずにダウンロード(&D)",
       }}}
       * (background on menu resource accelerators: [http://msdn.microsoft.com/en-us/library/syzb5sda%28VS.80%29.aspx microsoft documentation])
   * you might have to modify the size/spacing of your new strings in the objects, if you notice that your new text is cutoff in the installer. For example, the values below for "60,85,88,10" mean: x,y,width,height - you might have to change the ''width'' value for longer translated strings
     {{{
       CONTROL "Use HTTP/FTP &Proxy:",IDC_NET_PROXY,"Button",
                BS_AUTORADIOBUTTON | WS_TABSTOP,60,85,88,10

       translated to:

       CONTROL "HTTP/FTPプロキシを利用する(&P):",IDC_NET_PROXY,"Button",
                BS_AUTORADIOBUTTON | WS_TABSTOP,60,85,188,10
     }}}
 * open '''res.rc''' in a text editor 
   * include your new ''res_[lang].rc'' file at the bottom of the file ''res.rc'' such as:
     {{{
       #include "res_en.rc"
       ...
       #include "res_ja.rc"
     }}}
 * complile your new ''setup.exe'', by following the steps in SetupDevelopment
 * test your new translated setup.exe
 * commit your changes to Subversion
 * inform the mailing list of your new translation
   * you might need assistance to publish the live osgeo4w-setup.exe to the download server (inform mailing list)

=== Current Issues ===

 * some installer text is hardcoded (see ticket:130)
 * packages' ''setup.hint'' text is also only in English (see ticket:131)

== Documentation Translation ==

* to be determined