aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
-rw-r--r--docs/gettingstarted/developers/index.rst1
l---------docs/gettingstarted/developers/punt.rst1
-rwxr-xr-xdocs/scripts/prepare-for-site.sh18
-rw-r--r--doxygen/dev_doc.md1
-rw-r--r--doxygen/doxygen.cfg2
-rw-r--r--src/examples/handoffdemo/README.md2
-rw-r--r--src/vnet/ip/punt.rst (renamed from src/vnet/ip/punt.md)21
7 files changed, 33 insertions, 13 deletions
diff --git a/docs/gettingstarted/developers/index.rst b/docs/gettingstarted/developers/index.rst
index 4f2c38d130a..fe265786e24 100644
--- a/docs/gettingstarted/developers/index.rst
+++ b/docs/gettingstarted/developers/index.rst
@@ -38,3 +38,4 @@ The Developers section covers the following areas:
eventviewer
fib20/index.rst
buildwireshark
+ punt
diff --git a/docs/gettingstarted/developers/punt.rst b/docs/gettingstarted/developers/punt.rst
new file mode 120000
index 00000000000..0a56632f671
--- /dev/null
+++ b/docs/gettingstarted/developers/punt.rst
@@ -0,0 +1 @@
+../../../src/vnet/ip/punt.rst \ No newline at end of file
diff --git a/docs/scripts/prepare-for-site.sh b/docs/scripts/prepare-for-site.sh
new file mode 100755
index 00000000000..15888ba6e83
--- /dev/null
+++ b/docs/scripts/prepare-for-site.sh
@@ -0,0 +1,18 @@
+#!/bin/bash
+
+if [ ! -d "docs" ]; then
+ echo "This script is meant to be run from the root directory"
+ exit 1;
+fi
+
+for f in $(find ./docs -type l)
+do
+ target=$(readlink $f)
+ rm $f
+ cp $(dirname $f)/$target $(dirname $f)/$(basename $target)
+ echo "Replaced symlink $f"
+done
+
+echo "Cleaning doc build directory"
+make docs-clean
+
diff --git a/doxygen/dev_doc.md b/doxygen/dev_doc.md
index 2e452d0f926..00f6caedf49 100644
--- a/doxygen/dev_doc.md
+++ b/doxygen/dev_doc.md
@@ -16,3 +16,4 @@ Programming notes for developers.
- @subpage stats_doc
- @subpage if_stats_client_doc
- @subpage api_lang_doc
+- @subpage handoff_queue_demo_plugin \ No newline at end of file
diff --git a/doxygen/doxygen.cfg b/doxygen/doxygen.cfg
index 39a918f5736..08356f40bce 100644
--- a/doxygen/doxygen.cfg
+++ b/doxygen/doxygen.cfg
@@ -622,7 +622,7 @@ STRICT_PROTO_MATCHING = NO
# list. This list is created by putting \todo commands in the documentation.
# The default value is: YES.
-GENERATE_TODOLIST = YES
+GENERATE_TODOLIST = NO
# The GENERATE_TESTLIST tag can be used to enable (YES) or disable (NO) the test
# list. This list is created by putting \test commands in the documentation.
diff --git a/src/examples/handoffdemo/README.md b/src/examples/handoffdemo/README.md
index 3787731c73f..e38c7b3cca0 100644
--- a/src/examples/handoffdemo/README.md
+++ b/src/examples/handoffdemo/README.md
@@ -1,4 +1,4 @@
-# Handoff queue demo plugin
+# Handoff queue demo plugin {#handoff_queue_demo_plugin}
This plugin provides a simplified example of how to hand off
packets between threads. I used it to debug packet-tracer handoff
diff --git a/src/vnet/ip/punt.md b/src/vnet/ip/punt.rst
index 2bbb5f6b97e..3f1a9d4a844 100644
--- a/src/vnet/ip/punt.md
+++ b/src/vnet/ip/punt.rst
@@ -1,10 +1,10 @@
-.. _punt:
+.. _dev_punt:
+
+.. toctree::
Punting Packets
===============
-.. toctree::
-
Overview
________
@@ -17,8 +17,8 @@ A popular meaning of punt is to send packets to the user/control-plane.
This is specific option of the more general case above, where VPP is
handing the packet to the control-plane for further prosessing.
-The Punt Infrastructe
----------------------
+The Punt Infrastructure
+_______________________
Exception packets are those that a given node cannot handle via normal
mecahnisms.
@@ -37,7 +37,7 @@ that the source node would otherise drop.
Punting to the Control Plane
-----------------------------
+____________________________
Active Punt
-----------
@@ -47,11 +47,10 @@ want to receive and this is where I want it sent.
Currently there exists 3 ways to describe how to match/classify the
packets to be punted:
-...
- 1) a matching UDP port
- 2) a matching IP protocol (i.e. OSPF)
- 3) a matching punt excpetion reason (see above)
-...
+
+1) a matching UDP port
+2) a matching IP protocol (i.e. OSPF)
+3) a matching punt excpetion reason (see above)
Depending on the type/classification of the packet to be punted, that
active punt will register itself into the VLIB graph to receive those