diff --git a/functions/printer.xml b/functions/printer.xml
index 002bda5f4d..a58acc7ad5 100644
--- a/functions/printer.xml
+++ b/functions/printer.xml
@@ -19,7 +19,7 @@
     <funcsynopsis>
      <funcprototype>
       <funcdef>mixed <function>printer_open</function></funcdef>
-      <paramdef>[string <parameter>devicename</parameter>]</paramdef>
+      <paramdef>string <parameter><optional>devicename</optional></parameter></paramdef>
      </funcprototype>
     </funcsynopsis>
     <para>
@@ -29,8 +29,9 @@
     </para>
     <para>
      If no parameter was given it tries to open a 
-     connection to the default printer (if not specified in php.ini as 
-     printer.default_printer, php tries to detect it).
+     connection to the default printer (if not specified in 
+     <filename>php.ini</filename> as 
+     <literal>printer.default_printer</literal>, php tries to detect it).
     </para>
     <para>
      <function>printer_open</function> also starts a device context.
@@ -153,8 +154,8 @@ printer_close($handle);
       <funcprototype>
        <funcdef>array <function>printer_list</function></funcdef>
        <paramdef>int <parameter>enumtype</parameter></paramdef>
-       <paramdef>[string <parameter>name</parameter></paramdef>
-       <paramdef>[int <parameter>level</parameter>]]</paramdef>
+       <paramdef>string <parameter><optional>name</optional></parameter></paramdef>
+       <paramdef>int <parameter><optional>level</optional></parameter></paramdef>
       </funcprototype>
      </funcsynopsis>
     <para>
@@ -583,7 +584,7 @@ printer_close($handle);
      <funcprototype>
       <funcdef>bool <function>printer_start_doc</function></funcdef>
       <paramdef>resource <parameter>handle</parameter></paramdef>
-      <paramdef>[string <parameter>document</parameter>]</paramdef>
+      <paramdef>string <parameter><optional>document</optional></parameter></paramdef>
      </funcprototype>
     </funcsynopsis>
     <para>
@@ -608,7 +609,6 @@ printer_close($handle);
    </refsect1>
   </refentry>
   
-  
   <refentry id="function.printer-end-doc">
    <refnamediv>
     <refname>printer_end_doc</refname>
@@ -625,15 +625,14 @@ printer_close($handle);
        </funcprototype>
       </funcsynopsis>
       <para>
-       The function creates a new document in the printer spooler. A document 
-       can contain multiple pages, it's used to schedule the print job in the 
-       spooler. For an example see <function>printer_start_doc</function>.
+       Closes a new document in the printer spooler. The document 
+       is now ready for printing. For an example see 
+       <function>printer_start_doc</function>.
        <parameter>handle</parameter> must be a valid handle to a printer.
       </para>
     </refsect1>
   </refentry>
   
-  
   <refentry id="function.printer-start-page">
    <refnamediv>
     <refname>printer_start_page</refname>
@@ -1058,9 +1057,20 @@ printer_close($handle);
        </simpara>
       </listitem>
      </itemizedlist>
-     <parameter>italic</parameter> can be &true; or &false;, and sets whether the font should be italic.
-     <parameter>underline</parameter> can be &true; or &false;, and sets whether the font should be underlined.
-     <parameter>strikeout</parameter> can be &true; or &false;, and sets whether the font should be striked out.
+    </para>
+    <para>
+     <parameter>italic</parameter> can be &true; or &false;, 
+     and sets whether the font should be italic.
+    </para>
+    <para>
+     <parameter>underline</parameter> can be &true; or &false;, 
+     and sets whether the font should be underlined.
+    </para>
+    <para>
+     <parameter>strikeout</parameter> can be &true; or &false;, 
+     and sets whether the font should be striked out.
+    </para>
+    <para>
      <parameter>orientation</parameter> specifies a rotation.
      For an example see <function>printer_select_font</function>.
     </para>
@@ -1437,7 +1447,7 @@ $handle = printer_open();
 printer_start_doc($handle, "My Document");
 printer_start_page($handle);
 
-$pen = printer_create_pen(PRINTER_PEN_SOLID, 30, 000000");
+$pen = printer_create_pen(PRINTER_PEN_SOLID, 30, "000000");
 printer_select_pen($handle, $pen);
 
 printer_draw_line($handle, 1, 10, 1000, 10);