Intelligently convert C/C++ comments to Rust

With this change, we can correctly parse C++ block comments.

```
/**
 * Does a thing
 *
 * More documentation. This test does something
 * useful.
 */
```

into

```
/// Does a thing
///
/// More documentation. This test does something
/// useful.
```

Fixes servo/rust-bindgen#426.

1 files changed, 14 insertions, 0 deletions

diff --git a/tests/headers/convert-cpp-comment-to-rust.hpp b/tests/headers/convert-cpp-comment-to-rust.hpp
new file mode 100644
index 00000000..649c2365
--- /dev/null
+++ b/tests/headers/convert-cpp-comment-to-rust.hpp
@@ -0,0 +1,14 @@
+
+typedef unsigned mbedtls_mpi_uint;
+
+/**
+ * \brief          MPI structure
+ */
+typedef struct
+{
+    int s;                /*!<  integer sign      */
+    unsigned long n;      /*!<  total # of limbs  */
+    mbedtls_mpi_uint *p;  /*!<  pointer to limbs  */
+}
+mbedtls_mpi;
+