[Bug 394687] g_get_home_dir documentation confusing

[glib (bugzilla.gnome.org)]

Do not reply to this via email (we are currently unable to handle email
responses and they get discarded).  You can add comments to this bug at
http://bugzilla.gnome.org/show_bug.cgi?id=394687

  glib | docs | Ver: 2.12.x


Havoc Pennington changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
                 CC|                            |hp at redhat.com




------- Comment #1 from Havoc Pennington  2007-01-09 16:35 UTC -------
There is a long historical discussion about this, unfortunately I think it was
very old and I have no idea what forum it may have been in.

To the extent I remember it, HOME was causing all sorts of problems when
running a program as another user (e.g. with pam_console or su) and the reason
g_get_home_dir works the way it does is that most apps should use the
g_get_home_dir value in preference to HOME.

The docs might should say "gets the home directory your application should use"

Anyway, all I really remember is that this was done on purpose many years ago
and it fixed a lot of bugs at that time, so changing it back or not using this
function would probably break something.


-- 
Configure bugmail: http://bugzilla.gnome.org/userprefs.cgi?tab=email