Eu estava olhando alguns tutoriais recentemente e alguns deles usados %
e outros usados %%
, mas ambos pareciam se comportar como comentários. Só queria saber se existe diferença entre os dois e se existe, quando usar %
e quando usar %%
.
Responder1
No que diz respeito ao analisador TeX (mais precisamente, os “olhos” e “boca” do TeX), não há diferença alguma entre
% A comment starting with a single "%" sign.
e
%% A comment starting with a double "%" sign.
Na verdade, assim que o primeiro %
é visto, tudo o que se segue, até o final da linha de entrada, é ignorado, de modo que o TeX nem percebe se um segundo %
vem a seguir ou não.
No entanto, há uma diferença significativa na forma como os dois comentários acima são tratados pelotira de documentosprograma. Permita-me aqui uma breve digressão.
Os programadores que escrevem código para aplicações (La)TeX geralmente empregam as facilidades oferecidas pelodocumentopacote (e outros pacotes, dependendo das necessidades) para combinar o código real e alguns comentários explicativos em um único arquivo, que pode ser formatado com LaTeX para produzir um documento que combina o código TeX com sua documentação, como no “programação alfabetizada” de Knuth ”. Otira de documentosO programa pode ser usado (entre outras coisas) para retirar de tais arquivos a parte de documentação, produzindo um arquivo que contém apenas o código TeX, quase sem comentários, e pode, portanto, ser inserido em maior velocidade (isso era uma preocupação muito maior há vinte anos). atrás do que hoje).
Mais precisamente, otira de documentosprograma remove qualquer linha quecomeçacom umsolteiro %
personagem. Às vezes, porém, deseja-se que um comentário também seja preservado no arquivo de “código”, por exemplo, porque contém um aviso crítico que os usuários devem absolutamente ver. Para isso, otira de documentosprograma introduz o conceito de “meta-comentário”: uma linha que começa com a string contida na \MetaPrefix
macro é passada para o arquivo de “código”, mesmo que seja um comentário. O valor padrão de \MetaPrefix
é \DoubleperCent
(sic), que, por sua vez, é definido como %%
; na prática, isso significa que, com a configuração padrão, os comentários que começam %%
nas colunas 1 e 2 são deixados com o código e não removidos como os demais.
Além disso, por questão de consistência, otira de documentosO programa insere o \MetaPrefix
no início de cada linha do preâmbulo e do postâmbulo que adiciona automaticamente aos arquivos de código. Assim, é comum ver arquivos de pacotes ou classes que começam com
%%
%% This is file `somepack.sty',
%% generated with the docstrip utility.
%%
%% The original source files were:
%%
etc., e termina com
%%
%% End of file `somepack.sty'.
Claro, também é possível que um programador – talvez depois de ver exemplos de comentários gerados pelotira de documentosprograma - decide usar dois ou mais sinais de porcentagem apenas para tornar um comentário mais visível.