48592 – Fix doc comments for recent stricter gtk-doc

Bug 48592 - Fix doc comments for recent stricter gtk-doc

Summary: Fix doc comments for recent stricter gtk-doc

Status:	RESOLVED FIXED

Alias:	None

Product:	Telepathy
Classification:	Unclassified
Component:	tp-glib (show other bugs)
Version:	unspecified
Hardware:	All All

Importance:	medium normal
Assignee:	Telepathy bugs list
QA Contact:	Telepathy bugs list

URL:
Whiteboard:
Keywords:

Depends on:
Blocks:

Reported:	2012-04-12 02:49 UTC by Stef Walter
Modified:	2012-04-12 08:06 UTC (History)
CC List:	1 user (show)

See Also:
i915 platform:
i915 features:

Attachments
Fix doc comments for recent stricter gtk-doc (23.29 KB, patch) 2012-04-12 02:49 UTC, Stef Walter	Details \| Splinter Review
Fix auto-generated gtk-doc constant comment (793 bytes, patch) 2012-04-12 07:34 UTC, Stef Walter	Details \| Splinter Review
View All

Description Stef Walter 2012-04-12 02:49:30 UTC

Seems like gtk-doc 1.18.1 is stricter. Build failures below.
Discovered via jhbuild. This patch applies to the 0.18.x version
of telepathy-glib which is what jhbuild builds.

/data/build/bin/g-ir-scanner   --namespace=TelepathyGLib --nsversion=0.12 --libtool="/bin/sh ../libtool" --pkg=gio-2.0 --pkg=dbus-glib-1 --include=GLib-2.0 --include=Gio-2.0 --pkg-export=telepathy-glib  --library=libtelepathy-glib.la --identifier-prefix=Tp -I.. -I.. --c-include="telepathy-glib/telepathy-glib.h" --warn-all --warn-error    proxy.c _gen/proxy-introspectable.h account.c account.h account-channel-request.c account-channel-request.h account-manager.c account-manager.h automatic-client-factory.c automatic-client-factory.h automatic-proxy-factory.c automatic-proxy-factory.h basic-proxy-factory.c basic-proxy-factory.h client-channel-factory.c client-channel-factory.h connection.c connection.h connection-contact-list.c connection-contact-list.h connection-handles.c connection-contact-info.c connection-avatars.c protocol.c protocol.h connection-manager.c connection-manager.h channel.c channel.h channel-group.c channel-contacts.c handle.c handle.h handle-channels-context.c handle-channels-context.h dbus-daemon.c dbus-daemon.h interfaces.c intset.c intset.h dbus.c dbus.h capabilities.c capabilities.h contact.c contact.h contact-operations.c contact-operations.h contact-search.c contact-search.h contact-search-result.c contact-search-result.h defs.h debug.c debug.h base-client.c base-client.h simple-approver.c simple-approver.h simple-client-factory.c simple-client-factory.h simple-handler.c simple-handler.h simple-observer.c simple-observer.h dbus-properties-mixin.c dbus-properties-mixin.h contacts-mixin.c contacts-mixin.h group-mixin.c group-mixin.h presence-mixin.c presence-mixin.h channel-dispatch-operation.c channel-dispatch-operation.h channel-request.c channel-request.h observe-channels-context.c observe-channels-context.h add-dispatch-operation-context.c add-dispatch-operation-context.h base-connection.c base-connection.h handle-repo.c handle-repo.h handle-set.c stream-tube-channel.c stream-tube-channel.h dbus-tube-channel.c dbus-tube-channel.h stream-tube-connection.c stream-tube-connection.h text-channel.c text-channel.h file-transfer-channel.c file-transfer-channel.h call-channel.c call-channel.h call-content.c call-content.h call-stream.c call-stream.h client-message.c client-message.h message.c message.h signalled-message.c signalled-message.h channel-dispatcher.c channel-dispatcher.h errors.c errors.h _gen/telepathy-enums.h _gen/telepathy-enums-gtk-doc.h _gen/telepathy-interfaces.h libtelepathy-glib.la --output TelepathyGLib-0.12.gir
account.c:1726: Warning: TelepathyGLib: missing ':' at column 18:
   * TpAccount:nickname
                       ^
