summaryrefslogtreecommitdiff
path: root/docs/coverage.rst
blob: 1fb9a1531a1a2821f4d30b2cffc6530321c7f390 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
########
Coverage
########

Overview over all commands, which are documented in the
``.. cfgcmd::`` or ``.. opcmd::`` Directives.

The build process take all xml definition files
from `vyos-1x <https://github.com/vyos/vyos-1x>`_  and a periodical export of
all VyOS commands and extract each leaf command or executable command.
After this the commands are compare and shown in
the following two tables. The script compare only the fixed part of a command.
All varables or values will be erase and then compare:

for example there are these two commands:

  * documentation: ``interfaces ethernet <interface> address
    <address | dhcp | dhcpv6>``
  * xml: ``interfaces ethernet <ethernet> address <address>``
  * VyOS: ``interfaces ethernet <text> address <value>``

Now the script earse all in between ``<`` and ``>`` and simply compare
the strings.

**There are 3 kind of problems:**   

``Not documented yet``

  * A XML command are not found in ``.. cfgcmd::`` or ``.. opcmd::`` Commands
  * The command should be documented

``Nothing found in XML Definitions``

  * ``.. cfgcmd::`` or ``.. opcmd::`` Command are not found in a XML command
  * Maybe the command where changed in the XML Definition, the feature is
    not anymore in VyOS, or there is a typo

``Nothing found in VyOS``

  * ``.. cfgcmd::`` or ``.. opcmd::`` Command are not found in a VyOS command
  * Maybe the command where changed, the feature is
    not anymore in VyOS, or there is a typo


Configuration Commands
======================

.. cfgcmdlist::
    :show-coverage:


Operational Commands
====================

.. opcmdlist::
    :show-coverage: