Opened 10 years ago

Last modified 10 years ago

#8355 new Bugs

spsc_queue - Incorrect doc for push/pop array operations — at Version 1

Reported by: viboes Owned by: timblechmann
Milestone: To Be Determined Component: lockfree
Version: Boost 1.53.0 Severity: Cosmetic
Keywords: Cc:

Description (last modified by viboes)

The operations

    template <size_type size>
    size_type push(T const (&t)[size]);
    template <size_type size>
    size_type pop(T (&ret)[size]);

are documented as

template<size_type size> size_type push(T const (&) t);
template<size_type size> size_type pop(T (&) t);

I don't know if this is a doxygen problem, but the doc should be updated to show the real prototype.

Adding something like the following would at least warm the user.

     * \note Doxygen has some issues generating this prototype. The real prototype is:
     * \code
     *     template <size_type size>
     *     size_type push(T const (&t)[size]);
     * \endcode

and

     * \note Doxygen has some issues generating this prototype. The real prototype is:
     * \code
     *     template <size_type size>
     *     size_type pop(T (&ret)[size]);
     * \endcode

Change History (1)

comment:1 by viboes, 10 years ago

Description: modified (diff)
Note: See TracTickets for help on using tickets.