account.c:1829: Warning: TelepathyGLib: missing ':' at column 25:
   * TpAccount:normalized-name
                              ^
account.c:1928: Warning: TelepathyGLib: missing ':' at column 30:
   * TpAccount:storage-restrictions
                                   ^
protocol.c:606: Warning: TelepathyGLib: missing ':' at column 30:
   * TpProtocol:protocol-properties
                                   ^
protocol.c:1070: Warning: TelepathyGLib: missing ':' at column 36:
 * tp_protocol_get_authentication_types
                                       ^
protocol.c:1683: Warning: TelepathyGLib: missing ':' at column 35:
 * tp_protocol_get_avatar_requirements
                                      ^
base-client.c:164: Warning: TelepathyGLib: missing ':' at column 31:
 * TpBaseClientDelegatedChannelsCb
                                  ^
simple-client-factory.c:90: Warning: TelepathyGLib: multiple comment blocks documenting 'TpSimpleClientFactoryClass:' identifier.
dbus-properties-mixin.c:1096: Warning: TelepathyGLib: invalid annotation option: unqualified
presence-mixin.c:115: Warning: TelepathyGLib: missing ':' at column 36:
 * TpPresenceStatusOptionalArgumentSpec
                                       ^
presence-mixin.c:127: Warning: TelepathyGLib: missing ':' at column 20:
 * TpPresenceStatusSpec
                       ^
presence-mixin.c:307: Warning: TelepathyGLib: missing ':' at column 19:
 * deep_copy_hashtable
                      ^
presence-mixin.c:657: Warning: TelepathyGLib: '@context' parameter unexpected at this location:
 * @context: The D-Bus invocation context to use to return values
    ^
presence-mixin.c:684: Warning: TelepathyGLib: '@context' parameter unexpected at this location:
 * @context: The D-Bus invocation context to use to return values
    ^
presence-mixin.c:718: Warning: TelepathyGLib: '@context' parameter unexpected at this location:
 * @context: The D-Bus invocation context to use to return values
    ^
presence-mixin.c:841: Warning: TelepathyGLib: '@context' parameter unexpected at this location:
 * @context: The D-Bus invocation context to use to return values
    ^
presence-mixin.c:909: Warning: TelepathyGLib: '@context' parameter unexpected at this location:
 * @context: The D-Bus invocation context to use to return values
    ^
presence-mixin.c:932: Warning: TelepathyGLib: '@context' parameter unexpected at this location:
 * @context: The D-Bus invocation context to use to return values
    ^
presence-mixin.c:1008: Warning: TelepathyGLib: '@context' parameter unexpected at this location:
 * @context: The D-Bus invocation context to use to return values
    ^
presence-mixin.c:1172: Warning: TelepathyGLib: '@context' parameter unexpected at this location:
 * @context: The D-Bus invocation context to use to return values
    ^
presence-mixin.c:1377: Warning: TelepathyGLib: '@context' parameter unexpected at this location:
 * @context: The D-Bus invocation context to use to return values
    ^
presence-mixin.c:1508: Warning: TelepathyGLib: '@context' parameter unexpected at this location:
 * @context: The D-Bus invocation context to use to return values
    ^
base-connection.c:163: Warning: TelepathyGLib: 'Since:' tag unexpected at this location:
 *  Since: 0.7.15
    ^
stream-tube-channel.c:442: Warning: TelepathyGLib: missing ':' at column 29:
   * TpStreamTubeChannel::incoming
                                  ^
dbus-tube-channel.c:599: Warning: TelepathyGLib: missing ':' at column 32:
 * tp_dbus_tube_channel_offer_async
                                   ^
dbus-tube-channel.c:713: Warning: TelepathyGLib: missing ':' at column 33:
 * tp_dbus_tube_channel_accept_async
                                    ^
stream-tube-connection.c:242: Warning: TelepathyGLib: missing ':' at column 30:
   * TpStreamTubeConnection::closed
                                   ^
text-channel.c:949: Warning: TelepathyGLib: missing ':' at column 31:
   * TpTextChannel::message-received
                                    ^
