Merge commit '074a00d192c0e749d677b008b337da42597e780f'
authorMichael Niedermayer <michaelni@gmx.at>
Tue, 8 Jan 2013 11:56:41 +0000 (12:56 +0100)
committerMichael Niedermayer <michaelni@gmx.at>
Tue, 8 Jan 2013 11:56:41 +0000 (12:56 +0100)
* commit '074a00d192c0e749d677b008b337da42597e780f':
  lavr: add a public function for setting a custom channel map
  lavr: typedef internal structs in internal.h
  doc: Extend commit message section

Conflicts:
doc/APIchanges
doc/developer.texi

Merged-by: Michael Niedermayer <michaelni@gmx.at>
1  2 
doc/APIchanges
doc/developer.texi
libavresample/utils.c

diff --cc doc/APIchanges
@@@ -15,123 -13,10 +15,127 @@@ libavutil:     2012-10-2
  
  API changes, most recent first:
  
 +2012-12-20 - xxxxxxx - lavfi 3.28.100 - avfilter.h
 +  Add AVFilterLink.channels, avfilter_link_get_channels()
 +  and avfilter_ref_get_channels().
 +
 +2012-12-15 - 2ada584d - lavc 54.80.100 - avcodec.h
 +  Add pkt_size field to AVFrame.
 +
 +2012-11-25 - c70ec631 - lavu 52.9.100 - opt.h
 +  Add the following convenience functions to opt.h:
 +   av_opt_get_image_size
 +   av_opt_get_pixel_fmt
 +   av_opt_get_sample_fmt
 +   av_opt_set_image_size
 +   av_opt_set_pixel_fmt
 +   av_opt_set_sample_fmt
 +
 +2012-11-17 - 4cd74c81 - lavu 52.8.100 - bprint.h
 +  Add av_bprint_strftime().
 +
 +2012-11-15 - 92648107 - lavu 52.7.100 - opt.h
 +  Add av_opt_get_key_value().
 +
 +2012-11-13 - 79456652 - lavfi 3.23.100 - avfilter.h
 +  Add channels field to AVFilterBufferRefAudioProps.
 +
 +2012-11-03 - 481fdeee - lavu 52.3.100 - opt.h
 +  Add AV_OPT_TYPE_SAMPLE_FMT value to AVOptionType enum.
 +
 +2012-10-21 - 6fb2fd8 - lavc  54.68.100 - avcodec.h
 +                       lavfi  3.20.100 - avfilter.h
 +  Add AV_PKT_DATA_STRINGS_METADATA side data type, used to transmit key/value
 +  strings between AVPacket and AVFrame, and add metadata field to
 +  AVCodecContext (which shall not be accessed by users; see AVFrame metadata
 +  instead).
 +
 +2012-09-27 - a70b493 - lavd 54.3.100 - version.h
 +  Add LIBAVDEVICE_IDENT symbol.
 +
 +2012-09-27 - a70b493 - lavfi 3.18.100 - version.h
 +  Add LIBAVFILTER_IDENT symbol.
 +
 +2012-09-27 - a70b493 - libswr 0.16.100 - version.h
 +  Add LIBSWRESAMPLE_VERSION, LIBSWRESAMPLE_BUILD
 +  and LIBSWRESAMPLE_IDENT symbols.
 +
 +2012-09-06 - 29e972f - lavu 51.72.100 - parseutils.h
 +  Add av_small_strptime() time parsing function.
 +
 +  Can be used as a stripped-down replacement for strptime(), on
 +  systems which do not support it.
 +
 +2012-08-25 - 2626cc4 - lavf 54.28.100
 +  Matroska demuxer now identifies SRT subtitles as AV_CODEC_ID_SUBRIP instead
 +  of AV_CODEC_ID_TEXT.
 +
 +2012-08-13 - 5c0d8bc - lavfi 3.8.100 - avfilter.h
 +  Add avfilter_get_class() function, and priv_class field to AVFilter
 +  struct.
 +
 +2012-08-12 - a25346e - lavu 51.69.100 - opt.h
 +  Add AV_OPT_FLAG_FILTERING_PARAM symbol in opt.h.
 +
 +2012-07-31 - 23fc4dd - lavc 54.46.100
 +  Add channels field to AVFrame.
 +
 +2012-07-30 - f893904 - lavu 51.66.100
 +  Add av_get_channel_description()
 +  and av_get_standard_channel_layout() functions.
 +
 +2012-07-21 - 016a472 - lavc 54.43.100
 +  Add decode_error_flags field to AVFrame.
 +
 +2012-07-20 - b062936 - lavf 54.18.100
 +  Add avformat_match_stream_specifier() function.
 +
 +2012-07-14 - f49ec1b - lavc 54.38.100 - avcodec.h
 +  Add metadata to AVFrame, and the accessor functions
 +  av_frame_get_metadata() and av_frame_set_metadata().
 +
 +2012-07-10 - 0e003d8 - lavc 54.33.100
 +  Add av_fast_padded_mallocz().
 +
 +2012-07-10 - 21d5609 - lavfi 3.2.0 - avfilter.h
 +  Add init_opaque() callback to AVFilter struct.
 +
 +2012-06-26 - e6674e4 - lavu 51.63.100 - imgutils.h
 +  Add functions to libavutil/imgutils.h:
 +  av_image_get_buffer_size()
 +  av_image_fill_arrays()
 +  av_image_copy_to_buffer()
 +
 +2012-06-24 - c41899a - lavu 51.62.100 - version.h
 +  version moved from avutil.h to version.h
 +
 +2012-04-11 - 359abb1 - lavu 51.58.100 - error.h
 +  Add av_make_error_string() and av_err2str() utilities to
 +  libavutil/error.h.
 +
 +2012-06-05 - 62b39d4 - lavc 54.24.100
 +  Add pkt_duration field to AVFrame.
 +
 +2012-05-24 - f2ee065 - lavu 51.54.100
 +  Move AVPALETTE_SIZE and AVPALETTE_COUNT macros from
 +  libavcodec/avcodec.h to libavutil/pixfmt.h.
 +
 +2012-05-14 - 94a9ac1 - lavf 54.5.100
 +  Add av_guess_sample_aspect_ratio() function.
 +
 +2012-04-20 - 65fa7bc - lavfi 2.70.100
 +  Add avfilter_unref_bufferp() to avfilter.h.
 +
 +2012-04-13 - 162e400 - lavfi 2.68.100
 +  Install libavfilter/asrc_abuffer.h public header.
 +
 +2012-03-26 - a67d9cf - lavfi 2.66.100
 +  Add avfilter_fill_frame_from_{audio_,}buffer_ref() functions.
 +
