* @param str The string to append.
* @return #EINA_TRUE on success, #EINA_FALSE on failure.
*
- * This function appends the escaped string @p str to @p buf. If @p
- * str can not be appended, #EINA_FALSE is returned, otherwise,
- * #EINA_TRUE is returned.
+ * This function escapes and then appends the string @p str to @p buf. If @p str
+ * can not be appended, #EINA_FALSE is returned, otherwise, #EINA_TRUE is
+ * returned.
*/
EAPI Eina_Bool eina_strbuf_append_escaped(Eina_Strbuf *buf, const char *str) EINA_ARG_NONNULL(1, 2);
* @return #EINA_TRUE on success, #EINA_FALSE on failure.
*
* This function appends at most @p maxlen characters of @p str to
- * @p buf. It can't appends more than the length of @p str. It
- * computes the length of @p str, so is slightly slower than
+ * @p buf. It can't append more than the length of @p str. It
+ * computes the length of @p str, so it is slightly slower than
* eina_strbuf_append_length(). If the length is known beforehand,
* consider using that variant (@p maxlen should then be checked so
* that it is greater than the size of @p str). If @p str can not be
* @param fmt The string to append.
* @return #EINA_TRUE on success, #EINA_FALSE on failure.
*
+ * This function appends the string defined by the format @p fmt to @p buf. @p
+ * fmt must be of a valid format for printf family of functions. If it can't
+ * insert it, #EINA_FALSE is returned, otherwise #EINA_TRUE is returned.
+ *
* @see eina_strbuf_append()
*/
EAPI Eina_Bool eina_strbuf_append_printf(Eina_Strbuf *buf, const char *fmt, ...) EINA_ARG_NONNULL(1, 2) EINA_PRINTF(2, 3);
* @param args The variable arguments.
* @return #EINA_TRUE on success, #EINA_FALSE on failure.
*
- * @see eina_strbuf_append()
+ * @see eina_strbuf_append_printf()
*/
EAPI Eina_Bool eina_strbuf_append_vprintf(Eina_Strbuf *buf, const char *fmt, va_list args) EINA_ARG_NONNULL(1, 2);
* @param pos The position to insert the string.
* @return #EINA_TRUE on success, #EINA_FALSE on failure.
*
- * This function inserts the escaped string @p str to @p buf at
+ * This function escapes and inserts the string @p str to @p buf at
* position @p pos. If @p buf can't insert @p str, #EINA_FALSE is
* returned, otherwise #EINA_TRUE is returned.
*/
* @param pos The position to insert the string.
* @return #EINA_TRUE on success, #EINA_FALSE on failure.
*
- * This function inserts @p str ot @p buf at position @p pos, with at
+ * This function inserts @p str to @p buf at position @p pos, with at
* most @p maxlen bytes. The number of inserted characters can not be
* greater than the length of @p str. It computes the length of
* @p str, so is slightly slower than eina_strbuf_insert_length(). If the
* @param fmt The string to insert.
* @param pos The position to insert the string.
* @return #EINA_TRUE on success, #EINA_FALSE on failure.
+ *
+ * This function insert a string as described by the format @p fmt to @p buf at
+ * the position @p pos. @p fmt must be of a valid format for printf family of
+ * functions. If it can't insert it, #EINA_FALSE is returned, otherwise
+ * #EINA_TRUE is returned.
*/
EAPI Eina_Bool eina_strbuf_insert_printf(Eina_Strbuf *buf, const char *fmt, size_t pos, ...) EINA_ARG_NONNULL(1, 2) EINA_PRINTF(2, 4);
* @param pos The position to insert the string.
* @param args The variable arguments.
* @return #EINA_TRUE on success, #EINA_FALSE on failure.
+ *
+ * @see eina_strbuf_insert_printf
*/
EAPI Eina_Bool eina_strbuf_insert_vprintf(Eina_Strbuf *buf, const char *fmt, size_t pos, va_list args) EINA_ARG_NONNULL(1, 2);
* @param str The string to prepend.
* @return #EINA_TRUE on success, #EINA_FALSE on failure.
*
- * This macro is calling eina_strbuf_insert() at position 0.If @p buf
+ * This macro is calling eina_strbuf_insert() at position 0. If @p buf
* can't prepend it, #EINA_FALSE is returned, otherwise #EINA_TRUE is
* returned.
*/
* This function returns the string contained in @p buf. The returned
* value must not be modified and will no longer be valid if @p buf is
* modified. In other words, any eina_strbuf_append() or similar will
- * make that pointer invalid.
+ * make that pointer invalid. The pointer returned by this function <b>must
+ * not</b> be freed.
*
* @see eina_strbuf_string_steal()
*/
* @param with The replaceing string.
* @return How often the string was replaced.
*
- * This function replaces all the occurrences of @p str in @ buf with
+ * This function replaces all the occurrences of @p str in @p buf with
* the string @p with. This function returns the number of times @p str
* has been replaced. On failure, it returns 0.
*/