w32/README

   1 ========
   2 Minipack
   3 ========
   4
   5 Homepage: http://code.google.com/p/minipack
   6 This minipack distribution was customized for the PCB project.
   7
   8 Minipack is an automated build tool. Given a set of recipes and patches, it
   9 downloads the sources, unpacks them, applies local patches, builds them and
  10 installs them. Its primary use is for cross-compiling free software to
  11 Windows, but minipack is more general-purpose than that.
  12
  13 To install, unpack it in any directory, and optionally set the PATH to it.
  14
  15 The tool can be run from anywhere, but it looks for a minipack.conf file
  16 in the current directory or in a parent directory.
  17
  18 Some recipes for cross-compiling to Windows are included in the distribution:
  19 * libraries: gtk+, guile, gd, freetype, libpng, jpeg, zlib, gettext.
  20 * applications: gEDA/gaf, PCB.
  21 See the 'recipes' directory for a full list.
  22
  23 When cross-compiling, you need a suitable cross-compiler for the host you are
  24 targeting. On Debian and derivatives, you can type 'sudo apt-get install mingw32'
  25 to get a MinGW cross-compiler. You can also build your own by using the build
  26 script provided by the MinGW project.
  27
  28 Modify the host setting in the minipack.conf file to reflect the cross-compiler
  29 being used. It can be found as the prefix of the compiler, eg. i586-mingw32msvc.
  30
  31 The build-all.sh script can be used to build all packages in one run. Edit the
  32 BUILD list to select only a subset. Beware, some recipes require a native
  33 version of pkg-config, others need the autotools and/or intltool as well.
  34
  35 =======
  36   mpk
  37 =======
  38
  39 The main (and only) tool of minipack is called mpk:
  40 * mpk build <package>  - download, unpack, and build a package.
  41 * mpk unpack <package> - download and unpack a package
  42 * mpk source <package> - download a source package
  43 * mpk shell [package]  - enter a shell with a pre-defined build environment
  44
  45 A cache of downloaded sources is kept in the 'sources' directory.
  46
  47 To add more recipes to minipack, place the recipe in the 'recipes' directory
  48 and place the patches in a subdirectory of the 'patches' directory.
  49
  50 Have fun!