生成符合自由软件惯例的Makefile

生成符合自由软件惯例的Makefile
./configure 的生成过程
configure 是个shell 脚本文件，是自动产生的，不是手工编写的。

------------------------------------------------------------
过程简述：
------------------------------------------------------------
编写3个文件
test.c
configure.in
Makefile.am

然后执行:
aclocal
autoconf
automake --add-missing

而后可以编译，安装，发布
./configure  生成Makefile
make
make clean
make install
make clean
make dist
------------------------------------------------------------
1. 准备目录和文件，autoscan 生成 configure.in 的模板
------------------------------------------------------------
[hjj@hjj ~/ctest]$ ls
test.c
[hjj@hjj ~/ctest]$ cat test.c
#include <stdio.h>

int main(int argc, char *argv[])
{
    printf("hello\n");
    return 0;
}
[hjj@hjj ~/ctest]$ autoscan
[hjj@hjj ~/ctest]$ ls
autoscan.log  configure.scan  test.c

------------------------------------------------------------
2. 编写configure.in 文件
有一些宏的定义要慢慢积累
AM_INIT_AUTOMAKE 宏是必须的
------------------------------------------------------------
以configure.scan 为模板，添加修改AC_INIT, AM_INIT_AUTOMAKE,AC_OUTPUT, 删除不用部分
[hjj@hjj ~/ctest]$ diff configure.scan configure.in
5,7c5,6
< AC_INIT([FULL-PACKAGE-NAME], [VERSION], [BUG-REPORT-ADDRESS])
< AC_CONFIG_SRCDIR([test.c])
< AC_CONFIG_HEADERS([config.h])
---
> AC_INIT(test, 1.0)
> AM_INIT_AUTOMAKE(test, 1.0)
20c19
< AC_OUTPUT
---
> AC_OUTPUT(Makefile)

------------------------------------------------------------
3. 运行aclocal autoconf 命令
aclocal 是一个perl脚本，将configure.in 变成 aclocal.m4
autoconf 生成configure. 它的输入是aclocal.m4
configure 是一个shell 脚本，它能检测系统特性，使支持各种平台
------------------------------------------------------------
[hjj@hjj ~/ctest]$ ls
autoscan.log  configure.in  configure.scan  test.c
[hjj@hjj ~/ctest]$ aclocal
[hjj@hjj ~/ctest]$ ls
aclocal.m4  autom4te.cache  autoscan.log  configure.in  configure.scan  test.c
[hjj@hjj ~/ctest]$ autoconf
[hjj@hjj ~/ctest]$ ls
aclocal.m4  autom4te.cache  autoscan.log  configure  configure.in  configure.scan  test.c

------------------------------------------------------------
4. 编写Makefile.am
是makefile.in 的输入文件
AUTOMAKE_OPTIONS:检查目录下是否存在标准GNU软件包中应具备的各种文件，例如AUTHORS、ChangeLog、NEWS等文件。
                 我们将其设置成foreign时，automake会改用一般软件包的标准来检查。
bin_PROGRAMS 　　指定我们所要产生的可执行文件的文件名。
                 如果你要产生多个可执行文件，那么在各个名字间用空格隔开。
test_SOURCES 　　指定产生“test”时所需要的源代码。如果它用到了多个源文件，那么请使用空格符号将它们隔开。
                 比如需要test.h，test.c那么请写成 test_SOURCES= test.h test.c。
bin_PROGRAMS定义了多个可执行文件，则对应每个可执行文件都要定义相对的filename_SOURCES
------------------------------------------------------------
[hjj@hjj ~/ctest]$ cat Makefile.am
AUTOMAKE_OPTIONS=foreign
bin_PROGRAMS=test
test_SOURCES=test.c

