[monkey-bubble: 127/753] Added info about the `gnome_*_file' functions.

[Sven Herzberg <herzi src gnome org>]

commit a1d933f91e6a9684a5058b28ec1c73b87e1a9114
Author: Martin Baulig <baulig suse de>
Date:   Wed Apr 11 18:29:39 2001 +0000

    Added info about the `gnome_*_file' functions.
    
    2001-04-11  Martin Baulig  <baulig suse de>
    
    	* Porting-1.0-2.0.txt: Added info about the `gnome_*_file'
    	functions.

 doc/ChangeLog           |    5 +++++
 doc/Porting-1.0-2.0.txt |   22 ++++++++++++++++++++--
 2 files changed, 25 insertions(+), 2 deletions(-)
---
diff --git a/doc/ChangeLog b/doc/ChangeLog
index e31d841..d51c0c1 100644
--- a/doc/ChangeLog
+++ b/doc/ChangeLog
@@ -1,3 +1,8 @@
+2001-04-11  Martin Baulig  <baulig suse de>
+
+	* Porting-1.0-2.0.txt: Added info about the `gnome_*_file'
+	functions.
+
 2001-03-21  Martin Baulig  <baulig suse de>
 
 	* Porting-1.0-2.0.txt: Added the libgnome section from
diff --git a/doc/Porting-1.0-2.0.txt b/doc/Porting-1.0-2.0.txt
index a9498fd..7e878d0 100644
--- a/doc/Porting-1.0-2.0.txt
+++ b/doc/Porting-1.0-2.0.txt
@@ -161,10 +161,28 @@ libgnome stuff:
     has for quite a while
   - g_file_exists():  Use g_file_test(,G_FILE_TEST_EXISTS) instead.
 
+  - gnome_libdir_file, gnome_datadir_file, gnome_sound_file, gnome_pixmap_file,
+  gnome_config_file, gnome_help_file, gnome_app_help_file,
+  gnome_unconditional_libdir_file, gnome_unconditional_datadir_file,
+  gnome_unconditional_sound_file, gnome_unconditional_pixmap_file,
+  gnome_unconditional_config_file, gnome_unconditional_help_file: Removed.
+
+  On the GNOME 1.x platform, this functions have extensively been abused to
+  locate files which are installed by your application.
+
+  If your applicatoin `foo' has a pixmap `foo.png', define FOOPIXMAPDIR in
+  your Makefile.am and use `FOOPIXMAPDIR "/foo.png"'.
+
+  If you want to locate a _system installed_ file, such as a file which has
+  been installed by libgnomeui-2 or another library which is part of the
+  GNOME 2 platform, use the new gnome_program_locate_file().
+
   The following functions have been added:
 
-  - gnome_file_locate():  A more flexible file location functions which
-    attempts to solve the issues of gnome_*_file functions.
+  - gnome_program_locate_file():  A more flexible file location functions which
+    attempts to solve the issues of gnome_*_file functions.  This function is
+    to locate a system installed file, not a file which is installed by your
+    application.
 
 * gnomelib-init, gnomelib-init2 - UNKNOWN