tbd.txt

   1
   2
   3 @ pkginit (gendir(/)/install(tools)/init(build), pkginfo(doc), ex(build-cfg))
   4
   5 @ pkginfo
   6 # .imi ==> .pkginfo
   7 + array decl
   8 + func invoke in @() in .tmpl. '@(echo 123)' does not display
   9
  10 @ pkginfo.tmpl.imi
  11 # incfile.shlib/imiload() with array
  12 # if some var has been loaded, keep value, do not load by new value.
  13
  14 ============================================================================
  15
  16 [NOTE]
  17 @ ui-cli.shlib/ui-tui.shlib VarType:
  18 # @ VAR, normal variable.
  19 # @ _LIST, a list seperated by ' '.
  20 # @ _ML, multiple line input.
  21 # @ _SEL, single select.
  22 # @ _MSEL, multiple select. connected by '+'.
  23 # @ _MLSEL, multi-line select.
  24 #
  25 # @ _FMT,
  26 # @ _EVL,
  27 # @ _STX,
  28 #
  29
  30 @ struct define
  31 # { }
  32 # disable globing '*',
  33
  34 #
  35 # srcpkg info
  36 #   this file was auto-generated by './dev.sh pkginfo'.
  37 #
  38 # reference about gitee.com.
  39 #
  40
  41 #
  42 # sometimes, maintainer is an account for software orgnization, or duplicated
  43 # srcpkg from other srcpkg.
  44 # those parameters are used in webpages to register a new srcpkg in repo.or.cz.
  45 #
  46
  47 #   info below provide info as general srcpkg info,
  48 #   especially for srcpkg register on web,
  49 #   and also for codegen/cmpl/coding/others... .
  50
  51 #   param below are for 'srcpkg pkginit',
  52 # to generate dir structure, and output dest&pkg for build-srcpkg.
  53
  54
  55 ============================================================================
  56
  57 @ grep '\n'
  58 # use ';' to replace '\n', it would not appeared in func def from cmd of 'set'.
  59 # after grep/sed, use tr to replace back.
  60
  61 @ incfile.shlib/imiload() with array
  62 # array in shadapt.shlib(replace [] with _)
  63 # multi-line initializer by string or array
  64 # imi load with ()/''/"" init by 'decl'.
  65
  66
  67 @ build-srcpkg
  68 # pkginit, tmpl
  69 = + .imi ==> .pkginfo
  70 # wiz
  71 = + load imi & .pkginfo, gen pkginfo.
  72 + install/init/autogen.shlib,
  73 + ui-cli.shlib/ui-tui.shlib
  74 + getval/setval/listval
  75 # pkgchk
  76 # cmpl bcfg & reglxgmr & ...
  77 # envchk(cmdlist/cmplr)
  78 # depchk(libpath/incpath/ex-cmpl)
  79 # zte
  80
  81
  82
  83 @ linestr.shlib
  84 # codegenµÄcatalogµÄitemÒÔ<N> [type]Îªhdr£¬Ö®ºóµÄsyntax¸ù¾Ýtype¶¨Òå¡£
  85 # linestr & param define in imi
  86 # linestr fmt defination by [type]
  87 @ fmt param define
  88
  89 @ imi/catalog general txt file loading
  90 @ param define for codegen
  91 # linestr(catanode)
  92 # dirnode
  93 # itemnode
  94 # elemnode
  95
  96 @ shlibinc(defination of inc/load)
  97 @ portable sh code(shadapt.shlib)
  98 # =~
  99 # ${XXX}
 100 # decl
 101 # array
 102
 103
 104
 105 @ construct
 106 # absolution to a function, so that it can be used in single script, or in
 107   build step.
 108 + .pkginfo
 109 + load compile param in build/dest/dest-<name>/
 110 + load toolchain param with cross info
 111 # *using shadapt.shlib in relative program
 112
 113 # subcmd of pkginit in 'srcpkg',
 114 # trim path & file info, store them into .imi. make it configurable.
 115
 116
 117
 118 ============================================================================
 119
 120 @ scripttest & codegen
 121 # unitteest integrating
 122 # testing invoke by list_curr_content()
 123 # test-item for build-srcpkg
 124 # code trim & figure doc for codegen/scripttest & srcpkg/cmpl/dev
 125 # load imi param should be putted in .catalog file
 126
 127 @ stdin file for testing
 128 # .stdout file to compare output content, add code to input from .stdin file as
 129   input file.
 130 # running item program with binary executables, such as DataAccess ==>
 131   DataAccess_test
 132
 133 @ srcpkg pkginit
 134 # --init-dir: dirs/files in doc/designdoc/2.xxx...
 135 # --install-build:
 136 + build-srcpkg trim
 137 + buildtype in dest.imi
 138 + buildprogtype: constructor/build-cmplib.shlib/cmplib.shlib/cmpl.sh
 139 + param at the beginning of cmpl.sh, buildprogtype/dir_buildsrcpkg/ ...
 140
 141 @ bin/features.md
 142 # srcpkg, devinfo/pkgwizard/pkginit/pkgchk/pkgreg
 143 # cmpl, doc/envchk/deplib/etz/genpkg
 144 # dev, codegen/scan
 145
 146
 147
 148 @ add param figure in schematic.uml
 149 # build/dev param trim
 150
 151 @ shlibinc & imi.shlib
 152 # use same skeletone to include/load/unload file.
 153 # regist file type with .shlib & func.
 154 # do file parsing work in imi.shlib.
 155 # use similar file processing code with catalog.shlib & incfile.shlib
 156
 157 @ attr.shlib & sh
 158 # modify src of sh, append envar char ':' in dual.
 159 # if '::' can be used in envar name, define 'attr' subcmd as NULL in imi.shlib.
 160
 161 @ std-sh-lization
 162 # bin/stdsh.md
 163 # misc sh ==> stdsh,
 164 # shlib ==> exe/loadbles
 165 # loadable exe. (exe -> sh -> loadable)
 166
 167 @ src/LangFeatureTesting
 168 # trim code
 169
 170
 171
 172
 173
 174
 175
 176
 177
 178
 179 @ for new features
 180 # is feature usefull
 181 # func interface & config file form is ok?
 182 # code can be better?
 183 # doc for code.