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 767189 - Add gnome devel demos and a Tutorial for Beginners for the Perl Language
Add gnome devel demos and a Tutorial for Beginners for the Perl Language
Status: RESOLVED NOTABUG
Product: gnome-devel-docs
Classification: Applications
Component: platform-demos
unspecified
Other Linux
: Normal enhancement
: ---
Assigned To: gnome-devel-docs maintainers
gnome-devel-docs maintainers
Depends on:
Blocks:
 
 
Reported: 2016-06-03 08:07 UTC by max.augsburg1
Modified: 2016-06-03 13:07 UTC
See Also:
GNOME target: ---
GNOME version: ---



Description max.augsburg1 2016-06-03 08:07:27 UTC
I saw that  at https://developer.gnome.org/gnome-devel-demos/stable/ there isn't a Tutorial for Perl although there is a very good binding using GObject::Introspection and Perl is listed under the Top Ten in the TIOBE Index :-)

I have translated the Python Tutorial at https://github.com/MaxPerl/perl-Gtk3-Tutorial where you can find also the most example codes (although sometimes the commentars are at the examples still in german (in the Tutorial PDF and odt File everything is english so that is not a very big problem). You can of course use these files without a limitation!

I think adding Perl should for this reason not a big task. If I can help furthermore, please let me know!
Comment 1 David King 2016-06-03 08:46:43 UTC
Unless someone has the time and motivation to write the necessary documentation for the Perl bindings and adds it to gnome-devel-docs (the repository which contains the developer demos), it is not likely that I will find the time to do it. Also, those demos would need to be maintained into the future. Additionally, as the Perl bindings are not hosted on gnome.org, it is not likely that I would have become aware of them if you had not just mentioned them.

If you want to help out with writing and maintaining the demos, you should clone the gnome-devel-docs repository:

https://git.gnome.org/browse/gnome-devel-docs

Have a look in the platform-demos directory. If you need any help with the build system or markup, feel free to ask on #docs on irc.gnome.org, or send an email to <gnome-doc-list@gnome.org>.
Comment 2 max.augsburg1 2016-06-03 12:25:15 UTC
Dear David King,

Thanks for your comment. I would have the time and motivation to write the single demo perl files, even if it will probably take some time because I am involved in some other projects.
But I have no git.gnome account! Would it be possible to publish it on my github account and send you an link so that you could upload the files? 

Best wishes,
Max
Comment 3 max.augsburg1 2016-06-03 13:01:22 UTC
PS.: I think, the perl bindings are hosted on gnome. See https://git.gnome.org/browse/perl-Gtk3 ;-)
Comment 4 David King 2016-06-03 13:07:48 UTC
Yes, that's fine. The easiest way for me to review changes is if patches of the changes are posted in Bugzilla, but a branch on github would be fine too. Please file a new bug specifically for those changes (if and when they are ready).

I had never heard of the Perl bindings, and I am not interested in having every single available binding documented in gnome-devel-docs, but if someone writes high-quality documentation and examples, it would seem like a worthwhile addition.