diff --git a/doc/scripts/CMakeLists.txt b/doc/scripts/CMakeLists.txt
index 04f8e54f76..3523806f4f 100644
--- a/doc/scripts/CMakeLists.txt
+++ b/doc/scripts/CMakeLists.txt
@@ -132,6 +132,8 @@ endmacro(REST_TARGET)
 rest_target(${CMAKE_CURRENT_SOURCE_DIR} example.bro           internal)
 
 rest_target(${POLICY_SRC_DIR} conn.bro                        user)
+rest_target(${POLICY_SRC_DIR} conn/base.bro                   user)
+rest_target(${POLICY_SRC_DIR} conn/contents.bro               user)
 
 rest_target(${POLICY_SRC_DIR} dns.bro                         policy/dns-index)
 rest_target(${POLICY_SRC_DIR} dns/auth-addl.bro               policy/dns-index)
diff --git a/policy/conn/contents.bro b/policy/conn/contents.bro
index 2e48139a54..0d4b4a83ac 100644
--- a/policy/conn/contents.bro
+++ b/policy/conn/contents.bro
@@ -1,15 +1,15 @@
 ##! This script can be used to extract either the originator's data or the 
 ##! responders data or both.  By default nothing is extracted, and in order 
-##! to actually extract data the :bro:id:`c$extract_orig` and/or the 
-##! :bro:id:`c$extract_resp` variable must be set to T.  One way to achieve 
+##! to actually extract data the ``c$extract_orig`` and/or the
+##! ``c$extract_resp`` variable must be set to T.  One way to achieve
 ##! would be to handle the connection_established event elsewhere and set the
 ##! extract_orig and extract_resp options there.
 ##! This script does not work well in a cluster context unless it has a remotely
 ##! mounted disk to write the content files to.
-
-##! Note: This script has a problem is another connection happens using the 
-##!       same IP addresses and ports.  There is nothing in place to test for
-##!       the existence of a file.
+##!
+##! .. note:: This script has a problem if another connection happens using the 
+##!    same IP addresses and ports.  There is nothing in place to test for
+##!    the existence of a file.
 
 module Conn;