asmejour (23dec21)

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

4 files changed, 121 insertions, 81 deletions

diff --git a/Master/texmf-dist/doc/latex/asmejour/README.md b/Master/texmf-dist/doc/latex/asmejour/README.md
index 18a7f825f0e..067d79afe30 100644
--- a/Master/texmf-dist/doc/latex/asmejour/README.md
+++ b/Master/texmf-dist/doc/latex/asmejour/README.md
@@ -1,11 +1,11 @@
  
   #asmejour: A template for ASME journal papers#
  
-  Version 1.15 dated 2021/02/01.
+  Version 1.16 dated 2021/12/23.
 
   ####Overview####
   This class provides a template to format preprints in the style of journal papers published by the American Society of Mechanical Engineers. 
-  The layout and reference formats follow the style of published papers in 2020.
+  The layout and reference formats follow the style of published papers in 2021.
   
   This work is not a publication of ASME.
 
@@ -29,7 +29,7 @@
 
  - closely approximate ASME's fonts and layout, including author/title/abstract design
 
- - match ASME's current reference formats, including hyperlinked DOI and URL fields
+ - match ASME's current reference formats, including hyperlinked DOI and URL (replaces asmems4.bst)
 
  - support hyperlinks to figures, tables, equations, references, and external URLs
 
@@ -64,6 +64,15 @@
  ---
  
  ####Change log####
+v1.16 (2021/12/23):
+ - suppress warnings about unused options when calling mathalfa and/or barcolor
+ - eliminate use of \\entry{} with a single argument to produce subheadings in nomenclature; use \\EntryHeading{} instead. (**not backward compatible**)
+ - incorporate pending changes to LaTeX pdf management in relation to pdf-a color profile loading and recently deprecated \\pdfcatalog command
+ - load xparse only for older kernels
+ - edit documentation; mention \\mathversion sans and sansbold
+ - add upright, sans serif Greek letters for math
+ - minor edits to class file code; correct calls for pdfminorversion; edit warnings
+ - minor edits to asmejour.bst in relation to hyperlinks, \\href, \\hrefurl; update jht macro to latest style
 
 v1.15 (2021/02/01): 
  - fix issue with math accents in mathversion sansbold (for captions)
diff --git a/Master/texmf-dist/doc/latex/asmejour/asmejour-sample.bib b/Master/texmf-dist/doc/latex/asmejour/asmejour-sample.bib
index 864e8f51fba..7f6e8d353d7 100644
--- a/Master/texmf-dist/doc/latex/asmejour/asmejour-sample.bib
+++ b/Master/texmf-dist/doc/latex/asmejour/asmejour-sample.bib
@@ -1,6 +1,6 @@
 %% Sample bibliography file for asmejour.bst and asmejour.cls
 %%
-%% Revised: 30 January 2021
+%% Revised: 22 December 2022
 %% Copyright John H. Lienhard, MIT
 %% Offered under the MIT license: https://ctan.org/license/mit 
 
@@ -12,7 +12,7 @@
   author  =	{D. K. Edwards},
   year	  =	{1969},
   title	  =	{Radiative Transfer Characteristics of Materials},
-  journal =	{{ASME} J. Heat Transfer},
+  journal = {{ASME} J. Heat Transfer-Trans. {ASME}},
   volume  =	91,
   number  = 1,
   pages   = {1--15},
@@ -128,14 +128,24 @@
 %%                               note, url, urldate, urltype
 %% These additional fields are also supported, but are intended as alternatives to url: doi, eprint with archive 
 