text-channel.c:977: Warning: TelepathyGLib: missing ':' at column 38:
   * TpTextChannel::pending-message-removed
                                           ^
text-channel.c:1002: Warning: TelepathyGLib: missing ':' at column 27:
   * TpTextChannel::message-sent
                                ^
text-channel.c:1585: Warning: TelepathyGLib: missing ':' at column 37:
 * tp_text_channel_supports_message_type
                                        ^
call-channel.c:1049: Warning: TelepathyGLib: missing ':' at column 28:
   * TpCallChannel::content-added
                                 ^
call-channel.c:1069: Warning: TelepathyGLib: missing ':' at column 30:
   * TpCallChannel::content-removed
                                   ^
call-channel.c:1090: Warning: TelepathyGLib: missing ':' at column 28:
   * TpCallChannel::state-changed
                                 ^
call-channel.c:1112: Warning: TelepathyGLib: missing ':' at column 30:
   * TpCallChannel::members-changed
                                   ^
call-content.c:656: Warning: TelepathyGLib: missing ':' at column 22:
   * TpCallContent::removed
                           ^
call-content.c:672: Warning: TelepathyGLib: missing ':' at column 28:
   * TpCallContent::streams-added
                                 ^
call-content.c:693: Warning: TelepathyGLib: missing ':' at column 30:
   * TpCallContent::streams-removed
                                   ^
call-stream.c:409: Warning: TelepathyGLib: missing ':' at column 41:
   * TpCallStream::local-sending-state-changed
                                              ^
call-stream.c:428: Warning: TelepathyGLib: missing ':' at column 36:
   * TpCallStream::remote-members-changed
                                         ^
errors.c:185: Warning: TelepathyGLib: 'Since:' tag unexpected at this location:
 *     Since: 0.11.12
       ^
errors.c:189: Warning: TelepathyGLib: 'Since:' tag unexpected at this location:
 *     Since: 0.11.12
       ^
errors.c:189: Warning: TelepathyGLib: multiple 'Since:' tags for identifier 'TpError':
 *     Since: 0.11.12
       ^
errors.c:194: Warning: TelepathyGLib: 'Since:' tag unexpected at this location:
 *     Since: 0.11.12
       ^
errors.c:194: Warning: TelepathyGLib: multiple 'Since:' tags for identifier 'TpError':
 *     Since: 0.11.12
       ^
errors.c:198: Warning: TelepathyGLib: 'Since:' tag unexpected at this location:
 *     Since: 0.11.15
       ^
errors.c:198: Warning: TelepathyGLib: multiple 'Since:' tags for identifier 'TpError':
 *     Since: 0.11.15
       ^
errors.c:202: Warning: TelepathyGLib: 'Since:' tag unexpected at this location:
 *     Since: 0.13.2
       ^
errors.c:202: Warning: TelepathyGLib: multiple 'Since:' tags for identifier 'TpError':
 *     Since: 0.13.2
       ^
errors.c:206: Warning: TelepathyGLib: 'Since:' tag unexpected at this location:
 *     Since: 0.13.3
       ^
errors.c:206: Warning: TelepathyGLib: multiple 'Since:' tags for identifier 'TpError':
 *     Since: 0.13.3
       ^
errors.c:213: Warning: TelepathyGLib: 'Since:' tag unexpected at this location:
 *     Since: 0.13.7
       ^
errors.c:213: Warning: TelepathyGLib: multiple 'Since:' tags for identifier 'TpError':
 *     Since: 0.13.7
       ^
errors.c:218: Warning: TelepathyGLib: 'Since:' tag unexpected at this location:
 *     Since: 0.13.7
       ^
errors.c:218: Warning: TelepathyGLib: multiple 'Since:' tags for identifier 'TpError':
 *     Since: 0.13.7
       ^
errors.c:239: Warning: TelepathyGLib: 'Since:' tag unexpected at this location:
 *     Since: 0.15.6
       ^
errors.c:239: Warning: TelepathyGLib: multiple 'Since:' tags for identifier 'TpError':
 *     Since: 0.15.6
       ^
errors.c:244: Warning: TelepathyGLib: 'Since:' tag unexpected at this location:
 *     Since: 0.15.6
       ^
