doc/designdoc/designdoc/1.0.features.md

   1
   2
   3 [build-features]
   4
   5 @ general
   6 # pure std-sh script, less external utils for build.
   7 # rich user-manual doc type support
   8 # gen intall pkg in etz fmt, it can be install & unpack by it self, do not need other software.
   9 # build dbgout info in compact or cmd mode, and output cmd in .log file. it's equal to -V option.
  10
  11 @ build
  12 # standard build/doc/test/install/clean subcmd, and others
  13 # *comparing chksum info to backup build mid file, and shorten cmpl
  14   time.(instead of tp)
  15 # build dst depend on src(.c/.h) modified
  16 + .h/.obj,
  17 + <srcfile>/.obj,
  18 + .obj / exe/dlib/slib
  19 # auto-gen
  20 + src dephdr auto-gen
  21 + src list auto-gen from file scanning, for cmpl.
  22 + deplib param auto-gen. chk on install, needn't on build. gen param from .deplib & srcpkg info for compile & link.
  23 # multiple
  24 + multiple dest
  25 + multiple arch/sys£¬for cross compile
  26 + multiple task/*host
  27 # build procedure defined by step info in list var in .list file, or in
  28   build.dot.
  29 + it gen build sequence diagram by graphviz, for good vitualized-looking,
  30   and for good comprehanssion of build procedure.
  31 # srcpkg can be casecaded in subdir. it can be combined to complex srcpkg. and
  32   config it by build-config (menuconfig).
  33 # keep src code readonly, middle file & output file generated in specified dir.
  34 + srcpkg can be stored in readonly media.
  35 + it support O= param similar with linux src, to output things in a rw dir.
  36 + independence build dir, srcpkg can be stored in read only media, and does not use fixed build file with src, for good looking. and src code would not been modified for security.
  37
  38 @ deplib info for srcpkg download & build.
  39
  40 @ param
  41 # config param for build & srcpkg feature.
  42 + config by file in config.imi,
  43 + cmd argument,
  44 + menuconfig,
  45 + app user param config file.
  46 # setting param for developer of srcpkg.
  47 + standard cmpl param, can be integrated in IDE, and build by build-pkg.
  48 # build info, src file, CFLAGS/LDFLAGS, are store in file, in form of list &
  49   imi. it's a standard interface for build, diff build utils can use it for
  50   config as envars. and any editor can edit it easilly to integrate in IDE. it
  51   seperate general info with code.
  52 + redundence param chk, param seq chk
  53 # public param info for build.
  54 + following with WRAP define for srcpkg info & building.
  55 + author/org/wrap/runtime-dir...
  56 + standard srcpkg dir, gen by codegen, chk by srcpkg/dev, grab srcpkg info by srcpkg for web.
  57
  58 @ srcpkg codemngr
  59 # regist repo space by srcpkg info file in cmd.
  60 # code/test auto gen by a catalog file, in txt.
  61 # srcpkg with demand(features)/design info, for comprehanssion and code modification.
  62 # gen webpages for fundamental info & features. update/upload by sh script. all work in term env.
  63 # src bak, commit to repo, pub new version.
  64
  65 @ set chksum value in src, compile if it's matching with the value in envar, setting by srcpkg.
  66
  67
  68
  69
  70
  71
  72
  73
  74
  75
  76
  77
  78
  79
  80
  81
  82
  83
  84
  85
  86
  87
  88
  89
  90
  91
  92
  93
  94
  95
  96
  97
  98
  99
 100
 101 [build-features]
 102
 103 @ src dephdr, only rebuild modified src
 104 @ deplib, chk on install, needn't on build. gen param from .deplib & srcpkg info.
 105 @ src list gen from file scanning, for cmpl.
 106 @ public param info for build. author/org/wrap/runtime-dir...
 107 @ standard cmpl param
 108 @ redundence param chk, param seq chk
 109 @ standard srcpkg dir, gen by codegen, chk by srcpkg/dev, grab srcpkg info by srcpkg for web.
 110 @ standard build/doc/test/install/clean subcmd, and others
 111 @ following with WRAP define for srcpkg info & building.
 112 @ multiple dest/arch/sys/task/host/
 113 @ config by file in config.imi, or cmd argument, or menuconfig.
 114 @ build procedure defined by step info in list var in .list file, or in build.dot.
 115 @ it can gen build sequence diagram by graphviz, for good build procedure comprehanssion.
 116 @ build info, src file, CFLAGS/LDFLAGS, are store in file, in form of list & imi. it's a standard interface for build, diff build utils can use it for config as envars. and any editor can edit it easilly to integrate in IDE. it seperate general info with code.
 117 @ pure std-sh script, less external utils for build.
 118 @ it support -O param similar with linux src. independence build dir, srcpkg can be stored in read only media, and does not fix build file with src, for good looking. and src code does not been  modified for security.
 119 @ rich doc type support
 120 @ srcpkg can be casecade in subdir. it can combine to complex srcpkg. and config it by build-config(menuconfig).
 121 @ build mid file backup, to shorten cmpl time.
 122 @ gen intall pkg in etz fmt, it can be install & unpack by it self, do not need other software.
 123 @ build dbgout info in compact or cmd mode, and output cmd in .log file.it's equal to -V option.
 124
 125 @ srcpkg with demand(features)/design info, for comprehanssion and code modification.
 126 @ code/test auto gen by a catalog file, in txt.
 127 @ src bak, commit to repo, pub new version.
 128 @ gen webpages for fundamental info & features. update/upload by sh script. all
 129   work in term env.
 130 @ regist repo space by srcpkg info file in cmd.
 131 @