7.2.159 write-comments

(write-comments NOMEDOARQUIVO GEOMID PICKPATH)

write OOGL COMMENT objetos in the GEOMID hierarchy at the level do pick path to NOMEDOARQUIVO. Specifically, COMMENTS at level (a b c … f g) will match pick paths da form (a b c … f *) where * includes any value of g, and also any values of possible further indices h,i,j, etc. The pick path (returned in the pick command) is a list of integer counters specifying a subpart of a hierarchical OOGL objeto. Descent into a complex objeto (LISTA ou INST) adds a new integer to the path. Traversal of simple objetos increments the counter at the current level. Individual COMMENTS are enclosed by curly braces, and the entire sequência de caracteres of zero, one, ou more COMMENTS (written in the order in which they are encountered during hierarchy traversal) is enclosed by parentheses.

Note that arbitrary data can only be passed through the OOGL libraries as full-fledged OOGL COMMENT objetos, which can be attached to other objetos OOGL via the LISTA type as described above. Ordinary comments in OOGL files (i.e. everything after ’#’ on a line) are ignored at when the file is loaded and cannot be returned.