defaults/Jambase.help

   1 # This program is free software: you can redistribute it and/or modify
   2 # it under the terms of the GNU General Public License as published by
   3 # the Free Software Foundation, either version 3 of the License, or
   4 # (at your option) any later version.
   5 #
   6 # This program is distributed in the hope that it will be useful,
   7 # but WITHOUT ANY WARRANTY; without even the implied warranty of
   8 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
   9 # GNU General Public License for more details.
  10 #
  11 # You should have received a copy of the GNU General Public License
  12 # along with this program.  If not, see <http://www.gnu.org/licenses/>.
  13
  14 #
  15 # 'help*' targets
  16 #
  17
  18 rule -ShowHelpProfile- {
  19   NotFile help-profile ;
  20   Always help-profile ;
  21   AShowHelpProfile help-profile ;
  22 }
  23 actions quietly AShowHelpProfile {
  24   echo "profile flags:"
  25   echo "  DEBUG=1           debug build"
  26   echo "  PROFILE=standard  -O2, etc (default profile)"
  27   echo "  PROFILE=speed     optimize for speed"
  28   echo "  PROFILE=size      optimize for size"
  29   echo "  PROFILE=debug     optimize for size"
  30   echo "  PROFILE=none      don't change anything"
  31   echo "  PROFILE=default   don't change anything"
  32   echo "  PROFILE=empty     remove optimization flags"
  33   echo "  VALGRIND=1        do not strip debug info"
  34   echo "  NO_WARNINGS=1     do not add '-Wall' flag"
  35   echo "  DIET=1            use dietlibc"
  36   echo "  NO_NATIVE=1       remove '-mtune=native' and '-march=native'"
  37   echo "  NO_FWRAP=1        remove '-fwrapv'"
  38   echo "WARNING: some flags (VALGRIND, NO_*) needs cleanup before building!"
  39 }
  40 -ShowHelpProfile- ;
  41
  42 rule -ShowHelp- {
  43   NotFile help ;
  44   Always help ;
  45   AShowHelp help ;
  46   #AShowHelpProfile help ;
  47 }
  48 actions quietly AShowHelp {
  49   echo "WARNING: default help; override 'actions AShowHelp' definition to customize 'help' target!"
  50   echo "usage: k8jam [target] [flags]"
  51   echo "tagets:"
  52   echo "  k8jam              -- build project"
  53   echo "  k8jam all          -- build project"
  54   echo "  k8jam clean        -- do cleanup"
  55   echo "  k8jam help         -- show this help"
  56   echo "  k8jam help-profile -- show help for building profiles"
  57   echo "  k8jam gen-boiler   -- generate 'boilerplate' jam files"
  58   echo "                        use FORCE=1 to regenerate"
  59   echo "                        use MAIN=name to specify name"
  60 }
  61 -ShowHelp- ;