|
Project Information
Links
|
Quick Access: Visit Code Repo (https://github.com/PatHuang/dotAux) to browse or download dotAux code. dotAux OverviewdotAT (.AT) - Practices to see how Autotools (Autoconf/Automake/Autotest) could work. dotAux (.AUX) - Utilities and Macros. Macros are helpful to you, but utilities may be not. Utilities are just practices and would be useful to you when you understand them and know why development automation and test automation are important. The important idea behind dotAux is portibility and independence and automation, the most exciting bigest benefit brought by GNU build system (Autotools, Autoconf/Automake/Autotest, Libtool, etc). Although you need to have Autotools installed in software product development phase, but Autotools (any of Aotuconf/Automake/Autotest, Libtool) is not required at all when your users configure, build, install and use your software product in field, not required too in your testing and release phase, while you are delivering portable and robust high quality software products developed in C, C++ or shell script. Similarly project dotAux and Dolem provides the same vision helping you in development phase, and also maybe in testing and release phases. Keep it in mind - Autotools is not required to be installed on user's machine. Users of course don't care what tools you are using to make products. So why not use powerful excellent toos as your AUX to reduce effort and improve quality and accelerate time to market? Copyright and LicenseCopyright (c) 2009-2014 The dotAux Project. All rights reserved. Sub projects: dotAT (.AT) - Most tests on tests/ subfolder are taken from autoconf-2.69/tests/, so license kept no changes. dotAux (.AUX) - MIT License for shell/application code, plus dotAux's M4 macros. See COPYING and Macros.COPYING for the details. dotAux Utilities OverviewTo understand what talk better, probably you know alredy about shell script, make, makefile, GNU build system (Autotools); know GnuLib would be even better.
You can see project Dolem, Effo etc, for typical useage of the above tools and Autotools and GnuLib practices for the details. dotAux Macros OverviewTo understand what we talk better, probably you know alredy about shell script, make, makefile, Autoconf, Autotest; know M4 would be even better.
You can see project this project dotAux, and others such as Dolem, Effo etc, for typical useage of the above Macros practices for the details. dotAux Getting StarteddotAux portable scripts intend for use by convention of ./configure && make && make install. See INSTALL In fact, dotAux utilities were developed based on macros, so they should be portable and able to work directly without "./configure && make && make install". See them in "dotaux" folder of each package, e.g., dotaux/dotaux, or dotat/dotaux. TBD dotAux Utilities Usagedapkg: Usage and optinosdapkg: -h|--help Display help info
-V|--version Display version info
-a[pa_folder]|--aux=pa_folder
pa_folder: Your local Package dotAux folder to store
stuff from dotAux distro
-p|--pack function pack, build a package tarball. If not
specified, default function is setup, to setup
initial Package dotAux folder.dotaux: Usage and optinosdotaux: -h|--help Display help info
-V|--version Display version info
-a[da_folder]|--aux=da_folder
da_folder: Your local dotAux folder to store stuff
from dotAux distro
-c|--clean function clean, clear all and clear autotools
generated files such as aclocal, etc. If not
specified, default function is setup, to setup
initial dotAux folder.
-k[namelist]|--keep=namelist
namelist: Dont' clear files or folders in namelist
which looks like "name1,name2,name3..."damk: Usage and optinosdamk: -h|--help Display help info
-V|--version Display version info
-a[da_folder]|--aux=da_folder
da_folder: Your local dotAux folder
-c config, is equal to ./configure --prefix=/abc.
--clean clean, is equal to make clean
--dclean dclean, is equal to make distclean
--aclean aclean, is equal to make clean && make distclean
-m make, is equal to make.
--cmake cmake, is equal to make check.
--dmake dmake, is equal to make dist.
--amake amake, is equal to make && make check.
-i inst, is equal to make install.
--tinst tinst, is equal to make DESTDIR=pwd-inst install.dadlm: Usage and optinosdadlm: -h|--help Display help info
-V|--version Display version info
-d[dlm_folder]|--dolem=dlm_folder
dlm_folder: Your local Dolem folder to store stuff
from gnulib
-c|--clean function clean, clear Dolem
and gnulib, etc. If not specified, default function
is setup, import
gnulib.
-k[namelist]|--keep=namelist
namelist: Dont' clear files or folders in namelist
which looks like "name1,name2,name3..."daln: Usage and optinosdaln: <link> <pattern> This utility links a source (file or folder) to current location as <link> link Source and Dest (the link) name. pattern Source path pattern. -h|--help Display help info -V|--version Display version info TBD dotAux Macros UsageSee project dotAux, Dolem, Effo, etc, for details of practice use of dotAux Macros. # Use dotAux DAS: m4_import([dmeta/das.m4]) # this import dotAux DAS; and optional: DAS_SHELL_FN # import shell function libs as well. then here write your appliation macros for shell script, configure.ac, or autotests (.at's). # Use dotAux DAC: m4_import([dmeta/das.m4]) # this import dotAux DAS. m4_import([dmeta/dac.m4]) # this import dotAux DAC; and optional: DAC_SHELL_FN # import shell function libs as well. It also imports DAS shell function libs. then here write your appliation macros for configure.ac. # Use dotAux DAT: m4_import([dmeta/das.m4]) # this import dotAux DAS. m4_import([dmeta/dat.m4]) # this import dotAux DAT; and optional: DAT_SHELL_FN # import shell function libs as well. It also imports DAS shell function libs. then here write your appliation macros for autotests (.at's) TBD Visit Code Repo (https://github.com/PatHuang/dotAux) to browse or download dotAux code. |