Correct various documentation typos

Some of the documentation had the right explanation but the incorrect
function names attached.

Change-Id: I7b479dae6d71a5ac7bc86df5a3890508c3b3d09f
Reviewed-on: https://boringssl-review.googlesource.com/5090
Reviewed-by: Adam Langley <agl@google.com>

include/openssl/err.h

diff --git a/include/openssl/err.h b/include/openssl/err.h
index 30dc4af..44ec7d2 100644
--- a/include/openssl/err.h
+++ b/include/openssl/err.h
@@ -287,7 +287,7 @@
 
 /* Deprecated functions. */
 
-/* |ERR_remove_state| calls |ERR_clear_error|. */
+/* ERR_remove_state calls |ERR_clear_error|. */
 OPENSSL_EXPORT void ERR_remove_state(unsigned long pid);