errors.c:244: Warning: TelepathyGLib: multiple 'Since:' tags for identifier 'TpError':
 *     Since: 0.15.6
       ^
errors.c:249: Warning: TelepathyGLib: 'Since:' tag unexpected at this location:
 *     Since: 0.15.6
       ^
errors.c:249: Warning: TelepathyGLib: multiple 'Since:' tags for identifier 'TpError':
 *     Since: 0.15.6
       ^
handle.h:52: Warning: TelepathyGLib: missing ':' at column 22:
 * TP_UNKNOWN_HANDLE_TYPE
                         ^
_gen/telepathy-enums-gtk-doc.h:2: Warning: TelepathyGLib: ignoring unrecognized GTK-Doc comment block, identifier not found:
 *
  ^
_gen/telepathy-enums-gtk-doc.h:13: Warning: TelepathyGLib: ignoring unrecognized GTK-Doc comment block, identifier not found:
 *
  ^
_gen/telepathy-enums-gtk-doc.h:29: Warning: TelepathyGLib: ignoring unrecognized GTK-Doc comment block, identifier not found:
 *
  ^
_gen/telepathy-enums-gtk-doc.h:43: Warning: TelepathyGLib: ignoring unrecognized GTK-Doc comment block, identifier not found:
 *
  ^
_gen/telepathy-enums-gtk-doc.h:73: Warning: TelepathyGLib: ignoring unrecognized GTK-Doc comment block, identifier not found:
 *
  ^
_gen/telepathy-enums-gtk-doc.h:80: Warning: TelepathyGLib: ignoring unrecognized GTK-Doc comment block, identifier not found:
 *
  ^
_gen/telepathy-enums-gtk-doc.h:91: Warning: TelepathyGLib: ignoring unrecognized GTK-Doc comment block, identifier not found:
 *
  ^
_gen/telepathy-enums-gtk-doc.h:99: Warning: TelepathyGLib: ignoring unrecognized GTK-Doc comment block, identifier not found:
 *
  ^
_gen/telepathy-enums-gtk-doc.h:106: Warning: TelepathyGLib: ignoring unrecognized GTK-Doc comment block, identifier not found:
 *
  ^
_gen/telepathy-enums-gtk-doc.h:116: Warning: TelepathyGLib: ignoring unrecognized GTK-Doc comment block, identifier not found:
 *
  ^
_gen/telepathy-enums-gtk-doc.h:126: Warning: TelepathyGLib: ignoring unrecognized GTK-Doc comment block, identifier not found:
 *
  ^
_gen/telepathy-enums-gtk-doc.h:143: Warning: TelepathyGLib: ignoring unrecognized GTK-Doc comment block, identifier not found:
 *
  ^
_gen/telepathy-enums-gtk-doc.h:161: Warning: TelepathyGLib: ignoring unrecognized GTK-Doc comment block, identifier not found:
 *
  ^
_gen/telepathy-enums-gtk-doc.h:178: Warning: TelepathyGLib: ignoring unrecognized GTK-Doc comment block, identifier not found:
 *
  ^
_gen/telepathy-enums-gtk-doc.h:198: Warning: TelepathyGLib: ignoring unrecognized GTK-Doc comment block, identifier not found:
 *
  ^
_gen/telepathy-enums-gtk-doc.h:218: Warning: TelepathyGLib: ignoring unrecognized GTK-Doc comment block, identifier not found:
 *
  ^
_gen/telepathy-enums-gtk-doc.h:235: Warning: TelepathyGLib: ignoring unrecognized GTK-Doc comment block, identifier not found:
 *
  ^
_gen/telepathy-enums-gtk-doc.h:244: Warning: TelepathyGLib: ignoring unrecognized GTK-Doc comment block, identifier not found:
 *
  ^
_gen/telepathy-enums-gtk-doc.h:260: Warning: TelepathyGLib: ignoring unrecognized GTK-Doc comment block, identifier not found:
 *
  ^
_gen/telepathy-enums-gtk-doc.h:274: Warning: TelepathyGLib: ignoring unrecognized GTK-Doc comment block, identifier not found:
 *
  ^
