___
■ 簡単なメイクファイルをかく

    SRCS:=





___

  POINT
    Make の組み込み関数は文字列操作が主な目的
    文字列置換 と同じ
    call は 関数.Call  というより 特殊な文字列置換
    


    list 中から 目的の file を選択

    変数参照に見えるが , 区切りの Argument をもつ
    何かの値に展開され, 変数への代入 , Shell にわたされる

  POINT
    Command 列を 変数に格納することで 応用範囲が広がる
    Macro, 変数 への展開結果をかえれるように Argument をわたせる

    Make の関数には 数値 という型はない( 文字列として扱う )

    # (call has-duplicate, list)

    # 数値も 文字列として比較
    #
    has-duplicate = $(filter                    \
                      $(word $1)             \
                       $(words $(sort $1)))


    関数が Nest される場合は, 最下層から ひとつずつ読む


    # (call file-to-class-name  rootdir file)
    file-to-class-name := $(subst /,.,             \    # "/" -> "."
                          $(subst .java,,       \      # ".java" を除去
                            $(subst $1/,,$2)))         # "$1/" を除去







  SYNTAX
      $(function arg[, arg...])

    # Argument の参照は $N とする
    echo $1

    # 展開するには call 組み込み関数 を利用
    #    call は 関数 というより
    #    特殊な マクロ展開
    #
    $(call MACRONAME arg, [arg...])

  POINT
     Macro, 変数 の違いは [\n] が組み込まれるかどうかだけ




  WARNING
    [,] 以降の SPC は arg として解釈


    #  ","  の後の " " は不要
    $(call intro, yamada) -> $1 = [ yamada]



    # パターンの適用も OK
    #    [%] == 0文字以上
    $(function %.obj)



  POINT
     Windows は File を開くと, 他の Process からの書き込みを防止するため
        File を Lock する


  POINT
    Make の EmbededFunc の共通点
     Text をもらって, ある操作をして 別の Text をかえす
     Argument は [,] 区切り
     Argument のひとつとして SPACE 区切りの 単語 List をもらう
       単語間の Space は区切り扱いだが, それ以外は無視

     Pattern 指定も OK
        [%] : 0 コ以上の文字


___
■ 文字列関数

___
■ filter

  SYNTAX:
      $(filter ptn ...,text )

  DESC
     text を " " 区切り文字として ptn 一致のものを取得
    grep みたいなもの


    # ui/*.o  のみを filter する
    #
      $(ui_lib): $(filter ui/%.o,$(OBJS))
          $(AR) $(ARFLAGS) $@ $^

      words := he the hen other the%
      get-the:
        @echo he matches $(filter he, $(words))
        @echo %he matches $(filter %he, $(words))



  WARNING
    単語は一部を含むではなく, すべて一致する必要あり
    ptn[%]  は一度しか使用できない
      複数あれば 最初のみ ptn[%]
      残りは文字あつかい( [%]という文字にマッチ )


___
■ filter-out

  SYNTAX
     $(filter-out ptn ...,text )

  DESC
    ptn に一致しない text 内の単語をかえす

      # ptn 不一致を取得
      $(filter-out ptn, text)




  srcs := main.c sub.c main.h sub.h

  # xxx.h を除去する
  to_compile := $(filter-out %.h, $(srcs))




