bazelbuild/bazel

Documentation issue: "C toolchain configuration" contains extremely outdated information

Open

#13.395 aberto em 22 de abr. de 2021

Ver no GitHub
 (0 comments) (7 reactions) (0 assignees)Java (4.465 forks)batch import
P3help wantedteam-Documentationteam-Rules-CPPtype: documentation (cleanup)

Métricas do repositório

Stars
 (25.384 stars)
Métricas de merge de PR
 (Mesclagem média 22d 20h) (77 fundiu PRs em 30d)

Description

Documentation URL: https://docs.bazel.build/versions/master/cc-toolchain-config-reference.html

At the bottom:

This is a long list of features. The plan is to get rid of them once Crosstool in Starlark is done.

The linked issue was closed mid-2018. If the protobuf CROSSTOOL file is no longer supported, it would be good to remove all documentation specific to it, ideally replacing with up-to-date documentation of the current mechanism.

It'd be really really nice to have a link to a few functioning and up-to-date toolchain configs - ideally with CI tests on bazel to ensure they stay in sync with the latest bazel version.

Guia do colaborador

Direção de pesquisa
Identificar o mecanismo atual para configuração da toolchain de C/C++ no Bazel examinando o código fonte do repositório e a documentação recente. Procurar exemplos de configurações de toolchain atualizadas, de preferência testadas em CI. Atualizar a página de documentação em https://docs.bazel.build/versions/master/cc toolchain config reference.html de acordo. Verificar se a remoção planejada mencionada na issue #5380 foi executada.
Pilha de tecnologia
java
Domain
documentationbuild system
Tipo Issue
Documentação
DifficultyDificuldade de implementação estimada para um novo contribuidor, de 1 para alterações muito pequenas a 5 para trabalho de nível especializado.
2
Tempo estimadoUm intervalo de tempo aproximado para um colaborador experiente investigar, implementar, testar e preparar um pull request.
Meio dia
Status da atividadeQuão disponível o issue aparece agora: novo, ativo, obsoleto, bloqueado ou aguardando entrada do mantenedor.
Ativo
ClarityCom que clareza o issue explica a mudança esperada, os critérios de aceitação e a próxima etapa.
Claro
Prerequisites
Git
Simpatia para novatosUma pontuação de 1 a 100 que estima o quão acessível este issue é para colaboradores iniciantes.
70