+
+# This file contains functions to accept files being uplodad with the <input
+# type="file" name="foo"> control.
+#
+# ########
+# # HTML #
+# ########
+#
+# First, your <form> tag must contain this attribute:
+# enctype="multipart/form-data"
+#
+# Second, you should indicate to the browser the maximum file size (in bytes)
+# allowed for uploads with a hidden input field named MAX_FILE_SIZE. You can
+# use the function upload_max_filesize() to get the maximum allowed size that
+# PHP will accept.
+#
+# Example:
+#
+# <form action="foo.php" enctype="multipart/form-data" method="post">
+# <input type="hidden" name="MAX_FILE_SIZE" value="2097152" />
+# <input type="file" name="photo" />
+# <input type="submit" name="save" value="Save" />
+# </form>
+#
+# #######
+# # PHP #
+# #######
+#
+# In the php code you can use either save_uploaded_file('photo',
+# 'upload/dir/'); or save_uploaded_image('photo', 'upload/dir/'); The only
+# difference being that save_uploaded_image() will convert gifs to PNGs.
+#
+# Both functions will generate a reasonable filename based on the filename
+# passed from the browser (and on the mime-type if there's no extension) unless
+# you specify a filename. See the comments above the function definitions below
+# for more details.
+#
+# In a future version of save_uploaded_image(), when you specify a filename, it
+# will check the image type of the uploaded image, and if it's different than
+# the type you specified, it will convert the image for you.
+
+
+