Re: Any objections to moving the perlapi's "NOTE: this functionis experimental" to the beginning of its entry

On Tue, Apr 30, 2013 at 08:33:03AM -0600, Karl Williamson wrote:
> Quite a few functions in the API are marked as experimental.  I
> think each should be highlighted by having that fact the first thing
> in the entry.  As an example, here's what a typical entry would look
> like:
> 
> av_create_and_push
>        NOTE: this function is experimental and may change or be
>        removed without notice.
> 
>        Push an SV onto the end of the array, creating the array if
>        necessary.  A small internal helper function to remove a
>        commonly duplicated idiom.
> 
>                void    av_create_and_push(AV **const avp,
>                                           SV *const val)
> 
> Are there any objections?

This makes sense to me.

Tony

• Any objections to moving the perlapi's "NOTE: this function is experimental"to the beginning of its entry by Karl Williamson
• Re: Any objections to moving the perlapi's "NOTE: this function isexperimental" to the beginning of its entry by Ricardo Signes
• Re: Any objections to moving the perlapi's "NOTE: this functionis experimental" to the beginning of its entry by Tony Cook
• Re: Any objections to moving the perlapi's "NOTE: this functionis experimental" to the beginning of its entry by Karl Williamson
• Re: Any objections to moving the perlapi's "NOTE: this functionis experimental" to the beginning of its entry by Tony Cook