[[TOC]]
= msys =
 
 * MSYS - '''Minimal SYStem''' - collection of GNU utilities, see [http://en.wikipedia.org/wiki/List_of_Unix_utilities list of unix utilities]
 * Current Version: 1.0.11
 * `msys`: http://download.osgeo.org/osgeo4w/release/msys/msys
 * `msys-dev`: http://download.osgeo.org/osgeo4w/release/msys/msys-dev
 * Initial packaged for GRASS by jef
 * Maintainer: [wiki:MartinLanda Martin Landa]

=== Open Tickets ===

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

=== Closed Tickets ===

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

== Packaging notes ==

=== Install the environment for compilation (MingW) ===

1. Download [http://downloads.sourceforge.net/mingw/msysCORE-1.0.11-bin.tar.gz msysCORE-1.0.11-bin.tar.gz]. Extract tarball into `C:\osgeo4w\apps\msys`. 

2. Modify `c:\osgeo4w\apps\msys\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
 
@@ -53,9 +55,9 @@
 if "x%1" == "x--rxvt" set MSYSCON=rxvt.exe
 if NOT "x%MSYSCON%" == "xunknown" shift
 
-if "x%MSYSCON%" == "xunknown" set MSYSCON=sh.exe
+if "x%MSYSCON%" == "xunknown" set MSYSCON=rxvt.exe
 
-if "x%MSYSTEM%" == "x" set MSYSTEM=MINGW32
+if "x%MSYSTEM%" == "x" set MSYSTEM=MSYS
 if "%1" == "MINGW32" set MSYSTEM=MINGW32
 if "%1" == "MSYS" set MSYSTEM=MSYS
 
@@ -80,8 +82,8 @@
 if NOT EXIST %WD%rxvt.exe goto startsh
 
 rem Setup the default colors for rxvt.
-if "x%MSYSBGCOLOR%" == "x" set MSYSBGCOLOR=White
-if "x%MSYSFGCOLOR%" == "x" set MSYSFGCOLOR=Black
+if "x%MSYSBGCOLOR%" == "x" set MSYSBGCOLOR=Black
+if "x%MSYSFGCOLOR%" == "x" set MSYSFGCOLOR=White
 if "x%MINGW32BGCOLOR%" == "x" set MINGW32BGCOLOR=LightYellow
 if "x%MINGW32FGCOLOR%" == "x" set MINGW32FGCOLOR=Navy
 if "%MSYSTEM%" == "MSYS" set BGCOLOR=%MSYSBGCOLOR%
@@ -89,7 +91,7 @@
 if "%MSYSTEM%" == "MINGW32" set BGCOLOR=%MINGW32BGCOLOR%
 if "%MSYSTEM%" == "MINGW32" set FGCOLOR=%MINGW32FGCOLOR%
 
-start %WD%rxvt -backspacekey  -sl 2500 -fg %FGCOLOR% -bg %BGCOLOR% -sr -fn Courier-12 -tn msys -geometry 80x25 -e /bin/sh --login -i
+start %WD%rxvt -backspacekey  -sl 2500 -fg %FGCOLOR% -bg %BGCOLOR% -sr -fn Courier-16 -tn msys -geometry 80x25 -e /bin/sh --login -i
 exit
 
 :startsh
}}}

3. Copy `c:\osgeo4w\apps\msys\etc\fstab.sample` to `c:\osgeo4w\apps\msys\etc\fstab` (without .sample)

4. Modify `c:\osgeo4w\apps\msys\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 @@
 #Blank lines are ignored.
 
 #Win32_Path            Mount_Point
-c:/mingw               /mingw
-c:/ActiveState/perl    /perl
+@osgeo4w@              /osgeo4w
}}}

5. Download the MinGW packages:
(''[https://sourceforge.net/project/showfiles.php?group_id=2435 updates may be found here]'')
 * '''bin-utils''' from [http://downloads.sourceforge.net/mingw/binutils-2.19.1-mingw32-bin.tar.gz here]
 * '''gcc-core''' from [http://downloads.sourceforge.net/mingw/gcc-core-3.4.5-20060117-3.tar.gz here] (dev package only)
 * '''gcc-g++''' from [http://downloads.sourceforge.net/mingw/gcc-g%2B%2B-3.4.5-20060117-3.tar.gz here] (dev package only)
 * '''mingw32-make''' from [http://downloads.sourceforge.net/mingw/mingw32-make-3.81-20080326-3.tar.gz here] (dev package only)
 * '''mingw-runtime''' from [http://downloads.sourceforge.net/mingw/mingwrt-3.15.2-mingw32-dev.tar.gz here] (dev package only)
 * '''mingw-utils''' from [http://downloads.sourceforge.net/mingw/mingw-utils-0.3.tar.gz here] (dev package only)
 * '''w32api''' from [http://downloads.sourceforge.net/mingw/w32api-3.13-mingw32-dev.tar.gz here] (dev package only)

6. Download the latest '''make''' program compliant with the OSGeo4W framework from [http://downloads.sourceforge.net/mingw/make-3.81-MSYS-1.0.11-2.tar.bz2 here]
(''future updates may be found [https://sourceforge.net/project/showfiles.php?group_id=2435 here]'')

7. Unpack to `c:\osgeo4w\apps\msys`  (the content of the sub-folders in the zip-files - ''bin'', ''share'' have to be copied into the related sub-folders of `c:\osgeo4w\apps\msys`)

8. Close and re-open msys to reload the settings.

=== Pre-built Binaries ===

Download: 
(''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]
 * '''bison''' from [http://downloads.sourceforge.net/gnuwin32/bison-2.1-bin.zip here] (dev package only)
 * '''bison-deps''' from [http://downloads.sourceforge.net/gnuwin32/bison-2.1-dep.zip here] (dev package only)
 * '''flex''' from [http://downloads.sourceforge.net/gnuwin32/flex-2.5.4a-1-bin.zip here] (dev package only)
 * '''gettext-bin''' from [http://downloads.sourceforge.net/gnuwin32/gettext-0.14.4-bin.zip here] (dev package only)
 * '''gettext-lib''' from [http://downloads.sourceforge.net/gnuwin32/gettext-0.14.4-lib.zip here] (dev package only)
 * '''libiconv-bin''' from [http://downloads.sourceforge.net/gnuwin32/libiconv-1.9.2-1-bin.zip here]
 * '''libiconv-lib''' from [http://downloads.sourceforge.net/gnuwin32/libiconv-1.9.2-1-lib.zip here] (dev package only)
 * '''libintl-bin''' from [http://downloads.sourceforge.net/gnuwin32/libintl-0.14.4-bin.zip here] 
 * '''libintl-lib''' from [http://downloads.sourceforge.net/gnuwin32/libintl-0.14.4-lib.zip here] (dev package only)
 * '''readline''' from [http://sourceforge.net/projects/gnuwin32/files/readline/5.0-1/readline-5.0-1-bin.zip/download here]
 * '''regex''' from [http://downloads.sourceforge.net/gnuwin32/regex-2.7-bin.zip here]

Unpack to `c:\osgeo4w\apps\msys`  (the content of the sub-folders in the zip-files - ''bin'', ''share'' have to be copied into the related sub-folders of `c:\osgeo4w\apps\msys`)

=== Extra packages ===

 * '''zip''' from [http://sourceforge.net/projects/gnuwin32/files/zip/ here] 

=== Etc scripts ===

 1. Create `c:\osgeo4w\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:\osgeo4w\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
}}}