texlive[54698] Master/texmf-dist: asmejour (12apr20)

commits+karl at tug.org commits+karl at tug.org
Sun Apr 12 23:29:31 CEST 2020


Revision: 54698
          http://tug.org/svn/texlive?view=revision&revision=54698
Author:   karl
Date:     2020-04-12 23:29:31 +0200 (Sun, 12 Apr 2020)
Log Message:
-----------
asmejour (12apr20)

Modified Paths:
--------------
    trunk/Master/texmf-dist/bibtex/bst/asmejour/asmejour.bst
    trunk/Master/texmf-dist/doc/latex/asmejour/README.md
    trunk/Master/texmf-dist/doc/latex/asmejour/asmejour-sample.bib
    trunk/Master/texmf-dist/doc/latex/asmejour/asmejour-template.pdf
    trunk/Master/texmf-dist/doc/latex/asmejour/asmejour-template.tex
    trunk/Master/texmf-dist/tex/latex/asmejour/asmejour.cls

Modified: trunk/Master/texmf-dist/bibtex/bst/asmejour/asmejour.bst
===================================================================
--- trunk/Master/texmf-dist/bibtex/bst/asmejour/asmejour.bst	2020-04-12 21:29:19 UTC (rev 54697)
+++ trunk/Master/texmf-dist/bibtex/bst/asmejour/asmejour.bst	2020-04-12 21:29:31 UTC (rev 54698)
@@ -1,14 +1,14 @@
 %%
-%% This is file `asmejour.bst',
-%% generated with the docstrip utility.
+%% This is file `asmejour.bst', initially generated with the docstrip utility and extensively customized.
 %%
-%% The original source files were:
+%% *** This bibtex style follows ASME journals ***
 %%
-%% merlin.mbs  (with options: `seq-no,nm-rev,jnrlst,dt-beg,xmth,tit-qq,atit-u,thtit-a,vol-bf,volp-com,jwdpg,pp-last,num-xser,numser,ser-vol,ser-ed,pre-edn,doi,edby,edbyy,blk-com,in-x,pp,ed,abr,ednx,ord,jabr,revdata,eprint,url,url-blk,eprint,url,url-nt,em-it,nfss,')
-%% ----------------------------------------
-%% *** This bibtex style follows ASME journals ***
-%% 
-%% Copyright 1994-2011 Patrick W Daly
+ % The original source files for docstrip were:
+ %
+ % merlin.mbs  (with options: `seq-no,nm-rev,jnrlst,dt-beg,xmth,tit-qq,atit-u,thtit-a,vol-bf,volp-com,jwdpg,pp-last,num-xser,numser,ser-vol,ser-ed,pre-edn,doi,edby,edbyy,blk-com,in-x,pp,ed,abr,ednx,ord,jabr,revdata,eprint,url,url-blk,eprint,url,url-nt,em-it,nfss,')
+ % ----------------------------------------
+ % 
+ % Copyright 1994-2011 Patrick W Daly
  % ===============================================================
  % IMPORTANT NOTICE:
  % This bibliographic style (bst) file has been generated from one or
@@ -26,21 +26,20 @@
  % ===============================================================
  %-------------------------------------------------------------------
  %%
- %% This file is asmejour.bst, version 1.02 dated 2019/12/03.
+ %% This file is asmejour.bst, version 1.03 dated 2020/04/12.
  %%
  %% This file was generated and edited by John Lienhard.
  %% This file is a derivative work under Clause 6 of the LPPL license.
  %%
- %% The generated file and the modifications are based on what ASME is actually putting into
- %% published journal papers in early 2019.  The modifications mainly relate to handling of online
- %% information. Details follow.
+ %% The generated file and the modifications are based on the formats that ASME is using in
+ %% published journal papers in early 2020. Details of the modifications follow.
  %%
- %% Added fields: eventdate, urldate, urltype, venue, version, versiontype 
- %% Added: @online{...} for web publications (and aliased it to @www and @electronic)
- %% Added: urlprefix = {}, format.web.urldate, bbl.urldate; urltype field changes "accessed" to something else. 
- %% Added: venue and eventdate to @inproceedings
- %% Added: format.version to @book, @online, and @manual; text can be changed with versiontype field.
- %% Updated: doi url prefix to https://doi.org/
+ %% Created entry:   @online{...} for web publications (and aliased it to @www and @electronic)
+ %% Created fields:  eventdate, urldate, urltype, venue, version, versiontype 
+ %% Format for url:  urlprefix = {}, format.web.urldate, bbl.urldate; urltype = {} changes "accessed" to other text. 
+ %% Added fields:    venue and eventdate to @inproceedings
+ %% Added field:     version={}, format.version to @book, @online, @manual; versiontype = {} changes "Version" to other
+ %% Updated doi:     doi url prefix updated to https://doi.org/
  %%
  %% Remove "emphasize" from journal article, and linked doi (or else url) to journal name (or book title) 
  %%   without explicitly showing the urls. The urls may be added to the note = {..} field to display explicitly
@@ -50,7 +49,7 @@
  %%   
  %% Capitalize: Vol., Chap., & No. 
  %% Remove "emphasize" before comma in format.bvolume, 
- %% @incollection: move chapter and edition, change format.in.ed.booktitle, modify format for "series" 
+ %% @incollection:  move chapter and edition, change format.in.ed.booktitle, modify format for "series"
  %%
  %% Modify \eprint to include full url, and provided some macros for archive={..} ... 
  %%   ....this format is uncommon in ASME journals so implemented only as a url (but can easily patch if needed)
@@ -57,9 +56,37 @@
  %%
  %% Change format.note capitalizations from "l" to "t" and "u" to "t" respectively.
  %%
- %% Included macros for titles of some of ASME's many journals.
+ %% Included macros for the titles of ASME's journals, following ASME formats (updated 4/10/20)
  %%
  %%
+ %% Modifications in v1.03 (2020/04/12)
+ %%
+ %% @article:		add warning for empty pages; change ordering of numpages "pages" for eid
+ %% @book:          reorder edition, version, and volume 
+ %% @inbook:        reorder edition, version, volume, etc.; hyperlink title to doi, url, or eprint 
+ %% @incollection:  create format.doi.booktitle to hyperlink title of collection to doi, url, or eprint. 
+ %% @inproceedings: move venue, eventdate, and paper number toward end; warn that address should not be used with venue;
+ %%					warn for empty venue and empty date;
+ %%					create format.pvolume and format.in.ed.proctitle, to permit both [paper] number and volume 
+ %%                 print either organization or publisher but not both
+ %%					add bbl.paperno = "Paper No." and enable type ={} to change it (this is not backward compatible!)
+ %%					hyperlink paper number to doi, or url, or eprint by default.
+ %% @inserialcollection: new entry type created to deal with citing articles in edited volumes that  
+ %%                      come under different titles in a an ongoing series. This changes the placement
+ %%						 of Vol. number in the reference, putting series name and volume in ( ) after title.
+ %%						 This calls a new function format.in.ed.serialtitle. Hyperlink title of book.
+ %% 					 For most uses, ordinary @incollection will be preferred. 
+ %%						 This edit also reverts @incollection and @inproceedings to use Series, Vol. after eds,
+ %%						 which is consistent with many ASME references 
+ %% @proceedings:   edit order of fields; warn that address should not be used with venue; 
+ %%                 print either organization or publisher but not both;
+ %%					hyperlink title of proceedings to doi, url, or eprint;
+ %%					provide format.alt.link to print the hyperlink if the report number is empty. 
+ %% @techrep:       move report number after address; hyperlink report number to doi, url, or eprint;
+ %%					provide format.alt.link to print the hyperlink if the report number is empty. 
+ %%					provide institution.address function
+ %%
+ %%
  %%  Author: John H. Lienhard V
  %%          Department of Mechanical Engineering
  %%          Massachusetts Institute of Technology
@@ -68,7 +95,7 @@
  %========================================================================
  %% LICENSE:
  %%
- %% Copyright (c) 2019 John H. Lienhard
+ %% Copyright (c) 2020 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, 
@@ -200,24 +227,12 @@
   }
   if$
 }
+
+%% For entries that hyperlink content
 FUNCTION {fin.urllink.entry}
-{ doi empty$ 
-  { eprint empty$
-    {
-    add.period$
-    write$
-    newline$
-    }{
-    write$
-    newline$
-    }
-    if$
-  }{
-  add.period$
+{ add.period$
   write$
   newline$
-  }
-  if$
 }
 
 FUNCTION {new.block}
@@ -377,6 +392,9 @@
 FUNCTION {bbl.techrep}
 { "Tech. Rep." }
 
+FUNCTION {bbl.paperno}
+{ "Paper No." }
+
 FUNCTION {bbl.mthesis}
 { "Master's thesis" }
 
@@ -469,22 +487,71 @@
 
 MACRO {jstor} {"http://www.jstor.org/stable/"}
 
+MACRO {oclc} {"http://www.worldcat.org/oclc/"}
+
 MACRO {pubmed} {"http://www.ncbi.nlm.nih.gov/pubmed/"}
 
 
+MACRO {amr} {"Appl. Mech. Rev."}
+
+MACRO {lds} {"ASME Letters Dynamic Systems"}
+
+MACRO {jru} {"ASME J. Risk Uncertainty"}
+
+MACRO {jsbc} {"ASME J. Sustainable Bldg. and Cities"}
+
+MACRO {jam} {"ASME J. Appl. Mech."}
+
+MACRO {jbe} {"ASME J. Biomed. Eng."}
+
+MACRO {jcnd} {"ASME J. Comput. Nonlin. Dyn."}
+
+MACRO {jcise} {"ASME J. Comput. Inf. Sci. Eng."}
+
+MACRO {jds} {"J. Dyn. Syst.-T. ASME"}
+
 MACRO {jep} {"ASME J. Electron. Packag."}
 
+MACRO {jert} {"ASME J. Energy Resour."}
+
 MACRO {jegtp} {"ASME J. Eng. Gas Turbines Power"}
 
-MACRO {jert} {"ASME J. Energy Resour. Technol."}
+MACRO {jem} {"ASME J. Eng. Mater."}
 
 MACRO {jfe} {"ASME J. Fluids Eng."}
 
+MACRO {jfcst} {"ASME J. Fuel Cell Sci. Tech."}
+
 MACRO {jht} {"ASME J. Heat Transfer"}
 
+MACRO {jmse} {"ASME J. Manuf. Sci. E."}
+
 MACRO {jmd} {"ASME J. Mech. Des."}
 
+MACRO {jmr} {"ASME J. Mech. Robot."}
 
+MACRO {jmdv} {"ASME J. Med. Devices"}
+
+MACRO {jmnm} {"ASME J. Micro Nano-Manuf."}
+
+MACRO {jnem} {"ASME J. Nanotech Eng. Med."}
+
+MACRO {joma} {"ASME J. Offshore Mech. Arct."}
+
+MACRO {jpv} {"ASME J. Press. Vess."}
+
+MACRO {jse} {"ASME J. Sol. Energy"}
+
+MACRO {jtsea} {"ASME J. Therm. Sci. Eng. Appl."}
+
+MACRO {jtb} {"ASME J. Tribol."}
+
+MACRO {jtm} {"ASME J. Turbomach."}
+
+MACRO {jva} {"ASME J. Vib. Acoust."}
+
+
+
 MACRO {acmcs} {"ACM Comput. Surv."}
 
 MACRO {acta} {"Acta Inf."}
@@ -759,7 +826,11 @@
 { pop$ "" }
 { doi empty$
     { url empty$
-        { skip$ }
+        { eprint empty$
+        	{ skip$ }
+			{  "\href{" archive eprint * * "}{" * swap$ * "}" *  }
+	        if$
+	    }
         { "\href{" url * "}{" * swap$ * "}" * }
         if$
         }
@@ -900,6 +971,18 @@
     }
   if$
 }
