Introduction

This is mingwGitDevEnv-packages, the project providing the mingw-get packages for mingwGitDevEnv.

Git configuration for LZMA (de-)compression

For convenience, the *.xml.lzma files are supposed to be (de-)compressed on-the-fly when checked out / in. To make this work you have to add the following diff and smudge / clean filters to your Git config file:

[diff "lzma"]
	textconv = lzma -d -c -qq | cat
[filter "lzma"]
	smudge = lzma -d
	clean = lzma -z

If you let the mingwGitDevEnv installer clone the packages repository this is already done for you.

Getting involved

Creating mingw-get packages

If you want to create a new package for use with mingw-get the following steps are necessary:

• Create an mgwport / msysport "build recipe" file that downloads the source code, applies optional patches, builds the binaries, and packages them to archives. Just like MSYS started out as a fork of Cygwin, mgwport is a fork of the Cygwin Port project's cygport tool and thus uses (almost) the same syntax. However, as there seems to be very little documentation about either syntax available and mgwport / cygport are heavily inspired by Gentoo's Portage, the best resource I could possibly find is the Gentoo Development Guide's section about Ebuild Writing, in particular the Variables article. (See the mgwport file for mingw32-openssl as an example.)
• If you need help with the actual build flags to use for a particular package good places to look at are (in no particular order):
  • The *.cygport files inside the Cygwin Port project's Git repository, especially those inside directories with an mingw- prefix.
  • The release.sh scripts below the msysgit repository's src directory.
  • The pkgbuild.sh scripts inside the *-src.tar.lzma archives below LRN's mingw directory on his web server.
  • The build scripts inside the *-src.tar.lzma archives in the MinGW project's files section.
• Actually build the packages using the mgwport tool. Use the Git Development Environment shortcut for building *.mgwport files and the Git Development Environment (MSYS Mode) shortcut for building *.msysport files.
• Create an xml catalogue / package description file which lists meta-information and dependencies. This is the hardest part as there seems to be no documentation of the format available at all (and cygport does not have this type of file). So probably the best thing you can do is to derive the syntax from the existing catalogue files. (See the catalogue file for mingw32-openssl as an example.)
• Add the package catalogue's file name to the master package catalogue file.
• Run the compress-xml.sh script to run LZMA on the *.xml files.
• Upload the compressed catalogue and updated master catalogue files to one of the web server locations listed as repository uri at the end of the update-mingw-get.sh script. (Currently only I have access to this location, so please contact me instead.)
• Upload the package archives to the web server location that is listed as download-host uri in its catalogue file. (As it probably makes sense to host all mingwGitDevEnv related packages in one place, please contact me instead.)
• Send a pull request.

Getting in contact

We now have a mailing list for developers.