2 ############################################################
4 # author: CottonCandyOwner(CottonCandyOwner@126.com)
6 ############################################################
8 # it's a code format utility.
9 ############################################################
26 ##############################
27 # section: public comment info
28 ##############################
32 ##############################
33 # section: variable define
34 ##############################
39 |prog $0 'project build util-program.'
40 |blank '[compile operation]'
43 |param |- |-- |---help |= |%<help> |&<on_help> |'this helper text.'
45 |blank '[integrate srcpkg]'
46 |param |- |-- |---list |= |%<pkglist> |&<on_pkglist> |'list packages.'
47 #|param |- |-- |---listclear |= |%<pkglistclear> |&<on_pkglistclear> |'clear package list in current src pkg.'
48 |param |- |-- |---append |= |%<pkgadd> |&<on_pkgadd> |'add a pkg as a sub src pkg.'
49 |param |- |-- |---del |= |%<pkgdel> |&<on_pkgdel> |'delete a pkg from package list.'
50 |param |- |-- |---get |= |%<pkgrename> |&<on_pkgrename> |'rename package, not only pkg dir name, it modify names in all it is a text file.'
51 |param |- |-- |---done |= |%<pkgimport> |&<on_pkgimport> |'import a pkg in current src pkg sub dir.'
53 |blank '[one version task]'
54 |param |- |-- |---launch |=[dest] |%<filelist> |&<on_filelist> |'list files for specified dest in current src pkg to be compiled.'
55 |param |- |-- |---launchback |=[dest] |%<filelistclear> |&<on_filelistclear> |'clear file list for specified dest.'
56 |param |- |-- |---suspend |=[dest] |%<fileadd> |&<on_fileadd> |'add src file to specified dest.'
57 |param |- |-- |---resume |=[dest] |%<filedel> |&<on_filedel> |'delete src file to specified dest.'
58 |param |- |-- |---submit |=[dest] |%<moduleadd> |&<on_moduleadd> |'add module src file to specified dest.'
69 clean - clean all the project under this workspace.
70 all - default. use native compiler to compile program.
71 cross - use CROSS_COMPILE to compile a cross program.
74 pkg - copy headers libs and programs into pkg dir.
75 devinstall - install pkg to system.
76 install - install executables to system.
77 crosspkg - copy headers libs and programs into pkg dir.
78 crossdevinstall - install pkg to cross-compiler.
79 crossinstall - install executables to system.
82 addtestprj - create test project as a templete, exe & lib.
83 addtestprj - create test project as a templete, exe & lib.
84 list - list project in this workspace
85 addexe PRJ=<name> - add a new executable project from templete.
86 addlib PRJ=<name> - add a new library project from templete.
88 listclear - clear all sub project in ws compile list.
89 rename OPRJ=<pld-name> PRJ=<new-name>
93 version - get workspace version as A.B.C format.
94 verinc1 - increase first version number A.
95 verinc2 - increase second version number B.
96 verinc3 - increase third version number C.
99 check-env - check running enviroument, check make, gcc, inc
100 path, lib path, and so on. espesially usefull under
101 CROSS_COMPILE, it can automatically check lib path.
102 # distclean - make src-tarball all project in workspace to
103 - source dir, clean project dirs, move other
105 backup - distclean, and src-tarball the workspace.
106 init - init project code in source dir, add them to workspace.
107 src-tarball - make a src tarball for this workspace.
132 ##############################
133 # section: private function
134 ##############################
137 # fsyntax: on_subcmd_proc <param_name> <param_value>
138 # fdesc: on all sub-cmd response. it invoke paramter proc function
139 # defined in src pkg.
143 # TBD: invoke sub-cmd proc function defined in src pkg.
149 # fdesc: on help sub-cmd.
160 # fdesc: on help sub-cmd.
170 # fdesc: on help sub-cmd.
180 # fdesc: on help sub-cmd.
190 # fdesc: on help sub-cmd.
200 # fdesc: on help sub-cmd.
210 # fdesc: on help sub-cmd.
221 # fdesc: on help sub-cmd.
231 # fdesc: on help sub-cmd.
241 # fdesc: on help sub-cmd.
251 # fdesc: on help sub-cmd.
261 # fdesc: on help sub-cmd.
271 ##############################
272 # section: public function
273 ##############################
290 ##############################
292 ##############################