Diferença entre% e%%

Diferença entre% e%%

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 \MetaPrefixmacro é 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 \MetaPrefixno 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.

informação relacionada