diff --git a/Makefile b/Makefile
index 5bbeba9..bfc87b7 100644
--- a/Makefile
+++ b/Makefile
@@ -192,7 +192,8 @@ genconf_parameters.sample: xpp/genconf_parameters
 	cp $< $@
 
 README.html: README system.conf.asciidoc init.conf.asciidoc tonezones.txt \
-  UPGRADE.txt genconf_parameters.asciidoc
+  UPGRADE.txt genconf_parameters.asciidoc assigned-spans.conf.asciidoc \
+  span-types.conf.asciidoc
 	$(ASCIIDOC) -n -a toc -a toclevels=3 $<
 
 README.Astribank.html: xpp/README.Astribank
diff --git a/README b/README
index 29ef174..d660f34 100644
--- a/README
+++ b/README
@@ -133,6 +133,16 @@ FIXME: still not properly formatted.
 include::genconf_parameters.asciidoc[]
 
 
+Sample assigned-spans.conf
+~~~~~~~~~~~~~~~~~~~~~~~~~~
+include::assigned-spans.conf.asciidoc[]
+
+
+Sample span-types.conf
+~~~~~~~~~~~~~~~~~~~~~~
+include::span-types.conf.asciidoc[]
+
+
 Tonezones
 ~~~~~~~~~
 The file zonedata.c contains the information about the tone zones used