gloo 7.0.3 → 7.0.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d8c6f18a171f22ad2efb9354555f867568cc64baa563a09cad5909d3074eb55c
-  data.tar.gz: 69d44646d15c1054ea6693ae2ad8cd9a10513ce258ca83703a5af0120da9ed97
+  metadata.gz: 0f84c9907a97353612993852efc46b6880b119c962b785da1c43326f1d0710b3
+  data.tar.gz: 6582c120e0b04e9daaa3be9d70002d407f778b045fa668f87ca20fae68b22218
 SHA512:
-  metadata.gz: 0b8c7c819ae9660f35bf1e8f1a6c93be762d8c94d1aef8a05828d0d57fa40d6415e567d9e9ef0bbf630e14cda7c6546616ed8a0c99e5d6b9d0a05daf6d1ddf29
-  data.tar.gz: 59f620d96fe5c1cf35b3e461c5dcd690bffd069b94da9e742927b8e40d934bbcfc9dc4b23c9a1d7018d67b67f3c7212cb39244c80d95c618b4bb1f8037e9e9ef
+  metadata.gz: 5ad11f0ed9bec1122fc796920029ee5b1bdea8dee0e3aecdedefd85241de70ff1f52e8fb893726d6fd135a0e86588aac44ab6598d2a3b6f071f61c2411281adc
+  data.tar.gz: ec26f94681a480a42bf9cf21ca7668de7896eba9937a731d501c1ca2a5998fe12dc08b26e9452c9aeafbee59f2eb3e21b1599af8e3211f8e5baa593d232a3146

data/docs/language_objects.md

@@ -106,6 +106,9 @@ floating comment in the file instead. When a name is declared in more
 than one loaded file, the first non-empty doc wins (same rule as the
 first value).
 
+A doc belongs to its object: when the object is moved, extracted, or
+deleted, its doc comment goes with it (see Verbs, Load & Save).
+
 `list` can show every documented object in a listed tree: turn on the
 `list_docs` setting (off by default) — see `list` and `settings` in the
 in-app help.

data/docs/verbs.md

@@ -99,6 +99,12 @@ If the name can't be resolved to a file, `load` reports `File '{name}' was not f
 
 A save is a **rewrite, not a regeneration**: comments, blank lines, and the original spacing are kept, and only the values you actually changed are re-written. A declaration you never touched comes back byte-for-byte.
 
+What counts as a change is narrow: an object is changed when its value is set, or when it is created, moved (`move`, or extracted with `save … to`), or deleted (for example with `unload`); everything else is untouched and comes back exactly as written, wherever it lives. Adding, moving, or removing an object's children doesn't change the object itself: its own declaration stays as it was, and only the children's lines appear, move, or disappear.
+
+An object's doc comment goes wherever the object goes: it moves with a moved or extracted object and disappears with a deleted one.
+
+A save never loses or alters data: loading the saved files again gives back the same objects, with the same values and docs, under the same parents. The interpreter decides how a changed or new declaration is laid out; only what it says has to come back the same.
+
 `save {obj} to {path}` doesn't just write a copy — `obj` stops being declared in its old file, wherever that was. Given `app.core.settings` declared inside `app.gloo`, `save app.core.settings to config/settings` leaves `app.gloo` without a `settings` subtree and writes `config/settings.gloo` with `app.core.settings [can] : ...` at the top level (the `app`/`core` prefix is implied via nested-container shorthand, not repeated as nested declarations) plus everything `settings` owns underneath, comments included. An object with no file of its own yet (brand new, or nested under an object that's never been saved) is simply written fresh — nothing to move.
 
 If `obj`'s own subtree already has declarations spread across more than one file (the namespace-merge pattern below, applied *inside* the subtree being extracted, not just above it), extraction refuses rather than guessing which file's slice is authoritative — save each contributing file on its own first.

data/lib/VERSION

@@ -1 +1 @@
-7.0.3
+7.0.4

data/lib/VERSION_NOTES

@@ -1,3 +1,7 @@
+7.0.4 - 2026.10.19
+ - Documentation update.
+
+
 7.0.3 - 2026.10.15
  - Removes test dependency on gloo-beep.
 

data/lib/gloo/verbs/save.rb

@@ -96,6 +96,10 @@ module Gloo
             'state. This is a rewrite, not a regeneration: comments, ' \
             'blank lines, and the original formatting are preserved, ' \
             'and only values that actually changed are re-written. ' \
+            'A declaration you never touched comes back byte-for-byte. ' \
+            'An object counts as changed only when its value is set or ' \
+            'it is created, moved, or deleted (its doc comment goes with ' \
+            'it); changes to its children do not change it. ' \
             'With a path, the object also stops being declared in its ' \
             'old file (if it had one) -- both files are rewritten ' \
             'together.',

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: gloo
 version: !ruby/object:Gem::Version
-  version: 7.0.3
+  version: 7.0.4
 platform: ruby
 authors:
 - Eric Crane
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-10-15 00:00:00.000000000 Z
+date: 2026-10-19 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler