diff --git a/reference/filesystem/functions/is-writable.xml b/reference/filesystem/functions/is-writable.xml
index d92c467fec..0e4ea2489d 100644
--- a/reference/filesystem/functions/is-writable.xml
+++ b/reference/filesystem/functions/is-writable.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.2 $ -->
+<!-- $Revision: 1.3 $ -->
 <!-- splitted from ./en/functions/filesystem.xml, last change in rev 1.2 -->
   <refentry id="function.is-writable">
    <refnamediv>
@@ -13,9 +13,9 @@
       <methodparam><type>string</type><parameter>filename</parameter></methodparam>
      </methodsynopsis>
     <para>
-     Returns &true; if the filename exists and is writable.  The
-     filename argument may be a directory name allowing you to check
-     if a directory is writeable.
+     Returns &true; if the <parameter>filename</parameter> exists and is
+     writable.  The filename argument may be a directory name allowing you
+     to check if a directory is writeable.
     </para>
     <para>
      Keep in mind that PHP may be accessing the file as the user id
@@ -26,13 +26,13 @@
      The results of this function are cached. See
      <function>clearstatcache</function> for more details.
     </para>
-    <simpara>
-     This function will not work on <link
-     linkend="features.remote-files">remote files</link>; the file to
-     be examined must be accessible via the server's filesystem.
-    </simpara>
+    
+    &note.no-remote;
+    
     <para>
-     See also <function>is_readable</function>.
+     See also <function>is_readable</function>,
+     <function>file_exists</function>, and 
+     <function>fwrite</function>.
     </para>
    </refsect1>
   </refentry>