README

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