[libdvbpsi-devel] demux API: mark deprecated

[Michael Ira Krufky]

On Mon, Aug 24, 2015 at 6:54 AM, Jean-Paul Saman <git at videolan.org> wrote:
> libdvbpsi | branch: master | Jean-Paul Saman <jpsaman at videolan.org> | Tue Jun  9 09:36:48 2015 +0200| [9cb706c5f1845b472862fa769f466380511c456b] | committer: Jean-Paul Saman
>
> demux API: mark deprecated
>
> The demux API for adding, deleting and selecting subtable decoders is marked
> deprecated. It is target for removal for the 2.0.0 release and will be replaced
> by a simpler system, that allows each PSI table decoder to be chained without the
> need of adding extra structures and indirections.
>
>> http://git.videolan.org/gitweb.cgi/libdvbpsi.git/?a=commit;h=9cb706c5f1845b472862fa769f466380511c456b

Jean-Paul,

What is the new "simpler system" is that will be replacing the current
demux API?

How soon will the current demux API be removed, considering that the
new system hasn't yet been introduced?  If this has already been
published somewhere then please forgive me - I searched, but didn't
find anything.

I have ATSC multi_string support and some new descriptor decoders that
I wanted to clean up before pushing for merge -- how much time do I
have to get them into a release that still supports the current demux
API?

Will you be at ELCE this year?  I will be there and also the
co-located Gstreamer conference - hope to see you there!

Thanks & best regards,

Michael Ira Krufky

On Mon, Aug 24, 2015 at 6:54 AM, Jean-Paul Saman <git at videolan.org> wrote:
> libdvbpsi | branch: master | Jean-Paul Saman <jpsaman at videolan.org> | Tue Jun  9 09:36:48 2015 +0200| [9cb706c5f1845b472862fa769f466380511c456b] | committer: Jean-Paul Saman
>
> demux API: mark deprecated
>
> The demux API for adding, deleting and selecting subtable decoders is marked
> deprecated. It is target for removal for the 2.0.0 release and will be replaced
> by a simpler system, that allows each PSI table decoder to be chained without the
> need of adding extra structures and indirections.
>
>> http://git.videolan.org/gitweb.cgi/libdvbpsi.git/?a=commit;h=9cb706c5f1845b472862fa769f466380511c456b
> ---
>
>  src/demux.h |    9 +++++++++
>  1 file changed, 9 insertions(+)
>
> diff --git a/src/demux.h b/src/demux.h
> index 7d11af3..f07c15d 100644
> --- a/src/demux.h
> +++ b/src/demux.h
> @@ -29,6 +29,7 @@
>   * \brief Subtable demutiplexor.
>   *
>   * Subtable demultiplexor structure
> + * @note deprecated
>   */
>
>  #ifndef _DVBPSI_DEMUX_H_
> @@ -139,6 +140,7 @@ struct dvbpsi_demux_s
>   * \param p_new_cb_data Data given to the previous callback.
>   * \return true on success, false on failure
>   */
> +__attribute__((deprecated))
>  bool dvbpsi_AttachDemux(dvbpsi_t *            p_dvbpsi,
>                          dvbpsi_demux_new_cb_t pf_new_cb,
>                          void *                p_new_cb_data);
> @@ -152,6 +154,7 @@ bool dvbpsi_AttachDemux(dvbpsi_t *            p_dvbpsi,
>   * \param p_dvbpsi The handle of the demux to be destroyed.
>   * \return nothing
>   */
> +__attribute__((deprecated))
>  void dvbpsi_DetachDemux(dvbpsi_t *p_dvbpsi);
>
>  /*****************************************************************************
> @@ -166,6 +169,7 @@ void dvbpsi_DetachDemux(dvbpsi_t *p_dvbpsi);
>   * \return a pointer to the found subdecoder, or NULL.
>   *
>   */
> +__attribute__((deprecated))
>  dvbpsi_demux_subdec_t * dvbpsi_demuxGetSubDec(dvbpsi_demux_t * p_demux,
>                                                uint8_t          i_table_id,
>                                                uint16_t         i_extension);
> @@ -180,6 +184,7 @@ dvbpsi_demux_subdec_t * dvbpsi_demuxGetSubDec(dvbpsi_demux_t * p_demux,
>   * \param p_dvbpsi PSI decoder handle.
>   * \param p_section PSI section.
>   */
> +__attribute__((deprecated))
>  void dvbpsi_Demux(dvbpsi_t *p_dvbpsi, dvbpsi_psi_section_t *p_section);
>
>  /*****************************************************************************
> @@ -199,6 +204,7 @@ void dvbpsi_Demux(dvbpsi_t *p_dvbpsi, dvbpsi_psi_section_t *p_section);
>   * \param p_decoder pointer to private decoder.
>   * \return pointer to demux subtable decoder.
>   */
> +__attribute__((deprecated))
>  dvbpsi_demux_subdec_t *dvbpsi_NewDemuxSubDecoder(const uint8_t i_table_id,
>                                                   const uint16_t i_extension,
>                                                   dvbpsi_demux_detach_cb_t pf_detach,
> @@ -215,6 +221,7 @@ dvbpsi_demux_subdec_t *dvbpsi_NewDemuxSubDecoder(const uint8_t i_table_id,
>   * \param p_subdec pointer to demux subtable decoder.
>   * \return nothing.
>   */
> +__attribute__((deprecated))
>  void dvbpsi_DeleteDemuxSubDecoder(dvbpsi_demux_subdec_t *p_subdec);
>
>  /*****************************************************************************
> @@ -227,6 +234,7 @@ void dvbpsi_DeleteDemuxSubDecoder(dvbpsi_demux_subdec_t *p_subdec);
>   * \param p_subdec pointer to dvbpsi_demux_subdec_t
>   * \return nothing
>   */
> +__attribute__((deprecated))
>  void dvbpsi_AttachDemuxSubDecoder(dvbpsi_demux_t *p_demux, dvbpsi_demux_subdec_t *p_subdec);
>
>  /*****************************************************************************
> @@ -239,6 +247,7 @@ void dvbpsi_AttachDemuxSubDecoder(dvbpsi_demux_t *p_demux, dvbpsi_demux_subdec_t
>   * \param p_subdec pointer to dvbpsi_demux_subdec_t
>   * \return nothing
>   */
> +__attribute__((deprecated))
>  void dvbpsi_DetachDemuxSubDecoder(dvbpsi_demux_t *p_demux, dvbpsi_demux_subdec_t *p_subdec);
>
>  #ifdef __cplusplus
>
> _______________________________________________
> libdvbpsi-devel mailing list
> libdvbpsi-devel at videolan.org
> https://mailman.videolan.org/listinfo/libdvbpsi-devel