FAQ sur Google Recherche de code

À propos de Google Recherche de code

Foire aux questions (FAQ)

Quel type de code explorez-vous ?

Quelle syntaxe regexp est prise en compte par Google Recherche de code ?

Quels langages de programmation sont inclus ?

Comment limiter la recherche par langage, licence ou nom de fichier ?

Puis-je ajouter les résultats de Google Recherche de code à mon site Web, interface IDE ou application ?

Quel critères utilisez-vous pour déterminer quelle licence logicielle afficher pour une page de code ?

Comment puis-je ajouter mon code aux résultats de Google Recherche de code ?

Comment puis-je m'assurer que vous associez le langage et la licence appropriés à mes fichiers de code ?

Comment puis-je empêcher Google d'explorer mon code ?

J'ai des suggestions pour améliorer le produit. Comment vous les soumettre ?

Comment suggérer à Google la suppression d'un résultat de Google Recherche de code ?

Quelles sont les conditions d'utilisation ?

À propos de Google Recherche de code

Google Recherche de code vous aide à trouver des définitions de fonctions et des exemples de code en vous offrant un espace où rechercher du code parmi les sources publiques disponibles sur Internet. Grâce à Google Recherche de code, vous pouvez :

utiliser des expressions rationnelles pour affiner votre recherche ;

limiter votre recherche par langage, licence ou nom de fichier ;

afficher le fichier source, avec des liens permettant de revenir au package entier et à la page Internet dont ce fichier est extrait.

Foire aux questions (FAQ)

1. Quel type de code explorez-vous ?

Nous explorons toutes les sources publiques possibles de code, notamment les archives (.tar.gz, .tar.bz2, .tar, et .zip) et les dépôts CVS et Subversion.

2. Quelle syntaxe regexp est prise en compte par Google Recherche de code ?

Google Recherche de code prend en charge les expressions rationnelles étendues POSIX, à l'exception des références arrières ainsi que des éléments et des classes d'interclassement. Pour rechercher un espace, vous devez l'associer à une barre oblique inverse, comme dans bonjour,\ la\ compagnie. Vous pouvez rechercher une chaîne littérale en la mettant entre guillemets, comme dans "bonjour, la compagnie".

Les extensions Perl suivantes sont également prises en charge :

`\w`	Reconnaît un caractère alphabétique (alphanumérique plus "_").
`\W`	Reconnaît un caractère non alphabétique.
`\s`	Reconnaît un caractère espace.
`\S`	Reconnaît un caractère différent d'un espace.
`\d`	Reconnaît un caractère numérique.
`\D`	Reconnaît un caractère non numérique.

3. Quels langages de programmation sont inclus ?

La page Recherche avancée de code répertorie les langages de programmation que nous détectons. Toutefois, même si un langage n'est pas cité, vous pouvez rechercher du code écrit dans ce langage. Nous incluons le plus grand nombre possible de pages de code dans les résultats de recherche, y compris du code dont nous ne détectons pas le langage. Lorsque nous parvenons à identifier le langage de programmation d'un fichier, nous l'indiquons dans les résultats de la recherche. Vous pouvez alors limiter votre recherche aux pages de code écrit dans ce langage.

Si nous ne détectons pas un langage qui vous intéresse, l'opérateur file: peut s'avérer utile pour rechercher des fichiers ayant une extension spécifique. Par exemple, vous pouvez limiter votre recherche aux fichiers ayant une extension .x ou .abc en entrant une requête du type myquery file:\.(x|abc)$. Si nous ne détectons pas un langage qui vous semble important, veuillez nous le faire savoir.

4. Comment limiter la recherche par langage, licence ou nom de fichier ?

Deux possibilités s'offrent à vous : utiliser la page Recherche avancée de code, ou utiliser nos opérateurs. Nos opérateurs comprennent notamment :

L'opérateur lang:, qui limite la recherche par langage de programmation (par exemple, lang:"c++", -lang:java ou lang:^(c|c#|c\+\+)$).

L'opérateur license:, qui limite la recherche par licence logicielle (par exemple, license:apache, -license:gpl ou license:bsd|mit).

L'opérateur package:, qui limite la recherche par package (par exemple, package:"www.kernel.org" ou package:\.tgz$).

L'opérateur file:, qui limite la recherche par nom de fichier (par exemple, file:include/linux/$ ou -file:\.cc$).

