diff --git a/functions/aspell.xml b/functions/aspell.xml
index a0a5b1b532..4bd68262b5 100644
--- a/functions/aspell.xml
+++ b/functions/aspell.xml
@@ -1,6 +1,6 @@
-<!-- $Revision: 1.13 $ -->
+<!-- $Revision: 1.14 $ -->
  <reference id="ref.aspell">
-  <title>Aspell functions</title>
+  <title>Aspell functions [deprecated]</title>
   <titleabbrev>Aspell</titleabbrev>
 
   <partintro>
@@ -27,7 +27,7 @@
   <refentry id="function.aspell-new">
    <refnamediv>
     <refname>aspell_new</refname>
-    <refpurpose>Load a new dictionary</refpurpose>
+    <refpurpose>Load a new dictionary [deprecated]</refpurpose>
    </refnamediv>
    <refsect1>
     <title>Description</title>
@@ -35,9 +35,11 @@
      <funcprototype>
       <funcdef>int <function>aspell_new</function></funcdef>
       <paramdef>string <parameter>master</parameter></paramdef>
-      <paramdef>string <parameter>personal</parameter></paramdef>
+      <paramdef>string 
+       <parameter><optional>personal</optional></parameter> </paramdef>
      </funcprototype>
     </funcsynopsis>
+    <!-- TODO: personal??? -->
     <simpara>
      <function>aspell_new</function> opens up a new dictionary and
      returns the dictionary link identifier for use in other aspell
@@ -57,7 +59,7 @@ $aspell_link = aspell_new("english");
   <refentry id="function.aspell-check">
    <refnamediv>
     <refname>aspell_check</refname>
-    <refpurpose>Check a word</refpurpose>
+    <refpurpose>Check a word [deprecated]</refpurpose>
    </refnamediv>
    <refsect1>
     <title>Description</title>
@@ -93,7 +95,7 @@ if (aspell_check($aspell_link, "testt")) {
    <refnamediv>
     <refname>aspell_check_raw</refname> 
     <refpurpose>
-     Check a word without changing its case or trying to trim it
+     Check a word without changing its case or trying to trim it [deprecated]
     </refpurpose>
    </refnamediv>
    <refsect1>
@@ -130,7 +132,7 @@ if (aspell_check_raw($aspell_link, "test")) {
   <refentry id="function.aspell-suggest">
    <refnamediv>
     <refname>aspell_suggest</refname>
-    <refpurpose>Suggest spellings of a word</refpurpose>
+    <refpurpose>Suggest spellings of a word [deprecated]</refpurpose>
    </refnamediv>
    <refsect1>
     <title>Description</title>