Hacktoberfest 2026: as issues que os mantenedores marcaram para outubro, abertas e boas para iniciantes. Ver issues do Hacktoberfest

Allow lines to start with `@foo` inside a block tag like `{@code}`

Aberta
#824 0 comentários 1 reação 0 responsáveis Ver no GitHub

Ninguém assumiu esta issue ainda.

Avaliação

Dificuldade
4/5
Tempo estimado
3-5 dias
Facilidade para iniciantes
35/100
Tipo de issue
Funcionalidade
Clareza
Razoavelmente clara
Status de atividade
Estagnada
Stack de tecnologia
java
Domínio
tooling

Direção de pesquisa

Comece reproduzindo o caso de tag de bloco Javadoc descrito na issue, incluindo uma linha que comece com @Override, e use JDK-8241780 como contexto para o comportamento do Java 15. Nenhum arquivo ou teste é mencionado; deve-se considerar concluído quando o formatter aceitar as linhas @foo pretendidas sem tratar a tag inline ao redor como inválida.

Escrita pelo modelo de indexação a partir do texto da issue.

Descrição

IIRC, we currently consider such an appearance of @foo to be an invalid tag (or, if it is a recognized one like @return, maybe a valid tag? or maybe never a valid tag because we're upset that the previous inline tag was never closed?). It is invalid... until Java 15, at which point https://bugs.openjdk.org/browse/JDK-8241780 saves us.

On those grounds, we don't format the Javadoc at all (which is not necessarily a great failure mode, but that's another issue).

Maybe we should just allow this, at least for cases that are not normally Javadoc tags, like @Override?

Linguagem predominante
Java
Estrelas
6.2k
Forks
936
Merge médio
6min
PRs com merge (30d)
3

Guia de contribuição

Abrir o guia de contribuição

Primeiros passos

  1. Leia a issue inteira e depois o guia de contribuição do projeto.
  2. Comente na issue dizendo que vai assumir — evita que duas pessoas façam o mesmo trabalho.
  3. Faça um fork do repositório e trabalhe em uma branch.
  4. Abra um pull request que referencie o número da issue.

Mais de google/google-java-format

Todas as issues de google/google-java-format

Issues semelhantes

Mais issues de Java

Receba novas issues na sua caixa de entrada

Um resumo curto de issues do GitHub para quem está começando.