X-Git-Url: http://review.tizen.org/git/?a=blobdiff_plain;f=glib%2Fgbase64.c;h=a6cbea459bca7368383ef476461360fe4d09ed21;hb=35eaf037bdfca985abf5d349e7355f1d2ed9c77b;hp=7c7ab7b97a6e16114b17eb1349a07b5ab16942aa;hpb=078dbda148a81af1b3a76fbda72f089b963087f1;p=platform%2Fupstream%2Fglib.git diff --git a/glib/gbase64.c b/glib/gbase64.c index 7c7ab7b..a6cbea4 100644 --- a/glib/gbase64.c +++ b/glib/gbase64.c @@ -37,9 +37,11 @@ * * Base64 is an encoding that allows a sequence of arbitrary bytes to be * encoded as a sequence of printable ASCII characters. For the definition - * of Base64, see RFC - * 1421 or RFC - * 2045. Base64 is most commonly used as a MIME transfer encoding + * of Base64, see + * [RFC 1421](http://www.ietf.org/rfc/rfc1421.txt) + * or + * [RFC 2045](http://www.ietf.org/rfc/rfc2045.txt). + * Base64 is most commonly used as a MIME transfer encoding * for email. * * GLib supports incremental encoding using g_base64_encode_step() and @@ -79,11 +81,11 @@ static const char base64_alphabet[] = * @break_lines is typically used when putting base64-encoded data in emails. * It breaks the lines at 72 columns instead of putting all of the text on * the same line. This avoids problems with long lines in the email system. - * Note however that it breaks the lines with LF - * characters, not CR LF sequences, so the result cannot - * be passed directly to SMTP or certain other protocols. + * Note however that it breaks the lines with `LF` characters, not + * `CR LF` sequences, so the result cannot be passed directly to SMTP + * or certain other protocols. * - * Return value: The number of bytes of output that was written + * Returns: The number of bytes of output that was written * * Since: 2.12 */ @@ -190,7 +192,7 @@ g_base64_encode_step (const guchar *in, * be written to it. It will need up to 4 bytes, or up to 5 bytes if * line-breaking is enabled. * - * Return value: The number of bytes of output that was written + * Returns: The number of bytes of output that was written * * Since: 2.12 */ @@ -242,7 +244,7 @@ g_base64_encode_close (gboolean break_lines, * Encode a sequence of binary data into its Base-64 stringified * representation. * - * Return value: (transfer full): a newly allocated, zero-terminated Base-64 + * Returns: (transfer full): a newly allocated, zero-terminated Base-64 * encoded string representing @data. The returned string must * be freed with g_free(). * @@ -309,7 +311,7 @@ static const unsigned char mime_base64_rank[256] = { * at least: (@len / 4) * 3 + 3 bytes (+ 3 may be needed in case of non-zero * state). * - * Return value: The number of bytes of output that was written + * Returns: The number of bytes of output that was written * * Since: 2.12 **/ @@ -391,7 +393,7 @@ g_base64_decode_step (const gchar *in, * that the returned binary data is not necessarily zero-terminated, * so it should not be used as a character string. * - * Return value: (transfer full) (array length=out_len) (element-type guint8): + * Returns: (transfer full) (array length=out_len) (element-type guint8): * newly allocated buffer containing the binary data * that @text represents. The returned buffer must * be freed with g_free(). @@ -430,7 +432,7 @@ g_base64_decode (const gchar *text, * Decode a sequence of Base-64 encoded text into binary data * by overwriting the input data. * - * Return value: (transfer none): The binary data that @text responds. This pointer + * Returns: (transfer none): The binary data that @text responds. This pointer * is the same as the input @text. * * Since: 2.20