L'argument pour chacun de ces opérateurs peut consister en une chaîne littérale entre guillemets ou en une expression rationnelle. Comme illustré dans certains exemples ci-dessus, chacun de ces opérateurs peut être utilisé en négatif. Pour ce faire, il suffit d'insérer le signe moins ("-") devant le nom de l'opérateur.

5. Puis-je ajouter les résultats de Google Recherche de code à mon site Web, interface IDE ou application ?

Oui. Les résultats fournis par Google Recherche de code sont disponibles via un flux GData/XML. En outre, nous vous encourageons à créer des plug-ins IDE et à ajouter Google Recherche de code à votre site.

6. Quels critères utilisez-vous pour déterminer quelle licence logicielle afficher pour une page de code ?

Nous faisons de notre mieux pour déterminer les licences logicielles des packages de code en recherchant ces licences dans les commentaires ou dans des fichiers de licence distincts (par exemple, LICENSE, LICENCE, COPYRIGHT, COPYING). Si nous ne trouvons pas de licence, nous précisons que la licence est "Inconnue". Notez que notre système de détection de licence n'est pas infaillible ; nous nous efforçons de répertorier les licences telles qu'indiquées par l'auteur du code, mais des erreurs de notre part sont possibles et il peut arriver que l'auteur indique une licence incorrecte. En outre, les résultats de Google Recherche de code ne mentionnent pas les brevets qui peuvent être associés à certains logiciels. Nous vous communiquons toutes les informations dont nous disposons sur les termes probables de la licence. Toutefois, il vous appartient de prendre connaissance des conditions légales de réutilisation d'un code.

7. Comment puis-je ajouter mon code aux résultats de Google Recherche de code ?

Vous pouvez nous envoyer votre code à l'aide du formulaire en ligne. Pour envoyer un volume de code important, vous pouvez créer un plan Sitemap pour Google Recherche de code qui vous permettra d'indiquer l'emplacement de tous les fichiers de code présents sur votre site. Notez que nous n'ajoutons pas toutes les pages de code qui nous sont communiquées et que nous ne pouvons pas non plus vous fournir de garantie de délai ou d'inclusion.

8. Comment puis-je m'assurer que vous associez le langage et la licence appropriés à mes fichiers de code ?

Vous devez pour cela créer un fichier packagemap précisant le langage et la licence de tous les fichiers regroupés dans le package. Créez ce fichier au format XML packagemap et placez-le dans le répertoire de plus haut niveau dans les archives du codes.

9. Comment puis-je empêcher Google d'explorer mon code ?

Google Recherche de code respecte les informations des fichiers robots.txt. Il existe donc plusieurs façons de nous empêcher d'explorer votre code :

Si vous avez accès au fichier robots de votre serveur Web, vous pouvez ajouter le chemin de votre code à la ligne Disallow:. En savoir plus.

Vous pouvez également placer un fichier robot dans le répertoire racine de votre package de code. Cette opération est possible avec les archives comme avec les gestionnaires de versions, tels que CVS et Subversion. Par exemple, pour indiquer que vous souhaitez empêcher l'exploration de l'ensemble de votre code, vous pouvez ajouter un fichier robots.txt dans le répertoire racine contenant les éléments suivants :


                         User-agent: *


                          Disallow: /

Notez que la suppression de votre code de l'index de Google Recherche de code peut prendre un certain temps. Si vous avez une question urgente, n'hésitez pas à nous contacter en nous envoyant un e-mail à codesearch-issues+fr@google.com.

10. J'ai des suggestions pour améliorer le produit. Comment vous les soumettre ?

Vous pouvez nous faire part de vos idées en envoyant un message via le groupe de discussion. Google Recherche de code fait partie de Google Labs. C'est pourquoi nous n'en sommes qu'aux prémices de son développement. Vos commentaires sont importants pour nous aider à améliorer ce produit.

11. Comment suggérer à Google la suppression d'un résultat de Google Recherche de code ?

Google Recherche de code est encore à l'étude dans Google Labs, ce qui explique que les résultats d'une recherche ne soient pas infaillibles. Si vous remarquez un problème important avec les résultats d'une recherche, veuillez nous contacter en nous envoyant un e-mail à codesearch-issues+fr@google.com. Si vous êtes propriétaire de droits d'auteur et pensez avoir trouvé des résultats ne respectant pas vos droits, reportez-vous à notre procédure DMCA afin de demander la suppression de ces résultats.

12. Quelles sont les conditions d'utilisation ?

Vous pouvez consulter les conditions d'utilisation de Google Recherche de code.