Index: file.h
===================================================================
--- file.h	(revision 327)
+++ file.h	(revision 328)
@@ -1,63 +1,19 @@
 #ifndef _FILE_H
 #define _FILE_H
 /*=
-Files
+Files (generic)
 2100
 **/
 
-// Warning
-/**
-It's important to use only functions with ##raydium_file_*## prefix.
-All other functions may change or disappear. Upper level functions are
-available (see ##object.c##).
-**/
-
 // Introduction
 /**
-##file.c## use .tri mesh files (text), available in 4 versions:
-
-1. version 1: providing normals and uv texture mapping informations.
-2. version 0: providing uv texture mapping.
-3. version -1: only providing vertices. 
-4. version 2: mesh animation support
-	 
-Version 1 example file:
-%%
-1
-5.1 15.75 -3.82 0.0000 0.0000 -1.0000 0.5158 0.5489 rgb(0.5,0.5,0.5)
-6.3 11.75 -3.82 0.0000 0.0000 -1.0000 0.5196 0.5365 rgb(0.5,0.5,0.5)
-5.0 11.75 -3.82 0.0000 0.0000 -1.0000 0.5158 0.5365 rgb(0.5,0.5,0.5)
-...
-%%
-	      
-You can find the file version on first line, and then data.
-Next lines: vertex position (x,y,z), normal (x,y,z), texture mapping (u,v)
-and texture (string). 
-
-Version 2 files are a bit different, as showed below:
-%%
-2
-3 1743
-0 39 stand
-40 45 run
-46 53 attack
-1
-5.1 15.75 -3.82 0.0000 0.0000 -1.0000 0.5158 0.5489 rgb(0.5,0.5,0.5)
-6.3 11.75 -3.82 0.0000 0.0000 -1.0000 0.5196 0.5365 rgb(0.5,0.5,0.5)
-5.0 11.75 -3.82 0.0000 0.0000 -1.0000 0.5158 0.5365 rgb(0.5,0.5,0.5)
-...
-%%
-
-You may have seen that headers are longer for v2 files. You'll find (just
-after the version number) how many "anims" are hosted by this file, and how
-many vertices are required for one frame. Then you'll find one line per
-"anim", with starting frame, ending frame and anim's name.
-Then starts a regular tri file ("sub-file", with its own version number)
-with ALL concatened frames.
+File support is now splitted in two parts: generic functions and TRI format
+specific functions. This chapter talks about generic part, where you'll find
+some libc replacements and wrappers, and functions dealing with
+"private directory" of the current user.
 **/
 
 
-#define DONT_SAVE_DUMMY_TEXTURE
 extern void raydium_file_dirname(char *dest,char *from);
 /**
 Reliable and portable version of libc's ##dirname## function.
@@ -94,30 +50,7 @@
 #else
 #define raydium_php_repository_file_get fopen
 #endif
-extern void dump_vertex_to (char *filename);
-/**
-This function save all scene to filename (.tri file) in version 1.
-Vertice may be sorted.
-Please, try to do not use this function.
-**/
 
-extern void dump_vertex_to_alpha (char *filename);
-/**
-Now useless and deprecated.
-**/
-
-extern int raydium_file_set_textures (char *name);
-/**
-Internal use.
-This function analyze texture filename, and search for extended multitexturing
-informations (u,v and another texture).
-**/
-
-extern void read_vertex_from (char *filename);
-/**
-Loads filename. Again, avoid use of this function.
-**/
-
 extern unsigned long raydium_file_sum_simple(char *filename);
 /**
 This function will generate a very simple checksum on ##filename##.
@@ -125,9 +58,10 @@
 
 extern char * raydium_file_home_path(char *file);
 /**
-This function will return an absolute file path for ##file##. Returned value
-is a pointer to static memory. Do not free this memory and use it before any
-other call to this function, since it will be overwritten.
+This function will return an absolute file path for ##file## in the home
+directory of the current user. 
+Returned value is a pointer to static memory. Do not free this memory and use
+it before any other call to this function, since it will be overwritten.
 Example:
 for ##test.cfg##, this function will return ##/home/me/.raydium/test.cfg##
 See also ##raydium_init_args_name()## if you want to tune this result.