From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Original-To: caml-list@sympa.inria.fr Delivered-To: caml-list@sympa.inria.fr Received: from mail2-relais-roc.national.inria.fr (mail2-relais-roc.national.inria.fr [192.134.164.83]) by sympa.inria.fr (Postfix) with ESMTPS id EBDBC7F736 for ; Thu, 17 Sep 2015 10:27:19 +0200 (CEST) IronPort-PHdr: 9a23:6FYf9BC72GGb2Z+D33OaUyQJP3N1i/DPJgcQr6AfoPdwSP7/osbcNUDSrc9gkEXOFd2CrakU16yN6ujJYi8p39WoiDg6aptCVhsI2409vjcLJ4q7M3D9N+PgdCcgHc5PBxdP9nC/NlVJSo6lPwWB6kO74TNaIBjjLw09fr2zQd6OyZ/un8mJuLTtICxwzAKnZr1zKBjk5S7wjeIxxbVYF6Aq1xHSqWFJcekFjUlhJFaUggqurpzopM0roGxsvKcG3MdFVe2udK09SflcDS86G2Ez/szi8xfZG1ih/HwZB0ISkwRFGUDv5Rf2U5O55iz+t/RwwgGUPNftUfY1X3Go4r1vSRmuhCpRZG1xy33elsEl1PETmxmmvREqm4M= Authentication-Results: mail2-smtp-roc.national.inria.fr; spf=None smtp.pra=oliver@first.in-berlin.de; spf=None smtp.mailfrom=oliver@first.in-berlin.de; spf=None smtp.helo=postmaster@einhorn.in-berlin.de Received-SPF: None (mail2-smtp-roc.national.inria.fr: no sender authenticity information available from domain of oliver@first.in-berlin.de) identity=pra; client-ip=192.109.42.8; receiver=mail2-smtp-roc.national.inria.fr; envelope-from="oliver@first.in-berlin.de"; x-sender="oliver@first.in-berlin.de"; x-conformance=sidf_compatible Received-SPF: None (mail2-smtp-roc.national.inria.fr: no sender authenticity information available from domain of oliver@first.in-berlin.de) identity=mailfrom; client-ip=192.109.42.8; receiver=mail2-smtp-roc.national.inria.fr; envelope-from="oliver@first.in-berlin.de"; x-sender="oliver@first.in-berlin.de"; x-conformance=sidf_compatible Received-SPF: None (mail2-smtp-roc.national.inria.fr: no sender authenticity information available from domain of postmaster@einhorn.in-berlin.de) identity=helo; client-ip=192.109.42.8; receiver=mail2-smtp-roc.national.inria.fr; envelope-from="oliver@first.in-berlin.de"; x-sender="postmaster@einhorn.in-berlin.de"; x-conformance=sidf_compatible X-IronPort-Anti-Spam-Filtered: true X-IronPort-Anti-Spam-Result: A0CJAQAAePpVnAgqbcBeFoNgaQaNO7IKhzY7EQEBAQEBAQEBEAEBAQEBCAsJCSEugh2CMBV2AhgOAl+IQQQJphyPapR1gSKPEIM7gUMFlWGFEYdwCUyBQoZqkGGBOjeBdgwBOhyBVm8BAYooAQEB X-IPAS-Result: A0CJAQAAePpVnAgqbcBeFoNgaQaNO7IKhzY7EQEBAQEBAQEBEAEBAQEBCAsJCSEugh2CMBV2AhgOAl+IQQQJphyPapR1gSKPEIM7gUMFlWGFEYdwCUyBQoZqkGGBOjeBdgwBOhyBVm8BAYooAQEB X-IronPort-AV: E=Sophos;i="5.17,545,1437429600"; d="scan'208";a="178013794" Received: from einhorn.in-berlin.de ([192.109.42.8]) by mail2-smtp-roc.national.inria.fr with ESMTP/TLS/DHE-RSA-AES256-GCM-SHA384; 17 Sep 2015 10:27:19 +0200 X-Envelope-From: oliver@first.in-berlin.de X-Envelope-To: Received: from localhost (yak.in-berlin.de [192.109.42.109]) by einhorn.in-berlin.de (8.14.4/8.14.4/Debian-4) with ESMTP id t8H8RIMw002420 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NOT) for ; Thu, 17 Sep 2015 10:27:18 +0200 Received: from x55b20de0.dyn.telefonica.de (x55b20de0.dyn.telefonica.de [85.178.13.224]) by webmail.in-berlin.de (Horde Framework) with HTTP; Thu, 17 Sep 2015 10:27:18 +0200 Date: Thu, 17 Sep 2015 10:27:18 +0200 Message-ID: <20150917102718.Horde.e0qQZzgq3rVrjG81WbumTBv@webmail.in-berlin.de> From: Oliver Bandel To: OCaml User-Agent: Horde Application Framework 5 Content-Type: text/plain; charset=utf-8; format=flowed; DelSp=Yes MIME-Version: 1.0 Content-Disposition: inline Subject: [Caml-list] LablGtk-documentation... Hello, possibly some people who are responsible for the LablGtk-documentation are reading here on this list. The ressources are spread over different documents, and these documents contain a lot of broken links. What seems to be the main page for LablGtk, IMO, is this one: http://lablgtk.forge.ocamlcore.org/ There are links to API-descriptions as well as a README and tutorials. 1 === Let's look at the API-documentation: http://lablgtk.forge.ocamlcore.org/refdoc/index.html Nice to have that document. But the links to GtK (C-API) are not available. Example: http://lablgtk.forge.ocamlcore.org/refdoc/GEdit.html If you look for "val entry_completion" there is a linkt to the documentation of "GtkEntryCompletion". But that link is the following: "file:///usr/share/gtk-doc/html/gtk/GtkEntryCompletion.html" and thats, why the document is not avaialable. I think, it would be much better to have detailed information inside the API-description itself (instead of comparing LablGtk/OCaml and GtK/C documentation), but as long as that is not the case, the link to GtK itself would be better than not to have such a link. So it would be nice, to make these links avaialable. 2 === Let's look at the "LablGtk2 Tutorial by SooHyoung Oh", which is very helpful, btw. But it suffers from the same broken-link desease. Example: http://plus.kaist.ac.kr/~shoh/ocaml/lablgtk2/lablgtk2-tutorial/x459.html There is a link to "GPack.table"-documentation. But following the link gives "Server not found". So, izt seems the document has changed it's location a while ago, and the links weren't updated in the document. 3 === Let's look at the "Treeview Tutorial by SooHyoung Oh", which I did not explored in depth so far. But just testing for broken links, arbitrarily picking a page immediately also brought a broken link. Example: http://plus.kaist.ac.kr/~shoh/ocaml/lablgtk2/treeview-tutorial/ch03s05.html The link to the "get" method gives "Server not found", and the link to "gtk_tree_model_get" gives document not found. (Looks like the Gnome-documents have changed location.) These are just some examples. I assume there will be more issues to find. I would like to ask the people, who maintain these documents, to fix these (and possibly other) issues, so that the quality of the documentation could become better. Also, if there are other docs abozt GtK/LablGtk, it would be nice if they could be added to the above mentioned main page, so that these other docs are available easily. Thanks In Advance, Oliver