diff --git a/Code/DataStructs/BitOps.h b/Code/DataStructs/BitOps.h
index 96a21c044..e18431058 100644
--- a/Code/DataStructs/BitOps.h
+++ b/Code/DataStructs/BitOps.h
@@ -105,7 +105,8 @@ RDKIT_DATASTRUCTS_EXPORT double TanimotoSimilarity(const T1 &bv1,
//! returns the Cosine similarity between two bit vects
/*!
- \return (bv1&bv2)_o / sqrt(bv1_o + bv2_o)
+ Also known as the Ochiai coefficient.
+ \return (bv1&bv2)_o / sqrt(bv1_o * bv2_o)
*/
template
RDKIT_DATASTRUCTS_EXPORT double CosineSimilarity(const T1 &bv1, const T2 &bv2);
@@ -157,6 +158,7 @@ RDKIT_DATASTRUCTS_EXPORT double McConnaugheySimilarity(const T1 &bv1,
//! returns the Asymmetric similarity between two bit vects
/*!
+ Also known as the **Simpson similarity** or **Overlap coefficient**.
\return (bv1&bv2)_o / min(bv1_o,bv2_o)
*/
template
@@ -209,8 +211,12 @@ RDKIT_DATASTRUCTS_EXPORT int NumBitsInCommon(const ExplicitBitVect &bv1,
const ExplicitBitVect &bv2);
//! returns the common-bit similarity (on and off) between two bit vects
-//! This is also called Manhattan similarity.
/*!
+ Also known as:
+ - **Simple Matching Coefficient**
+ - **Rand similarity**
+ - **Sokal–Michener similarity**
+
\return [bv1_n - (bv1^bv2)_o] / bv1_n
*/
template