Uh oh!
There was an error while loading. Please reload this page.
docs(help): document the 3.8.0 builtins, shadowing, and two fixes - #203
Merged
Merged
Conversation
Fourteen new function pages, plus the table, index and behavior updates
that go with the 3.8.0 engine work.
New pages
readfile, readlines, dirlist
rematch, refind, resubst
strjoin, strindexof, strlastindexof
arraysort, arrayunique, arrayreverse, arrayslice
Rewritten
push.md -- was documented as UNIMPLEMENTED. Corrected to the real
signature, push(value, array), matching the hand-written push() in
visualText/spec/UtilFuncs.nlp.
Table_of_Array_Functions.md -- the page held a single row, the
unimplemented push. Now lists the whole array family, and explains
how to test for an empty result: assigning an empty array collapses
it to no value and arraylength reports 1 for that, so a loop must be
guarded on the first element rather than on the count.
DECL.md -- a user function may now shadow a builtin of the same name.
regexp.md, regexpi.md -- cross-referenced to the real regular
expression functions, and the whole-token matching rule is now
written down: regexp("run") does NOT match "running". That was
undocumented and is an easy trap.
Table_of_File_Functions, Table_of_String_Functions and index.md pick up
the new entries. New_in_Current_Version records the three 3.8.0 items:
the new builtins, user functions shadowing builtins, and the str() fix
for negative numbers.
Engine side: VisualText/nlp-engine PRs #704 through #708.
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>Uh oh!
There was an error while loading. Please reload this page.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for freeto join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Help documentation for engine 3.8.0 — VisualText/nlp-engine #704 – #709, all merged.
14 new function pages
readfile,readlines,dirlistrematch,refind,resubststrjoin,strindexof,strlastindexofarraysort,arrayunique,arrayreverse,arraysliceCorrections to existing pages
push.mdwas documented as UNIMPLEMENTED. It now works, and the page carries the real signaturepush(value, array)— value first, matching the hand-writtenpush()long present invisualText/spec/UtilFuncs.nlp.Table_of_Array_Functions.mdheld exactly one row: the unimplementedpush. It now lists the whole array family and explains how to test for an empty result — assigning an empty array collapses it to no value andarraylengthreports 1 for that, so a loop must be guarded on the first element rather than the count.DECL.md— a user function may now shadow a builtin of the same name, with the warning it emits.regexp.md/regexpi.md— cross-referenced to the real regex functions, and the whole-token matching rule is now documented:regexp("run")does not matchrunning, andregexp("at")does not matchcat. That was undocumented and easy to trip over.Table_of_File_Functions,Table_of_String_Functionsandindex.mdpick up the new entries.New_in_Current_Versionrecords the three 3.8.0 items.All internal links in the new and edited pages were checked to resolve.
🤖 Generated with Claude Code