abntexto (13oct22)

git-svn-id: svn://tug.org/texlive/trunk@64694 c570f23f-e606-0410-a88d-b1316a301751

5 files changed, 170 insertions, 53 deletions

diff --git a/Master/texmf-dist/doc/latex/abntexto/README b/Master/texmf-dist/doc/latex/abntexto/README.txt
index c7265329349..850a1cd3f3a 100644
--- a/Master/texmf-dist/doc/latex/abntexto/README
+++ b/Master/texmf-dist/doc/latex/abntexto/README.txt
@@ -1,8 +1,8 @@
 Public Domain Software
-2022-10-06
-1.2.0-alpha
+2022-10-12
+1.2.1-alpha
 Elayson
-abntexto dot classe at gmail dot com 
+abntexto.classe at gmail.com 
 
 The abntexto is a LaTeX class for the elaboration of academic works according
 to the guidelines of the Associação Brasileira de Normas Técnicas (ABNT).
\ No newline at end of file
diff --git a/Master/texmf-dist/doc/latex/abntexto/abntexto-manual.pdf b/Master/texmf-dist/doc/latex/abntexto/abntexto-manual.pdf
index 1756b851689..79ea6ff35f9 100644
--- a/Master/texmf-dist/doc/latex/abntexto/abntexto-manual.pdf
+++ b/Master/texmf-dist/doc/latex/abntexto/abntexto-manual.pdf
diff --git a/Master/texmf-dist/doc/latex/abntexto/abntexto-manual.tex b/Master/texmf-dist/doc/latex/abntexto/abntexto-manual.tex
index d054cf73fc0..7d9d2b3153b 100644
--- a/Master/texmf-dist/doc/latex/abntexto/abntexto-manual.tex
+++ b/Master/texmf-dist/doc/latex/abntexto/abntexto-manual.tex
@@ -4,14 +4,14 @@
 
 \usepackage[brazil]{babel}
 \usepackage[T1]{fontenc}
-\usepackage{tgheros} \def\familydefault{\sfdefault}
-\usepackage{inconsolata}
+\usepackage{newtxtext}
+\usepackage{newtxmath}
 \usepackage{lipsum} \def\lip{\lipsum[1][1-2]}
 \usepackage{graphicx}
 \usepackage[cmyk]{xcolor}
 \usepackage[style=abnt]{biblatex} \addbibresource{abntexto.bib}
 \usepackage[colorlinks]{hyperref}
-%\let\href=\relax
+%\let\href=\relax \newdimen\bibitemsep \def\textcite#1{{\bfseries#1}}
 
 % MARKUP
 % ================================================
@@ -25,12 +25,6 @@
 
 \def\arg{\cc{arg}}
 \def\opt{\kk{opt}}
-\def\argi{\cc{argi}}
-\def\argii{\cc{argii}}
-\def\argiii{\cc{argiii}}
-\def\opti{\kk{opti}}
-\def\optii{\kk{optii}}
-\def\optiii{\kk{optiii}}
 \def\ccval#1{{\ttnoligs \{#1\}}}
 \def\kkval#1{{\ttnoligs [#1]}}
 \def\pkg#1{{\ttnoligs #1}}
