FAQs da Pesquisa de código do Google

Sobre a Pesquisa de código do Google

Perguntas freqüentes

Que tipo de código é rastreado pelo Google ?

Que tipo de sintaxe regexp é compatível com a Pesquisa de código?

Que linguagens de programação são compatíveis?

Como faço para restringir a pesquisa a uma linguagem, licença ou nome de arquivo?

Posso adicionar os resultados da Pesquisa de código do Google ao meu site, IDE ou aplicativo?

Como vocês decidem que licença de software será listada para um determinado trecho de código?

Como faço para adicionar meu código aos resultados da Pesquisa de código do Google?

Como faço para saber se a linguagem e a licença foram corrigidas nos arquivos de código?

Como faço para impedir que meu código seja rastreado?

Tenho sugestões para melhorar o produto. Como faço para enviá-las ao Google?

Se eu encontrar um resultado que deve ser removido da Pesquisa de código, como poderei informá-lo ao Google?

Quais são os termos de uso?

Sobre a Pesquisa de código do Google

A Pesquisa de código do Google o ajuda a encontrar definições de funções e códigos de exemplo, fornecendo um ponto de pesquisas de código-fonte acessível on-line e abertos ao público. Com a Pesquisa de código do Google você pode:

Usar expressões regulares para realizar pesquisas com mais precisão

Restringir sua pesquisa por linguagem, licença ou nome de arquivo

Visualizar arquivos e links para o pacote inteiro e a página da web onde ele foi encontrado

Perguntas freqüentes

1. Que tipo de código é rastreado pelo Google?

Estamos rastreando o máximo de códigos-fonte acessíveis publicamente que encontramos, incluindo arquivos (.tar.gz, .tar.bz2, .tar e .zip) e repositórios CVS e Subversion.

2. Que tipo de sintaxe regexp é compatível com a Pesquisa de código?

A Pesquisa de código do Google é compatível com a sintaxe de expressões regulares estendidas POSIX, sem incluir referências anteriores, elementos intercalados e classes de intercalação. Para pesquisar um caractere de espaço, insira uma barra invertida antes dele, como em olá,\ mundo. Para pesquisar strings exatas, insira-as entre aspas, como em "olá, mundo".

Também oferecemos compatibilidade com as seguintes extensões Perl:

`\w`	Encontra correspondência para um caractere do termo. (caractere alfanumérico mais "_")
`\W`	Encontra correspondência para um caractere que não pertence ao termo.
`\s`	Encontra correspondência para um caractere de espaço em branco.
`\S`	Encontra correspondência para um caractere que não seja de espaço em branco.
`\d`	Encontra correspondência para um caractere numérico.
`\D`	Encontra correspondência para um caractere que não seja numérico.

3. Que linguagens de programação são compatíveis?

A página Pesquisa de código avançada lista as linguagens de programação que podemos detectar. Mas mesmo se a linguagem de sua escolha não estiver listada, você ainda poderá pesquisar o código nessa linguagem. Fazemos com que o código seja o mais pesquisável possível, incluindo códigos cuja linguagem não podemos detectar. Quando conseguimos detectar a linguagem de programação de um arquivo, inserimos essa informação nos resultados da pesquisa, e você poderá restringir a pesquisa aos códigos dessa linguagem.

Se não estivermos detectando uma linguagem de seu interesse, o operador file: poderá ser útil para pesquisar arquivos com uma extensão específica. Por exemplo, você poderia restringir sua pesquisa aos arquivos com extensão .x ou .abc em uma consulta como myquery file:\.(x|abc)$. Se não estivermos detectando uma linguagem que você considere importante, entre em contato conosco.

4. Como faço para restringir a pesquisa a uma linguagem, licença ou nome de arquivo?

Você pode usar a página Pesquisa de código avançada ou os nossos operadores. Nossos operadores incluem:

