[ovs-dev] [PATCH v2 06/11] doc: Further populate the 'howto' section

Stephen Finucane stephen at that.guru
Thu Dec 8 12:55:25 UTC 2016


There are a couple of references to these for various build systems.
The website is going to be our "one true resource" for all docs, so
simply remove these references.

Signed-off-by: Stephen Finucane <stephen at that.guru>
---
 Documentation/automake.mk                                  |  4 ++++
 Documentation/howto/index.rst                              |  8 ++++++++
 README-lisp.rst => Documentation/howto/lisp.rst            |  0
 .../howto/native-tunneling.rst                             |  0
 .../howto/openstack-containers.rst                         | 10 +++++-----
 vtep/README.ovs-vtep.rst => Documentation/howto/vtep.rst   | 14 +++++++-------
 Makefile.am                                                |  2 --
 ofproto/ofproto-tnl-unixctl.man                            |  3 +--
 ovn/automake.mk                                            |  1 -
 rhel/openvswitch.spec.in                                   |  2 +-
 utilities/ovs-sim.1.xml                                    |  6 +++---
 vtep/automake.mk                                           |  1 -
 12 files changed, 29 insertions(+), 22 deletions(-)
 rename README-lisp.rst => Documentation/howto/lisp.rst (100%)
 rename README-native-tunneling.rst => Documentation/howto/native-tunneling.rst (100%)
 rename ovn/CONTAINERS.OpenStack.rst => Documentation/howto/openstack-containers.rst (96%)
 rename vtep/README.ovs-vtep.rst => Documentation/howto/vtep.rst (95%)

diff --git a/Documentation/automake.mk b/Documentation/automake.mk
index 50e9808..2622f83 100644
--- a/Documentation/automake.mk
+++ b/Documentation/automake.mk
@@ -28,6 +28,10 @@ EXTRA_DIST += \
 	Documentation/howto/libvirt.rst \
 	Documentation/howto/selinux.rst \
 	Documentation/howto/ssl.rst \
+	Documentation/howto/native-tunneling.rst \
+	Documentation/howto/lisp.rst \
+	Documentation/howto/openstack-containers.rst \
+	Documentation/howto/vtep.rst
 	Documentation/ref/index.rst \
 	Documentation/faq/index.rst \
 	Documentation/internals/index.rst
diff --git a/Documentation/howto/index.rst b/Documentation/howto/index.rst
index 81b2931..fe85a34 100644
--- a/Documentation/howto/index.rst
+++ b/Documentation/howto/index.rst
@@ -37,4 +37,12 @@ topics covered herein, refer to :doc:`/topics/index`.
    selinux
    libvirt
    ssl
+   lisp
+   native-tunneling
+   vtep
+
+.. toctree::
+   :maxdepth: 1
+
    docker
+   openstack-containers
diff --git a/README-lisp.rst b/Documentation/howto/lisp.rst
similarity index 100%
rename from README-lisp.rst
rename to Documentation/howto/lisp.rst
diff --git a/README-native-tunneling.rst b/Documentation/howto/native-tunneling.rst
similarity index 100%
rename from README-native-tunneling.rst
rename to Documentation/howto/native-tunneling.rst
diff --git a/ovn/CONTAINERS.OpenStack.rst b/Documentation/howto/openstack-containers.rst
similarity index 96%
rename from ovn/CONTAINERS.OpenStack.rst
rename to Documentation/howto/openstack-containers.rst
index 2934d1c..f10f60e 100644
--- a/ovn/CONTAINERS.OpenStack.rst
+++ b/Documentation/howto/openstack-containers.rst
@@ -45,10 +45,10 @@ example.
 
 * When VM-A is created on a hypervisor, its VIF gets added to the Open vSwitch
   integration bridge.  This creates a row in the Interface table of the
