GNOME Bugzilla – Bug 790015
docs: Various linking and syntax fixes
Last modified: 2017-11-07 14:52:25 UTC
Some mostly-trivial patches attached.
Created attachment 363141 [details] [review] docs: Add recent version check macros to glib-sections.txt Signed-off-by: Philip Withnall <withnall@endlessm.com>
Created attachment 363142 [details] [review] docs: Add 2.56 to the API version reference in glib-docs.xml Signed-off-by: Philip Withnall <withnall@endlessm.com>
Created attachment 363143 [details] [review] docs: Add version and deprecation decorators to gtk-doc ignore list This allows gtk-doc to recognise a whole lot more API than it could before. Maintaining the lists between 6 build files is going to be a bit of a pain, but they only need to be modified once a cycle. Signed-off-by: Philip Withnall <withnall@endlessm.com> https://bugzilla.gnome.org/show_bug.cgi?id=789087
Created attachment 363144 [details] [review] docs: Make argument names in GAppInfo consistent This fixes a mismatch between some of the gtk-doc comments and reality. Signed-off-by: Philip Withnall <withnall@endlessm.com>
Created attachment 363145 [details] [review] docs: Fix various minor syntax errors in gtk-doc comments This will fix a few broken links in the documentation, and shut up a load of gtk-doc warnings (but certainly not all of them). Signed-off-by: Philip Withnall <withnall@endlessm.com>
Created attachment 363146 [details] [review] docs: Add 2.56 to the API version reference in glib-docs.xml Signed-off-by: Philip Withnall <withnall@endlessm.com>
Review of attachment 363141 [details] [review]: ACK
Review of attachment 363143 [details] [review]: And at some point, we're going to maintain only the ones in Meson…
Review of attachment 363144 [details] [review]: :thumbsup:
Review of attachment 363145 [details] [review]: ::: gio/gtlsdatabase.c @@ +460,3 @@ * * @chain is a chain of #GTlsCertificate objects each pointing to the next + * certificate in the chain by its `issuer` property. The chain may initially This could be replaced by "#GtlsCertificate:issuer" to link to the appropriate property documentation blurb.
Review of attachment 363146 [details] [review]: ACK
Thanks for the fast review. Pushed with the fix suggested in comment #10. Attachment 363141 [details] pushed as 6546d87 - docs: Add recent version check macros to glib-sections.txt Attachment 363143 [details] pushed as a12fbd2 - docs: Add version and deprecation decorators to gtk-doc ignore list Attachment 363144 [details] pushed as 249d74f - docs: Make argument names in GAppInfo consistent Attachment 363145 [details] pushed as 8e8f4e6 - docs: Fix various minor syntax errors in gtk-doc comments Attachment 363146 [details] pushed as f33ca57 - docs: Add 2.56 to the API version reference in glib-docs.xml