build/bakefiles/README

   1
   2 This directory contains Bakefile (see http://bakefile.sourceforge.net)
   3 files needed to generate native makefiles for wxWidgets library, contrib 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   * contrib/build/* (except .bkl files)
  35   * makefiles with same names as makefiles in above dirs, Makefile.in files
  36     that contain "This makefile was generated by Bakefile" banner and
  37     VC++ project files in samples, demos and utils directories (inc. contrib
  38     ones)
  39   * src/wxWindows.dsp
  40   * {wxGTK,wxMotif,wxX11}.spec (only wxBase headers list)
  41   * autoconf_inc.m4
  42   * all Makefile.in files
  43   (hopefully I didn't forget anything - VS)