# HG changeset patch # User stephent # Date 1113471867 0 # Node ID 3213c79d66724b58b3f54e54f9dc3c4d201b2950 # Parent 7031e143e4ee8f56c8df9fd9d85f03ec0b8e36dd [xemacs-hg @ 2005-04-14 09:44:24 by stephent] stderr_out doc <87ll7lbsmv.fsf@tleepslib.sk.tsukuba.ac.jp> diff -r 7031e143e4ee -r 3213c79d6672 src/ChangeLog --- a/src/ChangeLog Thu Apr 14 05:58:46 2005 +0000 +++ b/src/ChangeLog Thu Apr 14 09:44:27 2005 +0000 @@ -1,3 +1,7 @@ +2005-04-12 Stephen J. Turnbull + + * print.c (stderr_out): Document need to convert arguments. + 2005-04-06 Stephen J. Turnbull (Fmap_char_table): Add note about proper usage. diff -r 7031e143e4ee -r 3213c79d6672 src/print.c --- a/src/print.c Thu Apr 14 05:58:46 2005 +0000 +++ b/src/print.c Thu Apr 14 09:44:27 2005 +0000 @@ -306,8 +306,17 @@ window under MS Windows); do external-format conversion and call GETTEXT on the format string. Automatically flush when done. - This is safe even when not initialized or when dying -- we don't do - conversion in such cases. */ + NOTE: CIbyte means "internal format" data. This includes the "..." + arguments. For numerical arguments, we have to assume that vsprintf + will be a good boy and format them as ASCII. For Mule internal coding + (and UTF-8 internal coding, if/when we get it), it is safe to pass + string values in internal format to be formatted, because zero octets + only occur in the NUL character itself. Similarly, it is safe to pass + pure ASCII literal strings for these functions. *Everything else must + be converted, including all external data.* + + This function is safe to use even when not initialized or when dying -- + we don't do conversion in such cases. */ void stderr_out (const CIbyte *fmt, ...)