docs(CLI): the trunk's third verb joins the list of forms the page says the console takes #2053
No reviewers
Labels
No milestone
No project
No assignees
1 participant
Notifications
Due date
No due date set.
Dependencies
No dependencies set.
Reference
jaylouisw/packetforge!2053
Loading…
Add table
Add a link
Reference in a new issue
No description provided.
Delete branch "docs/1118-2347"
Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?
Doc:
docs/CLI.md, the paragraph under "helpis an index, and a test reads it out of the parser".What was untrue. That paragraph enumerates what the console takes beyond the index row
switchport trunk allowed vlan <list|all>; it named onlyadd <list>andremove <list>and closed with "Both are accepted by the console today". Since #2038 the console also takesexcept <list>, a verb that replaces the list instead of editing it, and the parser's own refusal names it:this console takes a list (10,20), a range (10-20), "all", "add <list>", "except <list>" or "remove <list>"(engine/cli.js:3199-3203). The same page documentsexceptas "the third verb" in "A trunk's allowed list is edited in place", so the two paragraphs contradicted each other. #2038 updateddocs/ARCHITECTURE.mdand missed this one.Evidence from the code.
generic-switch,Fa0/1in trunk mode:The
_help()row is stillswitchport trunk allowed vlan <list|all>, so the gap between the index and the parser is real and is still the code's to close; the page now records all three verbs.Guards (before == after; prose-only).
scripts/syntax-check.js430 files OK;check-control-bytesclean;docs-cli-transcript4/0;docs-show-commands7/0 (59 forms, 118 commands, 74 refusals);help-completeness8/0 (102 advertised commands, 19 mechanisms, 16 shows);help-key-is-not-a-value40/0;no-form-help-key81/0;help-key-works-in-every-prompt10 pass, 0 fail.Docs-only; no code touched. Not done here: the
helpindex still lacksexcept <list>andlink state <linkId>, both accepted at the console — the index is the code's to complete.