From 33962198a853f02497f72266ebf3fa692abd6976 Mon Sep 17 00:00:00 2001 From: icewing Date: Wed, 23 Apr 2008 17:23:03 +0000 Subject: Marcus Povey * Improved documentation git-svn-id: https://code.elgg.org/elgg/trunk@513 36083f99-b078-4883-b0ff-0f9b5a30f544 --- engine/lib/filestore.php | 12 ++++++++++++ 1 file changed, 12 insertions(+) (limited to 'engine') diff --git a/engine/lib/filestore.php b/engine/lib/filestore.php index 98cba7ade..afc924099 100644 --- a/engine/lib/filestore.php +++ b/engine/lib/filestore.php @@ -234,6 +234,18 @@ /** * @class ElggFile * This class represents a physical file. + * + * Usage: + * Create a new ElggFile object and specify a filename, and optionally a FileStore (if one isn't specified + * then the default is assumed. + * + * Open the file using the appropriate mode, and you will be able to read and write to the file. + * + * Optionally, you can also call the file's save() method, this will turn the file into an entity in the + * system and permit you to do things like attach tags to the file etc. This is not done automatically since + * there are many occasions where you may want access to file data on datastores using the ElggFile interface + * but do not want to create an Entity reference to it in the system (temporary files for example). + * * @author Marcus Povey */ class ElggFile extends ElggObject -- cgit v1.2.3