O operador lang: , que restringe a pesquisa por linguagem de programação (ex.: lang:"c++", -lang:java ou lang:^(c|c#|c\+\+)$)

O operador license:, que restringe a pesquisa por licença de software (ex.: license:apache, -license:gpl ou license:bsd|mit)

O operador package:, que restringe a pesquisa ao URL do pacote (ex.:package:"www.kernel.org" ou package:\.tgz$)

O operador file:, que restringe a pesquisa por nome de arquivo (ex.:file:include/linux/$ ou -file:\.cc$)

O argumento para cada um desses operadores pode ser uma string exata ou uma expressão regular. Conforme ilustrado em alguns dos exemplos acima, cada um dos operadores pode ser usado como um operador negativo, basta inserir um sinal de menos ("-") antes dele.

5. Posso adicionar os resultados da Pesquisa de código do Google ao meu site, IDE ou aplicativo?

Sim. Os resultados da Pesquisa de código estão disponíveis por meio de um feed GData/XML, e incentivamos você a criar plug-ins IDE e a adicionar a Pesquisa de código do Google ao seu site.

6. Como vocês decidem que licença de software será listada para um determinado trecho de código?

Trabalhamos com afinco para determinar a licença de software para os pacotes de código, procurando a licença nos comentários ou em um arquivo de licença individual (ex., LICENSE, LICENCE, COPYRIGHT, COPYING). Se não conseguirmos encontrar uma licença, indicamos que ela é "Desconhecida". Observe que o nosso mecanismo de detecção de licenças não é perfeito. Tentamos listar as licenças conforme indicado pelo autor do código, mas podemos cometer erros e às vezes o autor indica a licença errada. Os resultados da pesquisa de código também podem informar as patentes relacionadas à parte de um software. Fornecemos todas as informações que conseguimos obter sobre os prováveis termos da licença, mas a compreensão dos requisitos legais para reutilizar parte de um código é de sua responsabilidade.

7. Como faço para adicionar meu código aos resultados da Pesquisa de código do Google?

Você pode enviar seu código usando nosso formulário on-line. Se você tiver vários códigos para enviar, crie um sitemap da Pesquisa de Código, que permite especificar todos os arquivos de código no seu site. Não indexamos todos os códigos que recebemos e não podemos prever nem garantir quando, ou se, eles vão aparecer.

8. Como faço para saber se a linguagem e a licença foram corrigidas nos arquivos de código?

Você pode criar um arquivo packagemap que especifica a linguagem e a licença de cada arquivo de um pacote. Crie o arquivo usando o formato XML do packagemap e, em seguida, coloque esse arquivo no diretório de nível superior do arquivamento de códigos.

9. Como faço para impedir que meu código seja rastreado?

A Pesquisa de código do Google respeita arquivos robots.txt, por isso há duas formas de impedir o rastreamento do seu código:

Se tiver acesso ao arquivo robots para o seu servidor da web, você poderá adicionar a linha Disallow: ao caminho do código. Saiba mais.

Você também pode simplesmente inserir um arquivo robots no diretório raiz do seu pacote de códigos. Esse procedimento funciona para ambos os arquivos e repositórios de controle de origem, como CVS e Subversion. Por exemplo, para indicar que nenhum de seus códigos deve ser rastreado, você poderá adicionar um arquivo chamado robots.txt no diretório raiz com:


                          User-agent: *

                          Disallow: /

É possível que a Pesquisa de código demore um pouco para atualizar o índice e remover seu código. Se precisar remover seu código com urgência, envie-nos um e-mail codesearch-issues+pt@google.com.

10. Tenho sugestões para melhorar o produto. Como faço para enviá-las ao Google?

Para compartilhar suas idéias conosco, publique-as no grupo de discussão. A Pesquisa de código do Google é parte do Google Labs, por isso ainda estamos nas etapas iniciais de seu desenvolvimento. Os seus comentários são muito importantes e nos ajudarão a melhorar o produto.

11. Se eu encontrar um resultado que deve ser removido da Pesquisa de código, como poderei informá-lo ao Google?

A Pesquisa de código do Google ainda está no Google Labs, por isso os resultados da pesquisa podem não ser precisos. Se perceber um problema grave nos resultados de pesquisa, entre em contato pelo e-mail codesearch-issues+pt@google.com. Se você detém direitos autorais sobre um determinado código e acredita que encontrou resultados que possam infringir seus direitos, siga o nosso procedimento DMCA para solicitar a remoção.

12. Quais são os termos de uso?

Consulte os Termos de Serviço de Código do Google.