build/bakefiles/README

   1
   2 This directory contains Bakefile (see http://bakefile.sourceforge.net)
   3 files needed to generate native makefiles for wxWidgets library and
   4 samples.
   5
   6 Use the bakefile_gen utility to regenerate the makefiles (run it in this
   7 directory!). If you run it with no arguments, it will generate all makefiles
   8 that are not up to date.
   9
  10 Use "bakefile_gen -c" to clean generated files.
  11
  12 You can generate or clean only subset of files by specifying -f or -b flags
  13 when invoking bakefile_gen. For example, "bakefile_gen -fborland,watcom" will
  14 only regenerate Borland C++ and OpenWatcom makefiles. -b flag limits
  15 regeneration only to specified bakefiles. For example,
  16 "bakefile_gen -b wx.bkl" will only regenerate main library makefiles.
  17 "bakefile_gen -b "../../samples/html/*/*.bkl" will regenerate makefiles for
  18 all wxHTML samples. -b and -f can be combined.
  19
  20 You can customize the process of generating makefiles by adding file
  21 Bakefiles.local.bkgen (same format as Bakefiles.bkgen) with further settings.
  22 For example, you may disable output for compilers you don't use:
  23    <?xml version="1.0" ?>
  24    <bakefile-gen>
  25      <disable-formats>msvc,msvc6prj</disable-formats>
  26    </bakefile-gen>
  27
  28 Note: bakefile_gen creates file .bakefile_gen.state with dependencies
  29 information. This file can be safely deleted, but it contains valuable
  30 information that speed up regeneration process.
  31
  32 Note: the following files are generated using bakefile_gen:
  33   * build/msw/*
  34   * makefiles with same names as makefiles in above dirs, Makefile.in files
  35     that contain "This makefile was generated by Bakefile" banner and
  36     VC++ project files in samples, demos and utils directories
  37   * src/wxWindows.dsp
  38   * {wxGTK,wxMotif,wxX11}.spec (only wxBase headers list)
  39   * autoconf_inc.m4
  40   * all Makefile.in files
  41   (hopefully I didn't forget anything - VS)