+FUNCTION {format.pvolume}
+{ volume empty$
+    { "" }
+    { bbl.volume volume tie.or.space.prefix
+      "volume" bibinfo.check * *
+      series "series" bibinfo.check
+      duplicate$ empty$ 'pop$
+        { ", " * swap$ *}
+      if$
+    }
+  if$
+}
 FUNCTION {format.number.series}
 { volume empty$
     { number empty$
@@ -1025,9 +1108,13 @@
   if$
 }
 FUNCTION {format.journal.pages}
-{ pages duplicate$ empty$ 'pop$
-    { swap$ duplicate$ empty$
-        { pop$ pop$ format.pages }
+{ pages duplicate$ empty$   
+       { "empty pages in " cite$ * warning$ }
+       'skip$
+     if$
+     duplicate$ empty$ 'pop$
+     { swap$ duplicate$ empty$
+        { pop$ pop$ format.pages}
         {
           ", " *
           swap$
@@ -1055,8 +1142,8 @@
       if$
       swap$ *
       numpages empty$ 'skip$
-        { bbl.eidpp numpages tie.or.space.prefix
-          "numpages" bibinfo.check * *
+        { numpages bbl.eidpp tie.or.space.prefix
+          "numpages" bibinfo.check  * *
           " (" swap$ * ")" * *
         }
       if$
@@ -1104,9 +1191,60 @@
   booktitle "booktitle" bibinfo.check
   emphasize
 }
+FUNCTION {format.doi.booktitle}
+{
+  booktitle "booktitle" bibinfo.check
+  doilink emphasize
+}
 FUNCTION {format.in.ed.booktitle}
+{ format.doi.booktitle duplicate$ empty$ 'skip$
+    {
+      format.edition duplicate$ empty$ 'pop$
+        { ", " swap$ * * }
+      if$
+      editor "editor" format.names.ed duplicate$ empty$ 'pop$
+        {
+          get.bbl.editor
+          swap$ "," *
+          " " * swap$ *
+          swap$
+          "," *
+          " " * swap$
+          * }
+      if$
+      format.bvolume duplicate$ empty$ 'pop$
+        { ", " swap$ * * }                    
+      if$
+      word.in swap$ *
+    }
+  if$
+}
+FUNCTION {format.in.ed.proctitle}
 { format.booktitle duplicate$ empty$ 'skip$
     {
+      format.edition duplicate$ empty$ 'pop$
+        { ", " swap$ * * }
+      if$
+      editor "editor" format.names.ed duplicate$ empty$ 'pop$
+        {
+          get.bbl.editor
+          swap$ "," *
+          " " * swap$ *
+          swap$
+          "," *
+          " " * swap$
+          * }
+      if$
+      format.pvolume duplicate$ empty$ 'pop$
+        { ", " swap$ * * }                    
+      if$
+      word.in swap$ *
+    }
+  if$
+}
+FUNCTION {format.in.ed.serialtitle}
+{ format.doi.booktitle duplicate$ empty$ 'skip$
+    {
       format.bvolume duplicate$ empty$ 'pop$
         { " (" swap$ * * ")" *}                    
       if$
@@ -1127,6 +1265,7 @@
     }
   if$
 }
+
 FUNCTION {empty.misc.check}
 { author empty$ title empty$ howpublished empty$
   month empty$ year empty$ note empty$
@@ -1143,6 +1282,33 @@
     }
   if$
 }
+
+FUNCTION {format.alt.link}
+{ doi empty$
+    { url empty$
+        { eprint empty$ 
+            {   format.note output 
+                fin.urllink.entry
+            }   
+			{   format.note output 
+			    format.eprint output
+			    fin.entry
+			}
+	      if$
+        }
+        { format.note output 
+		  format.url output
+		  fin.entry
+		}
+      if$
+    }
+    { format.doi output 
+      format.note output
+	  fin.urllink.entry
+    }
+  if$
+}
+
 FUNCTION {format.tr.number}
 { number "number" bibinfo.check
   type duplicate$ empty$
@@ -1154,7 +1320,45 @@
     { pop$ "t" change.case$ }
     { tie.or.space.prefix * * }
   if$
+    duplicate$ empty$ 'skip$
+    {
+      doilink
+    }
+  if$
 }
+
+FUNCTION {format.paper.number}
+{ number "number" bibinfo.check
+  type duplicate$ empty$
+    { pop$ bbl.paperno }
+    'skip$
+  if$
+  "type" bibinfo.check
+  swap$ duplicate$ empty$
+    { pop$ "t" change.case$ }
+    { tie.or.space.prefix * * }
+  if$
+    duplicate$ empty$ 'skip$
+    {
+    doilink
+    }
+  if$
+}
+FUNCTION {format.venue}
+{ venue "venue" bibinfo.check
+  duplicate$ empty$ 'skip$
+    { 
+    }
+  if$
+}
+FUNCTION {format.eventdate}
+{ eventdate "eventdate" bibinfo.check
+  duplicate$ empty$ 'skip$
+    {
+    }
+  if$
+}
+
 FUNCTION {format.article.crossref}
 {
   key duplicate$ empty$
@@ -1273,6 +1477,10 @@
 { organization "organization" bibinfo.check format.org.or.pub
 }
 
+FUNCTION {format.institution.address}
+{ institution "institution" bibinfo.check format.org.or.pub
+}
+
 FUNCTION {article}
 { output.bibitem
   format.authors "author" output.check
@@ -1294,11 +1502,11 @@
   eid empty$
     { format.journal.pages }
     { format.journal.eid }
-  if$
+  if$ 
   format.note output
-  format.eprint output
   fin.urllink.entry
 }
+
 FUNCTION {book}
 { output.bibitem
   author empty$
@@ -1315,9 +1523,9 @@
   date.block
   format.doi.btitle "title" output.check
   crossref missing$
-    { format.bvolume output
-      format.edition output
+    { format.edition output
       format.version output
+      format.bvolume output 
       format.number.series output
       format.publisher.address output
     }
@@ -1326,9 +1534,9 @@
     }
   if$
   format.note output
-  format.eprint output
   fin.urllink.entry
 }
+
 FUNCTION {booklet}
 { output.bibitem
   format.authors output
@@ -1359,14 +1567,15 @@
   if$
   format.date "year" output.check
   date.block
-  format.btitle "title" output.check
+  format.doi.btitle "title" output.check
   crossref missing$
     {
+      format.edition output
+      format.version output
       format.bvolume output
-      format.chapter.pages "chapter and pages" output.check
-      format.edition output
       format.number.series output
       format.publisher.address output
+      format.chapter.pages "chapter and pages" output.check
     }
     {
       format.chapter.pages "chapter and pages" output.check
@@ -1374,11 +1583,8 @@
     }
   if$
   format.pages "pages" output.check
-  format.doi output
   format.note output
-  format.eprint output
-  format.url output
-  fin.entry
+  fin.urllink.entry
 }
 
 FUNCTION {incollection}
@@ -1399,12 +1605,32 @@
     }
   if$
   format.pages "pages" output.check
-  format.doi output
   format.note output
-  format.eprint output
-  format.url output
-  fin.entry
+  fin.urllink.entry
 }
+
+FUNCTION {inserialcollection}
+{ output.bibitem
+  format.authors "author" output.check
+  format.date "year" output.check
+  date.block
+  format.title "title" output.check
+  end.quote.title
+  crossref missing$
+    { format.in.ed.serialtitle "booktitle" output.check
+      format.number.series output
+      format.publisher.address output
+      format.chapter.pages output
+    }
+    { format.incoll.inproc.crossref output.nonnull
+      format.chapter.pages output
+    }
+  if$
+  format.pages "pages" output.check
+  format.note output
+  fin.urllink.entry
+}
+
 FUNCTION {inproceedings}
 { output.bibitem
   format.authors "author" output.check
@@ -1413,28 +1639,33 @@
   format.title "title" output.check
   end.quote.title
   crossref missing$
-    { format.in.ed.booktitle "booktitle" output.check
-      venue output
-      eventdate output
-      format.number.series output
+    { format.in.ed.proctitle "booktitle" output.check
       publisher empty$
         { format.organization.address output }
-        { organization "organization" bibinfo.check output
-          format.publisher.address output
-        }
+        { format.publisher.address output }
       if$
     }
     { format.incoll.inproc.crossref output.nonnull
     }
   if$
-  format.pages "pages" output.check
-  format.doi output
-  format.note output
-  format.eprint output
-  format.url output
-  fin.entry
+  venue empty$ 
+    { venue "venue" output.check}
+    { "address and venue" address either.or.check format.venue output }
+  if$
+  format.eventdate "eventdate" output.check
+  number empty$
+  	{ format.pages "pages" output.check
+	  format.alt.link 
+	}
+  	{ format.paper.number "number" output.check
+  	  format.pages "pages" output.check
+      format.note output
+      fin.urllink.entry
+  	}
+  if$
 }
 FUNCTION {conference} { inproceedings }
+
 FUNCTION {manual}
 { output.bibitem
   author empty$
@@ -1450,6 +1681,8 @@
   format.date output
   date.block
   format.btitle "title" output.check
+  format.edition output
+  format.version output
   author empty$
     { organization empty$
         {
@@ -1463,8 +1696,6 @@
       address "address" bibinfo.check output
     }
   if$
-  format.edition output
-  format.version output
   format.doi output
   format.note output
   format.eprint output
@@ -1504,6 +1735,36 @@
   fin.entry
   empty.misc.check
 }
+
+FUNCTION {online}
+{ output.bibitem
+  author empty$
+    { format.editors "author and editor" output.check
+    }
+    { format.authors output.nonnull
+      crossref missing$
+        { "author and editor" editor either.or.check }
+        'skip$
+      if$
+    }
+  if$
+  format.date "year" output.check
+  date.block
+  format.title
+  "title" output.check
+  end.quote.title
+  format.version output
+  organization "organization" bibinfo.warn output
+  address "address" bibinfo.check output  
+  format.doi output
+  format.note output
+  format.eprint output
+  format.url "url" bibinfo.warn output
+  fin.entry
+}
+FUNCTION {electronic} { online }
+FUNCTION {www} { online }
+
 FUNCTION {phdthesis}
 { output.bibitem
   format.authors "author" output.check
@@ -1531,10 +1792,8 @@
   if$
   format.date "year" output.check
   date.block
-  format.btitle "title" output.check
+  format.doi.btitle "title" output.check
   format.bvolume output
-  venue output
-  eventdate output
   editor empty$
     { publisher empty$
         {  format.number.series output }
@@ -1550,17 +1809,15 @@
           format.organization.address output }
         {
           format.number.series output
-          organization "organization" bibinfo.check output
           format.publisher.address output
         }
       if$
      }
   if$
-  format.doi output
+  "address and venue" address either.or.check format.venue "venue" output.check
+  format.eventdate "eventdate" output.check
   format.note output
-  format.eprint output
-  format.url output
-  fin.entry
+  fin.urllink.entry
 }
 
 FUNCTION {techreport}
@@ -1571,47 +1828,16 @@
   format.title
   "title" output.check
   end.quote.title
-  format.tr.number output.nonnull
-  institution "institution" bibinfo.warn output
-  address "address" bibinfo.check output
-  format.doi output
-  format.note output
-  format.eprint output
-  format.url output
-  fin.entry
-}
-
-FUNCTION {online}
-{ output.bibitem
-  author empty$
-    { format.editors "author and editor" output.check
-    }
-    { format.authors output.nonnull
-      crossref missing$
-        { "author and editor" editor either.or.check }
-        'skip$
-      if$
-    }
+  format.institution.address output
+  number empty$
+  	{ format.alt.link }
+  	{ format.tr.number output.nonnull
+  	  format.note output
+  	  fin.urllink.entry
+  	}
   if$
-  format.date "year" output.check
-  date.block
-  format.title
-  "title" output.check
-  end.quote.title
-  format.version output
-  organization "organization" bibinfo.warn output
-  address "address" bibinfo.check output  
-  format.doi output
-  format.note output
-  format.eprint output
-  format.url "url" bibinfo.warn output
-  fin.entry
 }
 
-FUNCTION {electronic} { online }
-
-FUNCTION {www} { online }
-
 FUNCTION {unpublished}
 { output.bibitem
   format.authors "author" output.check

Modified: trunk/Master/texmf-dist/doc/latex/asmejour/README.md
===================================================================
--- trunk/Master/texmf-dist/doc/latex/asmejour/README.md	2020-04-12 21:29:19 UTC (rev 54697)
+++ trunk/Master/texmf-dist/doc/latex/asmejour/README.md	2020-04-12 21:29:31 UTC (rev 54698)
@@ -1,11 +1,11 @@
  
   #asmejour: A template for ASME journal papers#
  
-  Version 1.11 dated 2020/02/29.
+  Version 1.12 dated 2020/04/12.
 
   ####Overview####
-  This class provides a template to format preprints submitted to ASME journals in the style that 
-  is being used in 2020.
+  This class provides a template to format preprints submitted to ASME journals. The layout and reference
+  formats follow the style that is being used for published papers in 2020.
   
   This work is not a publication of ASME itself.
 
@@ -29,7 +29,7 @@
 
 - closely approximate ASME's fonts and layout, including author/title/abstract design
 
-- follow today's ASME format for citations
+- follow today's ASME style for reference lists
 
 - support hyperref package (hyperlinks for figures, tables, citations, and web)
 
@@ -56,10 +56,14 @@
  ---
  
  ####Change log####
+ 
+v1.12 (2020/04/12): Change subfigure \\ref labels to have parentheses around italic letters; remove space between consecutive numerical citations; add macro to adjust vertical space below abstract; edit documentation; remove varl and varqu options of inconsolata font; extensively edit/document asmejour-sample.bib file. 
 
+Many changes to asmejour.bst (v1.03) to improve consistency with ASME reference formats for collections, technical reports, and conference papers, to better manage hyperlinks, and to warn for missing fields. These includes: move venue, eventdate, and paper number to end of @inproceedings; move paper number after address of @techreport; hyperlink technical report numbers and conference numbers, and provide fallback for missing numbers; separate serial collection parenthetical layout from @incollection into new @inserialcollection; add default name for @inproceedings paper number, "Paper No.", changed by type ={} (this alternation is not backward compatible!); add oclc macro for archive field; complete the set of macros for ASME journal names.
+
 v1.11: ensure T1 font encoding, utf-8 input, and LuaLaTeX compatibility; edit documentation.
 
-v1.10: update asmeconf.bst to most recent Crossref standard prefix for doi (https://doi.org/); remove xpatch package from class file; disable \\( and \\) in pdf bookmarks to avoid warnings; adjust \\eqref in bookmarks; edit documentation.
+v1.10: update asmejour.bst to most recent Crossref standard prefix for doi (https://doi.org/); remove xpatch package from class file; disable \\( and \\) in pdf bookmarks to avoid warnings; adjust \\eqref in bookmarks; edit documentation.
 
 v1.09: adjust nomenclature list; edit language support
 

Modified: trunk/Master/texmf-dist/doc/latex/asmejour/asmejour-sample.bib
===================================================================
--- trunk/Master/texmf-dist/doc/latex/asmejour/asmejour-sample.bib	2020-04-12 21:29:19 UTC (rev 54697)
+++ trunk/Master/texmf-dist/doc/latex/asmejour/asmejour-sample.bib	2020-04-12 21:29:31 UTC (rev 54698)
@@ -1,186 +1,209 @@
-%% Revised 06 November 2019.
-
+%% Revised: 12 April 2020
+%%
+%% Titles should be capitalized (title case) according to ASME style
+%% Allowable fields are listed after the first use of each entry type.
+%%
 @article{DKE1969,
   author  =	{D. K. Edwards},
+  year	  =	{1969},
   title	  =	{Radiative Transfer Characteristics of Materials},
-  journal =	jht,
+  journal =	{{ASME} J. Heat Transfer},
   volume  =	91,
   number  = 1,
   pages   = {1--15},
-  month   = {February},
-  year	  =	{1969},
   doi     = {10.1115/1.3580108},
+  month   = feb,
 }
+%% article supports these fields: author, year, title, journal, volume, number, pages OR eid, doi OR url OR eprint with archive, note. (The month field is not used in ASME style and will be ignored.)
 	
 @article{toohey2007,
   author  = {Kathleen S. Toohey and Nancy R. Sottos and Jennifer A. Lewis and Jeffrey S. Moore and Scott R. White}, 
   year    = {2007}, 
-  title   = {Self-healing Materials with Microvascular Networks},
+  title   = {Self-Healing Materials With Microvascular Networks},
   journal = {Nature Materials}, 
   volume  = {6},
-  number  = {6662}, 
+  number  = {8}, 
   pages   = {581--585},
   doi     = {10.1038/nmat1934},
 }
 
- at BOOK{gibson2008,
-  title = {The Big Book of Cellular Studies},
+ at book{gibson2008,
+  author 	= {Tom A. Gibson and Matthew A. Tucker},
+  year 		= {2008},
+  title 	= {The Big Book of Cellular Studies},
   publisher = {John Wiley and Sons},
-  year = {2008},
-  author = {Tom A. Gibson and Matthew A. Tucker},
-  address = {New York, NY},
+  address 	= {New York, NY},
 }
+%% book supports these fields: author OR editor, year, title, edition, version, series, volume OR number, publisher, address, doi OR url OR eprint with archive, note.  type={} field can change "Chap." to something else.
 
- at INCOLLECTION{stevens1999,
-  title = {Stochastic Fields and Their Digital Simulation},
+ at incollection{stevens1999,
+  author 	= {Thomas T. Stevens},
+  year 		= {1999},
+  title 	= {Stochastic Fields and Their Digital Simulation},
+  booktitle = {Stochastic Methods},
+  editor 	= {T. A. Sulle and M. Siiu},
   publisher = {Martinius Publishers},
-  pages = {22--36},
-  year = {1999},
-  booktitle = {Stochastic Methods},
-  author = {Thomas T. Stevens},
-  editor = {T. A. Sulle and M. Siiu},
-  address = {Dordrecht, Germany},
+  address 	= {Dordrecht, Germany},
+  pages 	= {22--36},
 }
+%% incollection supports these fields: author, year, title, booktitle, edition, editor, series, volume OR number, publisher, address, chapter, pages, doi OR url OR eprint with archive, note.  type={} field changes "Chap." to something else.
 
- at inproceedings{wions2005,
-  author = {Thomas Wions and Christopher D. Mills}, 
-  title = {Structural Dynamics in Parallel Manipulation},
-  booktitle = {Proceedings of the ASME IDETC/CIE},
-  year = {2005},
-  pages = {777--798},
-  number = {ASME Paper No.\ DETC2005-99532},
-  venue = {New Orleans, LA},
+ at inproceedings{wions2006,
+  author 	= {Thomas Wions and Christopher D. Mills}, 
+  year 		= {2006},
+  title 	= {Structural Dynamics in Parallel Manipulation},
+  booktitle = {Proceedings of the IDETC/CIE},
+  venue 	= {New Orleans, LA},
   eventdate = {September 10--13},
+  type		= {ASME Paper No.},
+  number 	= {DETC2005-99532},  
+  pages 	= {777--798},
 }
-% Note that venue and eventdate are specific to the asmejour.bst style
+%% inproceedings supports these fields: author, year, title, booktitle, edition, editor, series, volume, 
+%%                                      organization OR publisher, address OR venue, eventdate, [paper] number
+%%										pages, doi, note, url, eprint with archive, url. 
+%% type = { } changes default "Paper No." 
+%% venue and eventdate are specific to the asmejour.bst style. The "series" field is rarely used.
+%% If there are no pages as such, just omit the pages field and ignore the bibtex warning "missing pages".
 
+
 @techreport{oligaria2011,
-  author = {Oligaria, T. T. and Fredy, C. W. and Popullo, A. Z. and Tucker, M. A.}, 
-  year = {2011}, 
-  title = {Characterization of PKM Dynamics}, 
-  type = {SAE Technical Paper},
-  institution = {Society of Automotive Engineers},
-  address = {Warrendale, PA},
-  number = {No.\ 2011-02-8345, 07ATC-96},
+  author 	= {Oligaria, T. T. and Fredy, C. W. and Popullo, A. Z. and Tucker, M. A.}, 
+  year 		= {2011}, 
+  title 	= {Characterization of {PKM} Dynamics}, 
+  type 		= {SAE Technical Paper},
+  number 	= {No. 2011-02-8345, 07ATC-96},
 }
+%% techreport supports these fields: author, year, title, institution, address, number, type, note
+%%                                   doi OR url OR eprint with archive.
+%% ASME's online examples omit institution; however, the ASME journals will include it, e.g.:
+%%   		institution = {Society of Automotive Engineers},
 
+
 @phdthesis{mollen2014,
-  author = {T. P. Mollen},
-  title = {Use of General Nonlinear Material in Articulated Systems},
-  school = {University of Boston},
-  address = {Boston, MA},
-  year = {2014},
+  author 	= {T. P. Mollen},
+  year 		= {2014},
+  title 	= {Use of General Nonlinear Material in Articulated Systems},
+  type		= {Ph.{D}. dissertation},
+  school 	= {University of Boston},
+  address 	= {Boston, MA},
 }
-% type = {Sc{D} Thesis}, could be added to change the type of thesis. See example below.
+%% phdthesis supports these fields: author, year, title, type, school, address, note.
+%% These fields are also supported, but don't use them all: doi, eprint with archive, url, urldate, urltype
+%% type = {} can optionally be added to change the style of thesis. Default is "Ph.D. thesis"
 
 @book{smith2014,
-  author = {Smith, John}, 
-  year = {2014},
-  title = {A Dog's Life in Berlin},
+  author 	= {Smith, John}, 
+  year 		= {2014},
+  title 	= {A Dog's Life in Berlin},
   publisher = {Oxford University Press}, 
-  address = {New York},
-  doi = {10.1055/acprof.oso/97890.0394.000},
-  note = {\doi{10.1055/acprof.oso/97890.0394.000}},
+  address 	= {New York},
+  doi 		= {10.1055/acprof.oso/97890.0394.000},
+  note 		= {\doi{10.1055/acprof.oso/97890.0394.000}},
 }
-%% An example to show a doi even though doi is linked.
-%% note = {\url{http://dx.doi.org/10.1055/acprof.oso/97890.0394.000}},
+%% This example shows how to print a doi even though the doi field is hyperlinked to the title. An alternative is:
+%% note = {\url{https://doi.org/10.1055/acprof.oso/97890.0394.000}},
  
 @online{apple2019,
-       title={Apple Privacy Policy},
-       url = {https://www.apple.com/legal/privacy/en-ww/},
-       urldate = {April 27, 2019},
-       organization = {Apple Inc.},
-       address = {Cupertino, CA},
-       note = {updated April 4, 2019},
+  title		= {Apple Privacy Policy},
+  url 		= {https://www.apple.com/legal/privacy/en-ww/},
+  urldate 	= {Apr. 5, 2020},
+  organization = {Apple Inc.},
+  address 	= {Cupertino, CA},
+  note 		= {last modified Dec. 31, 2019},
 }
+%% online supports these fields: author OR editor, year, title, version, versiontype, organization, address, 
+%%                               note, url, urldate, urltype
+%% These additional fields are also supported, but are intended as alternatives to url: doi, eprint with archive 
 
 @online{sharpe1,
-  author = {Michael Sharpe},
-  title = {New {TX} font package},
-  year = {2018},
+  author 	= {Michael Sharpe},
+  year 		= {2018},
+  title 	= {New {TX} Font Package},
+  version 	= {1.554},
   organization = {Comprehensive \TeX\ Archive Network},
-  url = {https://ctan.org/pkg/newtx},
-  urldate = {April 27, 2019},
-  version = {1.554},
+  url 		= {https://ctan.org/pkg/newtx},
+  urldate 	= {Apr. 27, 2019},
 }
 
 @article{Lienhard2019b,
-  title 	= "Exterior Shape Factors from Interior Shape Factors",
+  title 	= {Exterior Shape Factors from Interior Shape Factors},
+  year 		= {2019},
   journal 	= jht,
-  year 		= "2019",
-  doi 		= "10.1115/1.4042912",
+  doi 		= {10.1115/1.4042912},
   author 	= {Lienhard, V, John H.},
   eid 		= {061301},
   volume 	= {141},
   number 	= {6},
 }
+%% note use of: eid in place of pages, and use of jht macro for the journal name
 
 @online{sharpe2,
-  author = {Michael Sharpe},
-  title = {The \textsf{mathalfa} package},
-  year = {2018},
+  author 	= {Michael Sharpe},
+  year 		= {2018},
+  title 	= {The \textsf{mathalfa} Package},
+  version 	= {1.10},
   organization = {Comprehensive \TeX\ Archive Network},
-  url = {https://ctan.org/pkg/mathalfa},
-  urldate = {April 27, 2019},
-  version = {1.10},
+  url 		= {https://ctan.org/pkg/mathalfa},
+  urldate 	= {Apr. 27, 2019},
 }
 
 @online{fairbairns,
-  author = {Robin Fairbairns and Sebastian Rahtz and Leonor Barroca},
-  title = {A package for rotated objects in \LaTeX},
-  year = {2016},
+  author 	= {Robin Fairbairns and Sebastian Rahtz and Leonor Barroca},
+  year 		= {2016},
+  title 	= {A Package for Rotated Objects in \LaTeX},
+  version 	= {2.16d},
   organization = {Comprehensive \TeX\ Archive Network},
-  url = {https://www.ctan.org/pkg/rotating},
-  urldate = {October 2, 2019},
-  version = {2.16d},
+  url 		= {https://www.ctan.org/pkg/rotating},
+  urldate 	= {Oct. 2, 2019},
 }                           
 
 @online{fear,
-  author = {Simon Fear},
-  title = {Publication quality tables in \LaTeX},
-  year = {2019},
+  author 	= {Simon Fear},
+  year 		= {2019},
+  title 	= {Publication Quality Tables in \LaTeX},
   organization = {Comprehensive \TeX\ Archive Network},
-  url = {https://www.ctan.org/pkg/booktabs},
-  urldate = {November 6, 2019},
-  version = {1.6180339},
+  version 	= {1.6180339},
+  url 		= {https://www.ctan.org/pkg/booktabs},
+  urldate 	= {Nov. 6, 2019},
 }                           
 
 @online{GSL,
-	title  = {{GNU} Scientific Library},
-    URL    = {https://www.gnu.org/software/gsl/},
-    author = {Mark Galassi 
-	and Jim Davies
-	and James Theiler
-	and Brian Gough
-	and Gerard Jungman
-	and Patrick Alken
-	and Michael Booth
-	and Fabrice Rossi
-	and Rhys Ulerich},
-    year = 2017,
-    organization = {Free Software Foundation},
-    address = {Boston, MA},
-    urldate = {Dec. 12, 2018},
-    version = {2.4},
-    versiontype = {Release},
+  title  	= {{GNU} Scientific Library},
+  year 		= 2017,
+  URL    	= {https://www.gnu.org/software/gsl/},
+  author 	= {Mark Galassi 
+  				and Jim Davies
+  				and James Theiler
+  				and Brian Gough
+  				and Gerard Jungman
+  				and Patrick Alken
+  				and Michael Booth
+  				and Fabrice Rossi
+  				and Rhys Ulerich},
+  organization = {Free Software Foundation},
+  address 	= {Boston, MA},
+  urldate 	= {Dec. 12, 2018},
+  version 	= {2.4},
+  versiontype = {Release},
 }
-
+%% An alternative approach that doesn't use version and versiontype follows next: 
 @online{dlmf,
-  title = {{NIST} {D}igital Library of Mathematical Functions, Release 1.0.17},
-  year = {2017},
-  editor = {F. W. J. Olver and A. B. {Olde Daalhuis} and D. W. Lozier and B. I. Schneider and
+  title 	= {{NIST} {D}igital Library of Mathematical Functions, Release 1.0.17},
+  year 		= {2017},
+  editor 	= {F. W. J. Olver and A. B. {Olde Daalhuis} and D. W. Lozier and B. I. Schneider and
             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/},
-  urldate ={Dec.\ 22, 2018},
+  address 	= {Gaithersburg, MD},
+  url 		= {http://dlmf.nist.gov/},
+  urldate 	= {Dec. 22, 2018},
 }
 
 @online{texshop,
-    author={Richard Koch},
-	title = {{\TeX}{S}hop, Version 4.01},
-	year={2018},
-	url = {http://pages.uoregon.edu/koch/texshop/obtaining.html},
+    author	= {Richard Koch},
+	title 	= {{\TeX}{S}hop, Version 4.01},
+	year	= {2018},
+	url 	= {http://pages.uoregon.edu/koch/texshop/obtaining.html},
 	urldate = {Apr. 16, 2018},
     organization = {University of Oregon},
     address = {Eugene, OR},
@@ -187,188 +210,211 @@
 }
 
 @online{tolusis,
-  author = {Sigitas Tolu{\v{s}}is},
-  title = {The \textsf{flushend} package},
-  year = {2017},
+  author 	= {Sigitas Tolu{\v{s}}is},
+  year 		= {2017},
+  title 	= {The \textsf{flushend} Package},
+  version 	= {3.3},
   organization = {Comprehensive \TeX\ Archive Network},
-  url = {https://www.ctan.org/pkg/flushend},
-  urldate = {October 1, 2019},
-  version = {3.3},
+  url 		= {https://www.ctan.org/pkg/flushend},
+  urldate 	= {Oct. 1, 2019},
 }
 
 @online{bottcher,
-  author = {Stephan I. B{\"o}ttcher and Uwe L{\"u}ck},
-  title = {\textsf{lineno.sty}: A {\LaTeX} package to attach line numbers to paragraphs},
-  year = {2005},
+  author 	= {Stephan I. B{\"o}ttcher and Uwe L{\"u}ck},
+  year 		= {2005},
+  title 	= {\textsf{lineno.sty}: A {\LaTeX} Package to Attach Line Numbers to Paragraphs},
+  version 	= {4.41},
   organization = {Comprehensive \TeX\ Archive Network},
-  url = {https://www.ctan.org/pkg/lineno},
-  urldate = {August 17, 2019},
-  version = {4.41},
+  url 		= {https://www.ctan.org/pkg/lineno},
+  urldate 	= {Aug. 17, 2019},
 }
 
 @online{oostrum,
-  author = {Piet van Oostrum},
-  title = {The \textsf{fancyhdr} and \textsf{extramarks} packages},
-  year = {2019},
+  author 	= {Piet van Oostrum},
+  year 		= {2019},
+  title 	= {The \textsf{fancyhdr} and \textsf{extramarks} Packages},
+  version 	= {3.10},
   organization = {Comprehensive \TeX\ Archive Network},
-  url = {https://www.ctan.org/pkg/lineno},
-  urldate = {August 17, 2019},
-  version = {3.10},
+  url 		= {https://www.ctan.org/pkg/lineno},
+  urldate 	= {Aug. 17, 2019},
 }
  
 @online{amsmath,
-  author = {{American Mathematical Society} and {LATEX3 Project}},
-  title = {User's Guide for the amsmath Package },
-  year = {2018},
+  author 	= {{American Mathematical Society} and {LATEX3 Project}},
+  year 		= {2018},
+  title 	= {User's Guide for the \textsf{amsmath} Package },
+  version 	= {2.1},
   organization = {Comprehensive \TeX\ Archive Network},
-  url = {https://ctan.org/tex-archive/macros/latex/required/amsmath/amsldoc.pdf},
-  urldate = {July 5, 2019},
-  version = {2.1},
+  url 		= {https://ctan.org/tex-archive/macros/latex/required/amsmath/amsldoc.pdf},
+  urldate 	= {July 5, 2019},
 }
 
 @article{Lienhard2019c,
-  title   = {Linearization of Nongray Radiation Exchange: The Internal Fractional Function Reconsidered},
-  journal = jht,
-  year   = "2019",
-  doi    = "10.1115/1.4042158",
-  author = {Lienhard, V, John H.},
-  eid    = {052701},
-  volume = {141},
-  number = {5},
+  author 	= {Lienhard, V, John H.},
+  year   	= {2019},
+  title   	= {Linearization of Nongray Radiation Exchange: The Internal Fractional Function Reconsidered},
+  journal 	= jht,
+  doi    	= {10.1115/1.4042158},
+  volume 	= {141},
+  number 	= {5},
+  eid    	= {052701},
 }
 
 @book{ww1927,
-       author={E. T. Whittaker and E. N. Watson},
-       title={A Course of Modern Analysis},
-       year={1920},
-       edition={3rd},
-       publisher={Cambridge University Press},
-       address={Cambridge, UK},
-       url = {https://archive.org/details/courseofmodernan00whit},
+  author	= {E. T. Whittaker and E. N. Watson},
+  year		= {1920},
+  title		= {A Course of Modern Analysis},
+  edition	= {3},
+  publisher = {Cambridge University Press},
+  address 	= {Cambridge, UK},
+  url 		= {https://archive.org/details/courseofmodernan00whit},
 }
   
- at incollection{euler1740,
-        author={Leonard Euler},
-        title={De summis serierum reciprocarum}, 
-        booktitle={Commentarii academiae scientiarum Petropolitanae},
-        volume= 7,
-        year=1740,
-        pages = {123--134},
-        archive=arxiv,
-        eprint={math/0506415},
-        note={First communicated to Daniel Bernoulli in 1734 and read before the St.\ Petersburg Academy in December 1735},
+ at article{euler1740,
+  author	= {Leonard Euler},
+  year		= 1740,
+  title		= {De Summis Serierum Reciprocarum}, 
+  journal	= {Commentarii Acad\-emiae Scientiarum Petropolitanae},
+  volume	= 7,
+  pages 	= {123--134},
+  archive	= arxiv,
+  eprint	= {math/0506415},
+  note		= {First communicated to Daniel Bernoulli in 1734 and read before the St.\ Petersburg Academy in December 1735},
 }
 
 @book{euler1748,
-        author={Leonard Euler},
-        title = {Introductio in analysin infinitorum},
-        year={1748},
-        volume=1,
-        publisher={Apud Marcum-Michaelem Bousquet \& Socios},
-        address={Lausannae},
+  author	= {Leonard Euler},
+  year		= {1748},
+  title 	= {Introductio in Analysin Infinitorum},
+  volume	= 1,
+  publisher	= {Apud Marcum-Michaelem Bousquet \& Socios},
+  address	= {Lausannae},
 }
 % note={English translation by I.\ Bruce available here at \url{http://www.17centurymaths.com/contents/introductiontoanalysisvol1.htm}},
 
- at online{fourierwiki,
-  title  = {Joseph Fourier---Wikip\'{e}dia{,} l'encyclop\'{e}die libre},
-  year   = {2019},
-  author = {Wikipedia},
-  url    = {https://fr.wikipedia.org/wiki/Joseph_Fourier},
-  urldate= {July 5, 2019},
+ at book{fourier1822,
+  author  	= {Jean Baptiste Joseph Fourier},
+  year		= {1822},
+  title		= {Th\'{e}orie Analytique de la Chaleur},
+  publisher = {Firmin Didot, P\`{e}re et Fils},
+  address	= {Paris},
+  url	= {https://archive.org/details/analyticaltheory00fourrich},
 }
-%% Note ASME Journal discourage citations to Wikipedia.
 
 @techreport{reynolds1958,
-  AUTHOR = {W.~C.~Reynolds and W.~M.~Kays and S.~J.~Kline},
-  TITLE = {Heat transfer in the incompressible turbulent boundary layer. {I}--constant wall temperature},
-  type = {NASA Technical Memorandum No.\ },
-  number = {12-1-58W},
+  author 	= {W. C. Reynolds and W. M. Kays and S. J. Kline},
+  title 	= {Heat transfer in the Incompressible Turbulent Boundary Layer. {I}---Constant Wall Temperature},
+  type 		= {NASA Technical Memorandum No.\ },
+  number 	= {12-1-58W},
   institution = {National Aeronautics and Space Administration},
-  address = {Washington, DC},
-  Month={December},
-  year = {1958},
-  archive = hndl,
-  eprint = {2060/19980228020},
+  address 	= {Washington, DC},
+  month		= dec,
+  year 		= {1958},
+  archive 	= hndl,
+  eprint 	= {2060/19980228020},
 }
-%% URL = {https://ntrs.nasa.gov/archive/nasa/casi.ntrs.nasa.gov/19980228020.pdf},
-%% URL = {http://hdl.handle.net/2060/19980228020},
+%% techreport supports these fields: author, year, title, institution, address, number, type, 
+%%                                   note, doi OR url OR eprint with archive.
+%% ASME's online examples omit the institution and address; however, the ASME journals will include these.
+%% 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}
 
- at incollection{DKE70,
-	author	  = {Donald K. Edwards},
-	title 	  = {Thermal Radiation Measurements},
-	editor    =	{Ernst R. G. Eckert and Richard J. Goldstein},
-	booktitle =	{Measurement Techniques in Heat Transfer}, 
-	chapter   = {9},
-	pages     = {353--396},
-	volume    = {130},
-	series	  = {{AGARD}ograph},
-	month     = {November},
-    publisher = {Advisory Group for Aerospace Research and Development of {NATO}, Technivision Services},
-	address   = {Slough, England},
-	year	  = {1970},
+ at incollection{clauser56,
+  author 	= {Francis H. Clauser},
+  year 		= {1956},
+  title 	= {The Turbulent Boundary Layer},
+  booktitle = {Advances in Applied Mechanics},
+  editor 	= {H.L. Dryden and Th. von K\'arm\'an},
+  volume 	= {4},
+  publisher = {Elsevier},
+  address	= {Amsterdam, The Netherlands},
+  pages 	= {1--51},
+  doi 		= {10.1016/S0065-2156(08)70370-3},
 }
-%%	type = {...}, changes chapter to something else...
-%%  url = {..} can be added if it exists
-%%  edition = {..} can be added if relevant.
-%%  For Collections, series is intended to be used with volume, i.e., which volume of a collection.
-%%  Series (the title of the collection) will not appear if the volume number is empty
+%% This common case is an article in series of edited books where the series title is the same for all volumes.
+%%	  type = {..},   changes chapter to something else...
+%%    url  = {..},   can be added if it exists
+%%    edition = {..} can be added if relevant.
 
+ at inserialcollection{DKE70,
+  author	= {Donald K. Edwards},
+  title 	= {Thermal Radiation Measurements},
+  editor    = {Ernst R. G. Eckert and Richard J. Goldstein},
+  booktitle = {Measurement Techniques in Heat Transfer}, 
+  chapter   = {9},
+  pages     = {353--396},
+  volume    = {130},
+  series	= {{AGARD}ograph},
+  month     = nov,
+  publisher = {Advisory Group for Aerospace Research and Development of {NATO}, Technivision Services},
+  address   = {Slough, England},
+  year	  	= {1970},
+}
+%%  This exotic variant of incollection cites an article in a book series where each volume has a different title.
+%%  In this case, the series field (title of the overall series of books) is used with a volume number to produce
+%%         ...Title (Series, Vol.#), ...
+%%  Series will not appear if the volume number is empty. If you don't have both, use incollection instead.
+%%
+%%  inserialcollection supports these fields: author, year, title, booktitle, edition, editor, series, 
+%%											  volume OR number, publisher, address, chapter, pages, 
+%%											  doi OR url OR eprint with archive, note. type={} changes "Chap."
+%%  This entry type is defined by asmejour.bst
 
 @book{EDM,
-	author = {D. K. Edwards and V. E. Denny and A. F. Mills},
-	title= {Transfer Processes},
-	publisher = {Hemisphere Publishing},
-	edition = {2nd},
-	year	  =	1979,
-	address   =	{Washington, DC},
+  author 	= {D. K. Edwards and V. E. Denny and A. F. Mills},
+  title		= {Transfer Processes},
+  publisher = {Hemisphere Publishing},
+  edition 	= {2},
+  year	  	= 1979,
+  address   = {Washington, DC},
 }
 
 @article{montijano2014,
-       title={Numerical methods with {\LuaLaTeX}},
-       author={Juan I. Montijano and Mario P{\'{e}}rez and Luis R{\'{a}}ndez and Juan Luis Varona},
-       year=2014,
-       volume=35,
-       month={January},
-       number=1,
-       pages={51--56},
-       journal={TUGboat},
-       url = {https://tug.org/TUGboat/tb35-1/tb109montijano.pdf},
+  title		= {Numerical Methods With {\LuaLaTeX}},
+  author	= {Juan I. Montijano and Mario P{\'{e}}rez and Luis R{\'{a}}ndez and Juan Luis Varona},
+  year		= 2014,
+  volume	= 35,
+  month		= jan,
+  number	= {1},
+  pages		= {51--56},
+  journal	= {TUGboat},
+  url 		= {https://tug.org/TUGboat/tb35-1/tb109montijano.pdf},
 }
 
 @conference{Swaminathan2017IDABRO,
-	Author = {Swaminathan, Jaichander and Stover, Richard L. and Tow, Emily W. and Warsinger, David M. and Lienhard, John H.},
-	Booktitle = {Proceedings of IDA World Congress on Desalination and Water Reuse},
-	Title = {Effect of practical losses on optimal design of batch {RO} systems},
-	Year = {2017},
-	Month = 10,
-	Publisher = {International Desalination Association},
-	address = {Topsfield, MA},
-    venue ={S{\~a}o Paulo, Brazil},
-    eventdate = {October 15--20},
-    archive = hndl,
-    eprint = {1721.1/111971},
-	number = {Paper No.\ IDA17WC-58334},
+  author 	= {Swaminathan, Jaichander and Stover, Richard L. and Tow, Emily W. and Warsinger, David M. and Lienhard, John H.},
+  booktitle = {Proceedings of IDA World Congress on Desalination and Water Reuse},
+  title 	= {Effect of Practical Losses on Optimal Design of Batch {RO} Systems},
+  year 		= {2017},
+  month 	= oct,
+  publisher = {International Desalination Association},
+  venue 	= {S{\~a}o Paulo, Brazil},
+  eventdate = {Oct. 15--20},
+  archive 	= hndl,
+  eprint 	= {1721.1/111971},
+  number 	= {IDA17WC-58334},
 }
+%% conference is the same as inproceedings
 
 @misc{Fong2015,
-  title = {Analytical Methods for Squaring the Disc},
-  author = {Chamberlain Fong},
+  title 	= {Analytical Methods for Squaring the Disc},
+  year 		= {2015},
+  author 	= {Chamberlain Fong},
   howpublished = {{\itshape ArXiv e-prints}},
-  eprint = {1509.06344},
-  archive = arxiv,
-  year = {2015},
-  month = {sep},
+  eprint 	= {1509.06344},
+  archive 	= arxiv,
+  month 	= sep,
 }
     
 @online{mpl,
-	title={mpl colormaps},
-	author={St{\'e}fan {van der Walt} and Nathaniel Smith},
-	URL = {http://bids.github.io/colormap/},
-	urldate = {Aug. 26, 2018},
-	year = 2015,
-	organization = {GitHub},
-	address = {San Francisco, CA},
-	month = {September},
+  title		= {mpl Colormaps},
+  author	= {St{\'e}fan {van der Walt} and Nathaniel Smith},
+  url 		= {http://bids.github.io/colormap/},
+  urldate 	= {Aug. 26, 2018},
+  year 		= 2015,
+  organization = {GitHub},
+  address 	= {San Francisco, CA},
+  month 	= sep,
 }
 
 @book{ahtt,   
@@ -379,65 +425,97 @@
   volume    = {},  
   series    = {},   
   address   = {Cambridge, MA},   
-  edition   = {5th},   
+  edition   = {5},   
   month     = aug,   
   version   = {5.00}, 
-  url  = {http://ahtt.mit.edu},  
+  url  		= {http://ahtt.mit.edu},  
 } 
+
  
- at misc{narayan2017,
-  author = {Prakash Narayan Govindan and Steven Lam and Maximus G. {St. John}},
-  title = {Systems including a condensing apparatus such as a bubble column condenser}, 
-  year = {2017},
+ at misc{govindan2017,
+  author 	= {Prakash Narayan Govindan and Steven Lam and Maximus G. {St. John}},
+  year 		= {2017},
+  title 	= {Systems Including a Condensing Apparatus Such As a Bubble Column Condenser}, 
   howpublished = {US Patent {\#}9700811},
+  url		= {https://patents.google.com/patent/US9700811B2},
 }
+%% misc supports these fields: author, year, title, howpublished, note.
+%% These fields are also supported, but don't use them all: doi, eprint with archive, url, urldate, urltype
 
+
 @mastersthesis{smith1998,
-  author = {Robert Smith},
-  title = {Conformal Lubricated Contact of Cylindrical Surfaces Involved in a Steady Motion},
-  school = {Rochester Institute of Technology},
-  address = {Rochester, NY},
-  year = {1998},
+  author 	= {Robert Smith},
+  title 	= {Conformal Lubricated Contact of Cylindrical Surfaces Involved in a Steady Motion},
+  school 	= {Rochester Institute of Technology},
+  address 	= {Rochester, NY},
+  year 		= {1998},
 }
-
+%% mastersthesis supports these fields: author, year, title, type, school, address, note.
+%% These fields are also supported, but don't use them all: doi, eprint with archive, url, urldate, urltype
+%% type={} can optionally be used to change the type of thesis. Default is "Master's thesis"
+%% The following example uses type to make an entry for a Bachelor's thesis.
 @mastersthesis{smith1996,
-  author = {Robert Smith},
-  title = {Cylindrical Surfaces Involved in a Steady Motion},
-  type = {{BS} Thesis},
-  school = {Rochester Institute of Technology},
-  address = {Rochester, NY},
-  year = {1996},
+  author 	= {Robert Smith},
+  title 	= {Cylindrical Surfaces Involved in a Steady Motion},
+  type 		= {Bachelor's thesis},
+  school 	= {Rochester Institute of Technology},
+  address 	= {Rochester, NY},
+  year 		= {1996},
 }
  
 @BOOK{johnson1980,
-  title = {Title of edited book},
+  editor 	= {Howard Johnson},
+  year 		= {1980},
+  title 	= {Title of Edited Book},
   publisher = {John Wiley and Sons, Inc.},
-  year = {1980},
-  editor = {Howard Johnson},
-  address = {New York, NY},
+  address 	= {New York, NY},
 }
 
- at proceedings{proceedings,
-  title        = {The title of the proceedings},
-  year         = 2015,
-  editor       = {Howard Johnson},
-  volume       = 2,
-  address      = {Address of publisher},
-  organization = {The organization},
-  publisher    = {Name of publisher},
-  venue        = {City, State},
-  eventdate    = {Month, days},
-  note         = {Optional note},
+ at proceedings{johnson2015,
+  editor	= {Howard 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},
+  note		= {Optional note},
 }
-%  series       = {Series A},
+%% proceedings supports these fields: author OR editor, year, title, edition, editor, 
+%%                                    series, volume OR number, organization OR publisher, 
+%%                                    address [of organization or publisher] OR venue, eventdate,
+%%                                    doi OR url OR eprint with archive.
+%% The organization will appear as author/editor if those fields are empty.
+%% If you opt to use the venue and eventdate fields, don't include the address field.
+%% The very uncommon "series" field should be used with number, rather than volume.
   
 @BOOK{kirk2288a,
-  title = {Decline and Fall of the Romulan Empire},
+  author 	= {James Tiberius Kirk},
+  year 		= {2288},
+  title 	= {Decline and Fall of the Romulan Empire},
+  edition 	= 7,
+  series 	= {Humankind's Greatest Writings},
+  number 	= {23},
   publisher = {Vulcan Free Press},
-  year = {2288},
-  author = {James Tiberius Kirk},
-  address = {T'Paal},
-  series = {Humankind's Greatest Writings},
-  number = {23},
-  edition = 7},
+  address 	= {T'Paal},
 }
+%% One book in a series of books
+
+ at inbook{churchill1948,
+  author 	= {Winston S. Churchill},
+  year 		= {1948},
+  title 	= {The Gathering Storm},
+  edition 	= {1},
+  series 	= {The Second World War},
+  volume 	= {1},
+  chapter	= {5},
+  pages 	= {66--89},
+  url 		= {http://web.mit.edu},
+  publisher = {Houghton Mifflin Co.},
+  address 	= {Boston},
+  note 		= {{``The Locust Years''}},
+}
+%% inbook supports these fields: author OR editor, year, title, edition, version, versiontype, series, volume OR number, doi OR url OR eprint with archive, publisher, address, note.  type={} field can change "Chap." to something else.
+
+

Modified: trunk/Master/texmf-dist/doc/latex/asmejour/asmejour-template.pdf
===================================================================
(Binary files differ)

Modified: trunk/Master/texmf-dist/doc/latex/asmejour/asmejour-template.tex
===================================================================
--- trunk/Master/texmf-dist/doc/latex/asmejour/asmejour-template.tex	2020-04-12 21:29:19 UTC (rev 54697)
+++ trunk/Master/texmf-dist/doc/latex/asmejour/asmejour-template.tex	2020-04-12 21:29:31 UTC (rev 54698)
@@ -3,7 +3,7 @@
 %%  This file is asmejour-template.tex, a template to format papers in the style of ASME journal papers 
 %%  as they are being published in 2020.
 %%
-%%  This file is version 1.11 dated 2020/02/29
+%%  This file is version 1.12 dated 2020/04/12
 %%
 %%  Author: John H. Lienhard V
 %%          Department of Mechanical Engineering
@@ -100,8 +100,7 @@
 
 \PaperYear % defaults to current year if no argument given or if command is omitted; 
            % \PaperYear{} omits year; \PaperYear{2018} sets 2018.
-           
-           
+                   
 %%%%%%%%%  End of Preamble  %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 
 \begin{document}
@@ -138,7 +137,6 @@
 %%% Change these to your keywords.  Keywords are automatically printed at the end of the abstract.
 %%% This command must come BEFORE the end of the abstract.
 %%% If you don't want keywords, delete the command.
-
 \keywords{ASME, Paper, Template, {\upshape\LaTeX}, {\upshape\hologo{BibTeX}}}
  
    
@@ -163,7 +161,7 @@
 
 The \texttt{asmejour} class file will typeset 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.
 
-This class is not a publication of ASME. 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. 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.
 
 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.
 
@@ -170,7 +168,7 @@
 \subsection{Essential Initial Commands}
 To begin, fill in the fields to be completed at top of the \texttt{asmejour-template.tex} file. The pdf metadata will be placed into the pdf file itself. 
 
-For each author, put author names and affiliation (with line breaks) into a separate \verb|\SetAuthorBlock{name}{affiliation}| command; follow the syntax illustrated \texttt{asmejour-template.tex} file.  One author (or more) may be designated as the \verb|\CorrespondingAuthor| by placing the command at the end of the name.  
+For each author, put author names and affiliation (with line breaks) into a separate \verb|\SetAuthorBlock{name}{affiliation}| command; follow the syntax illustrated \texttt{asmejour-template.tex} file.  One author (or more) may be designated as the corresponding author  by placing the command \verb|\CorrespondingAuthor| at the end of that name.  
 
 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. The abstract text must be placed into \verb|\begin{abstract}|\ldots\verb|\end{abstract}|. The abstract will automatically be italicized. 
 
@@ -187,7 +185,7 @@
 
 For ASME papers, the labels Figure and Equation should be abbreviated when they do not start a sentence, as in Fig.~\ref{fig:1} and Eq.~\eqref{eqn:1}. Figure~\ref{fig:1} is spelled out when it starts a sentence. Equation~\eqref{eqn:1} is spelled out when it starts a sentence. 
 
-Citations will be numbered automatically \cite{DKE1969}. They should be inserted at the appropriate point using a \verb|\cite{ref}| command~\cite{toohey2007,gibson2008}. The citations will be automatically sorted and compressed, as well, if they are given in a set \cite{stevens1999, DKE1969, wions2005, oligaria2011,mollen2014,smith2014,apple2019}. Just refer to the number when naming a reference, as in \cite{smith2014}. Reference~\cite{smith2014} is appropriate at the beginning of a sentence.
+Citations will be numbered automatically \cite{DKE1969}. They should be inserted at the appropriate point using a \verb|\cite{ref}| command~\cite{toohey2007,gibson2008}. The citations will be automatically sorted and compressed, as well, if they are given in a set \cite{stevens1999, DKE1969, wions2006, oligaria2011, mollen2014, smith2014, apple2019}. If naming a reference explicitly, use an abbreviation in front of the number, as in Ref.~\cite{smith2014}. Reference~\cite{smith2014} is appropriate at the beginning of a sentence.
 See the \texttt{asmeconf-sample.bib} file for examples of how to enter your references.
 
 Equations are typeset in the usual way.  The class file loads the \texttt{amsmath} and \texttt{mathtools} packages. Further, the \texttt{newtxmath} package used for the math fonts includes many additional features.
@@ -278,7 +276,7 @@
 
 The \texttt{booktabs} package \cite{fear} is loaded (and customized) to provide versions of \verb|\toprule|, \verb|\midrule|, and \verb|\bottomrule}| appropriate to ASME-style tables.
 
-Table~\ref{tab:4} shows a table that spans both text columns. Figure~\ref{fig:2} shows a figure spanning both columns.
+Table~\ref{tab:4} shows a table that spans both text columns. Figure~\ref{fig:2} shows a figure spanning both columns. Two column tables and figures will always float to the top of a later page. Subframes in figures, such as  Fig.~\ref{fig:interior-region}, may be referenced individually.
 
 Text in the figures should be checked for legibility at either single-column width (about 83~mm) or full-column width (about 170~mm).  Figure captions should be placed below figures. Images in figures are handled by the standard \texttt{graphicx} package.
 
@@ -332,27 +330,32 @@
 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 \section{Reference Formatting with \texttt{asmejour.bst}}
 
-The {\upshape\texttt{asmejour.bst}} \hologo{BibTeX} style follows the reference styles observed in ASME journals in 2019. The vast majority of published references are to journal papers and books. Examples for these and many other cases 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 early 2020. 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{Hyperlinked Titles} If an \verb|@article{..| or \verb|@book{..| includes \verb|doi={..}|, the journal title will be hyperlinked to that doi number, and the doi number will not be printed. If no doi is included, but a url is included, then the title will be hyperlinked to that url. To display the doi (or the url when no doi is given), put it into the \verb|note={..}| field:
+\subsection{Hyperlinked Titles and Numbers} When the entries \verb|@article{..|, \verb|@book{..|, \verb|@inbook{..|, \verb|@incollection{..|, \verb|@proceedings{..|, or \verb|@techreport{..| include \verb|doi={..}|, the document title, paper number, or report number will be hyperlinked to that doi number, and the doi number will not be printed. If no doi is included, but a url or eprint is included, then the title will be hyperlinked to that url or eprint. To display the doi (or the url or eprint when no doi is given), put it into the \verb|note={..}| field (using \verb|\doi{..| or \verb|\url{..| ):
 \begin{quote}
 \verb|note = {\doi{10.1115/1.4042912}}|
 \end{quote}
 Include doi numbers in references whenever possible.
 
-Elementary support for \texttt{eprint} numbers is also included, generating a url at the end of the citation. The \texttt{archive} type may be specified using the macros \texttt{arxiv, googlebooks, hndl, jstore}, or \texttt{pubmed} (e.g., \texttt{archive=hndl},  \textit{without} braces). Both \texttt{eprint} and \texttt{archive} fields \textit{must} be given. Other root urls may be invoked using \verb|archive = {http://another.url.org/}|.
+\subsection{eprint Support} Elementary support for \texttt{eprint} numbers is included, either hyperlinking or generating a url at the end of the citation. The \texttt{archive} type may be specified using the macros \texttt{arxiv, googlebooks, hndl, jstore, oclc}, or \texttt{pubmed} (e.g., \texttt{archive=hndl},  \textit{without} braces). Both \texttt{eprint} and \texttt{archive} fields \textit{must} be given. Other root urls may be invoked using \verb|archive = {http://another.url.org/}|.
 
-\subsection{Online Sources} A bibliography field \verb|@online{..| is included for citation of online sources, such as web pages. See the examples of use in the \texttt{asmejour-sample.bib} file. 
+\subsection{Online Sources} A bibliography field \verb|@online{..| is included for citation of online sources, such as web pages. A \texttt{url}, \texttt{doi}, or \texttt{eprint} with \texttt{archive} should be included. See the examples of use in the \texttt{asmejour-sample.bib} file. 
 
 \subsection{Date Accessed} The \verb|urldate={..}| field may be used to provide the date on which a given url was accessed. By default, the text printed will be \texttt{accessed `date',}. The word ``accessed'' may be changed using the \verb|urltype={..}| field.
 
-\subsection{Conference Location and Date} For the entry types \verb|@inproceeedings{..| and \verb|@proceeedings{..|, you may include \verb|venue={..}| and \verb|eventdate={..}| to specify the city and the date of a conference. 
+\subsection{Conference Location and Date} For the entry types \verb|@inproceeedings{..| and \verb|@proceeedings{..|, you may include \verb|venue={..}| and \verb|eventdate={..}| to specify the city and the date of a conference. Omit \verb|address={..}| if \verb|venue={..}| is used.
 
 \subsection{Version Number\protect\footnote{Footnotes can appear in \texttt{\string\section} commands. However, when the \texttt{[lineno]} option is used either: i) write \texttt{\string\protect\string\footnote\{..\}}; or ii) include the optional argument, as in \texttt{\string\section[Foo]\{Foo\string\footnote\{..\}\}}.\label{ftnt:3}}} 
-The \verb|version={..}| field may be used with \verb|@book|, \verb|@online|, and \verb|@manual|. By default, the text will read \texttt{Version `number'} as in \cite{sharpe1,sharpe2},  but different wording may be selected using the \verb|versiontype={..}| field, to have ``Revision''  or something similar, as in \cite{GSL}. ASME often puts the version in the title, as in \cite{dlmf, texshop}, so I've left the final decision for discussion between the authors and the copy editor.
+The \verb|version={..}| field may be used with \verb|@book|, \verb|@online|, and \verb|@manual|. By default, the text will read \texttt{Version `number'} as in Refs.~\cite{sharpe1,sharpe2},  but different wording may be selected using the \verb|versiontype={..}| field, to have ``Revision''  or something similar, as in Ref.~\cite{GSL}. ASME often puts the version in the title, as in Refs.~\cite{dlmf, texshop}, so I've left the final decision for discussion between the authors and the copy editor.
 
+\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.
+%(ASME capitalizes ``With'', but not other prepositions).
 
+\subsection{Articles in Collections} In addition to the standard entry, \verb|@incollection{..|, an entry  \verb|@inserialcollection{..| is defined for serials in which each volume has a different title. See the \texttt{asmejour-sample.bib} file for discussion and compare Ref.~\cite{clauser56} to Ref.~\cite{DKE70}.
+
+
 %%%%%%%%%%%%%%% begin more complicated table %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 
 \begin{table}[t]
@@ -377,12 +380,14 @@
 \section{Additional Options for \texttt{asmejour.cls}}
 The class accepts a number of options in addition to those already described.
 
+\subsection{Lists of Figures and Tables} A list of figures and a list of tables are generated automatically as the last page.  To omit these lists, use the option \texttt{[nolists]}.
+
 \subsection{Final Column Balancing} The option \texttt{[balance]} invokes the the \texttt{flushend} package~\cite{tolusis}.
 This package will attempt to give equal height to the two columns on the last page. The performance of this package is sometimes inconsistent (with odd page layout or, very rarely, errors), so use this option with caution.
 
 \subsection{Line Numbers} The option \texttt{[lineno]} invokes the the \texttt{lineno} package~\cite{bottcher}.  This will produce line numbers in the margins. You must run \LaTeX\ twice for proper placement of the numbers. The \texttt{lineno} package is not compatible with the \texttt{flushend} package that makes final short columns the same height. Balancing is disabled when this option is called. See the documentation of the \texttt{lineno} package for further commands to control line numbering. See footnote~\ref{ftnt:3} with regard to footnotes in section headings while this option is in~effect. The abstract, tables, captions, and footnotes will not be numbered.
 
-\subsection{Changing the Footer Text} The option \texttt{[nofoot]} will omit everything other than a page number from the page footer.  The option \texttt{nocopyright} will omit the ASME copyright from the first page footer. The command \verb|\PreprintString{..}| replaces the words \textsf{PREPRINT FOR REVIEW}. The left and right preprint strings can be changed separately using an optional argument: \verb|\PreprintString{..}[L]| and \verb|\PreprintString{..}[R]|.
+\subsection{Changing the Footer Text}\label{sec:footer} The option \texttt{[nofoot]} will omit everything other than a page number from the page footer.  The option \texttt{nocopyright} will omit the ASME copyright from the first page footer. The command \verb|\PreprintString{..}| replaces the words \textsf{PREPRINT FOR REVIEW}. The left and right preprint strings can be changed separately using an optional argument: \verb|\PreprintString{..}[L]| and \verb|\PreprintString{..}[R]|.
 The final paper number may be added to the page number using \verb|\PaperNumber{..}|.
 
 The footers are all generated with the \texttt{fancyhdr} package~\cite{oostrum}, so you can change them in any way you like using the commands of that package. 
@@ -389,6 +394,9 @@
 
 \subsection{Superiors Font} The \texttt{newtxtext} package includes a superiors font (both numbers and letters) for use in footnote markers and superscripts. To enable this font, use the option \texttt{[nodefaultsups]}. The corresponding author mark in the author block will not change.
 
+\subsection{Vertical Space on Title Page} The space between the author/title/abstract block and the main text defaults to 12.5~mm. Infrequently, a different value may be desirable.  The space can be changed using \verb|\AbstractSep{..}|, where the argument is a \LaTeX\ dimension with units (e.g., 5mm).
+
+
 %%%%%%%%%%%%%%%%%%%  begin linewidth table  %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 
 \begin{table}[t]
@@ -409,24 +417,7 @@
 %%%%%%%%%%%%%%%%%%%%  end linewidth table %%%%%%%%%%%%%%%%%%%%%%%
 
 
-%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
-%% Dealing with complicated math in a section heading: optional argument of \section provides the pdfbookmark
-%%   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.
-%%
-\section[Math in a Section Heading: \omega\cdot U=0]{Math in a Section Heading: $\hat{\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:
-\begin{quote}\raggedright
-\verb|\section*[Math in a Section Heading:| 
-\hspace*{1em}\verb|\omega\cdot U=0]{Math in a Section Heading:|
-\hspace*{1em}\verb|$\hat{\upomega}\cdot\hat{\mathrm{U}}=0$}|
-\end{quote}
-Note that bookmarks can include simple math. Also note that \texttt{newtxmath} provides the option to obtain upright Greek letters as \verb|\upomega| (vs.\ \verb|\omega|), etc.
-
-
-
 %%%%%%%%%%%%%%% begin two column table %%%%%%%%%%%%%%%%%% 
 \begin{table*}[t]
 \caption{A table spanning two columns}\label{tab:4}%
@@ -459,6 +450,23 @@
 %%%%%%%%%%%%%%%% end two column table %%%%%%%%%%%%%%%%%%% 
 
 
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%% Dealing with complicated math in a section heading: optional argument of \section provides the pdfbookmark
+%%   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.
+%%
+\section[Math in a Section Heading: \omega\cdot U=0]{Math in a Section Heading: $\hat{\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:
+\begin{quote}\raggedright
+\verb|\section*[Math in a Section Heading:| 
+\hspace*{1em}\verb|\omega\cdot U=0]{Math in a Section Heading:|
+\hspace*{1em}\verb|$\hat{\upomega}\cdot\hat{\mathrm{U}}=0$}|
+\end{quote}
+Note that bookmarks can include simple math. Also note that \texttt{newtxmath} provides the option to obtain upright Greek letters as \verb|\upomega| (vs.\ \verb|\omega|), etc.
+
+
 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 \section{Summary}
 The class \texttt{asmejour} and associated files are for typesetting preprints in the style of ASME journals.
@@ -547,11 +555,11 @@
 users who may wish to include other languages. Options are supported to load a primary language, \texttt{lang=}, as well
 as a secondary and tertiary language, \texttt{lang-second} and \texttt{lang-third}.  The primary language must be given as the \textit{last} language option in  \verb|\documentclass|.  
 
-If no language option is given, the package defaults to English. The standard caption and section names will follow \texttt{babel}'s dictionary for primary languages other than English.  Users may additionally change ``Keywords'', ``Nomenclature'', and  ``Corresponding author'' by renewing the commands \verb|\keywordname|, \verb|\nomname|, and \verb|\CAwords|. Changes to the page footer were described earlier. The pdf bookmark for ``Appendices'' by be changed by renewing \verb|\appendicesname|.
+If no language option is given, the package defaults to English. The standard caption and section names will follow \texttt{babel}'s dictionary for primary languages other than English.  Users may additionally change ``Keywords'', ``Nomenclature'', and  ``Corresponding author'' by renewing the commands \verb|\keywordname|, \verb|\nomname|, and \verb|\CAwords|. Changes to the page footer were described in Sec.~\ref{sec:footer}. The pdf bookmark for ``Appendices'' by be changed by renewing \verb|\appendicesname|.
 
 An example of use is shown in \selectlanguage{french}\appendixname\ \ref{app:fourier}.\selectlanguage{english}
 
-Font encoding is set to T1 with utf-8 input supported: 
+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.}
 àáâäæãåā  èéęëêēė  îïíīįì ôöòóœøōõ ûüùúū çćč ł ñń ßśš ÿ žźż
@@ -560,9 +568,12 @@
 
 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 \selectlanguage{french}
-\section{Joseph Fourier}\label{app:fourier}
+\section{Discours Préliminaire de Fourier}\label{app:fourier}
 
-Joseph Fourier est connu pour avoir déterminé, par le calcul, la diffusion de la chaleur en utilisant la décomposition d'une fonction quelconque en une série trigonométrique convergente. De telles fonctions sont appelées séries de Fourier. La méthode de calcul permettant de passer, de façon réversible, d'une fonction à la série trigonométrique correspondante est la transformation de Fourier~\cite{fourierwiki}.
+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} 
 
 

Modified: trunk/Master/texmf-dist/tex/latex/asmejour/asmejour.cls
===================================================================
--- trunk/Master/texmf-dist/tex/latex/asmejour/asmejour.cls	2020-04-12 21:29:19 UTC (rev 54697)
+++ trunk/Master/texmf-dist/tex/latex/asmejour/asmejour.cls	2020-04-12 21:29:31 UTC (rev 54698)
@@ -6,9 +6,9 @@
 %%  The asmejour.cls file should be used with the files asmejour.bst (for citations) and asmejour-template.tex.
 %%
 %%
-%%  This file is version 1.11 dated 2020/02/29.
-		\def\versionno{1.11}
-		\def\versiondate{2020/02/29\space}
+%%  This file is version 1.12 dated 2020/04/12.
+		\def\versionno{1.12}
+		\def\versiondate{2020/04/12\space}
 %%
 %%  Author: John H. Lienhard V
 %%          Department of Mechanical Engineering
@@ -184,6 +184,7 @@
 % ASME's pdf pages are 11.25 in. tall, not 11.00 in.
 
 \RequirePackage[sort&compress,numbers]{natbib} 
+\AtBeginDocument{\def\NAT at space{\relax}}  % ASME puts no space between numerical references (4/5/20)
 \setlength\bibsep{0pt plus 1pt minus 0pt} % ASME keeps this tight
 \renewcommand*{\bibfont}{\footnotesize}
 
@@ -222,7 +223,7 @@
 \RequirePackage{mathtools} % extends amsmath
 \RequirePackage[]{babel}
 \RequirePackage[]{newtxtext} 
-\RequirePackage[varqu,varl]{inconsolata} % sans typewriter font
+\RequirePackage[]{inconsolata} % sans typewriter font % removed varl, varqu 2020/04/08 for unicode compatibility
 \RequirePackage[]{newtxmath}
 
 %% override \textsu if using default superiors
@@ -426,7 +427,16 @@
 \captionsetup[figure]{labelfont={sf,bf},textfont={sf,bf},textformat=boldmath,labelsep=quad}
 \captionsetup[table]{labelfont={sf,bf},textfont={sf,bf},textformat=boldmath,labelsep=quad,skip=0.5\baselineskip} 
 
+%% 4 April 2020. ASME only labels subfigures with a sans serif, italic (a), (b),... no caption text, no bold face.
+%% Could set labelfont={sf},textfont={sf}, and normal math version needed; but would need sans math... 
 
+\captionsetup[subfigure]{labelformat=simple} % default: =parens
+\renewcommand\thesubfigure{(\textit{\alph{subfigure}})}
+
+\captionsetup[subtable]{labelformat=simple} 
+\renewcommand\thesubtable{(\textit{\alph{subtable}})}
+
+
 %%%%%%%%%%%%  SECTION HEADINGS  %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 %% wish to accommodate hyperref
 
@@ -737,12 +747,16 @@
 
 %%%%%%%%%%
 
+\newlength{\@AbstractSep} %% <== separation of author/abstract coffin from main two-column text.
+\setlength{\@AbstractSep}{12.5mm}
+\NewDocumentCommand\AbstractSep{m}{\setlength{\@AbstractSep}{#1}}
+
 \DeclareDocumentCommand{\MakeTitlePage}{}{%
 \thispagestyle{title}%
 \twocolumn[
   \begin{@twocolumnfalse}
 \ConstructAuthorBlock
-  \vspace*{12.5mm}
+  \vspace*{\@AbstractSep} 
   \end{@twocolumnfalse} 
 ]
 \ifCA 



More information about the tex-live-commits mailing list.