docs: better docs, mv doxygen to sphinx

[vpp.git] / docs / cli-reference / interface / create_interface.rst

diff --git a/docs/reference/cmdreference/interface/create_interface.rst b/docs/cli-reference/interface/create_interface.rst
similarity index 93%
rename from docs/reference/cmdreference/interface/create_interface.rst
rename to docs/cli-reference/interface/create_interface.rst
index fa50c6a..abd1f40 100644 (file)
--- a/docs/reference/cmdreference/interface/create_interface.rst
+++ b/docs/cli-reference/interface/create_interface.rst
@@ -15,10 +15,11 @@ This section contains those interface commands that are associated to creating a
 
 Create Host-Interface
 ++++++++++++++++++++++
-Summary/Usage
--------------
 
-create host-interface name <*ifname*> [*hw-addr <*mac-addr*>]
+.. code-block:: console
+
+    create host-interface name <*ifname*> [*hw-addr <*mac-addr*>]
+
 
 Description
 ------------
@@ -59,10 +60,10 @@ Declaration and Implementation
 Create Interface Memif
 +++++++++++++++++++++++
 
-Summary/Usage
--------------
+.. code-block:: console
+
+    create interface memif [id <*id*>] [socket-id <*socket-id*>] [ring-size <*size*>] [buffer-size <*size*>] [hw-addr <*mac-address*>] <master|slave> [rx-queues <*number*>] [tx-queues <*number*>] [mode ip] [secret <*string*>]
 
-create interface memif [id <*id*>] [socket-id <*socket-id*>] [ring-size <*size*>] [buffer-size <*size*>] [hw-addr <*mac-address*>] <master|slave> [rx-queues <*number*>] [tx-queues <*number*>] [mode ip] [secret <*string*>]
 
 Declaration and Implementation
 -------------------------------
@@ -75,15 +76,13 @@ Declaration and Implementation
 Create Loopback Interface
 ++++++++++++++++++++++++++
 
-Summary/Usage
---------------
 
-create loopback interface [mac <*mac-addr*>] [instance <*instance*>]
+Create a loopback interface. Optionally, a MAC Address can be provided. If not provided, de:ad:00:00:00:<*loopId*> will be used.
 
-Description
-------------
+.. code-block:: console
+
+    create loopback interface [mac <*mac-addr*>] [instance <*instance*>]
 
-Create a loopback interface. Optionally, a MAC Address can be provided. If not provided, de:ad:00:00:00:<*loopId*> will be used.
 
 Example Usage
 --------------
@@ -118,7 +117,7 @@ and *subId* (subinterface Id) parameters. If no additional VLAN ID is
 provide, the VLAN ID is assumed to be the *subId*. The VLAN ID and
 *subId* can be different, but this is not recommended.
 
-This command has several variations: 
+This command has several variations:
 
 -  **create sub-interfaces** <*interface*> <*subId*> - Create a subinterface
    to process packets with a given 802.1q VLAN ID (same value as the
@@ -221,4 +220,4 @@ When subinterfaces are created, they are in the down state. Example of how to en
 .. code-block:: console
 
     vpp# set interface GigabitEthernet2/0/0.7 up
-        
+