_gen/telepathy-enums-gtk-doc.h:289: Warning: TelepathyGLib: ignoring unrecognized GTK-Doc comment block, identifier not found:
 *
  ^
_gen/telepathy-enums-gtk-doc.h:309: Warning: TelepathyGLib: ignoring unrecognized GTK-Doc comment block, identifier not found:
 *
  ^
_gen/telepathy-enums-gtk-doc.h:322: Warning: TelepathyGLib: ignoring unrecognized GTK-Doc comment block, identifier not found:
 *
  ^
_gen/telepathy-enums-gtk-doc.h:349: Warning: TelepathyGLib: ignoring unrecognized GTK-Doc comment block, identifier not found:
 *
  ^
_gen/telepathy-enums-gtk-doc.h:360: Warning: TelepathyGLib: ignoring unrecognized GTK-Doc comment block, identifier not found:
 *
  ^
_gen/telepathy-enums-gtk-doc.h:376: Warning: TelepathyGLib: ignoring unrecognized GTK-Doc comment block, identifier not found:
 *
  ^
_gen/telepathy-enums-gtk-doc.h:393: Warning: TelepathyGLib: ignoring unrecognized GTK-Doc comment block, identifier not found:
 *
  ^
_gen/telepathy-enums-gtk-doc.h:410: Warning: TelepathyGLib: ignoring unrecognized GTK-Doc comment block, identifier not found:
 *
  ^
_gen/telepathy-enums-gtk-doc.h:425: Warning: TelepathyGLib: ignoring unrecognized GTK-Doc comment block, identifier not found:
 *
  ^
_gen/telepathy-enums-gtk-doc.h:438: Warning: TelepathyGLib: ignoring unrecognized GTK-Doc comment block, identifier not found:
 *
  ^
_gen/telepathy-enums-gtk-doc.h:452: Warning: TelepathyGLib: ignoring unrecognized GTK-Doc comment block, identifier not found:
 *
  ^
_gen/telepathy-enums-gtk-doc.h:467: Warning: TelepathyGLib: ignoring unrecognized GTK-Doc comment block, identifier not found:
 *
  ^
_gen/telepathy-enums-gtk-doc.h:475: Warning: TelepathyGLib: ignoring unrecognized GTK-Doc comment block, identifier not found:
 *
  ^
_gen/telepathy-enums-gtk-doc.h:489: Warning: TelepathyGLib: ignoring unrecognized GTK-Doc comment block, identifier not found:
 *
  ^
_gen/telepathy-enums-gtk-doc.h:506: Warning: TelepathyGLib: ignoring unrecognized GTK-Doc comment block, identifier not found:
 *
  ^
_gen/telepathy-enums-gtk-doc.h:524: Warning: TelepathyGLib: ignoring unrecognized GTK-Doc comment block, identifier not found:
 *
  ^
_gen/telepathy-enums-gtk-doc.h:534: Warning: TelepathyGLib: ignoring unrecognized GTK-Doc comment block, identifier not found:
 *
  ^
_gen/telepathy-enums-gtk-doc.h:547: Warning: TelepathyGLib: ignoring unrecognized GTK-Doc comment block, identifier not found:
 *
  ^
_gen/telepathy-enums-gtk-doc.h:561: Warning: TelepathyGLib: ignoring unrecognized GTK-Doc comment block, identifier not found:
 *
  ^
_gen/telepathy-enums-gtk-doc.h:575: Warning: TelepathyGLib: ignoring unrecognized GTK-Doc comment block, identifier not found:
 *
  ^
_gen/telepathy-enums-gtk-doc.h:584: Warning: TelepathyGLib: ignoring unrecognized GTK-Doc comment block, identifier not found:
 *
  ^
_gen/telepathy-enums-gtk-doc.h:600: Warning: TelepathyGLib: ignoring unrecognized GTK-Doc comment block, identifier not found:
 *
  ^
_gen/telepathy-enums-gtk-doc.h:616: Warning: TelepathyGLib: ignoring unrecognized GTK-Doc comment block, identifier not found:
 *
  ^
_gen/telepathy-enums-gtk-doc.h:632: Warning: TelepathyGLib: ignoring unrecognized GTK-Doc comment block, identifier not found:
 *
  ^
