docs(CLI): show interfaces status inactive is not a command - the port's own status line is where inactive is reported #1597
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!1597
Loading…
Add table
Add a link
Reference in a new issue
No description provided.
Delete branch "docs/1116-0345"
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?
The paragraph under Reading
show ip interface briefsaid that the device "lists such ports undershow interfaces status inactive". There is no such command, and the console says so in its own words:inactiveexists only as a reason on a port's ownshow interfacesblock —status: down (inactive)— which the same paragraph already lists. The sentence now says that, and stops advertising a spelling the parser refuses.Second drift fixed by the same line: the guard paragraph (
## Everyshowform on this page is typed by a test) claims "47 forms, 94 commands today".test/docs-show-commands.test.jsenumerated 48 forms and typed 96 commands, because it read this phantom row as a form. With the row gone the measured counts are 47 and 94 again and the sentence is true — no edit to the test was needed.Guards (before → after):
test/doc-catalog-counts.test.jstest/docs-show-commands.test.jstest/help-completeness.test.jstest/help-key-works-in-every-prompt.test.jsscripts/syntax-check.jsscripts/check-control-bytes.jsNot fixed here (code, not docs):
docs-show-commandsaccepts any refusal that is a sentence longer than 12 characters and does not begin% Invalid show/% Unrecognized/% Unknown show. "this console has noshow interfaces status inactive" is a complaint about the command, not about the device, so the phantom row passed the guard ever since #1568.show interfaces status inactiveis not a command, and the port's own status line is whereinactiveis reported (#1568)The paragraph under *Reading `show ip interface brief`* said the device "lists such ports under `show interfaces status inactive`". The console has no such view and says so itself: show interfaces status inactive % `status inactive` is a view, not a port: this console has no `show interfaces status inactive`. `show interfaces` prints every port's status and protocol, one block each. `inactive` exists only as a reason inside a port's `show interfaces` block, which the same paragraph already lists. So the sentence now says that, and the phantom spelling leaves the page. Removing it also puts the guard paragraph's count back in step with the test that enforces it (`test/docs-show-commands.test.js`): 47 forms, 94 commands, as that paragraph claims — the phantom had made it 48 and 96 without the number being told.68f07b2996a8c2a69a7c