diff --git a/basis/io/sockets/secure/openssl/openssl-docs.factor b/basis/io/sockets/secure/openssl/openssl-docs.factor
index bc66781b62..0ff6903fe6 100644
--- a/basis/io/sockets/secure/openssl/openssl-docs.factor
+++ b/basis/io/sockets/secure/openssl/openssl-docs.factor
@@ -1,13 +1,12 @@
-USING: help.markup help.syntax ;
+USING: help.markup help.syntax kernel strings sequences ;
 IN: io.sockets.secure.openssl
 
-
 HELP: subject-name
-{ $values { "certificate" "an SSL peer certificate" } }
+{ $values { "certificate" "an SSL peer certificate" } { "host" string } }
 { $description "The subject name of a certificate." } ;
 
 HELP: subject-names-match?
-{ $values { "host" "a host name" } { "subject" "a subject name" } }
+{ $values { "host" "a host name" } { "subject" "a subject name" } { "?" boolean } }
 { $description "True if the host name matches the subject name." }
 { $examples
     { $code
@@ -17,5 +16,5 @@ HELP: subject-names-match?
 } ;
 
 HELP: alternative-dns-names
-{ $values { "certificate" "an SSL peer certificate" } }
+{ $values { "certificate" "an SSL peer certificate" } { "dns-names" sequence } }
 { $description "Alternative subject names for the certificate." } ;