_gen/telepathy-enums-gtk-doc.h:659: Warning: TelepathyGLib: ignoring unrecognized GTK-Doc comment block, identifier not found:
 *
  ^
_gen/telepathy-enums-gtk-doc.h:679: Warning: TelepathyGLib: ignoring unrecognized GTK-Doc comment block, identifier not found:
 *
  ^
_gen/telepathy-enums-gtk-doc.h:704: Warning: TelepathyGLib: ignoring unrecognized GTK-Doc comment block, identifier not found:
 *
  ^
_gen/telepathy-enums-gtk-doc.h:721: Warning: TelepathyGLib: ignoring unrecognized GTK-Doc comment block, identifier not found:
 *
  ^
_gen/telepathy-enums-gtk-doc.h:737: Warning: TelepathyGLib: ignoring unrecognized GTK-Doc comment block, identifier not found:
 *
  ^
_gen/telepathy-enums-gtk-doc.h:747: Warning: TelepathyGLib: ignoring unrecognized GTK-Doc comment block, identifier not found:
 *
  ^
_gen/telepathy-enums-gtk-doc.h:758: Warning: TelepathyGLib: ignoring unrecognized GTK-Doc comment block, identifier not found:
 *
  ^
_gen/telepathy-enums-gtk-doc.h:778: Warning: TelepathyGLib: ignoring unrecognized GTK-Doc comment block, identifier not found:
 *
  ^
_gen/telepathy-enums-gtk-doc.h:790: Warning: TelepathyGLib: ignoring unrecognized GTK-Doc comment block, identifier not found:
 *
  ^
_gen/telepathy-enums-gtk-doc.h:798: Warning: TelepathyGLib: ignoring unrecognized GTK-Doc comment block, identifier not found:
 *
  ^
_gen/telepathy-enums-gtk-doc.h:813: Warning: TelepathyGLib: ignoring unrecognized GTK-Doc comment block, identifier not found:
 *
  ^
_gen/telepathy-enums-gtk-doc.h:831: Warning: TelepathyGLib: ignoring unrecognized GTK-Doc comment block, identifier not found:
 *
  ^
_gen/telepathy-enums-gtk-doc.h:846: Warning: TelepathyGLib: ignoring unrecognized GTK-Doc comment block, identifier not found:
 *
  ^
_gen/telepathy-enums-gtk-doc.h:861: Warning: TelepathyGLib: ignoring unrecognized GTK-Doc comment block, identifier not found:
 *
  ^
_gen/telepathy-enums-gtk-doc.h:876: Warning: TelepathyGLib: ignoring unrecognized GTK-Doc comment block, identifier not found:
 *
  ^
_gen/telepathy-enums-gtk-doc.h:895: Warning: TelepathyGLib: ignoring unrecognized GTK-Doc comment block, identifier not found:
 *
  ^
_gen/telepathy-enums-gtk-doc.h:908: Warning: TelepathyGLib: ignoring unrecognized GTK-Doc comment block, identifier not found:
 *
  ^
_gen/telepathy-enums-gtk-doc.h:922: Warning: TelepathyGLib: ignoring unrecognized GTK-Doc comment block, identifier not found:
 *
  ^
_gen/telepathy-enums-gtk-doc.h:930: Warning: TelepathyGLib: ignoring unrecognized GTK-Doc comment block, identifier not found:
 *
  ^
_gen/telepathy-enums-gtk-doc.h:942: Warning: TelepathyGLib: ignoring unrecognized GTK-Doc comment block, identifier not found:
 *
  ^
_gen/telepathy-enums-gtk-doc.h:959: Warning: TelepathyGLib: ignoring unrecognized GTK-Doc comment block, identifier not found:
 *
  ^
_gen/telepathy-enums-gtk-doc.h:975: Warning: TelepathyGLib: ignoring unrecognized GTK-Doc comment block, identifier not found:
 *
  ^
_gen/telepathy-enums-gtk-doc.h:998: Warning: TelepathyGLib: ignoring unrecognized GTK-Doc comment block, identifier not found:
 *
  ^
_gen/telepathy-enums-gtk-doc.h:1014: Warning: TelepathyGLib: ignoring unrecognized GTK-Doc comment block, identifier not found:
 *
  ^
