diff --git a/ChangeLog b/ChangeLog index 81dd0971d..1c897bbb4 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,10 @@ +2001-08-21 David Turner + + * include/freetype/config/ftoption.h: changed the default setting for + FT_CONFIG_OPTION_USE_MODULE_ERRORS to undefined, since it breaks source + compatibility in a few cases.. (sorry Werner). Updated the comment to + explain that too.. + 2001-08-17 Martin Muskens * src/base/ftcalc.c (FT_MulDiv): Fixed serious typo. diff --git a/include/freetype/config/ftoption.h b/include/freetype/config/ftoption.h index 8150cfded..b16331254 100644 --- a/include/freetype/config/ftoption.h +++ b/include/freetype/config/ftoption.h @@ -77,16 +77,17 @@ FT_BEGIN_HEADER /* */ /* Module errors */ /* */ - /* If this macro is set (which is the default), the higher byte of an */ - /* error code gives the module in which the error has occurred, while */ - /* the lower byte is the real error code. */ + /* If this macro is set (which is _not_ the default), the higher byte */ + /* of an error code gives the module in which the error has occurred, */ + /* while the lower byte is the real error code. */ /* */ - /* Unsetting this macro makes sense for backwards compatibility; only */ - /* the real error code is emitted, and the higher byte is always zero. */ + /* Setting this macro makes sense for debugging purposes only, since */ + /* it would break source compatibility of certain programs that use */ + /* FreeType 2. */ /* */ /* More details can be found in the files ftmoderr.h and fterrors.h. */ /* */ -#define FT_CONFIG_OPTION_USE_MODULE_ERRORS +#undef FT_CONFIG_OPTION_USE_MODULE_ERRORS /*************************************************************************/ diff --git a/include/freetype/freetype.h b/include/freetype/freetype.h index eb5a595bd..d475395f6 100644 --- a/include/freetype/freetype.h +++ b/include/freetype/freetype.h @@ -1360,8 +1360,8 @@ FT_BEGIN_HEADER /* FT_Open_Flags */ /* */ /* */ - /* An enumeration used to list the bit flags used within */ - /* FT_Open_Args(). */ + /* An enumeration used to list the bit flags used within the */ + /* 'flags' field of the @FT_Open_Args structure */ /* */ /* */ /* ft_open_memory :: This is a memory-based stream. */ @@ -1374,6 +1374,10 @@ FT_BEGIN_HEADER /* */ /* ft_open_params :: Use the `num_params' & `params' field. */ /* */ + /* */ + /* the 'ft_open_memory', 'ft_open_stream' and 'ft_open_pathname' */ + /* flags are mutually exclusive.. */ + /* */ typedef enum { ft_open_memory = 1, @@ -1418,7 +1422,7 @@ FT_BEGIN_HEADER /* */ /* A structure used to indicate how to open a new font file/stream. */ /* A pointer to such a structure can be used as a parameter for the */ - /* functions FT_Open_Face() & FT_Attach_Stream(). */ + /* functions @FT_Open_Face() & @FT_Attach_Stream(). */ /* */ /* */ /* flags :: A set of bit flags indicating how to use the */ @@ -1443,22 +1447,23 @@ FT_BEGIN_HEADER /* opening a new face. */ /* */ /* */ - /* `stream_type' determines which fields are used to create a new */ - /* input stream. */ + /* the stream type is determined by the content of 'flags', which */ + /* are tested in the following order by @FT_Open_Face: */ /* */ - /* If it is `ft_stream_memory', a new memory-based stream will be */ - /* created using the memory block specified by `memory_base' and */ - /* `memory_size'. */ + /* if the 'ft_open_memory' bit is set, assume that this is a */ + /* memory file, located at 'memory_address', of 'memory_size' bytes */ /* */ - /* If it is `ft_stream_pathname', a new stream will be created with */ - /* the `pathname' field, calling the system-specific FT_New_Stream() */ - /* function. */ + /* otherwise, if the 'ft_open_stream' bit is set, assume that */ + /* a custom input stream is used, a grab it in 'stream'. */ /* */ - /* If is is `ft_stream_copy', then the content of `stream' will be */ - /* copied to a new input stream object. The object will be closed */ - /* and destroyed when the face is destroyed itself. Note that this */ - /* means that you should not close the stream before the library */ - /* does! */ + /* otherwise, if the 'ft_open_pathname' bit is set, assume that */ + /* this is a normal file and use the "pathname" to open it. */ + /* */ + /* if the 'ft_open_driver' bit is set, @FT_Open_Face will only */ + /* try to open the file with the driver whose handler is in "driver" */ + /* */ + /* if the 'ft_open_params' bit is set, the parameters given by */ + /* "num_params" and "params" will be used. They're ignored otherwise */ /* */ typedef struct FT_Open_Args_ {