[#2750] add makefile rule for ascii umls

* also adds tkey.atxt and update.atxt sequence diagrams in ASCII art,
  although not actively used anywhere yet
* also adds a uml rule to make all targets

diff --git a/doc/sphinx/Makefile.am b/doc/sphinx/Makefile.am
index 1eea0d551bbdc41d8d7ad8210e82f862a194324f..62cf7490d788480e3e8182df6eb1cec626367170 100644 (file)
--- a/doc/sphinx/Makefile.am
+++ b/doc/sphinx/Makefile.am
@@ -145,14 +145,19 @@ svgs += uml/tkey.svg
 svgs += uml/update.svg
 
 if HAVE_PLANTUML
+uml: uml-to-png uml-to-svg format-svgs uml-to-txt
+
 uml-to-png: $(umls)
-       @PLANTUML@ $^
+       @PLANTUML@ -tpng $^
 
 uml-to-svg: $(umls)
-       @PLANTUML@ -svg $^
+       @PLANTUML@ -tsvg $^
 
 format-svgs: $(svgs)
        for svg in $(svgs); do xq -x . $$svg > tmp; mv tmp $$svg; done
+
+uml-to-txt: $(umls)
+       @PLANTUML@ -ttxt $^
 endif
 
 EXTRA_DIST += $(umls)
@@ -201,7 +206,7 @@ clean-local:
        rm -f $(srcdir)/kea-messages.rst $(srcdir)/api.rst
        rm -f $(srcdir)/arm/platforms.rst
 
-.PHONY: all pdf html mans update-python-dependencies uml-to-png uml-to-svg format-svgs
+.PHONY: all pdf html mans update-python-dependencies uml uml-to-png uml-to-svg format-svgs uml-to-txt
 
 endif
 

diff --git a/doc/sphinx/uml/tkey.atxt b/doc/sphinx/uml/tkey.atxt
new file mode 100644 (file)
index 0000000..f348aee
--- /dev/null
+++ b/doc/sphinx/uml/tkey.atxt
@@ -0,0 +1,13 @@
+         TKEY Exchange (GSS-TSIG hook)
+
+     ,-------------.          ,----------.
+     |Kea D2 server|          |DNS server|
+     `------+------'          `----+-----'
+            |     TKEY request     |
+            |---------------------->
+            |                      |
+            |TKEY response (signed)|
+            |<----------------------
+     ,------+------.          ,----+-----.
+     |Kea D2 server|          |DNS server|
+     `-------------'          `----------'

diff --git a/doc/sphinx/uml/update.atxt b/doc/sphinx/uml/update.atxt
new file mode 100644 (file)
index 0000000..f5d1b02
--- /dev/null
+++ b/doc/sphinx/uml/update.atxt
@@ -0,0 +1,13 @@
+         DNS Update Exchange (GSS-TSIG hook)
+
+     ,-------------.                ,----------.
+     |Kea D2 server|                |DNS server|
+     `------+------'                `----+-----'
+            |DNS update request (signed) |
+            |---------------------------->
+            |                            |
+            |DNS update response (signed)|
+            |<----------------------------
+     ,------+------.                ,----+-----.
+     |Kea D2 server|                |DNS server|
+     `-------------'                `----------'