[[TOC]]
= msys =
 
 * MSYS - '''Minimal SYStem''' - provides Windows ports of a lightweight Unix-like shell environment 
 * Current Version: 1.0.18
 * `msys`: http://download.osgeo.org/osgeo4w/release/msys
 * Initial packaged for GRASS by jef
 * Maintainer: [wiki:MartinLanda Martin Landa]


=== Changes ===
 * 1.0.11-11: added 'zip' package
 * 1.0.11-12: fix dependencies for 'zip' package
 * 1.0.18-1: new installation via MinGW installer
=== Open Tickets ===

[[TicketQuery(status=new|assigned|reopened&keywords~=msys&order=priority)]]

=== Closed Tickets ===

[[TicketQuery(status=closed&keywords~=msys&order=priority)]]

== Packaging notes (`msys` and `mingw` package) ==

=== Install MinGW ===

1. Download [http://sourceforge.net/projects/mingw/files/latest/download latest installer].

2. Choose ''MSYS Base System'' | ''C & C++ Compiler'', ''MSYS Base System'' and ''MinGW Developer Toolkit''  (`mingw` package).

3. Install MinGW (including MSYS) into `C:\MinGW`. 

4. Modify `C:\MinGW\msys\1.0\msys.bat`

{{{
--- msys.bat	2009-07-11 18:34:35 +0000
+++ apps/msys/msys.bat	2012-02-09 18:03:45 +0000
@@ -12,6 +12,8 @@
 rem A value similar to C:\msys\1.0\bin is what the "Start in:" field needs
 rem to represent.
 
+call "%~dp0\..\..\bin\o4w_env.bat"
+
 rem ember value of GOTO: is used to know recursion has happened.
 if "%1" == "GOTO:" goto %2
}}}

5. Modify `C:\MinGW\msys\1.0\etc\fstab`

{{{
--- apps/msys/etc/fstab.sample  2009-07-11 18:34:34 +0000
+++ apps/msys/etc/fstab 2012-02-09 16:11:26 +0000
@@ -13,5 +13,4 @@
-C:\MinGW\   /mingw
+@osgeo4w@              /osgeo4w
}}}

6. Move `C:\MinGW\msys\1.0` to `C:\MinGW\apps\msys`

7. Remove `C:\MinGW\unins000.*` files
=== Download extra packages ===

1. Download extra pre-built binaries

(''updates may be found [https://sourceforge.net/project/showfiles.php?group_id=23617 here]'')

 * '''bc''' from [http://sourceforge.net/projects/gnuwin32/files/bc/1.06-2/bc-1.06-2-bin.zip/download here]
 * '''libintl-bin''' from [http://downloads.sourceforge.net/gnuwin32/libintl-0.14.4-bin.zip here] 
 * '''libiconv-bin''' from [http://downloads.sourceforge.net/gnuwin32/libiconv-1.9.2-1-bin.zip here] 
 * '''readline-bin''' from [http://sourceforge.net/projects/gnuwin32/files/readline/5.0-1/readline-5.0-1-bin.zip/download here]
 * '''regex-bin''' from [http://downloads.sourceforge.net/gnuwin32/regex-2.7-bin.zip here] (also for `mingw` package)
 * '''zip''' from [http://sourceforge.net/projects/gnuwin32/files/zip/ here] ('''zip-bin''' and '''zip-dep''')
 * '''unzip''' from [http://sourceforge.net/projects/gnuwin32/files/unzip/ here] ('''unzip-bin''')

2. Unpack into `c:\MinGW\apps\msys`

=== Include DLL libraries ===

1. List of DLL libraries from `mingw` package to be copied

 * libintl-8.dll, libgcc_s_dw2-1.dll
=== Etc scripts ===

 1. Create `C:\MinGW\etc\ini` and save `msys.bat` into this directory

{{{
PATH %PATH%;%OSGEO4W_ROOT%\apps\msys\bin
if not defined HOME set HOME=%USERPROFILE%
}}}

 2. Create `C:\MinGW\etc\postinstall` and save `msys.bat` into this directory

{{{
mkdir "%OSGEO4W_STARTMENU%"
xxmklink "%OSGEO4W_STARTMENU%\MSYS.lnk"       "%OSGEO4W_ROOT%\apps\msys\msys.bat" " " \ "Minimal SYStem" 7 "%OSGEO4W_ROOT%\apps\msys\msys.ico"

xxmklink "%ALLUSERSPROFILE%\Desktop\MSYS.lnk" "%OSGEO4W_ROOT%\apps\msys\msys.bat" " " \ "Minimal SYStem" 7 "%OSGEO4W_ROOT%\apps\msys\msys.ico"

textreplace -std -t apps/msys/etc/fstab
}}}