- info about update

UPDATE-v3.3.0/update.txt

@@ -0,0 +1,51 @@
+Release information for 3.3.0
+-------------------------------------
+
+This release contains various improvements which require your manual
+interaction during an upgrade from an earlier version. You ѕhould definitely
+make a backup of your database and possibly your content folder.
+
+Folder search
+-------------
+The new folder search has introduced a new database field which has to
+be initially filled. Without that field searching for subfolders in a
+folder will not work.
+
+Data conversion
+---------------
+The conversion of strings like names and comments of documents and folders,
+when saved in the database, has been completely droped. This was originally
+done for security reasons, both to prevent sql injections and cross side
+scripting. Basically any field data that could do any harm, was replaced
+by 'harmless' chars. Ampersands, semi colons, quotes, etc., they all have
+been replaced by their html entity or masked by a backslash. The output of
+those fields on html pages was not decoded anymore, but any other application
+that accessed the database had to decode the data.
+
+The new approach with less impact on the data keeps the data 
+unmodified when saving it in the database without opening new security
+wholes. Protection against cross side scripting is done when the data
+is placed on a html page.
+
+As a consequence the complete database has to be searched for those
+previously converted strings and converted back into the original value. 
+
+For both of the above improvements a php script is provided which has to be
+called after the database update.
+
+Content directory
+-----------------
+Each document in LetoDMS is associated with a directory in the file system.
+Consequently, there is a limitation of documents set by the maximum number
+of subdirectories in a directory of the filesystem. The currently most used
+filesystem on Linux (ext3) supports only 31998 directories. In order to
+overcome this limitation another level of directories has been put inbetween
+the content directory and the document directory numbered from 1 to maxDirId.
+
+If you intend to switch to the new content directory format, you will have
+to create a new directory with name '1' below the content dir and move all
+document directories into it. If you have already a document with id 1, you
+must choose a different name for your new sub directory and rename to 1 after
+all document directories have been moved.
+
+