From: <tho...@ke...> - 2006-09-02 13:40:56
|
CVS Root: /cvs/gstreamer Module: gstreamer Changes by: thomasvs Date: Sat Sep 02 2006 13:40:53 UTC Log message: clarify error message Modified files: gst : gsterror.c Links: http://freedesktop.org/cgi-bin/viewcvs.cgi/gstreamer/gstreamer/gst/gsterror.c.diff?r1=1.29&r2=1.30 ====Begin Diffs==== Index: gsterror.c =================================================================== RCS file: /cvs/gstreamer/gstreamer/gst/gsterror.c,v retrieving revision 1.29 retrieving revision 1.30 diff -u -d -r1.29 -r1.30 --- gsterror.c 12 Jun 2006 08:55:21 -0000 1.29 +++ gsterror.c 2 Sep 2006 13:40:41 -0000 1.30 @@ -82,7 +82,11 @@ * parentheses.</para></listitem> * <listitem><para>If you do supply a custom message, it should be * marked for translation. The message should start with a capital - * and end with a period.</para></listitem> + * and end with a period. The message should describe the error in short, + * in a human-readable form, and without any complex technical terms. + * A user interface will present this message as the first thing a user + * sees. Details, technical info, ... should go in the debug string. + * </para></listitem> * <listitem><para>The debug string can be as you like. Again, use (NULL) * if there's nothing to add - file and line number will still be * passed. #GST_ERROR_SYSTEM can be used as a shortcut to give |