+@online{kern,
+  author 	= {Uwe Kern},
+  year 		= {2021},
+  title 	= {Extending \LaTeX's color facilities: the \textsf{xcolor} package},
+  version 	= {2.13},
+  organization = {Comprehensive \TeX\ Archive Network},
+  url 		= {https://ctan.org/pkg/xcolor},
+  urldate 	= {Dec. 22, 2021},
+}
+
 @online{sharpe1,
   author 	= {Michael Sharpe},
-  year 		= {2018},
+  year 		= {2021},
   title 	= {New {TX} Font Package},
-  version 	= {1.554},
+  version 	= {1.659},
   organization = {Comprehensive \TeX\ Archive Network},
   url 		= {https://ctan.org/pkg/newtx},
-  urldate 	= {Apr. 27, 2019},
+  urldate 	= {Dec. 22, 2021},
 }
 
 @article{Lienhard2019b,
@@ -212,7 +222,7 @@
             	R. F. Boisvert and C. W. Clark and B. R. Miller and B. V. Saunders},
   organization = {National Institute of Standards and Technology},
   address 	= {Gaithersburg, MD},
-  url 		= {http://dlmf.nist.gov/},
+  url 		= {https://dlmf.nist.gov/},
   urldate 	= {Dec. 22, 2018},
 }
 
@@ -220,7 +230,7 @@
   author	= {Richard Koch},
   title 	= {{\TeX}{S}hop, Version 4.01},
   year		= {2018},
-  url 		= {http://pages.uoregon.edu/koch/texshop/obtaining.html},
+  url 		= {https://pages.uoregon.edu/koch/texshop/obtaining.html},
   urldate 	= {Apr. 16, 2018},
   organization = {University of Oregon},
   address 	= {Eugene, OR},
@@ -341,7 +351,7 @@
   eprint 	= {2060/19980228020},
 }
 %% Equivalent links for this case: url = {https://ntrs.nasa.gov/archive/nasa/casi.ntrs.nasa.gov/19980228020.pdf},
-%%                                 url = {http://hdl.handle.net/2060/19980228020}
+%%                                 url = {https://hdl.handle.net/2060/19980228020}
 
 @incollection{clauser56,
   author 	= {Francis H. Clauser},
@@ -433,7 +443,7 @@
 @online{mpl,
   title		= {mpl Colormaps},
   author	= {St{\'e}fan {van der Walt} and Nathaniel Smith},
-  url 		= {http://bids.github.io/colormap/},
+  url 		= {https://bids.github.io/colormap/},
   urldate 	= {Aug. 26, 2018},
   year 		= 2015,
   organization = {GitHub},
@@ -452,7 +462,7 @@
   edition   = {5},   
   month     = aug,   
   version   = {5.00}, 
-  url  		= {http://ahtt.mit.edu},  
+  url  		= {https://ahtt.mit.edu},  
 } 
 
  
@@ -497,14 +507,14 @@
 }
 
 @proceedings{johnson2015,
-  editor	= {Howard Johnson},
+  editor	= {Howard W. Johnson},
   title		= {The Title of the Proceedings},
   year		= 2015,
   volume	= 2,
   organization = {Organization},
   venue		= {City, State},
   eventdate	= {April 27--28},
-  url		= {http://web.mit.edu},
+  url		= {https://news.mit.edu/2009/obit-johnson},
   note		= {Optional note},
 }
 %% proceedings supports these fields: author OR editor, year, title, edition, editor, 
@@ -524,6 +534,7 @@
   number 	= {23},
   publisher = {Vulcan Free Press},
   address 	= {T'Paal},
+  note 		= {To appear.},
 }
 %% One book in a series of books
 
@@ -536,7 +547,7 @@
   volume 	= {1},
   chapter	= {5},
   pages 	= {66--89},
-  url 		= {http://web.mit.edu},
+  url 		= {https://www.worldcat.org/oclc/3025315},
   publisher = {Houghton Mifflin Co.},
   address 	= {Boston},
   note 		= {{``The Locust Years''}},
diff --git a/Master/texmf-dist/doc/latex/asmejour/asmejour-template.pdf b/Master/texmf-dist/doc/latex/asmejour/asmejour-template.pdf
index 2951bf48e78..8d6ee337d44 100644
--- a/Master/texmf-dist/doc/latex/asmejour/asmejour-template.pdf
+++ b/Master/texmf-dist/doc/latex/asmejour/asmejour-template.pdf
diff --git a/Master/texmf-dist/doc/latex/asmejour/asmejour-template.tex b/Master/texmf-dist/doc/latex/asmejour/asmejour-template.tex
index b822063f694..9aba31970cb 100644
--- a/Master/texmf-dist/doc/latex/asmejour/asmejour-template.tex
+++ b/Master/texmf-dist/doc/latex/asmejour/asmejour-template.tex
@@ -3,7 +3,7 @@
 %% 
 %%  This file is asmejour-template.tex, a template to format papers in the style of ASME journal papers. 
 %%
-%%  This file is version 1.15 dated 2021/02/01
+%%  This file is version 1.16 dated 2021/12/23
 %%
 %%  Author: John H. Lienhard V
 %%          Department of Mechanical Engineering
@@ -18,7 +18,7 @@
 %%          * Option to omit the list of figures and list of tables at the end [nolists]
 %%
 %%          * Math options from M. Sharpe's newtxmath package: upright integrals [upint];
-%%          *    [varvw] for a v and w that are better distinguished from greek nu; [subscriptcorrection]
+%%          *    [varvw] for a v and w that are better distinguished from Greek nu; [subscriptcorrection]
 %%			*	 to fine-tune the placement of math subscripts; and also additional options such as
 %%          *    [smallerops, varg, slantedGreek, frenchmath, varbb, cmbraces]. Version 1.6 or higher
 %%          *    is recommended.
@@ -31,17 +31,21 @@
 %%			*    misbehaves, so use it with an awareness that it can create unexpected problems.
 %%			*	 This option is not compatible with line numbering.
 %%
-%%			* Options for PDF/A compliance. [pdf-a] will produce PDF/A-3u compliance with sRGB OutputIntent.
-%%			*	 [pdfapart= 1 or 2 or 3] and [pdfaconformance= b or u] allow other levels: 1b, 2b, 2u, and 3b.
-%%
-%%          * An option to omit all the ASME text fields from the footer [nofoot].
-%%
 %%          * Options for copyright notices:
 %%			* 	 Omit the ASME copyright from the footer [nocopyright]
 %%			*	 Copyright footnote if all authors are government employees  [govt]
 %%			*	 Copyright footnote if some authors are government employees [govtsome]
 %%			*	 Copyright footnote for government contractors [contractor]
 %%
+%%          * Option to omit all ASME text fields from the footer [nofoot].
+%%
+%%			* Options for PDF/A compliance. [pdf-a] will produce PDF/A-3u compliance with sRGB OutputIntent.
+%%			*	 [pdfapart= 1 or 2 or 3] and [pdfaconformance= b or u] can enable levels 1b, 2b, 2u, and 3b.
+%%			*
+%%			*    The most recent versions of LaTeX (2021 and later) are moving toward integrated support for pdf-a, 
+%%			*    through \DeclareDocumentMetadata{..}. The asmeconf class supports these new features, which can 
+%%			*	 replace the aforementioned class options. (An up-to-date LaTeX installation is required.)
+%%
 %%          * Many options for calligraphic, script, and fraktur fonts from the mathalfa package; the
 %%          *    example value used is: mathalfa=cal=euler (use Euler font for \mathcal)
 %%          *    some other options for cal are: dutchcal, zapfc, cm (default), boondox,...
@@ -59,7 +63,7 @@
 %%          *    abstract in an appendix), e.g. [french].  The main language will default to English 
 %%          *    unless a different main language is selected, e.g. [main=spanish]. See Appendix C for details.
 %%
-%%  For details of the newtxmath and mathalfa packages, refer to their documentation (available at CTAN: http://ctan.org).
+%%  For details of the newtx and mathalfa packages, refer to their documentation (available at CTAN: http://ctan.org).
 %%
 %%  The use of commands defined or modified by the asmejour class is illustrated below. In particular, some care
 %%  is needed when using complicated math and macros in section headings, to avoid problems with pdf bookmarks, 
@@ -75,28 +79,30 @@
 %%
 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 
-
 %% Class options are described above.
-\documentclass[subscriptcorrection,upint,varvw,mathalfa=cal=euler,barcolor=Goldenrod3,balance,hyphenate,french,pdf-a]{asmejour}
+\documentclass[subscriptcorrection,upint,varvw,barcolor=Goldenrod3,mathalfa=cal=euler,balance,hyphenate,french,pdf-a]{asmejour} %
+
 
-%%%%%  FIELDS TO BE COMPLETED FOLLOW  %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%%%%  pdf metadata  %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 
-%%%%%  pdf metadata, the user should edit %%%%%%%%%%%%%%%%%%
 \hypersetup{%
-	pdftitle={ASME Journal Paper Template},                % <=== change to YOUR pdf file title
-	pdfkeywords={ASME, Paper, Template, LaTeX, BibTeX, asmejour class},    % <=== change to YOUR pdf keywords
-	pdfauthor={John H. Lienhard},                          % <=== change to YOUR name[s]!!!
+	pdfauthor={John H. Lienhard},                       		   	% <=== change to YOUR name[s]!
+	pdftitle={ASME Journal Paper LaTeX Template},                  	% <=== change to YOUR pdf file title
+	pdfkeywords={ASME journal paper, LaTeX template, BibTeX style, asmejour class},% <=== change to YOUR pdf keywords
+	pdfsubject = {Describes the asmejour LaTeX template},			% <=== change to YOUR subject
+	pdfurl={https://ctan.org/pkg/asmejour},% may delete
+	pdflicenseurl={https://ctan.org/pkg/asmejour},% may delete
 }
 
-%%%% Journal name and optional copyright year %%%%%%%%%%%%%%
+%%%%  Journal name and optional copyright year %%%%%%%%%%%%%%
 
 %% Omit "Journal of". If Journal Name is quite long, use \\ to insert a line break
 \JourName{Heat Transfer}%<=== change to the name of your journal
 
 %% The default copyright year is the current year
-%% \PaperYear{2020} sets 2020; and \PaperYear{} omits the year entirely.
+%% \PaperYear{2022} sets 2022; and \PaperYear{} omits the year entirely.
                    
-%%%%%%%%%  End of Preamble  %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%%%%  end of preamble  %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 
 \begin{document}
 
@@ -152,12 +158,11 @@ This paper is an example and {\upshape\LaTeX} template for the {\upshape\texttt{
 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 %%%%%%%%%%%%%%%%%%%%%  End of fields to be completed. Now write! %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 
-
 \section{Introduction}
 
 The \texttt{asmejour} class typesets papers with margins, fonts, headings, captions, and reference formats that follow those used in journals published by the American Society of Mechanical Engineers (ASME). Internal and external hyperlinks will be set automatically, and the pdf file will contain bookmarks and metadata. Many other useful features are supported. 
 
-This class is not a publication of ASME, although the author has published in ASME journals since 1984. The intended use of this package is to allow authors to format their papers in ASME style prior to submission to an ASME journal for peer review.
+This class is not a publication of ASME, although the author has published in ASME journals since 1984. The intended use of this package is to enable authors to format their papers in ASME style prior to submission to an ASME journal for peer review.
 
 The \texttt{.tex} file may be written using standard \LaTeX\ commands, although some specific initial commands are needed to format the block containing the author[s], title, and abstract. The class calls a number of packages, all of which are contained in up-to-date versions of \TeX~Live, Mac\TeX, and similar platforms. If you find that you are missing a package, you may obtain it at no cost from CTAN (\href{http://ctan.org}{ctan.org}). 
 
@@ -168,12 +173,12 @@ For each author, put author names and affiliation (with line breaks) into a sepa
 
 The title should be placed into \verb|\title{..}|, and line breaks may be specified if desired. Keywords may optionally be including using the \verb|\keywords{..}| command; this command \textit{must} be issued before the abstract. To omit keywords, just omit this command. Next, the abstract text must be placed into \verb|\begin{abstract}|\ldots\verb|\end{abstract}|. The abstract will automatically be italicized. 
 
-The date is automatically given as an unnumbered footnote, which deafults to \verb|\today|. Different text may be given using \verb|\date{..}|. Putting \verb|\date{}| will suppress the date footnote.
+The date is automatically given as an unnumbered footnote, which defaults to \verb|\today|. Different text may be given using \verb|\date{..}|. Putting \verb|\date{}| will suppress the date footnote.
 
 After setting up the authors, title, and abstract, issue the \verb|\maketitle| command. The introduction section comes next. 
 
-\subsection{Optional to the Color Title Bar}
-The vertical bar in the title block is black in all ASME journals. Since the \texttt{asmejour} class is only for preprints, we include the [fun] option to have the bar in color. Any color \texttt{name} recognized by the \texttt{xcolor} package may be invoked by including the option \texttt{[barcolor=name]} in the \verb|\documentclass[..]{asmejour}| command. The color for this example is \texttt{Goldenrod3}. To have a black bar, either omit \texttt{barcolor} entirely or use the name \texttt{black}.
+\subsection{Option to Color the Title Bar}
+The vertical bar in the title block is black in all ASME journals. Since the \texttt{asmejour} class is only for preprints, we include the [fun] option to have the bar in color. Any color \texttt{name} recognized by the \texttt{xcolor} package~\cite{kern} may be invoked by including the option \texttt{[barcolor=name]} in the \verb|\documentclass[..]{asmejour}| command. The color for this example is \texttt{Goldenrod3}. To have a black bar, either omit \texttt{barcolor} entirely or use the name \texttt{black}.
 
 
 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
@@ -261,7 +266,7 @@ Landscape figures and tables may be produced at full-page size by putting \verb|
 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 \section{Reference Formatting with \texttt{asmejour.bst}}
 
-The {\upshape\texttt{asmejour.bst}} \hologo{BibTeX} style follows the reference styles observed in ASME journals in 2020.\footnote{\texttt{asmejour.bst} is intended as a replacement for the older style \texttt{asmems4.bst}, which does not follow ASME's current reference formats or support DOI and URL.} The vast majority of published references are to journal papers and books. Examples for these and many other entry types are given in the \texttt{asmejour-sample.bib} file, which is part of this distribution. Citations and references are managed by the standard \texttt{natbib} package.
+The {\upshape\texttt{asmejour.bst}} \hologo{BibTeX} style follows the reference styles observed in ASME journals in 2021.\footnote{\texttt{asmejour.bst} is intended as a replacement for the older style \texttt{asmems4.bst}, which does not follow ASME's current reference formats or support DOI and URL.} The vast majority of published references are to journal papers and books. Examples for these and many other entry types are given in the \texttt{asmejour-sample.bib} file, which is part of this distribution. Citations and references are managed by the standard \texttt{natbib} package.
 Nevertheless, a few comments are necessary. 
 
 \subsection{Capitalization of Titles} ASME's bibliography style requires that titles be in title case. The first letters of principal words are capitalized. This must be done when writing the \texttt{.bib} file.
@@ -291,6 +296,9 @@ Run 12 & 24   & 68.3 \\
 }%
 \end{table}
 
+%% Note: location of tables and figures can be adjusted with the options [!tbhp] 
+%% 		 see: https://latexref.xyz/dev/latex2e.html#Floats
+
 %%%%%%%%%%%%%%%%%  end table  %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% 
 
 %%%%%%%%%%%%%%% begin more complicated table %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
@@ -327,10 +335,23 @@ The \verb|version={..}| field may be used with \verb|@book|, \verb|@online|, and
 
 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 \section{More on Math}
-Math italics are used for roman and lower-case greek letters by default.  If you want an upright letter in math, you can use the relevant math alphabet, e.g., \verb|\mathrm, \mathbf, \mathsf|:
+
+In most cases, long equations can be kept below the column width by using one of the multiline equation environments defined by \texttt{amsmath}, 
+such as \texttt{align}, \texttt{split}, or \texttt{multline}~\cite{amsmath}. The following equation is set with the \texttt{multline} environment:
+\begin{multline}
+\frac{\partial}{\partial t}\left[\rho\Bigl(e + \lVert\mathbf{u}\rVert^2\mspace{-3mu}\big/2\Bigr)\right]  + \nabla\cdot\left[\rho\Bigl(h + \lVert\mathbf{u}\rVert^2\mspace{-3mu}\big/2 \Bigr)\mathbf{u}\right]\\
+ ={}-\nabla \cdot \mathbf{q} +  \rho \mathbf{u}\cdot\mathbf{g}+ \frac{\partial}{\partial x_j}\bigl(d_{ji}u_i\bigr) + \dot{Q}_v\label{eqn:energy}
+\end{multline}
+An example using \texttt{align} appears in Appendix~\ref{app:zetafunction}. 
+
+An alternative solution may be to set large equations into two-column-wide tables or figures. While a package exists for setting equations that span two columns (\texttt{widetext.sty}), that code is erratic in relation to floats and page breaks.
+
+Math italics are used for Roman and lower-case Greek letters by default.  If you want an upright letter in math, you can use the relevant math alphabet, e.g., \verb|\mathrm, \mathbf, \mathsf|:
 \begin{equation}\label{eqn:newton2}
 \vec{F} = m \vec{a} \quad\textrm{or}\quad \vec{\mathrm{F}} = m \vec{\mathrm{a}} \quad\textrm{or}\quad \mathbf{F} = m \mathbf{a} \quad\textrm{or}\quad \vec{\mathsf{F}} = m \vec{\mathsf{a}}
 \end{equation}
+The class file also provides upright sans-serif Greek letters with \verb|\sfalpha| and similar expressions (e.g., $\sfalpha, \sfbeta, \sfgamma, \sfdelta$ \ldots $\bm{\sfalpha, \sfbeta, \sfgamma, \sfdelta \ldots}$). 
+% (Note that the \verb|newtxmath| options \verb|frenchmath| and \verb|slantedGreek| also affect how Greek letters are presented.)
 
 ASME typesets vectors in upright bold, like the third instance in Eq.\ \eqref{eqn:newton2}, and sets matrices in bold italic. In the next equation, $\mathbf{w}$ is a vector and  $\bm{J}_1$ is a matrix:
 \begin{equation}\label{eqn:dw}
@@ -350,21 +371,12 @@ To get additional symbols in bold math, you can use the \verb|\bm{..}| macro fro
 \begin{equation}
 \mathbf{u}_r = u_r\bm{\hat{\textbf{\i}}}+v_r\bm{\hat{\textbf{\j}}}+w_r\bm{\hat{\textbf{k}}}
 \end{equation}
-or, \textit{very} rarely, \verb|\mathversion{bold}| for an entire equation: 
+or, \textit{very} rarely, \verb|\mathversion{bold}| for an entire equation\footnote{For sans-serif math expressions, \texttt{asmejour.cls} provides \texttt{\string\mathversion \{sans\}} and \texttt{\string\mathversion \{sansbold\}}. These fonts can act as engineering gothic for figures.}: 
 \mathversion{bold}\begin{equation}
 S = k \ln w = k \ln \biggl(\frac{N!}{\prod_i N_i!}\biggr)
 \end{equation}
 \mathversion{normal}% avoid extra line break with %
 
-In most cases, long equations can be kept below the column width by using one of the multiline equation environments defined by \texttt{amsmath}, 
-such as \texttt{align}, \texttt{split}, or \texttt{multline}~\cite{amsmath}. The following equation is set with the \texttt{multline} environment:
-\begin{multline}
-\frac{\partial}{\partial t}\left[\rho\Bigl(e + \lVert\mathbf{u}\rVert^2\mspace{-3mu}\big/2\Bigr)\right]  + \nabla\cdot\left[\rho\Bigl(h + \lVert\mathbf{u}\rVert^2\mspace{-3mu}\big/2 \Bigr)\mathbf{u}\right]\\
- ={}-\nabla \cdot \mathbf{q} +  \rho \mathbf{u}\cdot\mathbf{g}+ \frac{\partial}{\partial x_j}\bigl(d_{ji}u_i\bigr) + \dot{Q}_v\label{eqn:energy}
-\end{multline}
-An example using \texttt{align} appears in Appendix~\ref{app:zetafunction}. 
-
-An alternative solution may be to set large equations into two-column-wide tables or figures. While a package exists for setting equations that span two columns (\texttt{widetext.sty}), that code is erratic in relation to floats and page breaks.
 
 \subsection{\texttt{newtxmath} and \texttt{mathalpha}} The \texttt{newtxmath} package~\cite{sharpe1}, loaded by default, includes a large number of options for mathematics, most of which can be called as options to \verb|\documentclass|. For example, the \texttt{upint} option of \texttt{newtxmath} selects upright integral signs (rather than slanted integral signs):
 \begin{quote}
@@ -381,12 +393,12 @@ To see all the font options, refer to the \texttt{mathalfa} documentation \cite{
 
 The class is designed for use with \texttt{newtxmath} and does not support the \texttt{unicode-math} package.
 
-%% Dealing with complicated math in a section heading: optional argument of \section provides the pdfbookmark
+%% Dealing with complicated math in a section heading: optional argument of \section provides the pdf bookmark
 %%    without losing characters or producing warnings/errors. Note that bookmark can include simple math and \eqref{..}.
 %% newtxmath provides the option for upright Greek letters as \upomega (vs. \omega), etc.
 \subsection[Math in a Section Heading: \omega\cdot U=0]{Math in a Section Heading: $\tilde{\upomega}\cdot\hat{\mathrm{U}}=0$}
 
-To include complicated math in a section heading without producing bookmark-related errors, use the optional argument of \verb|\section| to create the pdfbookmark. The heading above was set with the following command:
+To include complicated math in a section heading without producing bookmark-related errors, use the optional argument of \verb|\section| to create the pdf bookmark. The heading above was set with the following command:
 \begin{quote}\raggedright
 \verb|\subsection[Math in a Section Heading:| 
 \hspace*{1em}\verb|\omega\cdot U=0]{Math in a Section Heading:|
@@ -395,7 +407,27 @@ To include complicated math in a section heading without producing bookmark-rela
 Note that bookmarks can include simple math. Also note that \texttt{newtxmath} provides the option to obtain upright Greek letters, such as \verb|\upomega| (vs.\ \verb|\omega|).
 
 
-\subsection{Units and Nomenclature} ASME requires SI units. U.~S.\ style units may be follow in parentheses. Be sure to put your symbols into the nomenclature list, including the SI units.
+\subsection{Units and Nomenclature} ASME requires SI units. U.~S.\ style units may follow in parentheses. Be sure to put your symbols into the nomenclature list, including the SI units.
+
+
+%%%%%%%%%%%%%%%%%%%  begin linewidth table  %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+
+\begin{table}[t]
+\newcolumntype{C}{>{$}c<{$}} % math-mode version of "c" column type, from array package
+\caption{\label{tab:3}Table at full column width with columns in math mode}
+\begin{tabular*}{\linewidth}{@{\extracolsep{\fill}}CCCC@{\extracolsep{\fill}}}
+\toprule
+X_{z} & X_{c} & X_{c,m} & X_{c,2}\rule{0pt}{8pt}\\
+ 3.92069  & 5.70943 & 6.32429 & 7.08757\\[2pt]
+\varepsilon (T_1)  & \varepsilon^i (T_1) & \varepsilon^i (T_m) & \alpha (T_1, T_2)\\
+0.7258 & 0.6237 & 0.6807 & 0.7964 \\[2pt]
+q_\textrm{gray}  & q_\textrm{int, $T_1$} & q_\textrm{int, $T_m$} & q_\textrm{exact}\\
+400.2 & 462.1 & 371.0 & 371.8 \\
+\bottomrule
+\end{tabular*}
+\end{table}
+
+%%%%%%%%%%%%%%%%%%%%  end linewidth table %%%%%%%%%%%%%%%%%%%%%%%
 
 
 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
@@ -424,30 +456,12 @@ default setting is for PDF/A-3u with sRGB OutputIntent (\texttt{sRGB.icc}). If l
 options \texttt{[pdfapart=1 or 2 or 3]} and  \texttt{[pdfaconformance=b or u]}. Note that accessible 
 conformance~(\texttt{a}) is not currently possible with \LaTeX.
 
-\subsection{Superiors Font} The \texttt{newtxtext} package includes a superiors font (numbers and letters) for use in footnote markers and superscripts. The option \texttt{[nodefaultsups]} enables this font. (The corresponding author mark in the author block will not change.)
-
-\subsection{Typewriter Font Options} This font is the sans-serif, monospaced font \texttt{inconsolata}. By default, the word spacing is variable, but option \texttt{[mono]} ends this behavior. A slashed zero is the default; option \texttt{[var0]} removes the slash. Option \texttt{[hyphenate]} enables hyphenation of the typewriter font.%(This option is not available if the \texttt{[fontspec]} option is used.)
-
-
-%%%%%%%%%%%%%%%%%%%  begin linewidth table  %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+As of late 2021, the \LaTeX 3 team is phasing in native support for PDF/A in the \LaTeX\ kernel, which eventually will make these
+class options unnecessary when using an up-to-date installation.
 
-\begin{table}[t]
-\newcolumntype{C}{>{$}c<{$}} % math-mode version of "c" column type, from array package
-\caption{\label{tab:3}Table at full column width with columns in math mode}
-\begin{tabular*}{\linewidth}{@{\extracolsep{\fill}}CCCC@{\extracolsep{\fill}}}
-\toprule
-X_{z} & X_{c} & X_{c,m} & X_{c,2}\rule{0pt}{8pt}\\
- 3.92069  & 5.70943 & 6.32429 & 7.08757\\[2pt]
-\varepsilon (T_1)  & \varepsilon^i (T_1) & \varepsilon^i (T_m) & \alpha (T_1, T_2)\\
-0.7258 & 0.6237 & 0.6807 & 0.7964 \\[2pt]
-q_\textrm{gray}  & q_\textrm{int, $T_1$} & q_\textrm{int, $T_m$} & q_\textrm{exact}\\
-400.2 & 462.1 & 371.0 & 371.8 \\
-\bottomrule
-\end{tabular*}
-\end{table}
-
-%%%%%%%%%%%%%%%%%%%%  end linewidth table %%%%%%%%%%%%%%%%%%%%%%%
+\subsection{Superiors Font} The \texttt{newtxtext} package includes a superiors font (numbers and letters) for use in footnote markers and superscripts. The option \texttt{[nodefaultsups]} enables this font. (The corresponding author mark in the author block will not change.)
 
+\subsection{Typewriter Font Options} This font is the sans-serif, monospaced font \texttt{inconsolata}. By default, the word spacing is variable, but option \texttt{[mono]} ends this behavior. A slashed zero is the default; option \texttt{[var0]} removes the slash. Option \texttt{[hyphenate]} enables hyphenation of the typewriter font.
 
 
 %%%%%%%%%%%%%%% begin two column table %%%%%%%%%%%%%%%%%% 
@@ -483,8 +497,9 @@ q_\textrm{gray}  & q_\textrm{int, $T_1$} & q_\textrm{int, $T_m$} & q_\textrm{exa
 
 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 \section{Conclusions}
+
 The class \texttt{asmejour} and associated files are for typesetting preprints in the style of ASME journals.
-Documentation is provided in this file and by comments in the \texttt{.tex} source code. Examples of references are shown in the \texttt{asmejour-sample.bib} file.  The \texttt{asemjour.bst} file produces references following ASME's current formats.  The code is compatible with both {\hologo{pdfLaTeX}} and \LuaLaTeX. This package is not a publication of ASME and is offered at no cost under the terms of the \href{https://ctan.org/license/mit}{MIT license}. 
+Documentation is provided in this file and by comments in the \texttt{.tex} source code. Examples of references are shown in the \texttt{asmejour-sample.bib} file.  The \texttt{asemjour.bst} file produces references following ASME's current formats.  The code is compatible with both {\hologo{pdfLaTeX}} and \LuaLaTeX. This package is not a publication of ASME and is offered at no cost under the terms of the \hrefurl{https://ctan.org/license/mit}{MIT license}. 
 
 \begin{enumerate}
 \item First conclusion 
@@ -501,6 +516,7 @@ Acknowledge individuals, institutions, or companies that supported the authors i
 
 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 \section*{Funding Data}
+
 \begin{itemize}
 \item U.S.\ Department of Heat Transfer, Office of Important Ideas (DOHT-OII Award No.\ 3.14159265)
 \end{itemize}
@@ -536,7 +552,7 @@ Acknowledge individuals, institutions, or companies that supported the authors i
 \end{nomenclature}
 
 
-%%%%%%%%%%%%%%%  APPENDICES  %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%%%%%%%%%%%%%%%  APPENDICES  %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 
 %% Note that appendices will be "numbered" A, B, C, ... etc. Use \section, not \section*
 %% Subsections need not be numbered, use \subsection*
@@ -576,21 +592,25 @@ The standard caption and section names will follow \texttt{babel}'s dictionary f
 The font encoding is set to T1 and utf-8 input is supported:
 %% If you have trouble with the next line (or the French text that follows), your file may not be saved in utf-8 format. You can delete these lines to resolve the issue.
 \typeout{If you have trouble with the next line, your file may not be saved in utf-8 format. You can delete that line to resolve the issue.}
-àáâäæãåā  èéęëêēė  îïíīįì ôöòóœøōõ ûüùúū çćč ł ñń ßśš ÿ žźż
- 
+\ifluatex\typeout{Under LuaLaTeX, some of these accents must be obtained as escaped characters, with \=a, \c{e}, \l, \.o, \oe, \v{z}, \'z, etc.}\fi
+àáâäæãåā  èéęëêēė  îïíīįì ôöòóœøōõ ûüùúū çćč ł ñń ßśš ÿ žźż 
+
 No effort has been made to support customization of language-specific fonts (some fonts can be implemented using the \texttt{substitutefont} package~\cite{milde}). The bibliography style, \texttt{asmejour.bst}, is designed in English and aimed at \texttt{BibTeX}.  Multilingual bibliographies can be supported using \texttt{BibLaTeX}.
 
 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 \selectlanguage{french}
 \section{Discours Préliminaire de Fourier}\label{app:fourier}
+
 Les causes primordiales ne nous sont point con­nues; mais elles sont assujetties à des lois simples et constantes, que l'on peut découvrir par l'obser­vation, et dont l'étude est l'objet de la philosophie naturelle. 
 
 La chale ur pénètre, comme la gravité, toutes les substances de l'univers, ses rayons occupent toutes les parties de l'espace. Le but de notre ouvrage est d'exposer les lois mathématiques que suit cet élé­ment. Cette théorie formera désormais une des branches les plus importantes de la physique gé­nérale~\cite{fourier1822}. 
 
 \selectlanguage{english} 
 
+% When you drop the [french] option, delete your .aux file as well, since [french] sets ":" as an active character.
+
 
-%%%%%%%%%%%%%  BIBLIOGRAPHY  %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%%%%%%%%%%%%%  BIBLIOGRAPHY  %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 
 \nocite{*} %% <=== delete this line - unless you wish to typeset the entire contents of your .bib file.