Discussion :

[troumad]

Bonsoir

Est-ce normal que lorsque je fais des recherches sur http://developer.gnome.org/gtk3/3.3/, j'arrive toujours su gtk2 ?

Par exemple, je cherche gtk_box_pack_start, je tombe sur http://developer.gnome.org/gtk/stabl...box-pack-start et c'est la version 2 de gtk

Je peux alors changer dans l'url gtk/stable par gtk3/stable ou gtk3/3.3 si je veux avoir les infos pour la future version 3.4.
Et là, si je refais une recherche je tombe à nouveau sur gtk/stable

[gerald3d]

Bizarre?!

Pour les GtkBox c'est ici : http://developer.gnome.org/gtk3/stab...box-pack-start

Le plus simple c'est de partir de cette page : http://developer.gnome.org/gtk3/stable/

[liberforce]

Par défaut le moteur renvoie aux versions les plus courantes, et actuellement il recherche dans les versions les plus courantes par défaut. En fait il est plus adapté à la recherche ponctuelle. Il ne faut pas oublier que ce champ de recherche concerne le site entier, et pas juste la documentation que tu consultes. Tu as donc le choix entre proposer une version par défaut (la dernière version de gtk2 en l'occurence), ou proposer une liste de toutes les versions de gtk pour lesquelles ce symbole existe (et tu te retrouverais avec une liste de versions longues comme le bras, et tu n'aurais plus le complètement dans le champ de recherche).

Si tu veux de l'aide sur une version en particulier pour laquelle tu développes, utilise plutôt devhelp.

Tu peux aussi ouvrir un bug sur https://bugzilla.gnome.org/browse.cgi?product=website pour le composant developer.gnome.org pour avoir un moyen de restreindre la recherche à la documentation en cours de consultation.

[troumad]

Je serais surpris d'être le premier à y penser !
Il faudrait que la recherche dépendent de la page de départ avec en haut un lien vers la dernière version stable, la dernière version en développement de gtk3 et de gtk2 la version la plus courante.

Tu veux dire quoi par devhelp ?

[liberforce]

Il faudrait que la recherche dépendent de la page de départ avec en haut un lien vers la dernière version stable, la dernière version en développement de gtk3 et de gtk2 la version la plus courante.

Et non... Car souvent tu développeurs pour une version cible particulière, et pas forcément la plus récente. Donc à moins que l'utilisateur ne te dise exactement quelle version il veut, tu ne peux pas le deviner.

Tu veux dire quoi par devhelp ?

http://live.gnome.org/devhelp

Sous Mandriva/Mageia

urpmi devhelp

C'est navigateur d'aide au format gtk-doc. Devhelp ne te propose que l'aide correspondant à ce que tu as d'installé sur ta machine, qui est normalement celle de la version de GTK pour laquelle tu développes. Dès que tu installes des paquet de développement, si la bibliothèque en question fournit une aide au format gtk-doc, cette aide apparaît automatiquement dans devhelp. Tu y trouveras donc l'aide de gobject, gdk-pixbuf, gtk, glib, cairo, etc.

Et puis chercher en local plutôt que sur le net, c'est plus écolo :-p.

L'aide en ligne, c'est bien pour donner des liens vers de la doc à d'autres gens via internet (ce qui n'était pas possible auparavant avec devhelp), mais quand c'est pour toi même, il vaut mieux utiliser devhelp.

[troumad]

Et non... Car souvent tu développeurs pour une version cible particulière, et pas forcément la plus récente. Donc à moins que l'utilisateur ne te dise exactement quelle version il veut, tu ne peux pas le deviner.

Ça va tout à fait avec ce que j'ai dit : tu es envoyé de préférence vers la version d'où tu as fait ta recherche.
Mais, pour info, on met en lien en haut de la page les versions phares du moment.

http://live.gnome.org/devhelp

Sous Mandriva/Mageia

Installé ! Il me reste à tester ! Je sens que je vais aussi pouvoir travailler sans connexion internet