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 786553 - Wrong example number in Gtk Tutorial
Wrong example number in Gtk Tutorial
Status: RESOLVED FIXED
Product: gtk+
Classification: Platform
Component: Documentation
3.22.x
Other All
: Normal minor
: ---
Assigned To: gtk-bugs
gtk-bugs
Depends on:
Blocks:
 
 
Reported: 2017-08-20 22:21 UTC by Oscar
Modified: 2017-08-22 13:20 UTC
See Also:
GNOME target: ---
GNOME version: ---



Description Oscar 2017-08-20 22:21:20 UTC
Please visit page: https://developer.gnome.org/gtk3/stable/ch01s03.html
That's the page for example number 3 but the source code and build instructions refer to example-4.c.

Looks like it should be example-3.c instead.
Comment 1 Daniel Boles 2017-08-22 13:12:30 UTC
the cause here is probably just sections getting rearranged but example file names not being updated; examples seem to be auto-numbered, whereas commands, filenames, etc are manually typed.


example-3 is currently used in https://developer.gnome.org/gtk3/stable/ch01s05.html

https://developer.gnome.org/gtk3/stable/gtk-getting-started.html#id-1.2.3.5 uses example-0.c, so I wonder how much correspondence there ever was here; Example 0 obviously probably did not ever exist...

I guess a patch to fix this by checking what example numbers are used throughout, and updating all filenames to match, would be welcome - but as long as the examples still compile and run as intended, it's not the end of the world, though confusing
Comment 2 Daniel Boles 2017-08-22 13:20:34 UTC
fixed by https://git.gnome.org/browse/gtk+/commit/?h=gtk-3-22&id=6537f7dad8a10c74d316102d01ac9cc8c500453a - thanks for the report