diff --git a/reference/openssl/functions/openssl-cms-read.xml b/reference/openssl/functions/openssl-cms-read.xml
index 2e06eab17f..c94f784776 100644
--- a/reference/openssl/functions/openssl-cms-read.xml
+++ b/reference/openssl/functions/openssl-cms-read.xml
@@ -1,6 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 497c40ac164d5873fd87f622dfdeb5206392b446 Maintainer: Fan2Shrek Status: ready -->
-<!-- Reviewed: yes -->
+<!-- EN-Revision: a97993d2ccf0c9a0a4433a3db171893632be73b7 Maintainer: lacatoire Status: ready -->
 <refentry xml:id="function.openssl-cms-read" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
   <refname>openssl_cms_read</refname>
@@ -14,11 +13,13 @@
    <methodparam><type>string</type><parameter>input_filename</parameter></methodparam>
    <methodparam><type>array</type><parameter role="reference">certificates</parameter></methodparam>
   </methodsynopsis>
-  <para>
-   Effectue l'opération équivalente de <function>openssl_pkcs7_read</function>.
-  </para>
-
-  &warn.undocumented.func;
+  <simpara>
+   Extrait les certificats et les <acronym>CRL</acronym> d'une structure
+   <acronym>CMS</acronym> encodée en <acronym>PEM</acronym>
+   et les retourne sous forme de chaînes <acronym>PEM</acronym>.
+   Il s'agit de l'équivalent <acronym>CMS</acronym> de
+   <function>openssl_pkcs7_read</function>.
+  </simpara>
 
  </refsect1>
 
@@ -28,17 +29,21 @@
    <varlistentry>
     <term><parameter>input_filename</parameter></term>
     <listitem>
-     <para>
-
-     </para>
+     <simpara>
+      Les données <acronym>CMS</acronym> encodées en <acronym>PEM</acronym>
+      à analyser. Malgré son nom, il s'agit des données elles-mêmes,
+      et non d'un chemin vers un fichier.
+     </simpara>
     </listitem>
    </varlistentry>
    <varlistentry>
     <term><parameter>certificates</parameter></term>
     <listitem>
-     <para>
-
-     </para>
+     <simpara>
+      Rempli avec un tableau de chaînes <acronym>PEM</acronym>.
+      Les certificats et les <acronym>CRL</acronym> ne sont extraits que des
+      données signées ; pour les autres types de contenu, le tableau reste vide.
+     </simpara>
     </listitem>
    </varlistentry>
   </variablelist>
@@ -46,11 +51,36 @@
 
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
-  <para>
+  <simpara>
    &return.success;
-  </para>
+  </simpara>
  </refsect1>
 
+ <refsect1 role="examples">
+  &reftitle.examples;
+  <example>
+   <title>Exemple avec <function>openssl_cms_read</function></title>
+   <programlisting role="php">
+<![CDATA[
+<?php
+// Données CMS encodées en PEM
+$data = file_get_contents('file.pem');
+
+if (!openssl_cms_read($data, $certificates)) {
+    exit('Structure CMS PEM invalide : ' . openssl_error_string());
+}
+
+foreach ($certificates as $pem) {
+    $info = openssl_x509_parse($pem);
+    if ($info !== false) {
+        echo $info['name'], PHP_EOL;
+    }
+}
+?>
+]]>
+   </programlisting>
+  </example>
+ </refsect1>
 
 </refentry>