___
■ findstring

  SYNTAX
      $(findstring serStr,text)

  DESC
    text 中の serStr を検索

    見つかれば serStr( 検索文字列 ) 自身をかえす
    wildcard[%] は使用不可
    if() とあわせると便利


  TIP
    [#]: make の変換結果を見るための, echo より簡易な方法


  # 複数の Tree ( src, DebugBinary, ReleaseBinary のどこにいるか調べる)
   find-tree:
      # PWD = $(PWD)

      # Tab から始まるため, Make は SubShell への Command と解釈
      #    Make 関数で置換してから わたす
      #
      # $(findstring d:/0916, $(PWD))
      # $(findstring d:/0915, $(PWD))
      # $(findstring d:/0914, $(PWD))





___
■ subst

  SYNTAX
    $(subst serStr,repStr,text)

  DESC
    文字列( text ) を置換( Substitute )
    [%] の指定はできない

  POINT

    # ext を変更するときに便利
    #  .c -> .o
    #
    SRCS := main.c sub.c foo.c
    $(subst .c,.o,$(SRCS))



  WARNING
    # [,] の後の空白は文字扱いになる

    # ERROR
    #    ".c "  が  ".o"  にかわる
    $(subst .c ,.o,(SRCS))

    # ERROR
    #    "main.c"  --->  "main .o"
    $(subst .c, .o,(SRCS))

    # OK
    #  RET: main.o  sub.o  foo.o
    $(subst .c,.o,(SRCS))




___
■ patsubst

  SYNTAX
    $(patsubst serPtn,repPtn, text)

  DESC
    wildcard 使用の検索、置換
    [%]: は match した文字列に置換される


  WARNING

    # 末尾 の [/] を除去
    #    serPtn: text 全体で一致する必要あり
    #    途中の [/] は置換されない
    #
    strip-tail-slash = $(patsubst %/,%,$(dirPath))




  BAD
    %/ -> [aaa/bbb/]ccc
  OK
    %/ -> [aaa/bbb/ccc/]



    $(variable:ser=rep)

    ser: 通常文字列 -> 単語の末尾に一致 -> rep に置換
  OBJS := $(SRCS:.cpp=.o)

    ser: [%]文字列 -> patsubst 同様


___
■ words

  SYNTAX
    $(words text)

  DESC
     単語数をかえす


    CURPATH := $(subst /, ,$(HOME))
    words:
          echo $$HOME has $(words $(CURPATH)) Directory


    # [/] -> [SPC] 変換
    CURPATH := $(subst /, ,$(HOME))
    words:
  @echo $(HOME)
  @echo my home path has $(words $(CURPATH))dirs
  @echo first dir is $(word 1, $(CURPATH))
  @echo second dir is $(word 2, $(CURPATH))






___
■ word

  SYNTAX
    $(word n,text)

  DESC
     [n] 番目の text を返す
     1 が最初
     n > nrText ならば 何も返さない


  POINT
    # list 最後の取得
    current := $(word $(words $(MAKEFILE_LIST)),$(MAKEFILE_LIST))



___
■ firstword

  SYNTAX
    $(firstword text)

  DESC
    1 番目の 単語をかえす
    == $(word 1,text)

    # 単語 List に変換
    #    "xxx.yyy.zzz" -> "xxx yyy zzz"
    #
    version_list := $(subst ., ,$(MAKE_VERSION))

    major_version := $(firstword $(version_list))






___
■ wordlist

  SYNTAX
    $(wordlist start,end,text)

  DESC
    [start:end] list をかえす

    start > $(words text)
    start > end
      なら何も返さない

    end > $(words text)
      なら [start:$(words text)]をかえす



    # $(call uid_gid username)
    #
    uid_gid = $(wordlist 3,4 \
                $(subst :, ,\
                   $(shell grep "^$1:" /etc/passwd)
                  )
                )










___
■ call

  SYNTAX
    $(call cmd,arg...)


___
■ sort

  SYNTAX
     $(sort list)

  DESC
    単語の重複, 前後の SPACE を除去してソートする


    # STDIN から makefile の内容を入力
    #
    make -f- < < <  'x:;@echo =$(sort a n d d c e)='






___
■ shell

  SYNTAX
      $(shell cmd)

  DESC

    ひとつの Argument をうけつけて, 展開後に SubShell にわたす

    STDOUT への出力は 結果としてかえる
    [\] は " "に置換される

    STDERR, Exit Status は返されない


  POINT
    $(shell cmd) は subshell 実行後の結果に置換される


      stdout := $(shell echo normal msg)
      stderr := $(shell echo err msg 1>&2)

    # STDERR への出力は shell 関数の戻値にならない
    #
      shell-value:
          # $(stdout)
          # $(stderr)



      # RET: [Mon Sep 17 10:41:29]
      # make がこの行を解釈すれば ERR
      $(shell date)

      # こちらは OK
         $(shell oman test)


    # make をはじめる前に 必要な dir を作成する
    # bash の for 文を利用して Directory 作成
    #
    POINT
      _MKDIRS 自体は意味はない
      $(shell) が実行されることが目的

    REQ_DIRS := foo bar goo
    _MKDIRS := $(shell for d in $(REQ_DIRS);      \
                 do                             \
                   [[ -d $$d ]] || mkdir -p $$d; \
                 done)


  WARNING
      単純変数 と 再帰変数の違いに注意すること
    ST := $(shell date)
    CT := $(shell date)  # CT が利用されるたびに評価

      # date uniq file を作成
      RELEASE_TAR := mpwm-$(shell date +%F).tar.gz


    # $(call file-to-class-name, filename)
    #  相対 Path を Java クラス名に変換
    #
    file-to-class-name := $(subst  /,.,$(patsubst %.java,%,$1))




___
■ file.名関数

___
■ wildcard

  SYNTAX
    $(wildcard ptn...)

  DESC
    ptn に match した file 名に展開
   一致しないなら ""


  TIP
    ptn は Target, Depend で展開されるのと同じ
    Shell の 展開文字 を利用する
    [ ~, *, ?, [...], [^...] ]

   "%" をまちがって利用しないように


    #  $(shell) で代用するとこうなる
    SRCS := $(shell ls *.cpp)



    # shell の ptn match 同様( Directory 込みで match )
    # RET
    #      ./dir/aaa.cpp ./dir/bbb.cpp
     $(wildcard ./dir/*.cpp)



    #  xxx.c, xxx.h   をセット
    SRCS := $(wildcard *.c *.h)


  POINT
    Directory .cpp をすべて取得可能
   SRCS := main.cpp sub.cpp ...  といったベタガキは不要

   #  if と併用することで File の有無をチェック
   #
   dotemacs := $(wildcard ~/.emacs)


  WARNING
    Current Directory 基準( 再帰的ではない )
    # Sub Directory にはマッチしない
    #  RET:
    #    ./foo.cpp ./bar.cpp
    $(wildcard *.cpp)




___
■ dir|notdir

  SYNTAX
     $(dir list ...)

  DESC
     list の各単語の Directory 部分を返す

     # src Directory 検索
    #
     srcdir:=$(sort               \
              $(dir             \
                $(shell find . -iname "*.cpp")))



      # $(call srcdir,dirlist)
      # WARNING
      #    即時評価では問題あり
      $(call srcdir,/pro/intp)
      srcdir=$(sort         \
              $(dir       \
                  $(shell find $1 -iname "*.cpp")))


      @echo $(call getshbody,test.sh)
      getshbody=$(notdir $(subst .sh,,$1))


    # File の出力先と同じ Directory で実行
    #
      $(OUT)/myfile.out: $(SRC)/src.in
              cd $(dir $@);                       \
              generate-myself $^ > $(notdir $@)



___
■ suffix

  SYNTAX
      $(suffix name ...)

  DESC
    list から suffix をかえす

    # RET
    #    bat
     $(suffix test.bat)

      # 同一 suffix Check
      same-suffix = $(filter 1,$(words $(sort $(suffix $1))))



  TIP
    findstring 関数と共に if() で使用



___
■ basename

  SYNTAX
    $(basename list...)

  DESC
    File Suffix を除去した文字列をかえす

    # RET
    #     main sub
    test:
      echo $(basename main.cpp sub.cpp)

    # $(call file-to-class-name  rootdir  filename)
    file-to-class-name := $(subst /,.,           \
                            $(basename        \
                              $(subst $1/,,$2)
                            )
                          )
    # $(call get-java-class-name  filename)
    #
    #  Java のクラス名をかえす
    #
    get-java-class-name = $(notdir  $(basename $1))




___
■ addsuffix

  SYNTAX
      $(addsuffix suffix list)

  DESC
     list の各単語に suffix 追加

  POINT
    wildcard の patten は shell と同じ
    filter は [%] のみ



    # $(call find-program, %)

    find-program = $(filter $1                  # 最後に filtering
                    $(wildcard                # wildcard で検索
                        $(addsuffix /*,        #  wildcard 用に "/*" を追加
                          $(sort               # sort
                             $(subst :, ,      # PATH 区切り[:] -> " " 単語に分解
                                $(subst ::,:.:,
                                  $(patsubst :%,.:%,
                                    $(patsubst :%,:.,$(PATH)
                                   )
                                )
                             )
                          )
                        )
                    )
                  )




___
■ addprefix

  SYNTAX
      $(addprefix pfxk,name...)

  DESC


      # file が空でないかテスト

      # "-a -s " が prefix
      # Command 内で利用されることを想定
      #
      validfile = test -s . $(addprefix -a -s ,$1)



___
■ join

  SYNTAX
      $(join pfxlist,sfxlist)

  DESC
      prefix list, suffix list の各単語を連結
     dir notdir で分離した単語を結合できる

      # 苗字 と 名前
      fname := yamada  suzuki
      sname := taro    itiro

      fullname := $(join $(fname),$(sname))






___
■ 実行制御

  POINT
     実行制御をすることで幅広い処理ができる
     error も本質的には 実行制御


___
■ if

  SYNTAX
    $(if cond,then-part,else-part)

  DESC
     cond が "文字列を含めば" : 真
     NULL 文字列            : 偽

    cond の前後の空白は除去した後, 結果がチェックされる


    true  ならば then-part マクロが展開
    false ならば else-part マクロが展開

    # PATH 区切り文字を決める
    #
    #  $(COMSPEC) は windows のみ定義
    #
     PATH_SEP := $(if $(COMSPEC),;,:)


  POINT
      # if - filter で 文字列のチェックをする

    # Version Check
      $(if $(filter $(MAKE_VERSION),3.80),, \
              $(error this ver in not 3.80) )

  POINT
    Macro 言語 と Programing 言語は異なる
    Macro 言語 は Macro の定義, 展開をして 結果をえるのが Macro 言語

___
■ error

___
■ error

  SYNTAX
      $(error text)

  DESC
    Error 報告をして
    ExitCode 2 をかえす

    # make assert
    #   $(call assert cond,msg)
    #
    define assert
      $(if $1,,$(error assertion failed: $2))
    endef


    #
    # make assert
    #      $(call assert-exit-file filePtn,msg)
    #      wildcard を利用して filePtn にマッチする file があるかチェック
    #
    define assert-exit-file
      $(call assert $(wildcard $1),$1 not exist)
    endef


    # make assert
    # $(call assert-not-null makeVar)
    #
    # WARNING
    #        VOID:=aiueo
    #        $(call assert-not-null VOID) != $(VOID)
    #
    define assert-not-null
      # $($1) とあるのは 引数 として 変数をもらうため
      #
      $(call assert $($1),var $1 is null)
    endef



  POINT
     Make の変数 は 他の変数も代入できる
     変数がはいった 変数を展開するには 2 回展開する


    # NULLVAR

    # RET
    #      "NULLVAR is null"
    #
    (call assert-not-null  NULLVAR)





___
■ warning

  SYNTAX
     $(warning text)

  DESC
    警告 Message を表示
    error とは違い, Make は終了しない

  POINT
     makefile( FILE ), LINE を表示してくれる

  POINT
     展開されないので, すべての場所で利用できる






___
■ foreach

  SYNTAX
      $(foreach var,list,body)

  DESC
    list の単語を順に var に設定して, body を展開
    展開された body の結果は " "区切りで累積する

     SPC 区切りの文字列 list として展開


    # RET
    #    music_1.wmv music_2.wmv music_3.wmv ...
    #
    tmp:
        @echo $(foreach idx,1 2 3 4 5 6 7 8 9,$music_$idx.wmv)



    # $(call grep-string  serstr, list)
    #
    #    List から serstr を含む文字のみ抽出
    #
    define grep-string
      $(strip
        $(foreach w,$2
           $(if  $(findstring $1,$w),$w))))

    endef

    list := foo.h bar.h foo.cpp

    # RET
    #    "foo.h foo.cpp"
    test:
        echo $(call grep-string,foo,$(list))




  POINT
     Make の関数は PreProcessor と同じ
     その場で展開するため, 展開後の結果がおきかわる

    VAR := foo

    #  TopLevel で展開された結果は ERROR
    $(call grep-string,foo,$(list))





      letters := $(foreach letter,a b c d,$(letter))
      show-words:
      #        letter has $(words $(letters)) words: $(letters)


      VARLIST := SRCS OBJS HOME
      $(foreach i,$(VARLIST),\
      $(if $($1),,$(shell echo $i has no value > /dev/stderr))\
      )

___
■ strip

  SYNTAX
     $(strip text)




  DESC
    前後の空白除去と
    list 間の空白をひとつにする

    [ aaa bbb    ccc     ] -> [aaa bbb ccc]

  TIP
    $(if) 判定の引数をきれいにするのに利用する


    #  [,] の後の " " が arg2 に含まれてしまう
    #
    $(call func,arg1, arg2)





   VAR:= aaa         bbb       ccc

   test:
     echo $(VAR)
     echo __$(strip $(VAR))__


   # echo __aaa         bbb       ccc   __
   # __aaa bbb ccc __
   # echo __aaa bbb ccc__
   # __aaa bbb ccc__





___
■ origin

  SYNTAX
      $(origin var)

  DESC
    変数の出所を調べる

    undefined:            未定義
    default:              組み込み ( DB で定義すみ )
    enviroment:           ENV
    enviroment override: (-e)--enviroment-overrides
    file:                makefine 定義
    command line:         CommandLine 定義
    override :          overwride 命令
    automatic :        自動変数




      $(origin MAKE_VERSION)  # 変数名自体

      make testtgt DATE=`date`
      $(origin DATE)  # cmdline

      # 変数 宣言 チェック
      define assert-defined
        $(call assert,\
                $(filter-out undefined,$(origin $1)),\
                $1 is undefined)
      endef





___
■ 高度なユーザー定義関数

  POINT
    Debug 機能は多くないので自前で用意すること





  POINT
    [=] を利用するのは, := では関数の評価に問題あり 

    # 関数 call を Trace
    #
    debug-enter = $(if $(debug-trace),\
                    ($warning Enter $0$(echo-args)))

    debug-leave = $(if $(debug-trace),\
                    ($warning Leave $0))

    # WARNING
    #    引数の数を数えることはできない( 数も固定 )
    #
    comma := ,
    echo-args = $(subst ' ','$(comma) ',\
                  $(foreach a,1,2,3,4,5,'$($a)'))


    debug-trace = 1

    define a
      $(debug-enter)
      echo $1 $2 $3
      $(debug-leave)
    endef

    define b
      $(debug-enter)
      $(call a,$1,$2,hi)
      $(debug-leave)
    endef

    test:
        $(call b,5,$(MAKE))





___
■ eval.関数と.val

  SYNTAX:
      $(eval exp)

  DESC
    Exp を Make の構文解析に直接渡す( eval 自体は値を返さない )

  POINT
    EXp が make に描かれていたことを 考えれば OK

  POINT
     Make の関数はまず 引数が変数の場合,展開する



      $(eval SRCS:=foo.c bar.c)








      # $(call pro-var,pfx,list)
      #
      #    list から 変数 $1_s, $1_h  $1_o に file をセットする
      #
      define pro-var
        $1_s = $(filter %.c,$2)
        $1_h = $(filter %.h,$2)
        $1_o = $(subst .c,.o,$(filter %.c,$2))

        $($1_o): $($1_h)
      endef


      # lss=ls.c glob.c < - make が tgt としてみなした
      #
      # WARNING
      #    TopLevel では 複数行の Macro は Error になる
      #    [区切り文字] がない といわれる

      #    eval はこれを解消するためにできた
      #
      #
      $(call pro-var,ls,ls.c ls.h glob.c glob.h)



      #

      # $(eval lss=ls.c glob.c) # 代入式が評価される
      #
      $(eval $(call pro-var,ls,ls.c ls.h glob.c glob.h))

  TIP
    複数行の macro を扱う
      2. 関数置換後の str を再評価
      2. eval の引数は 2度展開される
    make が eval を展開する
    2. eval 自身


  POINT
     Macro とは define によって定義される 特殊な変数
        ( ie. Macro は変数のひとつ )

     Macro と 変数の違いは , Macro が [\n] を含めることができること

  POINT
    eval を使う理由は, 複数の変数を展開をするため

  POINT
    複数行に 展開される Macro を makfile の Top で利用するには eval() にわたすこと


  WARNING
    最初の Macro の展開だけでは, Macro 内の変数の代入はされない

        # 展開後の 代入がされない
        ls_s = ls.c
        ls_h = ls.h
        ls_o = ls.o

        # ので これは 正しくない
        #    変数代入の前に参照された
        $(ls_o): $(ls_h)

        # そこで, $$ として展開を遅延させる
        $$($1_o) : $$($1_h)

  POINT
     まとめ
         eval の引数は 2 回展開される

         1 回目 : Make が eval の引数を展開
         2 回目 : eval 自身の展開


  # これでも OK
  #    eval を代入に利用することで, Macro 内でおこなう
  #
      define pro-var
        $(eval $1_s = $(filter %.c,$2))
        $(eval $1_h = $(filter %.h,$2))
        $(eval $1_o = $(filter %.o,$2))

        $($1_o): $($1_h)
      endef

  POINT
    まとめとして, 次のように使う

      define pro-var
        $(eval $1_s = $(filter %.c,$2))
        $(eval $1_h = $(filter %.h,$2))
        $(eval $1_o = $(filter %.o,$2))

        programs += $1

        $1: $($1_o)
        $($1_o): $($1_h)
      endef


      # TopLevel で展開する
      #    POINT
      #      文字列の置換にすぎないことを覚えておくこと
      #
      $(eval  $(call  pro-var ls,ls.c  ls.h ))
      $(eval  $(call  pro-var mv,mv.c  mv.h ))



  WARNING
     複数行に展開される macro は構文 ERROR


___
■ hook.関数

  POINT
     User 定義関数とは 単に 文字列を格納した変数のこと
     call は 関数という文字列  の中で  $1, $2 があれば, 引数に置換するだけ
        そのため変数に文字列がなくても何もしない



    #  $1, $2 を引数に展開
    #
     $(call func,foo,bar)

    # これは ERROR にならない
    #
     $(call invalidfunc,foo,bar)



  POINT
     hook を利用すると 関数がさらに便利になる
     user は hook に自分の好きな処理を追加できる


    # ar 後 後処理を build-library-hook という macro で用意しておく
    define build-library
      $(AR) $(ARFLAGS) $@ $1
      $(call build-library-hook,$@)
    endef


    # hook を使うには
    #    hook 関数( という変数 )に処理をいれる
    #
    $(foo_lib): build-library-hook = $(RANLIB) $1
    $(foo_lib): $(fooobj)
          $(call build-library,$^)

    $(bar_lib): build-library-hook = $(CHMOD) 444 $1
    $(bar_lib): $(barobj)
          $(call build-library,$^)




___
■ 関数に値を渡す

  DESC
    call を利用
      2. 関数外の変数
      3. tgt 固有変数

___

___
■ 自動変数リスト

  POINT
     Rule.が決定した後に展開される
     そのため Command 以外での利用はできない
     Make は Command を実行する前に 自動変数 を設定する



  $@: Target
  $?: Target より新しい Depend ( Space 区切りで展開 )
  $^: all Depend
  $%: library 構成指定要素 すべて
  $< : first dep
  $+: 重複を含む all Depend
        ( Linker の用途 )
  $*: suffix を除く target( pattern rule 以外での使用禁止 )



  // make との互換機能
  D: dir 返却
  F: file 返却
  EX
    $(@D), $(< F)

  TIP
    // GNU make
    dir, notdir 関数をサポート

      target: main.o sub.o
        gcc $^ -o $@          # gcc  main.o sub.o  -o target



  WARNING
    Command Line 以外は利用できない

  target: main.o  sub.o
      gcc $^  $@             #  ここだけで使用できる



___

  POINT
     Make は大量の Command Option をもつ

  SYNTAX
    -o arg
    -option=arg





    # すべてを強制的に更新
    -B
    --always-make

    # Current Directory 移動
    #    $(CURDIR) が設定される
    -C
    --directory

    # ENV 優先指定
    -e

    # makefile 指定
    -f
    --file
    
    # Help
    -h
    --help
    
    # Include Directory
    -I
    --include-dir

    # Error がでても 継続
    -k
    --keep-going


    # Make が実行する Command を表示
    #    WARNING
    #      $(shell) も実行される
    -n
    --just-print

    # 指定した file が非常に古いものとして扱う
    #    DependGraph の影響を調べるときに便利
    #
    -o
    --old-file

    #  Make の DB を表示
    -p
    --print-data-base    

    
    # TimeStamp が最新でない File を更新する
    #    Comment だけを追加した場合に便利
    -t
    --touch

    # TimeStamp を更新なしに File を最新として扱う
    -W 
    --new-file

    # 定義されてない変数の展開時 に WARNING 
    --warn-undefined-variables
        



___

  POINT
     Command とは 1 行の ShellScript
        make は一行ごとに subshellに渡す


      既定 shell == /bin/sh
      ENV:SHELL の影響をうける

  POINT
     SubShell にわたさないで Make 自身が実行する場合もある
          Shell の特殊文字 ( wildcard , redirect )の有無が判定基準
          fork/exec などの重い処理が不要になる


___
■ Command 構文解析

  POINT
    Make が Command と認識する箇所
      Target に続く "最初の文字が Tab" から始まる


    Command を Target 直後以外の場所から読むと 次のエラーがでる

    # CommandLine が最初の Target 以前に置かれています
    #

  POINT
     Target の文脈以外で CommandLine が見つかりました が正しい


  POINT
     Command 以外の行がみつかると Command 解析モードがとまる


    先頭に tab がなくなった時点で 解析 mode 終了

  [tab]XXX ... < -> cmdline>XXX...


    Script として make に解釈されるもの( 以下のものは SKIP )

  POINT
     Command Mode では以下も Command 扱いになる
   空行
   Comment
   条件判断命令( ifdef, ifeq )  -> Make の設計として必要だったと思う
   include





  POINT
     CommandLIne 中の 組み込み関数の置換結果は有効な ShellCommand | VOID


    longcommand:
      @echo line 2

      # shell Comment
    # make Comment ( no tab )
      # make Comment
      @echo line 11
    ifdef COMSPEC
      @echo env is Windows
    endif

      # Command としての warning
      #    warning は置換結果は 空 -> 空文字列 が Shell に渡る
      #
      #    echo より warning による出力が先に表示される
      #    ( Make が Command 内部の展開を先にするから )
      #
      $(warning keikoku)
    #



___
■ 長い Command

     各 Command は別々 sub Shell に渡される
      複数行を同時に渡すには \ をつかう

     [\] : 行継続をあらわす


  POINT
     複数行の CommandLine は \ && ; でつなぐ


  POINT
    define macro を CommandLine に配置したとき
    各行に TAB がおかれる

  #  一連の Shell Command を "cmd" マクロにまとめる
  define cmd
    cd src;\
    ls
  endef

  # [tab]  がはいった状態になる
  definetest:
    $(cmd)



   # d に対する参照を escape する
  ERROR
    $d : make が置換する
  OK
    $$d



    # 中間 file は消去
    .INTERMEDIATE: filelist


    ll:=foo bar goo

    # [\] により 1 行に連結されて Shell にわたるので
    #    [;] を忘れないこと
    filelist:
      for d in $(ll);    \
      do                 \
        echo $$d;        \   # shell の [$d] として渡すため [$$d] とする
      done



    # File 数が少ないなら make 関数を利用するのもあり
    #
    filelist:
        echo $(addsuffix  /*.java,$(COMPILATION_DIRS))  >  $@

    #  cd などは \ をつけないと意味なし
    #
    TAGS:
        cd src; \
        ctags --recusrse


    # さらに 結果をみる
    #
    #
    TAGS:
        cd src && \
        ctags --recusrse


  POINT
     define の CommandLine での展開も注意が必要
        展開された 各行は 別の SubShell に渡る


___
■ Command 修飾子

  POINT
     Command は Prefix をおくことで動作を変更できる
     Prefix は各行単位でする

    @  : Command を非表示
    -  : Command の ERROR を無視
    +  : -n でも Command を実行


      @: cmd silent

    .SILENT. tgt
    QUIET:=@

    # -s( --silent ) option で全 Command を Log OFF
    #
    make -s

    # QUIET という変数で ON/OFF をできるようにする
    # Reset するなら CommandLine から Reset する
    #
    #    shell> make  QUIET=  test
    #
    QUIET := @
    test:
        $(QUIET)echo "test ..."
        echo "aaa"

  POINT
     Make が Command を実行するとき, その Program の StatusCode をチェックする
     0 以外を返す( 失敗 )なら, Make はそこで処理を中断

    make が 終了 status を無視して処理を継続

    #  CommandLine から一括で
    shell> make -i( --ignore-errors )

    # Target 指定
    .IGNORE : test

    # Command ごとに
    test:
        $(QUIET)echo "test ..."
        -rm noExistFile
        echo "aaa"
    +: -n でも cmd 実行

]


___

___
■ インストール

    nmake とは VisualStudio に付属する make プログラムのこと。
    $(VC)/bin/nmake.exe に付属する。

    使いかたは Cygwin の make とほぼ同じ。

    nmake  -f  makefile.vcproj



    nmake  clean all  -f  makefile.vcproj