+ 2013-xx-xx - xxxxxxx - lavr 1.1.0
+   Add avresample_set_channel_mapping() for input channel reordering,
+   duplication, and silencing.
  2012-xx-xx - xxxxxxx - lavu 52.2.1 - avstring.h
    Add av_basename() and av_dirname().
  
@@@ -222,17 -253,38 +222,24 @@@ For Emacs, add these roughly equivalen
     an "or any later version" clause is also acceptable, but LGPL is
     preferred.
  @item
 -   All the patches MUST be reviewed in the mailing list before they are
 -   committed.
 -@item
 -   The Libav coding style should remain consistent. Changes to
 -   conform will be suggested during the review or implemented on commit.
 -@item
 -   Patches should be generated using @code{git format-patch} or directly sent
 -   using @code{git send-email}.
 -   Please make sure you give the proper credit by setting the correct author
 -   in the commit.
 +   You must not commit code which breaks FFmpeg! (Meaning unfinished but
 +   enabled code which breaks compilation or compiles but does not work or
 +   breaks the regression tests)
 +   You can commit unfinished stuff (for testing etc), but it must be disabled
 +   (#ifdef etc) by default so it does not interfere with other developers'
 +   work.
  @item
 -   If the patch is a bug fix which should be backported to stable releases,
 -   i.e. a non-API/ABI-breaking bug fix, add @code{CC: libav-stable@@libav.org}
 -   to the bottom of your commit message, and make sure to CC your patch to
 -   this address, too. Some git setups will do this automatically.
 -@item
 -   Work in progress patches should be sent to the mailing list with the [WIP]
 -   or the [RFC] tag.
 -@item
 -   Branches in public personal repos are advised as way to
 -   work on issues collaboratively.
+    The commit message should have a short first line in the form of
+    a @samp{topic: short description} as a header, separated by a newline
+    from the body consisting of an explanation of why the change is necessary.
+    If the commit fixes a known bug on the bug tracker, the commit message
+    should include its bug ID. Referring to the issue on the bug tracker does
+    not exempt you from writing an excerpt of the bug in the commit message.
 -   You do not have to over-test things. If it works for you and you think it
 -   should work for others, send it to the mailing list for review.
 -   If you have doubt about portability please state it in the submission so
 -   people with specific hardware could test it.
+ @item
 +   You do not have to over-test things. If it works for you, and you think it
 +   should work for others, then commit. If your code has problems
 +   (portability, triggers compiler bugs, unusual environment etc) they will be
 +   reported and eventually fixed.
  @item
     Do not commit unrelated changes together, split them into self-contained
     pieces. Also do not forget that if part B depends on part A, but A does not
Simple merge