@yuneta/gobj-ui 7.23.169 → 7.23.171

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -1888,9 +1888,33 @@ source read the same:
1888
1888
  | `(↖)` | 1 fkey — 1 parent |
1889
1889
  | `[↖]` | n fkeys — n parents |
1890
1890
  | `{↖}` | N fkeys — N parents |
1891
+ | `(2)` | a secondary key (`pkey2s`) — the name is bold, like the pkey's |
1892
+ | `(t)` | the time key (`tkey`) |
1891
1893
  | `*` | required |
1892
1894
  | `#` | the primary key |
1893
1895
 
1896
+ The key marks come first in the mark column, because they change what a record
1897
+ of the topic is. A field that is a pkey2 and an fkey reads `(2) (↖)`. The
1898
+ `(t)` mark is new to the notation, and the legends of the `.c` literals carry
1899
+ it too. For example, `binaries.version` in `treedb_yuneta_agent` is declared
1900
+ like this:
1901
+
1902
+ ```C
1903
+ 'topic_name': 'binaries',
1904
+ 'pkey': 'id',
1905
+ 'tkey': '',
1906
+ 'pkey2s': 'version',
1907
+ ```
1908
+
1909
+ and its card draws the row `version (2)`. An empty `tkey` marks no field.
1910
+
1911
+ The topic cards (`C_YUI_TREEDB_TOPICS`) and its topic-info panel say the same
1912
+ keys. A card of a topic with `pkey2s` has a `pkey2s` line under its version and
1913
+ column count. The info panel always has a `tkey` row, which says *append time*
1914
+ when the topic has none, a `pkey2s` row when the topic has secondary keys, and
1915
+ `system` by the flag names (`sf_string_key`), not by the number. In its column
1916
+ table, the *key* cell of a key field says `pkey`, `pkey2` or `tkey`.
1917
+
1894
1918
  `dict` and `object` are one shape and `list` and `array` are another, exactly
1895
1919
  as tr_treedb's hook/fkey switches treat them. A self-referent hook (a tree)
1896
1920
  draws as a loop.