_gen/telepathy-enums-gtk-doc.h:1029: Warning: TelepathyGLib: ignoring unrecognized GTK-Doc comment block, identifier not found:
 *
  ^
_gen/telepathy-enums-gtk-doc.h:1040: Warning: TelepathyGLib: ignoring unrecognized GTK-Doc comment block, identifier not found:
 *
  ^
_gen/telepathy-enums-gtk-doc.h:1053: Warning: TelepathyGLib: ignoring unrecognized GTK-Doc comment block, identifier not found:
 *
  ^
_gen/telepathy-enums-gtk-doc.h:1070: Warning: TelepathyGLib: ignoring unrecognized GTK-Doc comment block, identifier not found:
 *
  ^
_gen/telepathy-enums-gtk-doc.h:1089: Warning: TelepathyGLib: ignoring unrecognized GTK-Doc comment block, identifier not found:
 *
  ^
_gen/telepathy-enums-gtk-doc.h:1105: Warning: TelepathyGLib: ignoring unrecognized GTK-Doc comment block, identifier not found:
 *
  ^
_gen/telepathy-enums-gtk-doc.h:1125: Warning: TelepathyGLib: ignoring unrecognized GTK-Doc comment block, identifier not found:
 *
  ^
_gen/telepathy-enums-gtk-doc.h:1142: Warning: TelepathyGLib: ignoring unrecognized GTK-Doc comment block, identifier not found:
 *
  ^
g-ir-scanner: compile: gcc -Wall -pthread -I/data/build/include/glib-2.0 -I/data/build/lib64/glib-2.0/include -I/data/build/include/dbus-1.0 -I/usr/include/dbus-1.0 -I/usr/lib64/dbus-1.0/include -g -O0 -I.. -I.. -I/data/build/include/dbus-1.0 -I/data/build/include/glib-2.0 -I/data/build/lib64/glib-2.0/include -I/data/build/include/gio-unix-2.0/ -I/usr/include/dbus-1.0 -I/usr/lib64/dbus-1.0/include -c -o /data/src/jhbuild/telepathy-glib/telepathy-glib/tmp-introspectpMZRWB/TelepathyGLib-0.12.o /data/src/jhbuild/telepathy-glib/telepathy-glib/tmp-introspectpMZRWB/TelepathyGLib-0.12.c
g-ir-scanner: link: /bin/sh ../libtool --mode=link --tag=CC gcc -o /data/src/jhbuild/telepathy-glib/telepathy-glib/tmp-introspectpMZRWB/TelepathyGLib-0.12 -export-dynamic -g -O0 -L/data/build/lib64 -Wl,-O1 /data/src/jhbuild/telepathy-glib/telepathy-glib/tmp-introspectpMZRWB/TelepathyGLib-0.12.o -L. libtelepathy-glib.la -pthread -Wl,--export-dynamic -L/data/build/lib64 -L/lib64 -lgthread-2.0 -lgmodule-2.0 -lgio-2.0 -ldbus-glib-1 -ldbus-1 -lpthread -lrt -lgobject-2.0 -lglib-2.0
libtool: link: gcc -o /data/src/jhbuild/telepathy-glib/telepathy-glib/tmp-introspectpMZRWB/.libs/TelepathyGLib-0.12 -g -O0 -Wl,-O1 /data/src/jhbuild/telepathy-glib/telepathy-glib/tmp-introspectpMZRWB/TelepathyGLib-0.12.o -pthread -Wl,--export-dynamic -Wl,--export-dynamic  -L/data/build/lib64 -L. ./.libs/libtelepathy-glib.so -L/lib64 /data/build/lib64/libgio-2.0.so /data/build/lib64/libgmodule-2.0.so -ldl -lz -lselinux -lresolv -ldbus-glib-1 -ldbus-1 /data/build/lib64/libgobject-2.0.so /data/build/lib64/libgthread-2.0.so -lffi /data/build/lib64/libglib-2.0.so -lpthread -lrt -pthread -Wl,-rpath -Wl,/data/build/lib64
<unknown>:: Fatal: TelepathyGLib: warnings configured as fatal
<unknown>:: Fatal: TelepathyGLib: warnings configured as fatal

