Updated the template for Pandoc and slightly improved the manual

CHANGELOG.md

@@ -5,3 +5,8 @@
 ### 2023/02/20: Version 1.0.1
 
 `\crossrefenum` is now protected against early expansion.
+
+### 2023/02/20: Version 1.0.2
+
+Fixed some minor issues in version numbers and in the manual.
+

README.md

@@ -1,8 +1,8 @@
-# crossrefenum 2023/02/20 v1.0.1
+# crossrefenum 2023/02/20 v1.0.2
 
 Smart typesetting of enumerated cross-references for various TeX formats.
 
-Copyright (C) 2022
+Copyright (C) 2022-2023
 by Bastien Dumont <bastien.dumont@posteo.net>
 
 CTAN: `macros/generic/crossrefenum`
@@ -66,7 +66,7 @@ and put in it `crossrefenum.tex` and, if required,
 
 ## License
 
-Copyright 2022 by Bastien Dumont (bastien.dumont@posteo.net)
+Copyright 2022-2023 by Bastien Dumont (bastien.dumont@posteo.net)
  
 crossrefenum.tex is free software: you can redistribute it and/or modify
 it under the terms of the GNU General Public License as published by

doc/Makefile

@@ -1,6 +1,9 @@
-crossrefenum.pdf: crossrefenum.md ../CHANGELOG.md \
+crossrefenum.pdf: crossrefenum-doc.tex
-				TEMPLATE_crossrefenum.context fixes.lua
+	context $< && mv crossrefenum-doc.pdf $@
-	pandoc -o crossrefenum.pdf --pdf-engine=context \
+
+crossrefenum-doc.tex: crossrefenum.md ../CHANGELOG.md \
+					TEMPLATE_crossrefenum.context fixes.lua
+	pandoc -s -o $@ -t context \
 		--template=TEMPLATE_crossrefenum.context \
 		-L fixes.lua \
 		crossrefenum.md ../CHANGELOG.md

doc/TEMPLATE_crossrefenum.context

@@ -88,6 +88,10 @@ intent=ISO coated v2 300\letterpercent\space (ECI)]
 \setuplist[subsection][margin=3em, width=3em]
 \setuplist[subsubsection][margin=6em, width=4em]
 
+$if(highlighting-commands)$
+$highlighting-commands$
+$endif$
+
 \starttext
 
 \starttitlepagemakeup
@@ -112,7 +116,7 @@ $endif$
 $if(license)$
 \startlicensepagemakeup
 \inframed[frame=off, width=0.66\textwidth, align=normal]{%
-  Copyright (C) 2022 Bastien Dumont.
+  Copyright (C) 2022-2023 Bastien Dumont.
   Permission is granted to copy, distribute and/or modify this document
   under the terms of the GNU Free Documentation License, Version 1.3
   or any later version published by the Free Software Foundation;

doc/crossrefenum.md

@@ -2,7 +2,7 @@
 title: "crossrefenum"
 subtitle: "Smart typesetting of enumerated cross-references for various TeX formats"
 author: Bastien Dumont
-date: 2022/11/11
+date: 2023/02/20
 lang: en-US
 toc: true
 license: true
@@ -230,7 +230,9 @@ if this feature were not already included in _crossrefenum_.
 \crfnm@newListFrom[\crfnm@doubleRefTypes][\crfnm@pageline] -> \crfnm@doubleRefTypes
 \crfnm@newListFrom[\crfnm@supportedTypes][\crfnm@line] -> \crfnm@supportedTypes
 \crfnm@newListFrom[\crfnm@supportedTypes][\crfnm@pageline] -> \crfnm@supportedTypes
+```
 
+```{.tex}
 %% For the double types, set the primary and the secondary type.
 %% The primary type corresponds to the widest typographic unit
 %% (“page” for “pagenote”, “section” for “sectionpage”...).
@@ -251,9 +253,11 @@ if this feature were not already included in _crossrefenum_.
 % Define all specific configuration options in the regular way.
 
 %% Required
-\def\crfnmLine{l. }
+\def\crfnmLine{l.~}
-\def\crfnmLines{ll.}
+\def\crfnmLines{ll.~}
+```
 
+```{.tex}
 %% If it differs from the defaults.
 \def\crfnmCollapsable{yes}
 \def\crfnmLineBeforeLastInSecond{, }
@@ -263,7 +267,7 @@ if this feature were not already included in _crossrefenum_.
 \def\crfnmLinePrintPrefixInSecond{no}
 ```
 
-Adding support to yet unsupported formats is far less trivial,
+Adding support for additional formats is far less trivial,
 not least because most of them do not provide a straightforward way
 to get reference numbers via purely expandable macros,
 which is required for _crossrefenum_ to perform its calculations.

release-to-CTAN.sh

@@ -18,6 +18,11 @@ check_files(){
 
 check_files
 
+cd doc
+make crossrefenum.pdf
+if [[ $? != 0 ]] ; then cd - ; exit 1 ; fi
+cd -
+
 if [[ -a crossrefenum.zip ]] ; then rm crossrefenum.zip ; fi
 mkdir crossrefenum
 cd crossrefenum

tex/crossrefenum.tex

@@ -3,9 +3,9 @@
 \def\crfnmShortDesc{Smart typesetting of enumerated cross-references for various TeX formats}
 \def\crfnmAuthor{Bastien Dumont}
 \def\crfnmDate{2023/02/20}
-\def\crfnmVersion{1.0.1}
+\def\crfnmVersion{1.0.2}
 %
-% Copyright 2022 by Bastien Dumont (bastien.dumont@posteo.net)
+% Copyright 2022-2023 by Bastien Dumont (bastien.dumont@posteo.net)
 %
 % crossrefenum.tex is free software: you can redistribute it and/or modify
 % it under the terms of the GNU General Public License as published by