------------------------------------------------------------
5. 运行 automake --add-missing
--add-missing 选项会让automake自动加入软件包所必须的一些文件。
------------------------------------------------------------
[hjj@hjj ~/ctest]$ automake --add-missing
configure.in:6: installing `./install-sh'
configure.in:6: installing `./missing'
Makefile.am: installing `./depcomp'
[hjj@hjj ~/ctest]$ ls
aclocal.m4  autom4te.cache  autoscan.log  configure  configure.in  configure.scan  depcomp  install-sh  Makefile.am  Makefile.in  missing  test.c
生成的Makefile.in 是符合GNU 惯例的。
至此，源码发布文件已经全部生成。

------------------------------------------------------------
6. 运行 ./configure
------------------------------------------------------------
[hjj@hjj ~/ctest]$ ./configure
checking for a BSD-compatible install... /usr/bin/install -c
checking whether build environment is sane... yes
checking for a thread-safe mkdir -p... /bin/mkdir -p
checking for gawk... gawk
checking whether make sets $(MAKE)... yes
checking for gcc... gcc
checking for C compiler default output file name... a.out
checking whether the C compiler works... yes
checking whether we are cross compiling... no
checking for suffix of executables...
checking for suffix of object files... o
checking whether we are using the GNU C compiler... yes
checking whether gcc accepts -g... yes
checking for gcc option to accept ISO C89... none needed
checking for style of include used by make... GNU
checking dependency style of gcc... gcc3
configure: creating ./config.status
config.status: creating Makefile
config.status: executing depfiles commands

------------------------------------------------------------
7. make & clean & distribute & install
------------------------------------------------------------
[hjj@hjj ~/ctest]$ make
gcc -DPACKAGE_NAME=\"test\" -DPACKAGE_TARNAME=\"test\" -DPACKAGE_VERSION=\"1.0\" -DPACKAGE_STRING=\"test\ 1.0\" -DPACKAGE_BUGREPORT=\"\" -DPACKAGE=\"test\" -DVERSION=\"1.0\" -I.     -g -O2 -MT test.o -MD -MP -MF .deps/test.Tpo -c -o test.o test.c
mv -f .deps/test.Tpo .deps/test.Po
gcc  -g -O2   -o test test.o  
[hjj@hjj ~/ctest]$ make dist
{ test ! -d "test-1.0" || { find "test-1.0" -type d ! -perm -200 -exec chmod u+w {} ';' && rm -fr "test-1.0"; }; }
test -d "test-1.0" || mkdir "test-1.0"
test -n "" \
    || find "test-1.0" -type d ! -perm -755 \
        -exec chmod u+rwx,go+rx {} \; -o \
      ! -type d ! -perm -444 -links 1 -exec chmod a+r {} \; -o \
      ! -type d ! -perm -400 -exec chmod a+r {} \; -o \
      ! -type d ! -perm -444 -exec /bin/sh /home/hjj/ctest/install-sh -c -m a+r {} {} \; \
    || chmod -R a+r "test-1.0"
tardir=test-1.0 && /bin/sh /home/hjj/ctest/missing --run tar chof - "$tardir" | GZIP=--best gzip -c >test-1.0.tar.gz
{ test ! -d "test-1.0" || { find "test-1.0" -type d ! -perm -200 -exec chmod u+w {} ';' && rm -fr "test-1.0"; }; }
[hjj@hjj ~/ctest]$ make clean
test -z "test" || rm -f test
rm -f *.o
[hjj@hjj ~/ctest]$ make
gcc -DPACKAGE_NAME=\"test\" -DPACKAGE_TARNAME=\"test\" -DPACKAGE_VERSION=\"1.0\" -DPACKAGE_STRING=\"test\ 1.0\" -DPACKAGE_BUGREPORT=\"\" -DPACKAGE=\"test\" -DVERSION=\"1.0\" -I.     -g -O2 -MT test.o -MD -MP -MF .deps/test.Tpo -c -o test.o test.c
mv -f .deps/test.Tpo .deps/test.Po
gcc  -g -O2   -o test test.o  
[hjj@hjj ~/ctest]$ sudo make install
make[1]: Entering directory `/home/hjj/ctest'
test -z "/usr/local/bin" || /bin/mkdir -p "/usr/local/bin"
  /usr/bin/install -c test '/usr/local/bin'
make[1]: Nothing to be done for `install-data-am'.

make[1]: Leaving directory `/home/hjj/ctest'

------------------------------------------------------------
调试信息的添加:
------------------------------------------------------------
不要在Makefile中用CFLAGS，CXXFLAGS，xxx_CFLAGS，xxx_CXXFLAGS来设置调试信息。这样每次发布前都要修改Makefile.am
执行configure，设置相关环境变量, 重新生成Makefile, 来决定是否需要调试信息
如果是 C 程序，就执行 ./configure "CFLAGS=..."
如果是 C++ 程序，就执行 ./configure "CXXFLAGS=..."
可执行 ./configure --help 查看帮助。