@@ -43,7 +37,7 @@
 \def\verbcatcodes{\let\do=\dodef \dospecials \catcode`\|=0 }
 
 {\catcode`\^^M=13 
-	\gdef\verbpercent#1^^M{{\bfseries\color{graycomment}\@percentchar#1^^M}}
+	\gdef\verbpercent#1^^M{{\color{graycomment}\itshape\@percentchar#1^^M}}
 }
 
 \long\def\codeon{\par\begingroup \verbcatcodes
@@ -85,7 +79,7 @@
 \sizeselectordef\LARGE{25pt}{30pt}
 
 \definecolor{graybar}{gray}{0.75}
-\definecolor{graycomment}{gray}{1}
+\definecolor{graycomment}{gray}{.2}
 
 \legendplacedef{code}{Código}{Lista de códigos}{cód.\,#1}{loc}
 \def\loclabelwidth{10.6ex}
@@ -98,8 +92,6 @@
 \widowpenalty=10000 
 
 \let\cite=\textcite
-\def\appendixlabelwidth{7.2em}
-
 \def\bibfont{\singlesp}
 \bibitemsep=18pt
 
@@ -118,12 +110,12 @@
 	abntexto\\[0.4em] \Large\itshape\mdseries
 	Classe para {\upshape\LaTeX}\\[2em] \normalfont\large
 	Elayson\\[1ex]
-	\href{mailto:abntexto.classe@gmail.com}{abntexto dot classe at gmail dot com}\\[2.5ex]
+	\href{mailto:abntexto.classe@gmail.com}{abntexto.classe at gmail.com}\\[2.5ex]
 	\today\par}
 
 \vskip3in
 
-{\centering \large\ttfamily 1.2.0-alpha\par}
+{\centering \large\ttfamily 1.2.1-alpha\par}
 
 \newpage
 
@@ -152,7 +144,7 @@ Digite as linhas em \ref{vb:início} e use \pkg{abntexto}.
 
 \usepackage[brazil]{babel} % para obter os padrões de hifenização corretos
 \usepackage[T1]{fontenc}
-\usepackage{newtxtext} % fontes New TX, semelhante a Times
+\usepackage{newtxtext} % fontes New TX, semelhantes a Times
 \usepackage{newtxmath}
 
 \begin{document}
@@ -162,13 +154,13 @@ Digite as linhas em \ref{vb:início} e use \pkg{abntexto}.
 
 \section{Fonte tipográfica}
 
-O tamanho da fonte é 12\,pt de imediato e pode ser configurado com o comando \cs\setfontsize\arg\ sendo que 12\,pt é a única opção disponível. Mas, se você deseja outro tamanho de fonte, crie-o usando \cs\fontsizedef\cc{size}\cc{defs}. Além disso, com os seletores de tamanho \cs\normalsize\ e \cs\small\ que configuram 12\,pt e 10\,pt, nessa ordem, é possível mudar o tamanho da fonte no corpo do documento.
+O tamanho da fonte é 12\,pt de imediato e pode ser configurado com o comando \cs\setfontsize\cc{size} sendo que 12\,pt é a única opção disponível. Mas, se você deseja outro tamanho de fonte, crie-o usando \cs\fontsizedef\cc{size}\cc{defs}. Além disso, com os seletores de tamanho \cs\normalsize\ e \cs\small\ que configuram 12\,pt e 10\,pt, nessa ordem, é possível mudar o tamanho da fonte no corpo do documento.
 
 O espaçamento é de um e meio e pode ser alterado para dois com \cs\spacing\ccval{2}, por exemplo. Os atalhos \cs\singlesp, \cs\onehalfsp\ e \cs\doublesp\ estão disponíveis. Note que o espaçamento simples não tem o mesmo valor que o espaçamento um, portanto, \cs\singlesp\ é diferente de \cs\spacing\ccval{1}! Os atalhos \cs\onehalfsp\ e \cs\doublesp\ tem o mesmo significado de \cs\spacing\ccval{1.5} e \cs\spacing\ccval{2}.
 
 \section{\emph{Layout}}
 
-A folha é A4 por padrão e as margens esquerda e direita são de 3\,cm, 2\,cm para páginas ímpares e de 2\,cm, 3\,cm para páginas pares, respectivamente. Além disso, as margens superior e inferior têm, nessa ordem, 3\,cm, 2\,cm para todo o documento. Todas essas medidas podem ser alteradas com a macro \cs\paper\ que deve ser usada assim: \cs\paper\ccval{left=0cm,right=0cm,top=0cm,botttom=0cm}.
+A folha é A4 por padrão e as margens esquerda e direita são de 3\,cm, 2\,cm para páginas ímpares e de 2\,cm, 3\,cm para páginas pares, respectivamente. Além disso, as margens superior e inferior têm, nessa ordem, 3\,cm, 2\,cm para todo o documento. Todas essas medidas podem ser alteradas com a macro \cs\paper\ que deve ser usada assim: \cs\paper\ccval{left=0cm, right=0cm, top=0cm, botttom=0cm}.
 
 Além das chaves anteriores também existe \cs{twoside} que é booleana, ou seja, aceita os valores \cs{true} ou \cs{false} e serve para ativar o modo de impressão em duas folhas aonde as medidas das margens horizontais se invertem nas páginas pares. Ao não informar um valor para \cs{twoside} subentende-se que seja \cs{true}, portanto \cs\paper\ccval{twoside} equivale a \cs\paper\ccval{twoside=true} e esse princípio também se aplica a outras chaves booleanas.
 
@@ -258,11 +250,13 @@ Use \cs\place\ para inserir áreas de legenda como mostrado em \ref{vb:place}. M
 \end{document}
 \codeoff
 
-O leitor pode querer definir uma nova área de legenda usando, por exemplo: \cs\legendplacedef\ccval{diagram}\ccval{Diagrama}\ccval{Lista de diagramas}\ccval{diag.\cs\,\cs#1}\ccval{lod} que vai criar o comando \cs\makelod\ para escrever no documento as entradas do arquivo auxiliar .lod.
+O leitor pode querer definir uma nova área de legenda usando, por exemplo, a instrução: \cs\legendplacedef\ccval{diagram}\ccval{Diagrama}\ccval{Lista de diagramas}\ccval{diag.\cs\,\cs#1}\ccval{lod} que vai criar o comando \cs\makelod\ para escrever no documento as entradas do arquivo auxiliar .lod.
+
+%*
 
 \section{Formatação de {\ttfamily\protect\textbackslash cite} e referências}
 
-Até o momento o \pkg{abntexto} não possui macros para formatação de \cs\cite\ e referências. Utilize \cs{\usepackage\{abnt2cite\}} ou \cs{\usepackage[style=abnt]\{biblatex\}}.
+Até o momento o \pkg{abntexto} não possui macros para formatação de \cs\cite\ e referências. Utilize \cs{\usepackage[style=abnt]\{biblatex\}}.
 
 \section{Citações}
 
@@ -271,18 +265,89 @@ Para inserir aspas em citações diretas use \cs\qt\ccval{texto}. Mas, se tratan
 \newpage
 
 \corrprinton
-\printbibliography
+%\printbibliography
 \corrprintoff
 
 \newpage
 \appendix
 
+\section{\emph{Feedback}}
+Sugestões, relatos de \emph{bugs} e doações são bem-vindas.
+
 \section{Código-fonte}
 
-Em progresso\dots
+\makeatletter
+\newcount\seccount \def\thesec{\the\seccount}
+\def\extlabelwidth{4ex}
+\def\extlabelbox#1{\hbox to\extlabelwidth{#1~---~\hfil}}
+\def\l@subsection#1#2{\smartaboveskip{\penalty351}{\vskip1em plus1pt}%
+	\begingroup
+		\usetocifont \nobreak
+		\extlineshape \relax
+		\hskip-\leftskip \maybeuctoc{#1}\nobreak\hfil\nobreak
+		\hbox to1.55em{\hss #2\kern-1pt\kern1pt}\par
+	\endgroup
+}
+\def\subsection#1{\par \smartaboveskip{\penalty351}{\vskip\subsectionabove}\noindent
+	\advancecount\seccount
+	\setbox0=\hbox{\usesubsectionfont \thesec\quad}%
+	{\usesubsectionfont \hangindent=\wd0 \box0 #1\tnba@nbpar}%
+	\nobreak \smartbelowskip{\vskip\subsectionbelow}%
+}
+\makeatother 
 
-\section{\emph{Feedback}}
+% SOURCE MACROS
+% ================================================
+
+\makeatletter
+
+\definecolor{bg}{cmyk}{0,0.06,0,0}
+\definecolor{comment}{cmyk}{0.9,0,0,0.1}
 
-Sugestões, \emph{bug reports} e doações são bem-vindas.
+\def\sec#1\par{\subsection{#1}}
 
-\end{document} 
+\newdimen\hhkern \hhkern=12pt 
+\newdimen\vvkern \vvkern=12pt 
+
+\def\hh{\kern\hhkern}
+\def\vv{\kern\vvkern}
+
+{\catcode`\^^M=13 
+	\gdef\verbpercent#1^^M{{\bfseries\color{comment}\@percentchar#1^^M}}
+}
+
+\def\srccatcodes{\catcode`\!=14 \catcode`\%=9 \catcode`\|=0 }
+\def\codecatcodes{\let\do=\dodef \dospecials}
+
+\long\def\bcode{\par\begingroup \codecatcodes
+	\adef{\^^I}{\ \ \ }%
+	\adef{\^^M}{\par\leavevmode}%
+	\adef{ }{\ }%
+	\adef{\%}{\verbpercent}%
+%	\def\par##1{\endgraf\ifx##1\par\leavevmode\fi##1}\obeylines
+	\startcode
+}
+{\catcode`\%=13 \catcode`\ =13 \catcode`\^^M=13 \catcode`\|=0 \catcode`\\=12 
+	|long|gdef|startcode #1% |ecode{|codefont{#1}|par|endgroup}
+}
+
+\def\codefont{\raggedright\small\ttnoligs\bgbox}
+
+\long\def\bgbox#1{\setbox0=\vbox{\advance\hsize-24pt \vv#1\vv}%
+	\ifdim\ht0>\dimexpr \pagegoal - \pagetotal \relax
+		\setbox2=\vsplit0 to\dimexpr \pagegoal - \pagetotal -24pt \relax
+	\fi
+	\vskip8pt minus2pt 
+	\drawbg2\par \drawbg0%
+	\vskip8pt minus2pt 
+}
+\def\drawbg#1{\leavevmode
+	\rlap{{\color{bg} \vrule width\dimexpr\wd#1+24pt\relax height\ht#1 depth\dp#1}}%
+	\hbox{\hh\box#1\hh}%
+}
+
+\def\inputsrc#1{\begingroup \parskip=0pt \srccatcodes \input #1\endgroup}
+
+\inputsrc{abntexto.cls}
+
+\end{document}
diff --git a/Master/texmf-dist/doc/latex/abntexto/abntexto.bib b/Master/texmf-dist/doc/latex/abntexto/abntexto.bib
index 6604bc3f5b8..6e58d2d95ff 100644
--- a/Master/texmf-dist/doc/latex/abntexto/abntexto.bib
+++ b/Master/texmf-dist/doc/latex/abntexto/abntexto.bib
@@ -22,4 +22,3 @@
 	url = {https://www.ctan.org/pkg/latex2e-help-texinfo},
 	urldate = {2022-09-28}
 }
-
diff --git a/Master/texmf-dist/tex/latex/abntexto/abntexto.cls b/Master/texmf-dist/tex/latex/abntexto/abntexto.cls
index aa12bb3eb8c..4ae9b0ade6d 100644
--- a/Master/texmf-dist/tex/latex/abntexto/abntexto.cls
+++ b/Master/texmf-dist/tex/latex/abntexto/abntexto.cls
@@ -1,8 +1,14 @@
 %! Public Domain Software
-%! 2022-10-06
-%! 1.2.0-alpha
+%! 2022-10-12
+%! 1.2.1-alpha
 %! Elayson
-%! abntexto dot classe at gmail dot com
+%! abntexto.classe at gmail.com
+
+%! ANNOUNCEMETS
+
+%!> Changed the manual's typographic font to a serif because they are better for reading long texts — although the manual is purposely short.
+
+%!> Removal of \srcname macro because it is useless.
 
 %! SUMÁRIO
 
@@ -21,6 +27,11 @@
 %! A VÍRGULA COMO SEPARADOR DECIMAL
 %! INICIALIZAÇÃO
 
+% |sec RECOMENDAÇÕES
+% !=======================================================
+
+% Macros internas não podem ser modificadas ou usadas diretamente. Isso é porque essas macros podem ser redefinidos ou até renomeados em futuras versões desta classe. Por macros internas entende-se aquelas com prefixo do pacote em questão, neste caso, \cs{tnba@}. Se você precisa de algum comando interno, defina outro sem anexar o prefixo.
+
 % \sec PRÉ-CONFIGURAÇÕES
 % !=======================================================
 
@@ -29,12 +40,12 @@
 % |bcode !------------------------------------------------
 \NeedsTeXFormat{LaTeX2e}
 
-\ProvidesClass{abntexto}[2022-10-06 1.2.0-alpha Preparation of works in ABNT standards]
+\ProvidesClass{abntexto}[2022-10-12 1.2.1-alpha Preparation of works in ABNT standards]
 
 \RequirePackage{keyval}
 % |ecode !------------------------------------------------
 
-% Definição do sistema \emph{chave=valor} e de um comando de \emph{debug}. Perceba que \tnba@bodyhook não pode ser igual a \cs\relax, mas \cs\empty ao invés.
+% Definição de um sistema \emph{chave=valor} pessoal e de macros auxiliares. Perceba que \cs{\tnba@bodyhook} não pode ser igual a \cs\relax, mas \cs\empty\ ao invés.
 
 % |bcode !------------------------------------------------
 \def\tnba@keyprefix{tnba}
@@ -49,7 +60,11 @@
 
 \let\tnba@bodyhook=\empty
 \AddToHook{begindocument}{\def\tnba@body{}\tnba@bodyhook}
+% |ecode !------------------------------------------------
+
+% Comando de \emph{debug}.
 
+% |bcode !------------------------------------------------
 \def\tnba@error{\ClassError{abntexto}}
 % |ecode !------------------------------------------------
 
@@ -115,11 +130,12 @@
 	\advance\topmargin-\headheight \advance\topmargin-\headsep 
 	\advance\textwidth-\tnba@L     \advance\textwidth-\tnba@R
 	\advance\textheight-\tnba@T    \advance\textheight-\tnba@B 
-	\setbox0=\hbox{\@setfontsize\@tempa{10}{12pt}\@tempa 1}
-	\advance\headsep-\ht0
+	\setbox0=\hbox{\@setfontsize\@tempa{10pt}{12pt}\@tempa 1}%
+	\advance\headsep-\ht0 
 	\ifx\pdfpagewidth\undefined
 		\ifx\pagewidth\undefined
-			\tnba@error{O comando \@backslashchar paper só suporta saída em PDF. Use o formato PDF ou carregue o pacote *geometry*}\expandafter\enddocument\relax \else
+			\tnba@error{O comando \@backslashchar paper só suporta saída em PDF.
+			 			 Use o formato PDF ou carregue o pacote *geometry*}\expandafter\enddocument\relax \else
 			\horigin=0pt 
 			\vorigin=0pt 
 			\pagewidth=\paperwidth 
@@ -143,6 +159,10 @@
 }
 % |ecode !------------------------------------------------
 
+% O estilo de página \cs\pretextual\ omite a numeração de página e desliga o modo \cs{twoside} porque os elementos pré-textuais que compreendem as folhas da capa à do sumário, devem constar no anverso da página, ou seja, na “frente” da folha.
+
+% A instrução \cs\textual\ põe a numeração de página no topo direito nas páginas ímpares e no topo esquerdo em paginas pares. Além disso, \cs{twoside} vai espelhar as margens horizontais.
+
 % |bcode !------------------------------------------------
 \def\pretextual{\paper{twoside=false}%
 	\let\@oddhead=\empty
@@ -163,6 +183,8 @@
 % \sec SUMÁRIO
 % !=======================================================
 
+% Aqui, \cs\extline\ foi baseado em \cs\@dottedtocline, do kernel do LaTeX. Ele não é uma instrução privada, ou seja, com prefixo interno, pois existe a chance de o leitor querer redefiní-lo (o mesmo vale para \cs\extlineshape).
+
 % |bcode !------------------------------------------------
 \def\thepage{\the\c@page}
 
@@ -196,6 +218,13 @@
 \def\l@subsubsection {\extline{toc}{3}}
 \def\l@paragraph     {\extline{toc}{4}}
 \def\l@subparagraph  {\extline{toc}{5}}
+% |ecode !------------------------------------------------
+
+% Comandos de personalização do ToC (sumário).
+
+% |bcode !------------------------------------------------
+\def\tociuppercase{\def\maybeuctoc{\MakeUppercase}}
+\def\tocilowercase{\let\maybeuctoc=\relax}
 
 \def\tocifont#1{\def\usetocifont{#1}}
 \def\tociifont#1{\def\usetociifont{#1}}
@@ -207,6 +236,8 @@
 % \sec SECIONAMENTO
 % !=======================================================
 
+% As linhas abaixo são basicamente uma cópia da funcionalidade do formato OpTeX. O par \cs\smartaboveskip, \cs\smartbelowskip, em especial, serve para eliminar \cs\vskip’s redundantes.
+
 % |bcode !------------------------------------------------
 \def\tnba@nbpar{\interlinepenalty=10000\par}
 \def\noindentfirst{\global\everypar={\tnba@wipeepar \setbox7=\lastbox}}
@@ -245,10 +276,12 @@
 \def\subparagraphmark#1{}
 % |ecode !------------------------------------------------
 
+% Nesta parte estão definidos os comandos secionais.
+
 % |bcode !------------------------------------------------
 \def\section#1{\par \smartaboveskip{\penalty351}{\vskip\sectionabove}\noindent
 	\advancecount\sectioncount
-	\def\@currentlabel{seção~\thesection}%
+	\def\@currentlabel{seção~\thesection}%+/
 	\setbox0=\hbox{\usesectionfont \thesection\quad}%
 	{\usesectionfont \hangindent=\wd0 \box0 \maybeucsec{#1}\tnba@nbpar}%
 %	\noindentfirst
@@ -293,20 +326,24 @@
 	\nobreak \smartbelowskip{\vskip\subparagraphbelow}%
 }
 
-\def\heading#1{\noindent
-	{\usesectionfont \centering \maybeucsec{#1}\tnba@nbpar}%
-	\nobreak \vskip\sectionbelow
-}
-
 \def\hreftocline#1{\Hy@MakeCurrentHrefAuto{#1}%
 	\Hy@raisedlink{\hyper@anchorstart{\@currentHref}\hyper@anchorend}%
 }
 \tnba@tobody{\ifx\hypertarget\undefined \let\hreftocline=\@gobble \fi}
 % |ecode !------------------------------------------------
 
+% A macro \cs\heading, em particular, serve para produzir títulos não contados, como “Sumário”, “Lista de figuras”, “Apêndice” etc.
+
+% |bcode !------------------------------------------------
+\def\heading#1{\noindent
+	{\usesectionfont \centering \maybeucsec{#1}\tnba@nbpar}%
+	\nobreak \vskip\sectionbelow
+}
+% |ecode !------------------------------------------------
+
+% Comandos de personalização de seções.
+
 % |bcode !------------------------------------------------
-\def\tociuppercase{\def\maybeuctoc{\MakeUppercase}}
-\def\tocilowercase{\let\maybeuctoc=\relax}
 \def\sectionuppercase{\def\maybeucsec{\MakeUppercase}}
 \def\sectionlowercase{\let\maybeucsec=\relax}
 
@@ -321,15 +358,20 @@
 \def\subsubsectionspaces#1#2{\def\subsubsectionabove{#1}\def\subsubsectionbelow{#2}}
 \def\paragraphspaces#1#2{\def\paragraphabove{#1}\def\paragraphbelow{#2}}
 \def\subparagraphspaces#1#2{\def\subparagraphabove{#1}\def\subparagraphbelow{#2}}
+
+\def\toclabelwidth{3.4ex}
+\def\toclabelbox#1{\hbox to\extlabelwidth{#1\hfil}}
 % |ecode !------------------------------------------------
 
+% Após a chamada da instrução \cs\appendix, \cs\section\ vai ser alterado para produzir títulos centralizados com o prefixo “Apêndice”. O mesmo vale para \annex.
+
 % |bcode !------------------------------------------------
 \newcount\appendixcount
 \newcount\annexcount
 
 \def\theappendix{\@Alph\appendixcount}
 \def\theannex{\@Alph\annexcount}
-\def\appendixlabelwidth{8em}
+\def\appendixlabelwidth{6.6em}
 \def\annexlabelwidth{6.2em}
 
 \def\l@appendix{\let\extlabelwidth=\appendixlabelwidth
@@ -372,6 +414,8 @@
 % \sec ALÍNEAS
 % !=======================================================
 
+% Estas linhas não foram baseadas no ambiente \cs{list} do LaTeX, portanto, não podem ser personalizadas pelo pacote \cs{enumitem}, por exemplo.
+
 % |bcode !------------------------------------------------
 \newcount\topicsdepth
 \newcount\topicscount
@@ -398,6 +442,8 @@
 % \sec TABELAS
 % !=======================================================
 
+% Na classe \cs{article} o ambiente \cs{table} inicia o modo flutuante. Mas nesta classe ele é sinônimo de \cs{tabular} porque faz mais sentido para min.
+
 % |bcode !------------------------------------------------
 \newenvironment{table}[1]{\begin{tabular}{#1}}{\end{tabular}}
 % |ecode !------------------------------------------------
@@ -461,7 +507,6 @@
 	\removelastskip \fi\fi
 	\def\tnba@savedsrc{#1}%
 }
-\def\srcname{Fonte}
 % |ecode !------------------------------------------------
 
 % |bcode !------------------------------------------------
@@ -504,6 +549,8 @@
 % \sec UTILIDADES
 % !=======================================================
 
+% Algumas macros úteis foram definidos aqui como \cs\Enter\ que serve para produzir um espaço vertical equivalente àquele produzido com a tecla Enter em editores de texto como MS Word.
+
 % |bcode !------------------------------------------------
 \def\tnba@getprevdepth{\par\xdef\tnba@getprevdepthA{\the\prevdepth}}
 \def\tnba@useprevdepth{\par\prevdepth=\tnba@getprevdepthA}
@@ -538,15 +585,19 @@
 % |ecode !------------------------------------------------
 
 % \sec A VÍRGULA COMO SEPARADOR DECIMAL
-% !======================================================= 
+% !=======================================================
+
+% No Brasil e em outro lugares a vírgula é um separador decimal, portanto \verb+$1,2$+ deve produzir um resultado diferente de \verb+$1, 2$+, por exemplo.
+
+% As linhas abaixo são uma cópia da implementação do pacote \pkg{icomma}.
 
 % |bcode !------------------------------------------------
 {\catcode`,=\active
-	\gdef,{\futurelet\let@token\tnba@smartcomma}
+	\gdef,{\futurelet\@let@token\tnba@smartcomma}
 }
 \def\tnba@smartcomma{%
-	\ifx\let@token\@sptoken \else
-	\ifx\let@token\space    \else \mathord \fi\fi
+	\ifx\@let@token\@sptoken \else
+	\ifx\@let@token\space    \else \mathord \fi\fi
 	\tnba@mathcomma
 }
 
@@ -566,6 +617,8 @@
 % \sec INICIALIZAÇÃO
 % !=======================================================
 
+% Aqui o \pkg{abntexto} define as configurações padrões. Note que \cs\pretextual\ deve ser carregado após \cs{\begin{document}} para evitar múltiplas chamadas deste caso seja redefinido pelo usuário ou escritor de pacotes.
+
 % |bcode !------------------------------------------------
 \fontsizedef{12pt}{
 	\normalsizedef{12pt}{14.5pt}
@@ -618,8 +671,8 @@
 \placespaces{\baselineskip}{\baselineskip}
 
 \def\maketoc{\heading{Sumário}
-	\def\extlabelwidth{4ex}%
-	\def\extlabelbox##1{\hbox to\extlabelwidth{##1\hfil}}%
+	\let\extlabelwidth=\toclabelwidth
+	\let\extlabelbox=\toclabelbox
 	\@starttoc{toc}\newpage
 }