O problema
Tenho visto uma tendência um tanto irritante na formatação de mensagens de saída, em especial de erros. A saída pode aparecer nas perguntas e respostas aqui do StackOverflow formatada de diversas formas, sendo as três principais as seguintes:
Sem nenhuma formatação;
Serem formatados como citação ou;
Serem formatados como código-fonte.
Usuários novos tendem a postar a saída com os erros diretamente no editor sem formá-la de forma adequada, pois eles tendem apenas a copiar-e-colar o erro no editor. Isso ocorre porque eles não estão habituados a usar o editor daqui e não conhecem o seu comportamento.
Usuários mais experientes ou os editores que vierem a tentar arrumar a formatação do usuário novo irão optar por uma das últimas duas formas citadas acima.
Entretanto, eu acredito que a formatação como citação seja inadequada porque destrói a informação de indentação existente nas mensagens de erro ou de saída. Os exemplos que coloco abaixo mostram o porque essa indentação é importante.
Eis abaixo alguns exemplos reais:
Exemplos
Exemplo 1:
Eis o que o usuário postou originalmente:
prog.c: In function 'main': prog.c:18:39: error: array subscript is not an integer if (aux_st == 0) ponto[i][j] = 246; ^ prog.c:7:12: warning: variable 'ponto' set but not used [-Wunused-but-set-variable] float ponto[MAX][MAX];
Então, após isso, alguém formata como citação:
prog.c: In function 'main': prog.c:18:39: error: array subscript is not an integer if (aux_st == 0) ponto[i][j] = 246; ^ prog.c:7:12: warning: variable 'ponto' set but not used [-Wunused-but-set-variable] float ponto[MAX][MAX];
Eu formatei como código-fonte, utilizando o <!-- language: none -->
antes do respectivo código:
prog.c: In function 'main':
prog.c:18:39: error: array subscript is not an integer
if (aux_st == 0) ponto[i][j] = 246;
^
prog.c:7:12: warning: variable 'ponto' set but not used [-Wunused-but-set-variable]
float ponto[MAX][MAX];
Observe que a saída (no caso um erro de compilação) inclui indentação do código-fonte e a linha com o ^ que aponta a coluna onde ocorreu o erro. Esses detalhes são destruídos pela formatação em citação.
Exemplo 2:
//Código do erro no Terminal
src/com/example/web/BeerSelect.java:3: error: package javax.servlet does not exist import javax.servlet.; ^ src/com/example/web/BeerSelect.java:4: error: package javax.servlet.http does not exist import javax.servlet.http.; ^ src/com/example/web/BeerSelect.java:7: error: cannot find symbol public class BeerSelect extends HttpServlet { ^ symbol: class HttpServlet src/com/example/web/BeerSelect.java:9: error: cannot find symbol public void doPost ( HttpServletRequest request, ^ symbol: class HttpServletRequest location: class BeerSelect src/com/example/web/BeerSelect.java:10: error: cannot find symbol HttpServletResponse response ) ^ symbol: class HttpServletResponse location: class BeerSelect src/com/example/web/BeerSelect.java:11: error: cannot find symbol throws IOException , ServletException{ ^ symbol: class ServletException location: class BeerSelect 6 errors
Depois, um outro usuário formatou como citação:
src/com/example/web/BeerSelect.java:3: error: package javax.servlet does not exist import javax.servlet.; ^ src/com/example/web/BeerSelect.java:4: error: package javax.servlet.http does not exist import javax.servlet.http.; ^ src/com/example/web/BeerSelect.java:7: error: cannot find symbol public class BeerSelect extends HttpServlet { ^ symbol: class HttpServlet src/com/example/web/BeerSelect.java:9: error: cannot find symbol public void doPost ( HttpServletRequest request, ^ symbol: class HttpServletRequest location: class BeerSelect src/com/example/web/BeerSelect.java:10: error: cannot find symbol HttpServletResponse response ) ^ symbol: class HttpServletResponse location: class BeerSelect src/com/example/web/BeerSelect.java:11: error: cannot find symbol throws IOException , ServletException{ ^ symbol: class ServletException location: class BeerSelect 6 errors
Depois, eu formatei como código:
src/com/example/web/BeerSelect.java:3: error: package javax.servlet does not exist
import javax.servlet.*;
^
src/com/example/web/BeerSelect.java:4: error: package javax.servlet.http does not exist
import javax.servlet.http.*;
^
src/com/example/web/BeerSelect.java:7: error: cannot find symbol
public class BeerSelect extends HttpServlet {
^
symbol: class HttpServlet
src/com/example/web/BeerSelect.java:9: error: cannot find symbol
public void doPost ( HttpServletRequest request,
^
symbol: class HttpServletRequest
location: class BeerSelect
src/com/example/web/BeerSelect.java:10: error: cannot find symbol
HttpServletResponse response )
^
symbol: class HttpServletResponse
location: class BeerSelect
src/com/example/web/BeerSelect.java:11: error: cannot find symbol
throws IOException , ServletException{
^
symbol: class ServletException
location: class BeerSelect
6 errors
Este caso é similar ao primeiro. A indentação contém detalhes importantes que são destruídos pela formatação em citação.
Exemplo 3:
Stacktrace postado pelo usuário:
Exception in thread "main" java.lang.NullPointerException
at Soma.(Main.java:37)
at Main.main(Main.java:7)
Formatado como citação por um moderador:
Exception in thread "main" java.lang.NullPointerException
at Soma.(Main.java:37)
at Main.main(Main.java:7)
Como eu acho que deveria ter sido formatado:
Exception in thread "main" java.lang.NullPointerException
at Soma.<init>(Main.java:37)
at Main.main(Main.java:7)
Exemplo 4:
Como o usuário formatou originalmente (já em código-fonte, mas com coloração de sintaxe inadequada):
Exception in thread "main" javax.persistence.PersistenceException: org.hibernate.PersistentObjectException: detached entity passed to persist: br.com.arena.model.Pessoa
at org.hibernate.ejb.AbstractEntityManagerImpl.throwPersistenceException(AbstractEntityManagerImpl.java:614)
at org.hibernate.ejb.AbstractEntityManagerImpl.persist(AbstractEntityManagerImpl.java:226)
at br.com.arena.dao.PessoaTimeDAO.cadastrar(PessoaTimeDAO.java:18)
at br.com.arena.util.Persistir.main(Persistir.java:54)
Caused by: org.hibernate.PersistentObjectException: detached entity passed to persist: br.com.arena.model.Pessoa
at org.hibernate.event.def.DefaultPersistEventListener.onPersist(DefaultPersistEventListener.java:102)
at org.hibernate.impl.SessionImpl.firePersist(SessionImpl.java:636)
at org.hibernate.impl.SessionImpl.persist(SessionImpl.java:628)
at org.hibernate.engine.EJB3CascadingAction$1.cascade(EJB3CascadingAction.java:28)
at org.hibernate.engine.Cascade.cascadeToOne(Cascade.java:291)
at org.hibernate.engine.Cascade.cascadeAssociation(Cascade.java:239)
at org.hibernate.engine.Cascade.cascadeProperty(Cascade.java:192)
at org.hibernate.engine.Cascade.cascade(Cascade.java:153)
at org.hibernate.event.def.AbstractSaveEventListener.cascadeBeforeSave(AbstractSaveEventListener.java:454)
at org.hibernate.event.def.AbstractSaveEventListener.performSaveOrReplicate(AbstractSaveEventListener.java:288)
at org.hibernate.event.def.AbstractSaveEventListener.performSave(AbstractSaveEventListener.java:204)
at org.hibernate.event.def.AbstractSaveEventListener.saveWithGeneratedId(AbstractSaveEventListener.java:130)
at org.hibernate.ejb.event.EJB3PersistEventListener.saveWithGeneratedId(EJB3PersistEventListener.java:49)
at org.hibernate.event.def.DefaultPersistEventListener.entityIsTransient(DefaultPersistEventListener.java:154)
at org.hibernate.event.def.DefaultPersistEventListener.onPersist(DefaultPersistEventListener.java:110)
at org.hibernate.event.def.DefaultPersistEventListener.onPersist(DefaultPersistEventListener.java:61)
at org.hibernate.impl.SessionImpl.firePersist(SessionImpl.java:645)
at org.hibernate.impl.SessionImpl.persist(SessionImpl.java:619)
at org.hibernate.impl.SessionImpl.persist(SessionImpl.java:623)
at org.hibernate.ejb.AbstractEntityManagerImpl.persist(AbstractEntityManagerImpl.java:220)
... 2 more
Um usuário editou e "simplificou" o erro. O problema é que daí a mensagem de erro deixa de ser uma expressão fiel da verdade, pois não mais corresponde a saída do programa como ela foi dada (mas isso já é um outro problema):
Exception in thread "main" javax.persistence.PersistenceException: org.hibernate.PersistentObjectException: detached entity passed to persist: br.com.arena.model.Pessoa
at org.hibernate.ejb.AbstractEntityManagerImpl.throwPersistenceException(AbstractEntityManagerImpl.java:614)
at org.hibernate.ejb.AbstractEntityManagerImpl.persist(AbstractEntityManagerImpl.java:226)
at br.com.arena.dao.PessoaTimeDAO.cadastrar(PessoaTimeDAO.java:18)
at br.com.arena.util.Persistir.main(Persistir.java:54)
Caused by: org.hibernate.PersistentObjectException: detached entity passed to persist: br.com.arena.model.Pessoa
at org.hibernate.event.def.DefaultPersistEventListener.onPersist(DefaultPersistEventListener.java:102)
at org.hibernate.impl.SessionImpl.firePersist(SessionImpl.java:636)
at org.hibernate.impl.SessionImpl.persist(SessionImpl.java:628)
at org.hibernate.engine.EJB3CascadingAction$1.cascade(EJB3CascadingAction.java:28)
... 18 more
E um outro usuário formatou como citação:
Exception in thread "main" javax.persistence.PersistenceException: org.hibernate.PersistentObjectException: detached entity passed to persist: br.com.arena.model.Pessoa at org.hibernate.ejb.AbstractEntityManagerImpl.throwPersistenceException(AbstractEntityManagerImpl.java:614) at org.hibernate.ejb.AbstractEntityManagerImpl.persist(AbstractEntityManagerImpl.java:226) at br.com.arena.dao.PessoaTimeDAO.cadastrar(PessoaTimeDAO.java:18) at br.com.arena.util.Persistir.main(Persistir.java:54) Caused by: org.hibernate.PersistentObjectException: detached entity passed to persist: br.com.arena.model.Pessoa at org.hibernate.event.def.DefaultPersistEventListener.onPersist(DefaultPersistEventListener.java:102) at org.hibernate.impl.SessionImpl.firePersist(SessionImpl.java:636) at org.hibernate.impl.SessionImpl.persist(SessionImpl.java:628) at org.hibernate.engine.EJB3CascadingAction$1.cascade(EJB3CascadingAction.java:28) ... 18 more
Ocorre que ao formatar o stacktrace como citação, o mesmo perdeu qualidade de formatação ao invés de ganhar e tornou-se mais difícil de ser lido e entendido ao invés de mais fácil.
Minha proposta
A minha proposta é:
SEMPRE formatar a saída de programas como código-fonte (exceto talvez quando for apenas uma linha) e;
ABOLIR a forma de formatação de saída de programas como citação (mas citação pode ser usada para outras coisas obviamente).
Perguntas relacionadas no meta
E antes que alguém clique no botão de "fechar" e marcar essa pergunta como duplicata, eu estou ciente dessas perguntas:
Como devemos formatar perguntas e respostas? - A minha pergunta não é duplicata dessa outra porque a minha pergunta busca questionar uma prática vigente e propor uma mudança, e não apenas fornecer um guia geral de estilo (observe a tag faq nessa pergunta linkada).
Mensagens de erros ou Exceptions devem ser formatadas? - O exemplo que o OP desta pergunta deu não era um bom exemplo por ser demasiadamente simples e poder ser formatado igualmente de ambas as formas. Além disso, ele perguntou se o erro deve ser formatado, propondo ambas as formas citação e código-fonte. Já o foco desta minha pergunta não é se deve ser formatado e sim como deve ser formatado. Além disso, nessa pergunta linkada, o OP estava querendo uma orientação, enquanto que nessa minha pergunta, o propósito não é buscar orientação para mim, e sim questionar uma prática vigente no site e propor uma mudança.
<!-- language: none -->
por exemplo.