gst/printf/README

   1 The files
   2
   3  asnprintf.c
   4  printf-args.c
   5  printf-args.h
   6  printf-parse.c
   7  printf-parse.h
   8  vasnprintf.c
   9  vasnprintf.h
  10
  11 are taken from the vasnprintf module of the GNUlib package, which can
  12 be found at:
  13
  14  http://www.gnu.org/software/gnulib/
  15
  16 All files have been modified to include g-gnulib.h.
  17
  18 vasnprintf.c has also been modified to include support for long long
  19 printing if the system printf doesn't. This code is protected by
  20 #ifndef HAVE_LONG_LONG_FORMAT.
  21
  22 Code has been added to printf-args.[ch], printf-parse.c and vasnprintf.c
  23 to support printing of __int64 values with the I64 format modifier. This
  24 is protected by #ifdef HAVE_INT64_AND_I64.
  25
  26 The files
  27
  28  printf.h
  29  printf.c
  30  g-gnulib.h
  31
  32 have been written by me. printf.[hc] contain implementations of the
  33 remaining functions in the printf family based on vasnprintf.
  34 g-gnulib.h is included by all source files in order to move all
  35 exported functions to the _g_gnulib namespace, replace malloc by
  36 g_malloc and make sure that snprintf is only used if it implements
  37 C99 return value semantics.
  38
  39 Matthias Clasen
  40 November 1, 2003
  41
  42 -----
  43
  44 GStreamer modifications
  45
  46 This was imported from GLib's gnulib subdirectory.
  47
  48 g-gnulib.h and _g_gnulib namespace has been changed to gst-printf.h and
  49 __gst_printf namespace for GStreamer. Also #define HAVE_SNPRINTF 0 has
  50 been changed to #undef HAVE_SNPRINTF, and HAVE_ALLOCA has been replaced
  51 by an #if defined(alloca) || defined(GLIB_HAVE_ALLOCA_H)
  52
  53 printf-extension.[ch] were added to provide support for custom pointer
  54 arguments (e.g. caps, events, etc.)
  55
  56 Files have also been indented with gst-indent, so this is basically a
  57 permanent fork and any patches will have to be merged manually.
  58
  59 March 30, 2013.