summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2025-01-26 21:02:11 +0000
committerKarl Berry <karl@freefriends.org>2025-01-26 21:02:11 +0000
commit014ad61ed29e9c7e5fe5cb473ffc4a0c497d7766 (patch)
treed675a9f172331ed3e110d751774b03358bad093c /Master/texmf-dist/doc/latex
parent2d2767490e2b1bc062bd18b3e07a8609d613ed53 (diff)
asmejour (26jan25)
git-svn-id: svn://tug.org/texlive/trunk@73602 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex')
-rw-r--r--Master/texmf-dist/doc/latex/asmejour/README.md15
-rw-r--r--Master/texmf-dist/doc/latex/asmejour/asmejour-sample.bib4
-rw-r--r--Master/texmf-dist/doc/latex/asmejour/asmejour-template.pdfbin728579 -> 729440 bytes
-rw-r--r--Master/texmf-dist/doc/latex/asmejour/asmejour-template.tex43
-rw-r--r--Master/texmf-dist/doc/latex/asmejour/asmewide_example/asmejour-wide-equation-examples.pdfbin2982565 -> 2979461 bytes
-rw-r--r--Master/texmf-dist/doc/latex/asmejour/asmewide_example/asmejour-wide-equation-examples.tex14
-rw-r--r--Master/texmf-dist/doc/latex/asmejour/asmewide_example/asmewide.sty26
7 files changed, 57 insertions, 45 deletions
diff --git a/Master/texmf-dist/doc/latex/asmejour/README.md b/Master/texmf-dist/doc/latex/asmejour/README.md
index 612e0b027a6..4acfe2b725b 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.23 dated 2024/07/24.
+ Version 1.24 dated 2025/01/26.
####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 2023.
+ The layout and reference formats follow the style of published papers in 2025.
This work is not a publication of ASME.
@@ -67,6 +67,15 @@
####Change log####
+v1.24 (2025/01/26)
+ - Drop metalogo package
+ - Add optional line numbers to author and title text
+ - Rescale roman, helvetica, and typewriter fontdimens under fontspec to match pdftex
+ - Define \\@title
+ - Replace xcoffin package by expl3 coffins, and resolve related tagging problem
+ - Edits to asmewide.sty: set \\@RuleWidth at end of \\maketitle; add \\ignorespacesafterend
+ - Minor code clean-up
+
v1.23 (2024/07/24)
- Add class option for single-column formatting, \[singlecolumn\], as sometimes requested for review (thanks Lennart Hultgren)
- Change language sample from French to German, to avoid active characters (from Fourier to Pohlhausen)
@@ -169,7 +178,7 @@ v1.00: initial release
####License####
- Copyright (c) 2021 John H. Lienhard
+ Copyright (c) 2025 John H. Lienhard
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and
associated documentation files (the "Software"), to deal in the Software without restriction,
diff --git a/Master/texmf-dist/doc/latex/asmejour/asmejour-sample.bib b/Master/texmf-dist/doc/latex/asmejour/asmejour-sample.bib
index 08438fd94d9..fd2888e77b8 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: 21 July 2024
+%% Revised: 9 August 2024
%% Copyright John H. Lienhard, MIT
%% Offered under the MIT license: https://ctan.org/license/mit
@@ -432,7 +432,7 @@
}
@article{montijano2014,
- title = {Numerical Methods With {\LuaLaTeX}},
+ title = {Numerical Methods With {\hologo{LuaLaTeX}}},
author = {Juan I. Montijano and Mario P{\'{e}}rez and Luis R{\'{a}}ndez and Juan Luis Varona},
year = 2014,
volume = 35,
diff --git a/Master/texmf-dist/doc/latex/asmejour/asmejour-template.pdf b/Master/texmf-dist/doc/latex/asmejour/asmejour-template.pdf
index c15cc9f7977..e90e6b0fa17 100644
--- a/Master/texmf-dist/doc/latex/asmejour/asmejour-template.pdf
+++ b/Master/texmf-dist/doc/latex/asmejour/asmejour-template.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/asmejour/asmejour-template.tex b/Master/texmf-dist/doc/latex/asmejour/asmejour-template.tex
index 7e3f8a29306..be61d6561bc 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.23 dated 2024/07/24
+%% This file is version 1.24 dated 2024/01/26
%%
%% Author: John H. Lienhard V
%% Department of Mechanical Engineering
@@ -35,23 +35,14 @@
%%
%% * Option for single column formatting [singlecolumn].
%%
-%% * Options for PDF/A compliance. With pdfTeX, [pdf-a] will produce PDF/A-3u compliance with sRGB OutputIntent.
-%% * [pdfapart= 1 or 2 or 3] and [pdfaconformance= b or u] will select other levels: 1b, 2b, 2u, and 3b.
-%% *
-%% * Recently, LaTeX (2021 and later) has integrated support for pdf-a, through the \DocumentMetadata{..}
-%% * command. This approach works with both pdfTeX and luaLaTeX. The asmeconf class supports this new feature,
-%% * 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,...
%% * frak (fraktur), bb (blackboard bold), scr (script) may also be controlled.
%%
%% * 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]
-%% * 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.
+%% * [varvw] for a v and w that are better distinguished from Greek nu; and other options
+%% * such as [smallerops, varg, slantedGreek, frenchmath, varbb, cmbraces].
%%
%% * With pdfTeX, an option to use newtxtext's slightly larger small capitals font [largesc]
%%
@@ -64,6 +55,13 @@
%% * abstract in an appendix), e.g. [german]. The main language will default to English
%% * unless a different main language is selected, e.g. [main=spanish]. See Appendix B for details.
%%
+%% * Legacy options for PDF/A compliance. With pdfTeX, [pdf-a] will produce PDF/A-3u compliance with sRGB OutputIntent.
+%% * [pdfapart= 1 or 2 or 3] and [pdfaconformance= b or u] will select other levels: 1b, 2b, 2u, and 3b.
+%% *
+%% * Since 2022, LaTeX has included integrated support for pdf-a, through the \DocumentMetadata{..}
+%% * command. This preferred approach works with both pdfTeX and luaLaTeX. The asmeconf class supports this new feature,
+%% * which can replace the aforementioned class options. (An up-to-date LaTeX installation is required.)
+%%
%% 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
@@ -73,7 +71,7 @@
%%
%% LICENSE:
%%
-%% Copyright (c) 2024 John H. Lienhard
+%% Copyright (c) 2025 John H. Lienhard
%%
%% Offered under the MIT license: https://ctan.org/license/mit
%%
@@ -82,10 +80,10 @@
%% RECOMMENDED new pdf management code.
%% This addition the LaTeX kernel was made by the LaTeX Project team in June 2022.
%% see https://www.latex-project.org/news/latex2e-news/ltnews35.pdf
-%% Uncomment the next lines and omit the option [pdf-a], if you are using an up-to-date LaTeX platform
+%% If you have problems with these lines, your LaTeX format may be out of date. You can comment them out.
\DocumentMetadata{%
- pdfstandard=A-3u,% A-2b, A-2u, A-3b, or A-3u (don't use u options with LuaLaTeX)
+ pdfstandard=A-3u,% A-2b, A-2u, A-3b, or A-3u. Don't use u option (unicode) with LuaLaTeX.
pdfversion=1.7,
lang=en-US,
}
@@ -93,7 +91,7 @@
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%% Class options are described above.
-\documentclass[nocopyright,upint,varvw,barcolor=Goldenrod3,mathalfa=cal=euler,balance,hyphenate,german]{asmejour}% subscriptcorrection,french
+\documentclass[nocopyright,upint,varvw,barcolor=Goldenrod3,mathalfa=cal=euler,balance,hyphenate,german]{asmejour}%
%%%% pdf metadata %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
@@ -423,8 +421,8 @@ Note that bookmarks can include simple math. Also note that \texttt{newtxmath} p
%%%%%%%%%%%%%%%%%%% begin linewidth table %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
\begin{table}[t]
+\caption{Table at full column width with columns in math mode}\label{tab:3}
\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}\\
@@ -460,13 +458,10 @@ The footers are all generated with the \texttt{fancyhdr} package~\cite{oostrum},
\subsection{Federal Copyright Notices} Several types of copyright statement can be placed an unnumbered footnote on the first page. Use the option \texttt{[govt]} when all authors are federal employees, \texttt{[govtsome]} when some authors are federal employees, and \texttt{[contractor]} when the authors are federal contractors.
-\subsection{Archivability:~PDF/A} Compliance with PDF/A standards can be enabled using the option \texttt{[pdf-a]}
-when running with \hologo{pdfLaTeX}. The
-default setting is for PDF/A-3u with sRGB OutputIntent (\texttt{sRGB.icc}). If levels 1b, 2b, 2u, or 3b are preferred, use the
-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{Archivability:~PDF/A} In June 2022, the \LaTeX 3 team added support for PDF/A to the \LaTeX\ kernel, using the command \verb|\DocumentMetadata{..}|. This approach works with \textit{both} \hologo{pdfLaTeX} and \hologo{LuaLaTeX}. Note that accessible conformance~(\texttt{a}) is still under development by the \LaTeX3 team.
-As of June 2022, the \LaTeX 3 team has added native support for PDF/A in the \LaTeX\ kernel, using \verb|\DocumentMetadata{..}|. This approach works with \textit{both} \hologo{pdfLaTeX} and \hologo{LuaLaTeX}. The class options previously mentioned can be omitted when using \verb|\DocumentMetadata{..}|.
+For out-of-date \LaTeX\ formats, compliance with PDF/A standards can be enabled using the legacy option \texttt{[pdf-a]} when running with \hologo{pdfLaTeX}. The default setting is PDF/A-3u with sRGB OutputIntent (\texttt{sRGB.icc}). If levels 1b, 2b, 2u, or 3b are desired, use the
+options \texttt{[pdfapart=1 or 2 or 3]} and \texttt{[pdfaconformance=b or u]}. Accessible conformance~(\texttt{a}) is not possible with this method.
\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 when running \hologo{pdfTeX}.
@@ -511,7 +506,7 @@ As of June 2022, the \LaTeX 3 team has added native support for PDF/A in the \La
\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 \hrefurl{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 \hologo{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
diff --git a/Master/texmf-dist/doc/latex/asmejour/asmewide_example/asmejour-wide-equation-examples.pdf b/Master/texmf-dist/doc/latex/asmejour/asmewide_example/asmejour-wide-equation-examples.pdf
index c3b0bc535e1..e4ce8701021 100644
--- a/Master/texmf-dist/doc/latex/asmejour/asmewide_example/asmejour-wide-equation-examples.pdf
+++ b/Master/texmf-dist/doc/latex/asmejour/asmewide_example/asmejour-wide-equation-examples.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/asmejour/asmewide_example/asmejour-wide-equation-examples.tex b/Master/texmf-dist/doc/latex/asmejour/asmewide_example/asmejour-wide-equation-examples.tex
index 5a506330aa4..c9f85806837 100644
--- a/Master/texmf-dist/doc/latex/asmejour/asmewide_example/asmejour-wide-equation-examples.tex
+++ b/Master/texmf-dist/doc/latex/asmejour/asmewide_example/asmejour-wide-equation-examples.tex
@@ -1,6 +1,6 @@
%% Examples of a widetext macro for setting wide equations in the asmejour class.
%%
-%% Copyright (c) 2024 John H. Lienhard. Use under the MIT license: https://ctan.org/license/mit
+%% Copyright (c) 2025 John H. Lienhard. Use under the MIT license: https://ctan.org/license/mit
%%
%%
%% USAGE: * \begin{widetext} ...wide material here... \end{widetext}
@@ -12,11 +12,17 @@
%%
%% NB: the strip environment from cuted is incompatible with the [lineno] option to asmejour!
%%
-\documentclass[nocopyright,nolists,pdf-a]{asmejour}
+\DocumentMetadata{%
+ pdfstandard=A-3u,% A-2b, A-2u, A-3b, or A-3u (don't use u options with LuaLaTeX)
+ pdfversion=1.7,
+ lang=en-US,
+}
+
+\documentclass[nocopyright,nolists]{asmejour}
%% This file's version and date are:
- \def\AJwidetextversion{1.02}
- \def\AJverdate{July 24, 2024}
+ \def\AJwidetextversion{1.03}
+ \def\AJverdate{January 26, 2025}
%
\usepackage{asmewide}
\usepackage{lipsum}% Latin filler text (lipsum generates a message about 'unused global options' - this can be ignored)
diff --git a/Master/texmf-dist/doc/latex/asmejour/asmewide_example/asmewide.sty b/Master/texmf-dist/doc/latex/asmejour/asmewide_example/asmewide.sty
index 949da71852f..58872909090 100644
--- a/Master/texmf-dist/doc/latex/asmejour/asmewide_example/asmewide.sty
+++ b/Master/texmf-dist/doc/latex/asmejour/asmewide_example/asmewide.sty
@@ -1,7 +1,7 @@
%%
%% This file is `asmewide.sty'.
%%
-%% Copyright (c) 2022 John H. Lienhard. Use under the MIT license: https://ctan.org/license/mit
+%% Copyright (c) 2025 John H. Lienhard. Use under the MIT license: https://ctan.org/license/mit
%%
%% Defines a widetext environment within ASME dimensions
%% Use for material spanning both columns (i.e., for wide equations)
@@ -12,24 +12,25 @@
%% The modifications made were: follow ASME dimensions; remove revtex-specific macros; update/rework commands; adapt to most recent cuted.sty
%% (Leaders don't vanish at pagebreaks, as in revtex, evidently related to how cuted.sty handles strip construction. Have coded around this.)
%%
-%% Required packages: cuted.sty v2.0 and flushend.sty v4.0 [2021/10/04] or later; asmeconf.cls or asmejour.cls w/their required packages, esp. etoolbox, xparse
+%% Required packages: cuted.sty v2.0 and flushend.sty v4.0 [2021/10/04] or later;
+%% asmeconf.cls or asmejour.cls w/their required packages, esp. etoolbox, xparse
%%
-%% The widetext environment can only appear once per page. It clashes with floats and footnotes, and often requires some hand-fitting of page layouts.
+%% The widetext environment can only appear once per page. It clashes with floats and footnotes,
+%% and often requires some hand-fitting of page layouts.
%%
-%% USAGE: * \begin{widetext} ...wide material here... \end{widetext}
+%% USAGE: \begin{widetext} ...wide material here... \end{widetext}
%% OPTIONAL ARGUMENTS:
-%% * \begin{widetext[N] .. changes upper/lower separation of wide material from default Xpt to Npt (X = 5pt asmeconf.cls; X = 10pt asmejour.cls)
-%% * \begin{widetext}[][tbn]: t = top line only; b = bottom line only; n = no lines. BOTH arguments are REQUIRED, even if first is left empty.
+%% \begin{widetext[N] ...change upper/lower separation of wide material from default Xpt to Npt (X = 5pt asmeconf.cls; X = 10pt asmejour.cls)
+%% \begin{widetext}[][tbn]: t = top line only; b = bottom line only; n = no lines. BOTH arguments are REQUIRED, even if first is left empty.
%%
%% asmewide,sty supports one option, [raggedend], which suppresses final page column balancing: \usepackage[raggedend]{asmewide}
-%% NB: remove the option [balance] when using [raggedend]!
%%
%% NB: the strip environment from cuted is incompatible with the [lineno] option to asmeconf and asmejour!
%%
\NeedsTeXFormat{LaTeX2e}
-\def\AW@versionno{1.1}
-\def\AW@versiondate{2022/06/26\space}
+\def\AW@versionno{1.11}
+\def\AW@versiondate{2025/01/22\space}
\ProvidesPackage{asmewide}[\AW@versiondate\space v\AW@versionno\space ASME wide equation environment (JHL)]
\DeclareOption{raggedend}{% Added 2022/05/08, to suppressed flushend on last page, if desired
@@ -46,7 +47,7 @@
\@ifpackagelater{cuted}{2021/10/04}{%
\relax
}{%
- \PackageError{asmewide}{The asmewide package has detected that the version of cuted.sty you are using is too old to be compatible. You can get an update at https://ctan.org/pkg/sttools}{You need at least v2.0 of cuted.sty to run asmewide.sty. Without it, you will get more errors. See discussion of installation process here: https://github.com/John02139/asmeconf/issues/4}%
+ \PackageError{asmewide}{Your version of cuted.sty is too old. You can get an update at https://ctan.org/pkg/cuted}{You need an up-to-date version of cuted.sty to run asmewide.sty.}%
}
\RequirePackage{flushend}[2021/10/04]
@@ -60,7 +61,8 @@
\newbox\@TopLeader
\newbox\@BottomLeader
\newlength\savparskip \setlength\savparskip{\parskip}
-\newlength\@RuleWidth \AtBeginDocument{\setlength\@RuleWidth{\dimexpr(\columnwidth+0.5\columnsep-1pt)}}
+\newlength\@RuleWidth
+\appto\maketitle{\setlength\@RuleWidth{\dimexpr(\columnwidth+0.5\columnsep-1pt)}}% do this after entering twocolumn, in \maketitle. 2025/01/22
\newlength\@TopSpace \setlength\@TopSpace{0ex}
\newlength\@TopCorr \setlength\@TopCorr{-5pt}
\def\@asmeindent{3.5mm}
@@ -129,7 +131,7 @@
\setlength\parindent{\@asmeindent}% strip makes parindent zero; enlarge for ASME
\setlength\parskip{\savparskip}% strip makes \parskip zero w/o glue; set to match main text
}{%
- \end{strip}\ignorespaces
+ \end{strip}\ignorespacesafterend
}
%%
\endinput