docs(CLI): the trunk allowed list is edited in place with add and remove #1822
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!1822
Loading…
Add table
Add a link
Reference in a new issue
No description provided.
Delete branch "docs/1117-0915"
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?
docs/CLI.mddocumentedswitchport trunk allowed vlan <list>andall, and nothing else. The console accepts two more forms and has for a while:switchport trunk allowed vlan add <list>andremove <list>(engine/cli.js, thetrunk/allowed/vlanbranch, #1455), which edit the list the port already carries;no switchport trunk allowed vlan, which restores the defaultall(Trunk on Fa0/1 allows all VLANs again).The console is emphatic about them: its own refusal for a bad word reads
% Unrecognized "banana": this console takes a list (10,20), a range (10-20), "all", "add <list>" or "remove <list>"� four forms, of which this page listed two.removeon a default trunk now subtracts and prints the remainder folded into ranges (#1749), which is documented in ARCHITECTURE.md but never reached the operator-facing reference.So this adds one section, with three transcripts that were each replayed into a real
generic-switchsession line for line: the add/remove receipts, the no-op answers (already allows VLANs 30: the list is unchanged (20,30),% VLANs 99 are not allowed ...), thenoform,remove 10on a default trunk answering1-9,11-1001,1006-4094, the quoted refusal, and the bareadd's% Incomplete commandline.Guards, before and after: syntax-check 383 files OK; docs-show-commands 52 show forms / 104 commands / 62 refusals (unchanged � the section introduces no new
showform); docs-cli-transcript 4 passed; help-completeness 8 passed; no-form-help-key 81 passed; help-key-works-in-every-prompt 10 tests.Out of scope here, and worth an engine change rather than a doc one: the
helpindex row still readsswitchport trunk allowed vlan <list|all>and omitsadd/remove, which is the same defect #1491 fixed for whole verbs, one level down.addandremove, and no page said so (#1749)