[gmime] Added (nullable) attribute for Parser and FormatOptions

From: Jeffrey Stedfast <fejj src gnome org>
To: commits-list gnome org
Cc:
Subject: [gmime] Added (nullable) attribute for Parser and FormatOptions
Date: Thu, 30 Mar 2017 23:15:58 +0000 (UTC)
commit 407828f95b52b955c031fae10e0affc1a82f690c
Author: Jeffrey Stedfast <jestedfa microsoft com>
Date:   Thu Mar 30 15:17:07 2017 -0400

    Added (nullable) attribute for Parser and FormatOptions

 gmime/gmime-content-type.c   |    4 ++--
 gmime/gmime-disposition.c    |    4 ++--
 gmime/gmime-format-options.c |   20 ++++++++++----------
 gmime/gmime-header.c         |   28 +++++++++++++---------------
 gmime/gmime-object.c         |   10 +++++-----
 gmime/gmime-parser-options.c |   10 +++++-----
 gmime/gmime-parser.c         |    4 ++--
 gmime/gmime-references.c     |    2 +-
 gmime/gmime-utils.c          |   34 +++++++++++++++++-----------------
 gmime/internet-address.c     |    8 ++++----
 10 files changed, 61 insertions(+), 63 deletions(-)
---
diff --git a/gmime/gmime-content-type.c b/gmime/gmime-content-type.c
index b0516ab..fc7abbc 100644
--- a/gmime/gmime-content-type.c
+++ b/gmime/gmime-content-type.c
@@ -177,7 +177,7 @@ g_mime_content_type_new (const char *type, const char *subtype)
 
 /**
  * g_mime_content_type_parse:
- * @options: a #GMimeParserOptions or %NULL
+ * @options: (nullable): a #GMimeParserOptions or %NULL
  * @str: input string containing a content-type (and params)
  *
  * Parses the input string into a #GMimeContentType object.
@@ -244,7 +244,7 @@ g_mime_content_type_get_mime_type (GMimeContentType *content_type)
 /**
  * g_mime_content_type_encode:
  * @content_type: a #GMimeContentType
- * @options: a #GMimeFormatOptions or %NULL
+ * @options: (nullable): a #GMimeFormatOptions or %NULL
  *
  * Encodes the Content-Disposition header.
  *
diff --git a/gmime/gmime-disposition.c b/gmime/gmime-disposition.c
index ac76de1..8b84d26 100644
--- a/gmime/gmime-disposition.c
+++ b/gmime/gmime-disposition.c
@@ -138,7 +138,7 @@ g_mime_content_disposition_new (void)
 
 /**
  * g_mime_content_disposition_parse:
- * @options: a #GMimeParserOptions or %NULL
+ * @options: (nullable): a #GMimeParserOptions or %NULL
  * @str: Content-Disposition field value
  *
  * Parses the input string into a #GMimeContentDisposition object.
@@ -306,7 +306,7 @@ g_mime_content_disposition_is_attachment (GMimeContentDisposition *disposition)
 /**
  * g_mime_content_disposition_encode:
  * @disposition: a #GMimeContentDisposition object
- * @options: a #GMimeFormatOptions or %NULL
+ * @options: (nullable): a #GMimeFormatOptions or %NULL
  *
  * Encodes the Content-Disposition header.
  *
diff --git a/gmime/gmime-format-options.c b/gmime/gmime-format-options.c
index 3883005..88528a6 100644
--- a/gmime/gmime-format-options.c
+++ b/gmime/gmime-format-options.c
@@ -109,7 +109,7 @@ g_mime_format_options_new (void)
 
 /**
  * _g_mime_format_options_clone:
- * @options: a #GMimeFormatOptions
+ * @options: (nullable): a #GMimeFormatOptions or %NULL
  * @hidden: %TRUE if the hidden headers should also be cloned
  *
  * Clones a #GMimeFormatOptions.
@@ -145,7 +145,7 @@ _g_mime_format_options_clone (GMimeFormatOptions *options, gboolean hidden)
 
 /**
  * g_mime_format_options_clone:
- * @options: a #GMimeFormatOptions
+ * @options: (nullable): a #GMimeFormatOptions or %NULL
  *
  * Clones a #GMimeFormatOptions.
  *
@@ -183,7 +183,7 @@ g_mime_format_options_free (GMimeFormatOptions *options)
 
 /**
  * g_mime_format_options_get_param_encoding_method:
- * @options: a #GMimeFormatOptions or %NULL
+ * @options: (nullable): a #GMimeFormatOptions or %NULL
  *
  * Gets the parameter encoding method to use for #GMimeParam parameters that do not
  * already have an encoding method specified.
@@ -219,7 +219,7 @@ g_mime_format_options_set_param_encoding_method (GMimeFormatOptions *options, GM
 
 /**
  * g_mime_format_options_get_newline_format:
- * @options: a #GMimeFormatOptions or %NULL
+ * @options: (nullable): a #GMimeFormatOptions or %NULL
  *
  * Gets the new-line format to use when writing out messages and headers.
  *
@@ -251,7 +251,7 @@ g_mime_format_options_set_newline_format (GMimeFormatOptions *options, GMimeNewL
 
 /**
  * g_mime_format_options_get_newline:
- * @options: a #GMimeFormatOptions or %NULL
+ * @options: (nullable): a #GMimeFormatOptions or %NULL
  *
  * Gets a string representing the currently set new-line format.
  *
@@ -272,7 +272,7 @@ g_mime_format_options_get_newline (GMimeFormatOptions *options)
 
 /**
  * g_mime_format_options_create_newline_filter:
- * @options: a #GMimeFormatOptions or %NULL
+ * @options: (nullable): a #GMimeFormatOptions or %NULL
  * @ensure_newline: %TRUE if the output must *always* end with a new line
  *
  * Creates a #GMimeFilter suitable for converting line-endings to the
@@ -296,7 +296,7 @@ g_mime_format_options_create_newline_filter (GMimeFormatOptions *options, gboole
 #ifdef NOT_YET_IMPLEMENTED
 /**
  * g_mime_format_options_get_allow_mixed_charsets:
- * @options: a #GMimeFormatOptions or %NULL
+ * @options: (nullable): a #GMimeFormatOptions or %NULL
  *
  * Gets whether or not headers are allowed to be encoded using mixed charsets.
  *
@@ -330,7 +330,7 @@ g_mime_format_options_set_allow_mixed_charsets (GMimeFormatOptions *options, gbo
 
 /**
  * g_mime_format_options_get_allow_international:
- * @options: a #GMimeFormatOptions or %NULL
+ * @options: (nullable): a #GMimeFormatOptions or %NULL
  *
  * Gets whether or not international encoding is allowed.
  *
@@ -361,7 +361,7 @@ g_mime_format_options_set_allow_international (GMimeFormatOptions *options, gboo
 
 /**
  * g_mime_format_options_get_max_line:
- * @options: a #GMimeFormatOptions or %NULL
+ * @options: (nullable): a #GMimeFormatOptions or %NULL
  *
  * Gets the max line length to use with encoders.
  *
@@ -392,7 +392,7 @@ g_mime_format_options_set_max_line (GMimeFormatOptions *options, guint maxline)
 
 /**
  * g_mime_format_options_is_hidden_header:
- * @options: a #GMimeFormatOptions
+ * @options: (nullable): a #GMimeFormatOptions or %NULL
  * @header: the name of a header
  *
  * Gets whether or not the specified header should be hidden.
diff --git a/gmime/gmime-header.c b/gmime/gmime-header.c
index eaa6ca5..a83b8a5 100644
--- a/gmime/gmime-header.c
+++ b/gmime/gmime-header.c
@@ -149,7 +149,7 @@ g_mime_header_finalize (GObject *object)
 
 /**
  * g_mime_header_new:
- * @options: a #GMimeParserOptions or %NULL
+ * @options: (nullable): a #GMimeParserOptions or %NULL
  * @name: header name
  * @value: header value
  * @raw_value: raw header value
@@ -271,7 +271,7 @@ g_mime_header_get_value (GMimeHeader *header)
 /**
  * g_mime_header_set_value:
  * @header: a #GMimeHeader
- * @options: a #GMimeFormatOptions or %NULL
+ * @options: (nullable): a #GMimeFormatOptions or %NULL
  * @value: the new header value
  * @charset: a charset
  *
@@ -402,7 +402,7 @@ _g_mime_header_set_offset (GMimeHeader *header, gint64 offset)
 /**
  * g_mime_header_write_to_stream:
  * @header: a #GMimeHeader
- * @options: a #GMimeFormatOptions or %NULL
+ * @options: (nullable): a #GMimeFormatOptions or %NULL
  * @stream: a #GMimeStream
  *
  * Write the header to the specified stream.
@@ -437,7 +437,7 @@ g_mime_header_write_to_stream (GMimeHeader *header, GMimeFormatOptions *options,
 /**
  * g_mime_header_format_content_disposition:
  * @header: a #GMimeHeader
- * @options: a #GMimeFormatOptions or %NULL
+ * @options: (nullable): a #GMimeFormatOptions or %NULL
  * @value: a Content-Disposition header value
  * @charset: a charset (note: unused)
  *
@@ -474,7 +474,7 @@ g_mime_header_format_content_disposition (GMimeHeader *header, GMimeFormatOption
 /**
  * g_mime_header_format_content_type:
  * @header: a #GMimeHeader
- * @options: a #GMimeFormatOptions or %NULL
+ * @options: (nullable): a #GMimeFormatOptions or %NULL
  * @value: a Content-Type header value
  * @charset: a charset (note: unused)
  *
@@ -513,7 +513,7 @@ g_mime_header_format_content_type (GMimeHeader *header, GMimeFormatOptions *opti
 /**
  * g_mime_header_format_message_id:
  * @header: a #GMimeHeader
- * @options: a #GMimeFormatOptions or %NULL
+ * @options: (nullable): a #GMimeFormatOptions or %NULL
  * @value: a Message-Id or Content-Id header value
  * @charset: a charset (note: unused)
  *
@@ -534,7 +534,7 @@ g_mime_header_format_message_id (GMimeHeader *header, GMimeFormatOptions *option
 /**
  * g_mime_header_format_references:
  * @header: a #GMimeHeader
- * @options: a #GMimeFormatOptions or %NULL
+ * @options: (nullable): a #GMimeFormatOptions or %NULL
  * @value: a References or In-Reply-To header value
  * @charset: a charset (note: unused)
  *
@@ -592,7 +592,7 @@ g_mime_header_format_references (GMimeHeader *header, GMimeFormatOptions *option
 /**
  * g_mime_header_format_addrlist:
  * @header: a #GMimeHeader
- * @options: a #GMimeFormatOptions or %NULL
+ * @options: (nullable): a #GMimeFormatOptions or %NULL
  * @value: a Sender, From, Reply-To, To, Cc, or Bcc header value
  * @charset: a charset (note: unused)
  *
@@ -787,7 +787,7 @@ struct _received_part {
 /**
  * g_mime_header_format_received:
  * @header: a #GMimeHeader
- * @options: a #GMimeFormatOptions or %NULL
+ * @options: (nullable): a #GMimeFormatOptions or %NULL
  * @value: a Received header value
  * @charset: a charset (note: unused)
  *
@@ -917,7 +917,7 @@ g_mime_header_format_received (GMimeHeader *header, GMimeFormatOptions *options,
 /**
  * g_mime_header_format_default:
  * @header: a #GMimeHeader
- * @options: a #GMimeFormatOptions or %NULL
+ * @options: (nullable): a #GMimeFormatOptions or %NULL
  * @value: a header value
  * @charset: a charset to use when encoding the @value
  *
@@ -1028,7 +1028,7 @@ g_mime_header_list_finalize (GObject *object)
 
 /**
  * g_mime_header_list_new:
- * @options: a #GMimeParserOptions or %NULL
+ * @options: (nullable): a #GMimeParserOptions or %NULL
  *
  * Creates a new #GMimeHeaderList object.
  *
@@ -1039,8 +1039,6 @@ g_mime_header_list_new (GMimeParserOptions *options)
 {
        GMimeHeaderList *headers;
        
-       g_return_val_if_fail (options != NULL, NULL);
-       
        headers = g_object_newv (GMIME_TYPE_HEADER_LIST, 0, NULL);
        headers->options = g_mime_parser_options_clone (options);
        
@@ -1475,7 +1473,7 @@ g_mime_header_list_remove_at (GMimeHeaderList *headers, int index)
 /**
  * g_mime_header_list_write_to_stream:
  * @headers: a #GMimeHeaderList
- * @options: a #GMimeFormatOptions or %NULL
+ * @options: (nullable): a #GMimeFormatOptions or %NULL
  * @stream: output stream
  *
  * Write the headers to a stream.
@@ -1520,7 +1518,7 @@ g_mime_header_list_write_to_stream (GMimeHeaderList *headers, GMimeFormatOptions
 /**
  * g_mime_header_list_to_string:
  * @headers: a #GMimeHeaderList
- * @options: a #GMimeFormatOptions or %NULL
+ * @options: (nullable): a #GMimeFormatOptions or %NULL
  *
  * Allocates a string buffer containing the raw rfc822 headers
  * contained in @headers.
diff --git a/gmime/gmime-object.c b/gmime/gmime-object.c
index 30cc469..92377ae 100644
--- a/gmime/gmime-object.c
+++ b/gmime/gmime-object.c
@@ -386,7 +386,7 @@ g_mime_object_register_type (const char *type, const char *subtype, GType object
 
 /**
  * g_mime_object_new:
- * @options: a #GMimeParserOptions
+ * @options: (nullable): a #GMimeParserOptions or %NULL
  * @content_type: a #GMimeContentType object
  *
  * Performs a lookup of registered #GMimeObject subclasses, registered
@@ -442,7 +442,7 @@ g_mime_object_new (GMimeParserOptions *options, GMimeContentType *content_type)
 
 /**
  * g_mime_object_new_type:
- * @options: a #GMimeParserOptions
+ * @options: (nullable): a #GMimeParserOptions or %NULL
  * @type: mime type
  * @subtype: mime subtype
  *
@@ -940,7 +940,7 @@ object_get_headers (GMimeObject *object, GMimeFormatOptions *options)
 /**
  * g_mime_object_get_headers:
  * @object: a #GMimeObject
- * @options: a #GMimeFormatOptions
+ * @options: (nullable): a #GMimeFormatOptions or %NULL
  *
  * Allocates a string buffer containing all of the MIME object's raw
  * headers.
@@ -968,7 +968,7 @@ object_write_to_stream (GMimeObject *object, GMimeFormatOptions *options, gboole
 /**
  * g_mime_object_write_to_stream:
  * @object: a #GMimeObject
- * @options: a #GMimeFormatOptions
+ * @options: (nullable): a #GMimeFormatOptions or %NULL
  * @stream: stream
  *
  * Write the contents of the MIME object to @stream.
@@ -1013,7 +1013,7 @@ g_mime_object_encode (GMimeObject *object, GMimeEncodingConstraint constraint)
 /**
  * g_mime_object_to_string:
  * @object: a #GMimeObject
- * @options: a #GMimeFormatOptions
+ * @options: (nullable): a #GMimeFormatOptions or %NULL
  *
  * Allocates a string buffer containing the contents of @object.
  *
diff --git a/gmime/gmime-parser-options.c b/gmime/gmime-parser-options.c
index 627ce9b..9531ae9 100644
--- a/gmime/gmime-parser-options.c
+++ b/gmime/gmime-parser-options.c
@@ -107,7 +107,7 @@ g_mime_parser_options_new (void)
 
 /**
  * g_mime_parser_options_clone:
- * @options: a #GMimeParserOptions
+ * @options: (nullable): a #GMimeParserOptions or %NULL
  *
  * Clones a #GMimeParserOptions.
  *
@@ -159,7 +159,7 @@ g_mime_parser_options_free (GMimeParserOptions *options)
 
 /**
  * g_mime_parser_options_get_address_compliance_mode:
- * @options: a #GMimeParserOptions or %NULL
+ * @options: (nullable): a #GMimeParserOptions or %NULL
  *
  * Gets the compliance mode that should be used when parsing rfc822 addresses.
  *
@@ -202,7 +202,7 @@ g_mime_parser_options_set_address_compliance_mode (GMimeParserOptions *options,
 
 /**
  * g_mime_parser_options_get_parameter_compliance_mode:
- * @options: a #GMimeParserOptions or %NULL
+ * @options: (nullable): a #GMimeParserOptions or %NULL
  *
  * Gets the compliance mode that should be used when parsing Content-Type and
  * Content-Disposition parameters.
@@ -247,7 +247,7 @@ g_mime_parser_options_set_parameter_compliance_mode (GMimeParserOptions *options
 
 /**
  * g_mime_parser_options_get_rfc2047_compliance_mode:
- * @options: a #GMimeParserOptions or %NULL
+ * @options: (nullable): a #GMimeParserOptions or %NULL
  *
  * Gets the compliance mode that should be used when parsing rfc2047 encoded words.
  *
@@ -290,7 +290,7 @@ g_mime_parser_options_set_rfc2047_compliance_mode (GMimeParserOptions *options,
 
 /**
  * g_mime_parser_options_get_fallback_charsets:
- * @options: a #GMimeParserOptions or %NULL
+ * @options: (nullable): a #GMimeParserOptions or %NULL
  *
  * Gets the fallback charsets to try when decoding 8-bit headers.
  *
diff --git a/gmime/gmime-parser.c b/gmime/gmime-parser.c
index d4cef20..f1b15a7 100644
--- a/gmime/gmime-parser.c
+++ b/gmime/gmime-parser.c
@@ -1898,7 +1898,7 @@ parser_construct_part (GMimeParser *parser, GMimeParserOptions *options)
 /**
  * g_mime_parser_construct_part:
  * @parser: a #GMimeParser context
- * @options: a #GMimeParserOptions or %NULL for the default options
+ * @options: (nullable): a #GMimeParserOptions or %NULL
  *
  * Constructs a MIME part from @parser.
  *
@@ -1992,7 +1992,7 @@ parser_construct_message (GMimeParser *parser, GMimeParserOptions *options)
 /**
  * g_mime_parser_construct_message:
  * @parser: a #GMimeParser context
- * @options: a #GMimeParserOptions or %NULL for the default options
+ * @options: (nullable): a #GMimeParserOptions or %NULL
  *
  * Constructs a MIME message from @parser.
  *
diff --git a/gmime/gmime-references.c b/gmime/gmime-references.c
index 71a5346..c7e6e37 100644
--- a/gmime/gmime-references.c
+++ b/gmime/gmime-references.c
@@ -89,7 +89,7 @@ g_mime_references_free (GMimeReferences *refs)
 
 /**
  * g_mime_references_parse:
- * @options: a #GMimeParserOptions or %NULL
+ * @options: (nullable): a #GMimeParserOptions or %NULL
  * @text: string containing a list of msg-ids
  *
  * Decodes a list of msg-ids as in the References and/or In-Reply-To
diff --git a/gmime/gmime-utils.c b/gmime/gmime-utils.c
index 792eef7..de3987c 100644
--- a/gmime/gmime-utils.c
+++ b/gmime/gmime-utils.c
@@ -1150,7 +1150,7 @@ charset_convert (iconv_t cd, const char *inbuf, size_t inleft, char **outp, size
 
 /**
  * g_mime_utils_decode_8bit:
- * @options: a #GMimeParserOptions or %NULL
+ * @options: (nullable): a #GMimeParserOptions or %NULL
  * @text: (array length=len) (element-type guint8): input text in
  *   unknown 8bit/multibyte character set
  * @len: input text length
@@ -1860,7 +1860,7 @@ rfc2047_decode_tokens (GMimeParserOptions *options, rfc2047_token *tokens, size_
 /**
  * _g_mime_utils_header_decode_text:
  * @text: header text to decode
- * @options: a #GMimeParserOptions or %NULL
+ * @options: (nullable): a #GMimeParserOptions or %NULL
  * @charset: if non-%NULL, this will be set to the charset used in the rfc2047 encoded-word tokens
  *
  * Decodes an rfc2047 encoded 'text' header.
@@ -1893,7 +1893,7 @@ _g_mime_utils_header_decode_text (GMimeParserOptions *options, const char *text,
 /**
  * g_mime_utils_header_decode_text:
  * @text: header text to decode
- * @options: a #GMimeParserOptions or %NULL
+ * @options: (nullable): a #GMimeParserOptions or %NULL
  *
  * Decodes an rfc2047 encoded 'text' header.
  *
@@ -1910,7 +1910,7 @@ g_mime_utils_header_decode_text (GMimeParserOptions *options, const char *text)
 /**
  * _g_mime_utils_header_decode_phrase:
  * @phrase: header to decode
- * @options: a #GMimeParserOptions or %NULL
+ * @options: (nullable): a #GMimeParserOptions or %NULL
  * @charset: if non-%NULL, this will be set to the charset used in the rfc2047 encoded-word tokens
  *
  * Decodes an rfc2047 encoded 'phrase' header.
@@ -1943,7 +1943,7 @@ _g_mime_utils_header_decode_phrase (GMimeParserOptions *options, const char *phr
 /**
  * g_mime_utils_header_decode_phrase:
  * @phrase: header to decode
- * @options: a #GMimeParserOptions or %NULL
+ * @options: (nullable): a #GMimeParserOptions or %NULL
  *
  * Decodes an rfc2047 encoded 'phrase' header.
  *
@@ -2401,7 +2401,7 @@ rfc2047_encode (GMimeFormatOptions *options, const char *in, gushort safemask, c
 
 /**
  * g_mime_utils_header_encode_phrase:
- * @options: a #GMimeFormatOptions or %NULL
+ * @options: (nullable): a #GMimeFormatOptions or %NULL
  * @phrase: phrase to encode
  * @charset: the charset to use or %NULL to use the default
  *
@@ -2422,7 +2422,7 @@ g_mime_utils_header_encode_phrase (GMimeFormatOptions *options, const char *phra
 
 /**
  * g_mime_utils_header_encode_text:
- * @options: a #GMimeFormatOptions or %NULL
+ * @options: (nullable): a #GMimeFormatOptions or %NULL
  * @text: text to encode
  * @charset: the charset to use or %NULL to use the default
  *
@@ -2570,8 +2570,8 @@ header_fold_tokens (GMimeFormatOptions *options, const char *field, const char *
 
 /**
  * g_mime_utils_structured_header_fold:
- * @options: a #GMimeParserOptions or %NULL
- * @format: a #GMimeFormatOptions or %NULL
+ * @options: (nullable): a #GMimeParserOptions or %NULL
+ * @format: (nullable): a #GMimeFormatOptions or %NULL
  * @header: header field and value string
  *
  * Folds a structured header according to the rules in rfc822.
@@ -2613,8 +2613,8 @@ g_mime_utils_structured_header_fold (GMimeParserOptions *options, GMimeFormatOpt
 
 /**
  * _g_mime_utils_structured_header_fold:
- * @options: a #GMimeParserOptions or %NULL
- * @format: a #GMimeFormatOptions or %NULL
+ * @options: (nullable): a #GMimeParserOptions or %NULL
+ * @format: (nullable): a #GMimeFormatOptions or %NULL
  * @field: header field
  * @value: header value
  *
@@ -2643,8 +2643,8 @@ _g_mime_utils_structured_header_fold (GMimeParserOptions *options, GMimeFormatOp
 
 /**
  * g_mime_utils_unstructured_header_fold:
- * @options: a #GMimeParserOptions or %NULL
- * @format: a #GMimeFormatOptions or %NULL
+ * @options: (nullable): a #GMimeParserOptions or %NULL
+ * @format: (nullable): a #GMimeFormatOptions or %NULL
  * @header: header field and value string
  *
  * Folds an unstructured header according to the rules in rfc822.
@@ -2686,8 +2686,8 @@ g_mime_utils_unstructured_header_fold (GMimeParserOptions *options, GMimeFormatO
 
 /**
  * _g_mime_utils_unstructured_header_fold:
- * @options: a #GMimeParserOptions or %NULL
- * @format: a #GMimeFormatOptions or %NULL
+ * @options: (nullable): a #GMimeParserOptions or %NULL
+ * @format: (nullable): a #GMimeFormatOptions or %NULL
  * @field: header field
  * @value: header value
  *
@@ -2715,8 +2715,8 @@ _g_mime_utils_unstructured_header_fold (GMimeParserOptions *options, GMimeFormat
 
 /**
  * g_mime_utils_header_printf:
- * @options: a #GMimeParserOptions or %NULL
- * @format: a #GMimeFormatOptions or %NULL
+ * @options: (nullable): a #GMimeParserOptions or %NULL
+ * @format: (nullable): a #GMimeFormatOptions or %NULL
  * @text: text with printf-style formatters
  * @...: arguments
  *
diff --git a/gmime/internet-address.c b/gmime/internet-address.c
index 451377a..e2af784 100644
--- a/gmime/internet-address.c
+++ b/gmime/internet-address.c
@@ -252,7 +252,7 @@ internet_address_get_charset (InternetAddress *ia)
 /**
  * internet_address_to_string:
  * @ia: Internet Address object
- * @options: a #GMimeFormatOptions
+ * @options: (nullable): a #GMimeFormatOptions or %NULL
  * @encode: %TRUE if the address should be rfc2047 encoded
  *
  * Allocates a string containing the contents of the #InternetAddress
@@ -1240,7 +1240,7 @@ group_to_string (InternetAddress *ia, GMimeFormatOptions *options, guint32 flags
 /**
  * internet_address_list_to_string:
  * @list: list of internet addresses
- * @options: a #GMimeFormatOptions
+ * @options: (nullable): a #GMimeFormatOptions or %NULL
  * @encode: %TRUE if the address should be rfc2047 encoded
  *
  * Allocates a string buffer containing the rfc822 formatted addresses
@@ -1271,7 +1271,7 @@ internet_address_list_to_string (InternetAddressList *list, GMimeFormatOptions *
 /**
  * internet_address_list_encode:
  * @list: list of internet addresses
- * @options: a #GMimeFormatOptions
+ * @options: (nullable): a #GMimeFormatOptions or %NULL
  * @str: string to write to
  *
  * Writes the rfc2047-encoded rfc822 formatted addresses in @list to
@@ -1998,7 +1998,7 @@ address_list_parse (InternetAddressList *list, GMimeParserOptions *options, cons
 
 /**
  * internet_address_list_parse:
- * @options: a #GMimeParserOptions
+ * @options: (nullable): a #GMimeParserOptions or %NULL
  * @str: a string containing internet addresses
  *
  * Construct a list of internet addresses from the given string.
[Date Prev][Date Next] [Thread Prev][Thread Next] [Thread Index] [Date Index] [Author Index]