After an evaluation, GNOME has moved from Bugzilla to GitLab. Learn more about GitLab.
No new issues can be reported in GNOME Bugzilla anymore.
To report an issue in a GNOME project, go to GNOME GitLab.
Do not go to GNOME Gitlab for: Bluefish, Doxygen, GnuCash, GStreamer, java-gnome, LDTP, NetworkManager, Tomboy.
Bug 747423 - Modernize GTK-Doc
Modernize GTK-Doc
Status: RESOLVED FIXED
Product: planner
Classification: Other
Component: Build
0.14.6
Other Linux
: Normal normal
: ---
Assigned To: planner-maint
planner-maint
Depends on:
Blocks:
 
 
Reported: 2015-04-06 17:08 UTC by Ahmed Baïzid
Modified: 2021-06-03 17:33 UTC
See Also:
GNOME target: ---
GNOME version: ---

Attachments
Move docs from tmpl files to sources (70.21 KB, patch)
2015-04-06 21:41 UTC, Ahmed Baïzid 		none Details | Review
Drop using tmpl-files (7.45 KB, patch)
2015-04-06 21:43 UTC, Ahmed Baïzid 		none Details | Review
Drop SGML in favor of XML (1.92 KB, patch)
2015-04-06 22:06 UTC, Ahmed Baïzid 		none Details | Review
Even function parameters. (4.18 KB, patch)
2015-04-10 22:22 UTC, Ahmed Baïzid 		none Details | Review
Update GTK-Doc files. Add checks. (15.61 KB, patch)
2015-04-10 22:23 UTC, Ahmed Baïzid 		none Details | Review
Even section blocks. (11.33 KB, patch)
2015-04-10 22:24 UTC, Ahmed Baïzid 		none Details | Review
Even enum comment block. (4.50 KB, patch)
2015-04-10 22:26 UTC, Ahmed Baïzid 		none Details | Review
Even struct comment block. (8.17 KB, patch)
2015-04-10 22:27 UTC, Ahmed Baïzid 		none Details | Review
Document MrpTime. (11.13 KB, patch)
2015-04-10 22:29 UTC, Ahmed Baïzid 		none Details | Review
Even functions comment block. (6.57 KB, patch)
2015-04-10 22:29 UTC, Ahmed Baïzid 		none Details | Review
Even signals comment block. (13.41 KB, patch)
2015-04-10 22:29 UTC, Ahmed Baïzid 		none Details | Review
Even cpp macros comment block. (962 bytes, patch)
2015-04-10 22:30 UTC, Ahmed Baïzid 		none Details | Review
Correct typos. (15.40 KB, patch)
2015-04-10 22:30 UTC, Ahmed Baïzid 		none Details | Review

Description Ahmed Baïzid 2015-04-06 17:08:18 UTC 
$ cd docs/libplanner
 $ make
 $ make distclean
 $ git status .

We should see nothing.

Instead, files lay in the directory, 
some SGML models even call for a commit. 
Of course, gtkdoc-check fails.

Since 2003, GTK-Doc has evolved.
Comment 2 Ahmed Baïzid 2015-04-06 21:43:00 UTC 
Created attachment 301037 [details] [review]
Drop using tmpl-files

https://developer.gnome.org/gtk-doc-manual/
Comment 3 Ahmed Baïzid 2015-04-06 22:06:39 UTC 
Created attachment 301039 [details] [review]
Drop SGML in favor of XML
Comment 4 Ahmed Baïzid 2015-04-10 22:22:37 UTC 
Created attachment 301326 [details] [review]
Even function parameters.

Some parameters have not exactly the same name in the .h and in the .c.
Comment 5 Ahmed Baïzid 2015-04-10 22:23:34 UTC 
Created attachment 301327 [details] [review]
Update GTK-Doc files. Add checks.
Comment 6 Ahmed Baïzid 2015-04-10 22:24:05 UTC 
Created attachment 301328 [details] [review]
Even section blocks.
Comment 7 Ahmed Baïzid 2015-04-10 22:26:58 UTC 
Created attachment 301329 [details] [review]
Even enum comment block.

To even, to normalize, to equalize.
Comment 8 Ahmed Baïzid 2015-04-10 22:27:50 UTC 
Created attachment 301330 [details] [review]
Even struct comment block.
Comment 9 Ahmed Baïzid 2015-04-10 22:29:06 UTC 
Created attachment 301331 [details] [review]
Document MrpTime.

Introduced in 2005, never documented.
Comment 10 Ahmed Baïzid 2015-04-10 22:29:33 UTC 
Created attachment 301332 [details] [review]
Even functions comment block.
Comment 11 Ahmed Baïzid 2015-04-10 22:29:54 UTC 
Created attachment 301333 [details] [review]
Even signals comment block.
Comment 12 Ahmed Baïzid 2015-04-10 22:30:16 UTC 
Created attachment 301334 [details] [review]
Even cpp macros comment block.
Comment 13 Ahmed Baïzid 2015-04-10 22:30:41 UTC 
Created attachment 301335 [details] [review]
Correct typos.
Comment 14 Mart Raudsepp 2021-06-03 17:33:24 UTC 
Looks like all these got merged a while ago via https://gitlab.gnome.org/World/planner/-/merge_requests/4