bin/constructor

   1 #!/bin/bash
   2 ############################################################
   3 # source: build
   4 # author: devenkong(18151155@qq.com)
   5 # date: 2022-04-21
   6 ############################################################
   7 # note:
   8 #     src-pkg compile utility. it orgnize compile file list
   9 # and paramters like Makefile, but it is implemented by shell
  10 # script.
  11 ############################################################
  12
  13 #
  14 # todo：
  15 # @
  16 # @
  17 #
  18
  19 . shlibinc
  20
  21 include gplib.shlib
  22
  23 include stdio.shlib
  24 #include term.shlib
  25 include args.shlib
  26
  27 #include paths.shlib
  28
  29 ##############################
  30 # section: public comment info
  31 ##############################
  32
  33
  34
  35 ##############################
  36 # section: variable define
  37 ##############################
  38
  39
  40
  41 scripttest_desc_str="
  42 |prog $0 'project build util-program.'
  43 |blank '[compile operation]'
  44
  45 |blank '[general]'
  46 |param |-  |--          |---help         |=                      |%<help>      |&<on_help>      |'this helper text doc.'
  47
  48 |blank '[information query]'
  49 |param |-  |--          |---list         |=<content> |%<list>      |&<on_list>      |'<null>/target/pkg/instpkg/dest/dep.'
  50 |param |-  |--          |---get          |=<pkgname> |%<get>       |&<on_get>       |'download the pkg.'
  51
  52 |param |-  |--          |---init         |=                      |%<init>      |&<on_init>      |'unpack archive src code pkg from backup dir to current dir.'
  53 |param |-  |--          |---srcbak       |=                      |%<srcbak>    |&<on_srcbak>    |'backup src to default src bak dir, which is configured in build paramter files.'
  54 |param |-  |--          |---clean        |=                      |%<clean>     |&<on_clean>     |'clean files in compile procedure.'
  55 |param |-  |--          |---distclean    |=                      |%<distclean> |&<on_distclean> |'clean src pkg .'
  56
  57 |blank '[src-pkg setting]'
  58 |param |-  |--          |---setting      |=                      |%<setting>   |&<on_setting>   |'set src pkg build paramters.'
  59 |param |-  |--          |---arch         |=<arch>    |%<arch>      |&<on_arch>      |'target cpu architechture.'
  60 |param |-  |--          |---release      |=                      |%<release>   |&<on_release>   |'build release version.'
  61 |param |-  |--          |---debug        |=                      |%<debug>     |&<on_debug>     |'build debug version.'
  62
  63 |blank '[build all]'
  64 |param |-  |--          |---config       |=                      |%<config>    |&<on_config>    |'config src pkg.'
  65 |param |-  |--          |---test         |=                      |%<test>      |&<on_test>      |'run test script for current src pkg.'
  66 |param |-  |--          |---doc          |=                      |%<doc>       |&<on_doc>       |'build man and info helper doc.'
  67 |param |-  |--          |---umdoc        |=                      |%<umdoc>     |&<on_umdoc>     |'build user manual doc in various kinds of doc type.'
  68 |param |-  |--          |---pkgs         |=                      |%<pkgs>      |&<on_pkgs>      |'build compiled binary executables to an installable pkg.'
  69 |param |-  |--          |---install      |=                      |%<install>   |&<on_install>   |'install compiled install pkg.'
  70
  71 |blank '[build type]'
  72 |param |-  |--          |---default      |=                      |%<default>   |&<on_default>   |'compile all dest in a src pkg.'
  73 |param |-  |--          |---all          |=                      |%<all>       |&<on_all>       |'buildinclude step of default, test, doc, umdoc, pkgs.'
  74 |param |-  |--          |---full         |=                      |%<full>      |&<on_full>      |'compile all platform setted cpu platform in compiler toolchain.'
  75 |param |-  |--          |---cross        |=                      |%<cross>     |&<on_cross>     |'build default cross platform setted in src-pkg. it is setted by arch subcmd.'
  76 |param |-  |--          |---target       |=<arch>    |%<target>    |&<on_target>    |'build specified cross platform.'
  77 |param |-  |--          |---srcpkg       |=<pkgname> |%<srcpkg>    |&<on_srcpkg>    |'build specified sub src pkg.'
  78 |param |-  |--          |---instpkg      |=<instpkg> |%<instpkg>   |&<on_instpkg>   |'build relative executables in a specified install pkg.'
  79 |param |-  |--          |---dest         |=<destname> |%<dest>     |&<on_dest>      |'build specified executables in a src pkg.'
  80
  81 |blank '[build misc]'
  82 |param |-  |--          |---example      |=                      |%<example>   |&<on_example>   |'build example code if it exist.'
  83 |param |-  |--          |---webpages     |=                      |%<webpages>  |&<on_webpages>  |'build webpages translate various doc file .'
  84
  85 |blank '[doc gen]'
  86 |param |-  |--          |---mandoc       |=                      |%<mandoc>    |&<on_mandoc>    |'build man doc.'
  87 |param |-  |--          |---infodoc      |=                      |%<infodoc>   |&<on_infodoc>   |'build info doc.'
  88 |param |-  |--          |---tutorial     |=                      |%<tutorial>  |&<on_tutorial>  |'build tutorial doc. it is an example guide doc.'
  89 |param |-  |--          |---pdfdoc       |=                      |%<pdfdoc>    |&<on_pdfdoc>    |'build pdf user manual doc.'
  90 |param |-  |--          |---htmldoc      |=                      |%<htmldoc>   |&<on_htmldoc>   |'build html user manual doc.'
  91
  92 |blank
  93 "
  94
  95
  96
  97
  98 helper="
  99 help             - this document.
 100 [compile operation]
 101 clean            - clean all the project under this workspace.
 102 all              - default. use native compiler to compile program.
 103 cross            - use CROSS_COMPILE to compile a cross program.
 104
 105 [install operation]
 106 pkg              - copy headers libs and programs into pkg dir.
 107 devinstall       - install pkg to system.
 108 install          - install executables to system.
 109 crosspkg                 - copy headers libs and programs into pkg dir.
 110 crossdevinstall  - install pkg to cross-compiler.
 111 crossinstall     - install executables to system.
 112
 113 # [project operation]
 114 addtestprj       - create test project as a templete, exe & lib.
 115 addtestprj       - create test project as a templete, exe & lib.
 116 list             - list project in this workspace
 117 addexe PRJ=<name> - add a new executable project from templete.
 118 addlib PRJ=<name> - add a new library project from templete.
 119                                                   files.
 120 listclear        - clear all sub project in ws compile list.
 121 rename OPRJ=<pld-name> PRJ=<new-name>
 122                  - rename a project.
 123
 124 [version operation]
 125 version          - get workspace version as A.B.C format.
 126 verinc1          - increase first version number A.
 127 verinc2          - increase second version number B.
 128 verinc3          - increase third version number C.
 129
 130 # [misc operation]
 131 check-env        - check running enviroument, check make, gcc, inc
 132                   path, lib path, and so on. espesially usefull under
 133                   CROSS_COMPILE, it can automatically check lib path.
 134 # distclean      - make src-tarball all project in workspace to
 135                  - source dir, clean project dirs, move other
 136                  - dirs to misc.
 137 backup           - distclean, and src-tarball the workspace.
 138 init             - init project code in source dir, add them to workspace.
 139 src-tarball      - make a src tarball for this workspace.
 140
 141 "
 142
 143
 144 # general
 145 v_help=
 146 v_default=
 147
 148 # information query
 149 v_list=
 150 v_get=
 151
 152 v_init=
 153 v_srcbak=
 154 v_clean=
 155 v_distclean=
 156
 157 # src-pkg setting
 158 v_setting=
 159 v_arch=
 160 v_release=
 161 v_debug=
 162
 163 # build all
 164 v_config=
 165 v_test=
 166 v_doc=
 167 v_umdoc=
 168 v_pkgs=
 169 v_install=
 170
 171 # build type
 172 v_all=
 173 v_full=
 174 v_cross=
 175 v_target=
 176 v_srcpkg=
 177 v_instpkg=
 178 v_dest=
 179
 180 # build misc
 181 v_example=
 182 v_webpages=
 183
 184 # doc gen
 185 v_mandoc=
 186 v_infodoc=
 187 v_tutorial=
 188 v_pdfdoc=
 189 v_htmldoc=
 190
 191
 192
 193 ##############################
 194 # section: private function
 195 ##############################
 196
 197 #
 198 # fsyntax: on_subcmd_proc <param_name> <param_value>
 199 # fdesc: on all sub-cmd response. it invoke paramter proc function
 200 #                defined in src pkg.
 201 #
 202 on_subcmd_proc ()
 203 {
 204         # TBD: invoke sub-cmd proc function defined in src pkg.
 205         :
 206 }
 207
 208 #
 209 # fsyntax: on_help
 210 # fdesc: on help sub-cmd.
 211 #
 212 on_help ()
 213 {
 214         # TBD:
 215         :
 216 }
 217
 218 #
 219 # fsyntax: on_help
 220 # fdesc: on help sub-cmd.
 221 #
 222 on_default ()
 223 {
 224         # TBD:
 225         :
 226 }
 227
 228
 229 #
 230 # fsyntax: on_help
 231 # fdesc: on help sub-cmd.
 232 #
 233 on_list ()
 234 {
 235         # TBD:
 236         :
 237 }
 238
 239 #
 240 # fsyntax: on_help
 241 # fdesc: on help sub-cmd.
 242 #
 243 on_get ()
 244 {
 245         # TBD:
 246         :
 247 }
 248
 249 #
 250 # fsyntax: on_help
 251 # fdesc: on help sub-cmd.
 252 #
 253 on_init ()
 254 {
 255         # TBD:
 256         :
 257 }
 258
 259 #
 260 # fsyntax: on_help
 261 # fdesc: on help sub-cmd.
 262 #
 263 on_srcbak ()
 264 {
 265         # TBD:
 266         :
 267 }
 268
 269 #
 270 # fsyntax: on_help
 271 # fdesc: on help sub-cmd.
 272 #
 273 on_clean ()
 274 {
 275         # TBD:
 276         :
 277 }
 278
 279 #
 280 # fsyntax: on_help
 281 # fdesc: on help sub-cmd.
 282 #
 283 on_distclean ()
 284 {
 285         # TBD:
 286         :
 287 }
 288
 289
 290 #
 291 # fsyntax: on_help
 292 # fdesc: on help sub-cmd.
 293 #
 294 on_setting ()
 295 {
 296         # TBD:
 297         :
 298 }
 299
 300 #
 301 # fsyntax: on_help
 302 # fdesc: on help sub-cmd.
 303 #
 304 on_arch ()
 305 {
 306         # TBD:
 307         :
 308 }
 309
 310 #
 311 # fsyntax: on_help
 312 # fdesc: on help sub-cmd.
 313 #
 314 on_release ()
 315 {
 316         # TBD:
 317         :
 318 }
 319
 320 #
 321 # fsyntax: on_help
 322 # fdesc: on help sub-cmd.
 323 #
 324 on_debug ()
 325 {
 326         # TBD:
 327         :
 328 }
 329
 330
 331 #
 332 # fsyntax: on_help
 333 # fdesc: on help sub-cmd.
 334 #
 335 on_config ()
 336 {
 337         # TBD:
 338         :
 339 }
 340
 341 #
 342 # fsyntax: on_help
 343 # fdesc: on help sub-cmd.
 344 #
 345 on_test ()
 346 {
 347         # TBD:
 348         :
 349 }
 350
 351 #
 352 # fsyntax: on_help
 353 # fdesc: on help sub-cmd.
 354 #
 355 on_doc ()
 356 {
 357         # TBD:
 358         :
 359 }
 360
 361 #
 362 # fsyntax: on_help
 363 # fdesc: on help sub-cmd.
 364 #
 365 on_umdoc ()
 366 {
 367         # TBD:
 368         :
 369 }
 370
 371 #
 372 # fsyntax: on_help
 373 # fdesc: on help sub-cmd.
 374 #
 375 on_pkgs ()
 376 {
 377         # TBD:
 378         :
 379 }
 380
 381 #
 382 # fsyntax: on_help
 383 # fdesc: on help sub-cmd.
 384 #
 385 on_install ()
 386 {
 387         # TBD:
 388         :
 389 }
 390
 391
 392 #
 393 # fsyntax: on_help
 394 # fdesc: on help sub-cmd.
 395 #
 396 on_all ()
 397 {
 398         # TBD:
 399         :
 400 }
 401
 402 #
 403 # fsyntax: on_help
 404 # fdesc: on help sub-cmd.
 405 #
 406 on_full ()
 407 {
 408         # TBD:
 409         :
 410 }
 411
 412 #
 413 # fsyntax: on_help
 414 # fdesc: on help sub-cmd.
 415 #
 416 on_cross ()
 417 {
 418         # TBD:
 419         :
 420 }
 421
 422 #
 423 # fsyntax: on_help
 424 # fdesc: on help sub-cmd.
 425 #
 426 on_target ()
 427 {
 428         # TBD:
 429         :
 430 }
 431
 432 #
 433 # fsyntax: on_help
 434 # fdesc: on help sub-cmd.
 435 #
 436 on_srcpkg ()
 437 {
 438         # TBD:
 439         :
 440 }
 441
 442 #
 443 # fsyntax: on_help
 444 # fdesc: on help sub-cmd.
 445 #
 446 on_instpkg ()
 447 {
 448         # TBD:
 449         :
 450 }
 451
 452 #
 453 # fsyntax: on_help
 454 # fdesc: on help sub-cmd.
 455 #
 456 on_dest ()
 457 {
 458         # TBD:
 459         :
 460 }
 461
 462
 463 #
 464 # fsyntax: on_help
 465 # fdesc: on help sub-cmd.
 466 #
 467 on_example ()
 468 {
 469         # TBD:
 470         :
 471 }
 472
 473 #
 474 # fsyntax: on_help
 475 # fdesc: on help sub-cmd.
 476 #
 477 on_webpages ()
 478 {
 479         # TBD:
 480         :
 481 }
 482
 483
 484 #
 485 # fsyntax: on_help
 486 # fdesc: on help sub-cmd.
 487 #
 488 on_mandoc ()
 489 {
 490         # TBD:
 491         :
 492 }
 493
 494 #
 495 # fsyntax: on_help
 496 # fdesc: on help sub-cmd.
 497 #
 498 on_infodoc ()
 499 {
 500         # TBD:
 501         :
 502 }
 503
 504 #
 505 # fsyntax: on_help
 506 # fdesc: on help sub-cmd.
 507 #
 508 on_tutorial ()
 509 {
 510         # TBD:
 511         :
 512 }
 513
 514 #
 515 # fsyntax: on_help
 516 # fdesc: on help sub-cmd.
 517 #
 518 on_pdfdoc ()
 519 {
 520         # TBD:
 521         :
 522 }
 523
 524 #
 525 # fsyntax: on_help
 526 # fdesc: on help sub-cmd.
 527 #
 528 on_htmldoc ()
 529 {
 530         # TBD:
 531         :
 532 }
 533
 534
 535
 536 ##############################
 537 # section: public function
 538 ##############################
 539
 540
 541
 542 main_build ()
 543 {
 544
 545         return
 546 }
 547
 548
 549 #echo xxxxxxxxxxaaa
 550 #exit
 551
 552 main_build "$@"
 553
 554
 555 ##############################
 556 # section: file tail
 557 ##############################
 558
 559
 560