make[3]: *** [TelepathyGLib-0.12.gir] Error 1
make[3]: Leaving directory `/data/src/jhbuild/telepathy-glib/telepathy-glib'
make[2]: *** [all] Error 2
rm _gen/tp-spec-call-content-media-description.xml _gen/tp-spec-call-content.xml _gen/tp-spec-call-stream.xml _gen/tp-spec-channel-request.xml _gen/tp-spec-connection-manager.xml _gen/tp-spec-media-stream-handler.xml _gen/tp-spec-debug.xml _gen/tp-spec-connection.xml _gen/tp-spec-client.xml _gen/tp-spec-tls-cert.xml _gen/tp-spec-account-manager.xml _gen/tp-spec-protocol.xml _gen/tp-spec-dbus-daemon.xml _gen/tp-spec-generic.xml _gen/tp-spec-media-session-handler.xml _gen/tp-spec-call-stream-endpoint.xml _gen/tp-spec-channel.xml _gen/tp-spec-account.xml _gen/tp-spec-channel-dispatch-operation.xml _gen/tp-spec-channel-dispatcher.xml
make[2]: Leaving directory `/data/src/jhbuild/telepathy-glib/telepathy-glib'
make[1]: *** [all-recursive] Error 1
make[1]: Leaving directory `/data/src/jhbuild/telepathy-glib'
make: *** [all] Error 2


dbus-properties-mixin.c:1096: Warning: TelepathyGLib: invalid annotation option: unqualified
Traceback (most recent call last):
  File "/data/build/bin/g-ir-scanner", line 46, in <module>
    sys.exit(scanner_main(sys.argv))
  File "/data/build/lib64/gobject-introspection/giscanner/scannermain.py", line 416, in scanner_main
    blocks = ap.parse(ss.get_comments())
  File "/data/build/lib64/gobject-introspection/giscanner/annotationparser.py", line 541, in parse
    comment_block = self.parse_comment_block(comment)
  File "/data/build/lib64/gobject-introspection/giscanner/annotationparser.py", line 578, in parse_comment_block
    return self._parse_comment_block(comment_lines, filename, lineno)
  File "/data/build/lib64/gobject-introspection/giscanner/annotationparser.py", line 646, in _parse_comment_block
    column = result.start('symbol_name') + column_offset

Comment 1 Stef Walter 2012-04-12 02:49:33 UTC

Created attachment 59840 [details] [review]
Fix doc comments for recent stricter gtk-doc

 * Build fails with new gtk-doc (1.18.1) which seems to
   be stricter than previous versions.

Comment 2 Simon McVittie 2012-04-12 04:50:44 UTC

The warnings aren't fatal; the fatal thing is that g-ir-scanner has also become more strict, and is unconditionally treating warnings as errors.

We don't generally fix warnings from newer tool versions on a stable branch (only on master), but since you've made a patch, I'll review it.

Comment 3 Simon McVittie 2012-04-12 05:50:12 UTC

Fixed in git for 0.18.1, thanks. Already fixed for 0.19 by Jonny (possibly with more fixes).

Comment 4 Stef Walter 2012-04-12 05:52:28 UTC

Thanks! jhbuild builds now.

Comment 5 Jonny Lamb 2012-04-12 07:27:52 UTC

Comment on attachment 59840 [details] [review]
Fix doc comments for recent stricter gtk-doc

Review of attachment 59840 [details] [review]:
-----------------------------------------------------------------

::: tools/c-constants-gen.py
@@ -71,1 @@
>  %s:

I don't think this is right?

Comment 6 Stef Walter 2012-04-12 07:34:32 UTC

Created attachment 59859 [details] [review]
Fix auto-generated gtk-doc constant comment

Ah yes. I removed the line which caused g-ir-scanner to barf, but should have also formatted the comment correctly.

Comment 7 Simon McVittie 2012-04-12 08:06:34 UTC

(In reply to comment #6)
> Fix auto-generated gtk-doc constant comment

Also pushed to 0.18.

Use of freedesktop.org services, including Bugzilla, is subject to our Code of Conduct. How we collect and use information is described in our Privacy Policy.