4 files changed, 17 insertions, 4 deletions
diff --git a/macros/latex/contrib/colorist/colorart.cls b/macros/latex/contrib/colorist/colorart.cls
index 289de77adc..ecb53faa42 100644
--- a/macros/latex/contrib/colorist/colorart.cls
+++ b/macros/latex/contrib/colorist/colorart.cls
@@ -18,7 +18,7 @@
 \NeedsTeXFormat{LaTeX2e}[2022-06-01]
 \ProvidesExplClass
   {colorart}
-  {2023/09/28} {}
+  {2023/09/30} {}
   {A colorful article style}
 
 \tl_const:Nn \l__colorclass_base_class_tl { article }
diff --git a/macros/latex/contrib/colorist/colorbook.cls b/macros/latex/contrib/colorist/colorbook.cls
index 51dacaee11..40b07da904 100644
--- a/macros/latex/contrib/colorist/colorbook.cls
+++ b/macros/latex/contrib/colorist/colorbook.cls
@@ -18,7 +18,7 @@
 \NeedsTeXFormat{LaTeX2e}[2022-06-01]
 \ProvidesExplClass
   {colorbook}
-  {2023/09/28} {}
+  {2023/09/30} {}
   {A colorful book style}
 
 \tl_const:Nn \l__colorclass_base_class_tl { book }
diff --git a/macros/latex/contrib/colorist/colorist-fancy.sty b/macros/latex/contrib/colorist/colorist-fancy.sty
index 75e8f0eecd..773190630b 100644
--- a/macros/latex/contrib/colorist/colorist-fancy.sty
+++ b/macros/latex/contrib/colorist/colorist-fancy.sty
@@ -18,7 +18,7 @@
 \NeedsTeXFormat{LaTeX2e}[2022-06-01]
 \ProvidesExplPackage
   {colorist-fancy}
-  {2023/09/28} {}
+  {2023/09/30} {}
   {The fancy style of colorist}
 
 \IfPackageLoadedTF { colorist } {}
@@ -619,6 +619,7 @@ heading_suffix "}\n"
     \vspace{2pc plus .5pc minus .3pc}
   }
 
+%% Prevent column break before the first sub-entry in the index
 \bool_new:N \l__colorist_if_first_subitem_bool
 \renewcommand*{\@idxitem}
   {
@@ -709,6 +710,7 @@ heading_suffix "}\n"
     \tl_use:c { c_colorist_r_mathparen_ \l_projlib_language_current_languagetype_tl _tl }
   }
 
+%% Change equation numbers to gray
 \def\tagform@#1{\maketag@@@{\textcolor{.!39!paper}{(\ignorespaces#1\unskip\@@italiccorr)}}}
 
 \PassOptionsToPackage { nopatch = eqnum } { microtype }
@@ -755,10 +757,18 @@ heading_suffix "}\n"
         {\color{main-text!50!paper}\thmnote{\hspace{.4em} \colorist_insert_l_mathparen: #3 \colorist_insert_r_mathparen: }}\nobreakspace\nobreakspace{\normalfont\textcolor{main-text!27!paper}{---}}\nobreakspace\nobreakspace}
   }
 
+\def\@endtheorem{\popQED\endtrivlist\@endpefalse}
+
 \newcommand{\customqedsymbol}{
   \makebox[1em]{\color{.!27!paper}\rule[-0.1em]{.95em}{.95em}}}
 \let\qedsymbol\customqedsymbol
 
+%% Special treatments for the Q.E.D. symbol
+\def\noQED{\let\popQED\relax}
+\let\noqed\noQED
+\def\proofless{\pushQED{\qed}}
+
+%% The style of the theorem-type environment that will be wrapped into the color box
 \bool_if:NTF \l__colorist_theorem_in_new_line_bool
   {
     \newtheoremstyle{basic}
@@ -801,10 +811,12 @@ heading_suffix "}\n"
 
 \theoremstyle{basic}
 
+%% The style of remark-type environments
 \newtheoremstyle{emphasis}
     {0pt}{0pt}{\itshape}{0pt}{}{}{0pt}
     {\thmnote{\normalfont\sffamily\color{main-text}#3\hspace*{0.5em}}}
 
+%% Custom proof style
 \renewenvironment{proof}[1][\proofname]{\par
   \pushQED{\qed}
   \normalfont \topsep6\p@\@plus6\p@\relax
@@ -1081,6 +1093,7 @@ heading_suffix "}\n"
     opacityframe=0, opacityback=0
   }
 
+%% Connect adjacent definition-type environments
 \NewDocumentCommand \AfterEnvEnd { +m }
   { \colorist_after_env_end:nw { #1 } }
 \cs_new_protected:Npn \colorist_after_env_end:nw #1 #2
diff --git a/macros/latex/contrib/colorist/colorist.sty b/macros/latex/contrib/colorist/colorist.sty
index 6a89f9d6e7..23137e14ae 100644
--- a/macros/latex/contrib/colorist/colorist.sty
+++ b/macros/latex/contrib/colorist/colorist.sty
@@ -18,7 +18,7 @@
 \NeedsTeXFormat{LaTeX2e}[2022-06-01]
 \ProvidesExplPackage
   {colorist}
-  {2023/09/28} {}
+  {2023/09/30} {}
   {A colorful style for articles and books}
 
 \keys_define:nn { colorist }