-  ``Open_vSwitch`` database.  As explained in the `integration guide
-  <IntegrationGuide.rst>`__, the vif-id associated with the VM network
-  interface gets added in the ``external_ids:iface-id`` column of the newly
-  created row in the Interface table.
+  ``Open_vSwitch`` database.  As explained in the `integration guide`, the
+  vif-id associated with the VM network interface gets added in the
+  ``external_ids:iface-id`` column of the newly created row in the Interface
+  table.
 
 * Since VM-A belongs to a logical network, it gets an IP address.  This IP
   address is used to spawn containers (either manually or through container
@@ -102,7 +102,7 @@ example.
 
 * When a container is eventually deleted, the network plugin in that VM may
   make a call to Neutron to delete that port.  Neutron in turn will delete the
-  entry in the Logical_Switch_Port table of the OVN Northbound Database.
+  entry in the ``Logical_Switch_Port`` table of the OVN Northbound Database.
 
 As an example, consider Docker containers.  Since Docker currently does not
 have a network plugin feature, this example uses a hypothetical wrapper around
diff --git a/vtep/README.ovs-vtep.rst b/Documentation/howto/vtep.rst
similarity index 95%
rename from vtep/README.ovs-vtep.rst
rename to Documentation/howto/vtep.rst
index 668ee08..6a52024 100644
--- a/vtep/README.ovs-vtep.rst
+++ b/Documentation/howto/vtep.rst
@@ -36,12 +36,12 @@ The VTEP emulator is a Python script that invokes calls to tools like vtep-ctl
 and ovs-vsctl. It is only useful when Open vSwitch daemons like ovsdb-server
 and ovs-vswitchd are running and installed. To do this, either:
 
-- Follow the instructions in ``Documentation/intro/install/general`` (don't
-  start any daemons yet).
+- Follow the instructions in :doc:`/intro/install/general` (don't start any
+  daemons yet).
 
-- Follow the instructions in ``Documentation/intro/install/debian`` and then
-  install the ``openvswitch-vtep`` package (if operating on a debian based
-  machine).  This will automatically start the daemons.
+- Follow the instructions in :doc:`/intro/install/debian` and then install the
+  ``openvswitch-vtep`` package (if operating on a debian based machine).  This
+  will automatically start the daemons.
 
 Design
 ------
@@ -152,8 +152,8 @@ using the debian packages as mentioned in step 2 of the "Requirements" section.
        $ vtep-ctl set Physical_Switch br0 tunnel_ips=10.2.2.1
 
 6. Start the VTEP emulator. If you installed the components following
-   ``Documentation/intro/install/general``, run the following from the same
-   directory as this README:
+   :doc:`/intro/install/general`, run the following from the ``vtep``
+   directory:
 
    ::
 
diff --git a/Makefile.am b/Makefile.am
index df42149..3579ac1 100644
--- a/Makefile.am
+++ b/Makefile.am
@@ -75,8 +75,6 @@ docs = \
 	OPENFLOW.rst \
 	PORTING.rst \
 	README.rst \
-	README-lisp.rst \
-	README-native-tunneling.rst \
 	WHY-OVS.rst
 EXTRA_DIST = \
 	$(docs) \
diff --git a/ofproto/ofproto-tnl-unixctl.man b/ofproto/ofproto-tnl-unixctl.man
index 7767197..c70cca5 100644
--- a/ofproto/ofproto-tnl-unixctl.man
+++ b/ofproto/ofproto-tnl-unixctl.man
@@ -1,6 +1,5 @@
 .SS "OPENVSWITCH TUNNELING COMMANDS"
-These commands query and modify OVS tunnel components. Ref to
-README-native-tunneling.rst for more info.
+These commands query and modify OVS tunnel components.
 .
 .IP "\fBovs/route/add ipv4_address/plen output_bridge [GW]\fR"
 Adds ipv4_address/plen route to vswitchd routing table. output_bridge
diff --git a/ovn/automake.mk b/ovn/automake.mk
index 3bcc1d5..7465f8e 100644
--- a/ovn/automake.mk
+++ b/ovn/automake.mk
@@ -72,7 +72,6 @@ DISTCLEANFILES += ovn/ovn-architecture.7
 
 EXTRA_DIST += \
 	ovn/TODO.rst \
-	ovn/CONTAINERS.OpenStack.rst \
 	ovn/OVN-GW-HA.rst
 
 # Version checking for ovn-nb.ovsschema.
diff --git a/rhel/openvswitch.spec.in b/rhel/openvswitch.spec.in
index d03588c..8484626 100644
--- a/rhel/openvswitch.spec.in
+++ b/rhel/openvswitch.spec.in
@@ -249,7 +249,7 @@ exit 0
 /usr/share/openvswitch/vswitch.ovsschema
 /usr/share/openvswitch/vtep.ovsschema
 %doc COPYING DESIGN.rst NOTICE README.rst WHY-OVS.rst FAQ.rst NEWS
-%doc rhel/README.RHEL.rst README-native-tunneling.rst
+%doc rhel/README.RHEL.rst
 /var/lib/openvswitch
 /var/log/openvswitch
 
diff --git a/utilities/ovs-sim.1.xml b/utilities/ovs-sim.1.xml
index 0430e73..62ac22b 100644
--- a/utilities/ovs-sim.1.xml
+++ b/utilities/ovs-sim.1.xml
@@ -143,7 +143,7 @@ utilities/ovs-sim
         </p>
 
         <pre>
-sim_add hv0           # Create sandbox hv0.  
+sim_add hv0           # Create sandbox hv0.
 as hv0                # Set hv0 as default sandbox.
 ovs-vsctl add-br br0  # Add bridge br0 inside hv0.
         </pre>
@@ -157,8 +157,8 @@ ovs-vsctl add-br br0  # Add bridge br0 inside hv0.
           default <code>system</code> type of bridges and interfaces are
           replaced by <code>dummy</code> devices.  Other types of devices,
           however, retain their usual functions, which means that, e.g.,
-          <code>vxlan</code> tunnels still act as tunnels (see
-          <code>README-native-tunneling.rst</code>).
+          <code>vxlan</code> tunnels still act as tunnels (refer to the
+          documentation).
         </p>
       </dd>
 
diff --git a/vtep/automake.mk b/vtep/automake.mk
index 6a98144..4e284d3 100644
--- a/vtep/automake.mk
+++ b/vtep/automake.mk
@@ -40,7 +40,6 @@ vtep_vtep_ctl_LDADD = vtep/libvtep.la lib/libopenvswitch.la
 scripts_SCRIPTS += \
     vtep/ovs-vtep
 
-docs += vtep/README.ovs-vtep.rst
 EXTRA_DIST += vtep/ovs-vtep
 
 FLAKE8_PYFILES += vtep/ovs-vtep
-- 
2.9.3



More information about the dev mailing list