aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorChris Luke <chrisy@flirble.org>2016-09-14 12:42:54 -0400
committerDamjan Marion <dmarion.lists@gmail.com>2016-09-20 10:53:04 +0000
commit5ccbaa97a86715bfee2ab44523075a93a8abb698 (patch)
treeed6b0b9dd2a65e5fc557cd4f07623da2e41bb7b7
parenta8cd30937e5dc8a3bf629e1ee667550e267e5651 (diff)
Add structure to some of the documentation; VPP-223
Moves the random .md files, when rendered by Doxygen, into a config examples tree. We may later flesh this out into a more complete user documentation section. Change-Id: If423b82f1047f1c84f90876a786313054b5f7c77 Signed-off-by: Chris Luke <chrisy@flirble.org>
-rw-r--r--README.md5
-rw-r--r--doxygen/Makefile6
-rw-r--r--doxygen/user_doc.md10
-rw-r--r--plugins/ioam-plugin/ioam/ioam_plugin_doc.md (renamed from plugins/ioam-plugin/ioam/Readme.md)3
-rw-r--r--plugins/lb-plugin/lb_plugin_doc.md (renamed from plugins/lb-plugin/README.md)2
-rw-r--r--vnet/vnet/ipsec-gre/ipsec_gre_doc.md2
-rw-r--r--vnet/vnet/lldp/lldp_doc.md (renamed from vnet/vnet/lldp/lldp.md)2
-rw-r--r--vnet/vnet/map/map_doc.md2
8 files changed, 24 insertions, 8 deletions
diff --git a/README.md b/README.md
index ccc832c4..bf26c9de 100644
--- a/README.md
+++ b/README.md
@@ -27,7 +27,7 @@ Directory name | Description
g2 | Event log visualization tool
gmod | perf related?
perftool | Performance tool
- plugins | VPP bundled plugins directory
+@ref plugins | VPP bundled plugins directory
@ref svm | Shared virtual memory allocation library
test | Unit tests
@ref vlib | VPP application library source
@@ -90,5 +90,8 @@ for this can be found [on the Setting up Vagrant wiki page]
## More information.
+Several modules provide documentation, see @subpage user_doc for more
+information.
+
Visit the [VPP wiki](https://wiki.fd.io/view/VPP) for details on more
advanced building strategies and development notes.
diff --git a/doxygen/Makefile b/doxygen/Makefile
index 954191eb..0a69c2df 100644
--- a/doxygen/Makefile
+++ b/doxygen/Makefile
@@ -40,10 +40,14 @@ DOXY_SRC_DIRECTORIES = \
# Input directories and files
DOXY_INPUT ?= \
- README.md \
+ $(wildcard $(WS_ROOT)/*.md) \
+ $(wildcard $(DOXY_DIR)/*.md) \
$(DOXY_SRC_DIRECTORIES) \
plugins
+# Strip leading workspace path from input names
+DOXY_INPUT := $(subst $(WS_ROOT)/,,$(DOXY_INPUT))
+
# Files to exclude, from pre-Doxygen steps, eg because they're
# selectively compiled.
# Examples would be to exclude non-DPDK related sources when
diff --git a/doxygen/user_doc.md b/doxygen/user_doc.md
new file mode 100644
index 00000000..b08ac86a
--- /dev/null
+++ b/doxygen/user_doc.md
@@ -0,0 +1,10 @@
+User Configuration Examples {#user_doc}
+===========================
+
+Several modules provide operational documentation.
+
+- @subpage ipsec_gre_doc
+- @subpage map_doc
+- @subpage lldp_doc
+- @subpage ioam_plugin_doc
+- @subpage lb_plugin_doc
diff --git a/plugins/ioam-plugin/ioam/Readme.md b/plugins/ioam-plugin/ioam/ioam_plugin_doc.md
index 469a15a1..343abcf7 100644
--- a/plugins/ioam-plugin/ioam/Readme.md
+++ b/plugins/ioam-plugin/ioam/ioam_plugin_doc.md
@@ -1,5 +1,4 @@
-
-## VPP Inband OAM (iOAM)
+## VPP Inband OAM (iOAM) {#ioam_plugin_doc}
In-band OAM (iOAM) is an implementation study to record operational
information in the packet while the packet traverses a path between
diff --git a/plugins/lb-plugin/README.md b/plugins/lb-plugin/lb_plugin_doc.md
index 4effe533..c7885ffb 100644
--- a/plugins/lb-plugin/README.md
+++ b/plugins/lb-plugin/lb_plugin_doc.md
@@ -1,4 +1,4 @@
-# Load Balancer plugin for VPP
+# Load Balancer plugin for VPP {#lb_plugin_doc}
## Version
diff --git a/vnet/vnet/ipsec-gre/ipsec_gre_doc.md b/vnet/vnet/ipsec-gre/ipsec_gre_doc.md
index e9e5fdd9..e1bb9cda 100644
--- a/vnet/vnet/ipsec-gre/ipsec_gre_doc.md
+++ b/vnet/vnet/ipsec-gre/ipsec_gre_doc.md
@@ -1,4 +1,4 @@
-# VPP L2-GRE over IPsec implementation
+# VPP L2-GRE over IPsec implementation {#ipsec_gre_doc}
This is a memo intended to contain documentation of the VPP L2-GRE over IPsec implementation.
Everything that is not directly obvious should come here.
diff --git a/vnet/vnet/lldp/lldp.md b/vnet/vnet/lldp/lldp_doc.md
index 55de8f06..bac480a5 100644
--- a/vnet/vnet/lldp/lldp.md
+++ b/vnet/vnet/lldp/lldp_doc.md
@@ -1,4 +1,4 @@
-# VPP Link Layer Discovery Protocol (LLDP) implementation
+# VPP Link Layer Discovery Protocol (LLDP) implementation {#lldp_doc}
This is a memo intended to contain documentation of the VPP LLDP implementation
Everything that is not directly obvious should come here.
diff --git a/vnet/vnet/map/map_doc.md b/vnet/vnet/map/map_doc.md
index 230c52df..17f3c511 100644
--- a/vnet/vnet/map/map_doc.md
+++ b/vnet/vnet/map/map_doc.md
@@ -1,4 +1,4 @@
-# VPP MAP and Lw4o6 implementation
+# VPP MAP and Lw4o6 implementation {#map_doc}
This is a memo intended to contain documentation of the VPP MAP and Lw4o6 implementations.
Everything that is not directly obvious should come here.