enotez (1may13)

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

4 files changed, 213 insertions, 73 deletions

diff --git a/Master/texmf-dist/doc/latex/enotez/README b/Master/texmf-dist/doc/latex/enotez/README
index cc8ee808576..d2ec4b2c748 100644
--- a/Master/texmf-dist/doc/latex/enotez/README
+++ b/Master/texmf-dist/doc/latex/enotez/README
@@ -1,9 +1,9 @@
 --------------------------------------------------------------------------
-the ENOTEZ package v0.6
+the ENOTEZ package v0.7
 
   Endnotes for LaTeX2e
 
-2013/04/06
+2013/05/01
 --------------------------------------------------------------------------
 Clemens Niederberger
 Web:    https://bitbucket.org/cgnieder/enotez/
diff --git a/Master/texmf-dist/doc/latex/enotez/enotez_en.pdf b/Master/texmf-dist/doc/latex/enotez/enotez_en.pdf
index 258115463a1..89c6e1f0e4c 100644
--- a/Master/texmf-dist/doc/latex/enotez/enotez_en.pdf
+++ b/Master/texmf-dist/doc/latex/enotez/enotez_en.pdf
diff --git a/Master/texmf-dist/doc/latex/enotez/enotez_en.tex b/Master/texmf-dist/doc/latex/enotez/enotez_en.tex
index 91b9370e505..0e395984921 100644
--- a/Master/texmf-dist/doc/latex/enotez/enotez_en.tex
+++ b/Master/texmf-dist/doc/latex/enotez/enotez_en.tex
@@ -32,6 +32,7 @@
 % If you have any ideas, questions, suggestions or bugs to report, please
 % feel free to contact me.
 % --------------------------------------------------------------------------
+\PassOptionsToPackage{supstfm=libertinesups}{superiors}
 \documentclass[toc=bib,toc=index]{cnpkgdoc}
 \docsetup{
   pkg      = enotez ,
@@ -68,7 +69,7 @@
   textsuperscript,
   theendnote
 }
-\setenotez{mark-cs=\textsu}
+\setenotez{mark-cs=\textsu,backref}
 \DeclareInstance{enotez-list}{addsec}{paragraph}{heading=\addsec{#1}}
 
 % Layout:
@@ -218,7 +219,7 @@
  suffix_3p "\\nohyperpage{\\,ff.}"
 \end{filecontents*}
 \indexsetup{othercode=\footnotesize}
-\makeindex[options={-s \jobname.ist},intoc,columns=3]
+\makeindex[options={-s \jobname.ist},intoc,columns=3,columnsep=1em]
 
 \usepackage{kantlipsum}
 \usepackage{etoolbox}
@@ -241,6 +242,8 @@
   \@esphack}
 \makeatother
 
+\robustify\code
+
 \begin{document}
 
 \section{Licence and Requirements}\secidx{Licence}
@@ -407,8 +410,17 @@ or with the setup command.
  \Option{mark-cs}{<command>}\Default{\cmd{textsuperscript}}
    Lets \cmd{enotezwritemark} to be equal to \code{<command>}. This command is
    used to typeset the endnote marks in the text and should take one argument.
+ \Option{backref}{\default{true}|false}\Default{false}
+   \sinceversion{0.7}If set to \code{true} and \paket{hyperref} has been loaded
+   backlinks from the notes in the list to the marks in the text are added.
  \Option{totoc}{section|chapter|false}\Default{false}
    Add an entry to the table of contents.
+ \Option{list-heading}{<sectioning command including argument>}\newline
+   You can use this option to manually set the list heading command, \textit{e.g.},
+   \key{list-heading}{\cmd{chapter}{\#1}} for a numbered heading. The default
+   depends upon if the class you're using provides \cmd{chapter} or not. It
+   either uses \cmd{chapter}* or \cmd{section}*. You can see that you have to
+   refer to the actual heading with \code{\#1}.
  \Option{list-style}{<style>}\Default{plain}
    Sets the default list style, see section \ref{ssec:customizing_the_list} for
    details.
@@ -525,11 +537,18 @@ You'll need to tell \enotez that you want to split the notes into groups.
  \Option{split}{section|chapter|false}\Default{false}
    Enable the automatic splitting.
  \Option{split-sectioning}{<csname>}\Default{}
+   \emph{This option is deprecated and may be dropped in future versions!}
    The command that is used to display the titles between the splits. It needs
    to be a command that takes one argument and should be entered without the
    leading backslash. If the option is not used \enotez will choose
    \code{subsection*} for \key*{split}{section} and \code{section*} for
    \key*{split}{chapter}.
+ \Option{split-heading}{<sectioning command including argument>}\newline
+   \sinceversion{0.3}The command that is used to display the titles between the
+   splits. It is entered with argument and the actual title is referred to with
+   \code{\#1}, \textit{e.g.}, \key{split-heading}{\cmd{subsection}*{\#1}}. If
+   the option is not used \enotez will choose \cmd{subsection}*{\#1} for
+   \key*{split}{section} and \cmd{section}*{\#1} for \key*{split}{chapter}.
  \Option{split-title}{<tokenlist>}\Default{Notes for <name> <ref>}
    The title that will be inserted between the splits. \code{<name>} is replaced
    by \code{section} for \key*{split}{section} and \code{chapter} for
@@ -559,6 +578,18 @@ Please beware that the option \key{reset} also impacts here: the numbing will
 be reset for each section or chapter, depending on the choice you made for
 \key{split}.
 
+\sinceversion{0.7}There are two -- or three, actually -- additional commands:
+\begin{beschreibung}
+ \Befehl{AtEveryListSplit}{<code>}\newline
+   Inserts \code{<code>} before each sub-heading in a splitted list.
+ \Befehl{AfterEveryListSplit}{<code>}\newline
+   Inserts \code{<code>} after each sub-heading in a splitted list.
+ \Befehl{EnotezCurrentSplitTitle}\newline
+   Holds the current sub-heading in a splitted list and may be used in
+   \cmd{AtEveryListSplit} and \cmd{AfterEveryListSplit}.
+\end{beschreibung}
+
+
 \enotez comes with an example document for a split list which you should
 find in the same folder as this documentation.
 \secidx*{Options}
@@ -589,7 +620,9 @@ If \paket{hyperref} is loaded and you are using the option \key{totoc} (see
 p~\pageref{key:totoc}) the list title is linked via a \verb=\phantomsection=.
 
 If \paket{hyperref} is used with \code{hyperfootnotes} set to \code{true} the
-endnote marks are linked to the respective entries in the list.
+endnote marks are linked to the respective entries in the list\changedversion{0.7}.
+If you also set \enotez' option \key{backref} (see p~\pageref{key:backref}) the
+notes in the list are themselves linked to the marks in the text.
 \secidx*{\paket*{hyperref} Support}[hyperref Support]
 
 \AtNextEndnotesList{This is an example of a preamble to the list set with
diff --git a/Master/texmf-dist/tex/latex/enotez/enotez.sty b/Master/texmf-dist/tex/latex/enotez/enotez.sty
index 07a6666c1fa..f3bcac7068e 100644
--- a/Master/texmf-dist/tex/latex/enotez/enotez.sty
+++ b/Master/texmf-dist/tex/latex/enotez/enotez.sty
@@ -31,11 +31,25 @@
 \RequirePackage{ expl3 , xparse , l3keys2e , xtemplate , etoolbox , xpatch , scrlfile }
 \ProvidesExplPackage
   {enotez}
-  {2013/04/06}
-  {0.6}
+  {2013/05/01}
+  {0.7}
   {Endnotes for LaTeX2e}
 
 % --------------------------------------------------------------------------
+% check expl3 version:
+\@ifpackagelater { expl3 } { 2012/11/21 }
+  { }
+  {
+    \PackageError { enotez } { Support~package~expl3~too~old }
+      {
+        You~need~to~update~your~installation~of~the~bundles~'l3kernel'~and~
+        'l3packages'.\MessageBreak
+        Loading~enotez~will~abort!
+      }
+    \tex_endinput:D
+  }
+
+% --------------------------------------------------------------------------
 % messages
 \msg_new:nnnn { enotez } { captions }
   { Endnotes~might~not~work~in~captions. }
@@ -45,6 +59,24 @@
     will~work~then.
   }
 
+
+\msg_new:nnnn { enotez } { deprecated }
+  { The~#1~`#2'~is~deprecated.~Use~`#3'~instead~\msg_line_context:. }
+  {
+    The~#1~`#2'~you~used~\msg_line_context: \c_space_tl is~deprecated~and~has~
+    been~replaced~by~`#3'.~Since~I~will~not~guarantee~that~#1~will~be~kept~
+    forever~I~encourage~you~to~switch.
+  }
+
+\cs_new:Npn \enotez_option_deprecated:nn #1#2
+  { \msg_warning:nnnnn { enotez } { deprecated } { option } { #1 } { #2 } }
+
+\cs_new:Npn \acro_command_deprecated:NN #1#2
+  {
+    \msg_warning:nnnnn { enotez } { deprecated } { command }
+      { \token_to_str:N #1 } { \token_to_str:N #2 }
+  }
+
 % --------------------------------------------------------------------------
 % variables:
 \bool_new:N \l__enotez_print_note_bool
@@ -52,6 +84,7 @@
 \bool_new:N \l__enotez_totoc_bool
 \bool_new:N \l__enotez_hyperref_bool
 \bool_new:N \l__enotez_hyperfootnotes_bool
+\bool_new:N \l__enotez_hyperbackref_bool
 \bool_new:N \l__enotez_split_bool
 \bool_new:N \l__enotez_caption_patched_bool
 \bool_new:N \l__enotez_koma_patched_bool
@@ -81,6 +114,8 @@
 \tl_new:N   \g__enotez_list_every_preamble_tl
 \tl_new:N   \g__enotez_list_next_postamble_tl
 \tl_new:N   \g__enotez_list_every_postamble_tl
+\tl_new:N   \g__enotez_split_list_preamble_tl
+\tl_new:N   \g__enotez_split_list_postamble_tl
 \tl_new:N   \l__enotez_footnotes_tl
 
 \skip_new:N \l__enotez_list_preamble_skip
@@ -109,6 +144,7 @@
 
 \keys_define:nn { enotez }
   {
+    backref          .bool_set:N         = \l__enotez_hyperbackref_bool ,
     footnotes        .bool_set:N         = \l__enotez_footnotes_tl ,
     list-name        .tl_set:N           = \l__enotez_list_name_tl ,
     reset            .bool_set:N         = \l__enotez_reset_bool ,
@@ -117,10 +153,8 @@
       \cs_set_eq:Nc \enotez_counter_format:n { int_to_ \l_keys_choice_tl :n } ,
     counter-format   .generate_choices:n =
       { arabic , alph , Alph , roman , Roman } ,
-    mark-format      .code:n             =
-      \cs_set:Npn \enmarkstyle { #1 } ,
-    mark-cs          .code:n             =
-      \cs_set:Npn \enotezwritemark { #1 } ,
+    mark-format      .code:n             = \cs_set:Npn \enmarkstyle { #1 } ,
+    mark-cs          .code:n             = \cs_set:Npn \enotezwritemark { #1 } ,
     totoc            .choice_code:n      =
       \tl_if_eq:VnTF \l_keys_choice_tl { false }
         { \bool_set_false:N \l__enotez_totoc_bool }
@@ -128,16 +162,20 @@
           \bool_set_true:N \l__enotez_totoc_bool
           \tl_set_eq:NN \l__enotez_totoc_tl \l_keys_choice_tl
         } ,
-    totoc            .generate_choices:n =
-      { section , chapter , false } ,
+    totoc            .generate_choices:n = { section , chapter , false } ,
+    list-heading     .code:n             =
+      \cs_set:Npn \enotezlistheading ##1 { #1 } ,
     split            .choice_code:n      =
       \tl_if_eq:VnTF \l_keys_choice_tl { false }
         { \bool_set_false:N \l__enotez_split_bool }
         { \bool_set_true:N \l__enotez_split_bool }
       \tl_set_eq:NN \l__enotez_split_tl \l_keys_choice_tl ,
-    split            .generate_choices:n =
-      { section , chapter , false } ,
-    split-sectioning .tl_set:N           = \l__enotez_splitted_list_sectioning_tl ,
+    split            .generate_choices:n = { section , chapter , false } ,
+    split-sectioning .code:n             =
+      \enotez_option_deprecated:nn { split-sectioning } { split-heading }
+      \l__enotez_splitted_list_sectioning_tl ,
+    split-heading    .code:n             =
+      \cs_set:Npn \enotezsplitlistheading ##1 { #1 } ,
     split-title      .tl_set:N           = \l__enotez_splitted_title_tl ,
     list-style       .tl_set:N           = \l__enotez_list_instance_tl ,
     list-preamble-skip .skip_set:N       = \l__enotez_list_preamble_skip ,
@@ -153,7 +191,14 @@
 \cs_new:Npn \enotez_write_mark:nn #1#2
   {
     \bool_if:NTF \l__enotez_hyperfootnotes_bool
-      { \enotezwritemark { \hyperlink { enz.#1 } { \enmarkstyle #2 } } }
+      {
+        \enotezwritemark { \hyperlink { enz.#1 } { \enmarkstyle #2 } }
+        \bool_if:NT \l__enotez_hyperbackref_bool
+          {
+            \box_move_up:nn { 1em }
+              { \hbox:n { \hypertarget { enz.#1.backref } { } } }
+          }
+      }
       { \enotezwritemark { \enmarkstyle #2 } }
   }
 
@@ -362,11 +407,18 @@
 
 % --------------------------------------------------------------------------
 % the list of notes
+\cs_if_exist:cTF { chapter }
+  { \cs_new:Npn \enotezlistheading { \chapter* } }
+  { \cs_new:Npn \enotezlistheading { \section* } }
+
+\cs_new:Npn \enotezsplitlistheading
+  { \use:c { \l__enotez_splitted_list_sectioning_tl } }
+
 \DeclareObjectType { enotez-list } { 1 }
 
 \DeclareTemplateInterface { enotez-list } { paragraph } { 1 }
   {
-    heading       : function 1 = \section*{#1}   ,
+    heading       : function 1 = \enotezlistheading{#1}   ,
     format        : tokenlist  = \footnotesize   ,
     number        : function 1 = \enmark{#1}     ,
     number-format : tokenlist  = \normalfont     ,
@@ -390,8 +442,6 @@
       }
     \enotez_list_heading:n { \l__enotez_list_name_tl }
     \enotez_list_preamble:
-    \group_begin:
-      \tl_use:N \l__enotez_list_format_tl
       \int_zero:N \l__enotez_tmpa_int
       \int_do_while:nn { \l__enotez_tmpa_int <= \g__enotez_list_printed_int }
         {
@@ -406,24 +456,16 @@
                   \bool_if:NT \l__enotez_print_note_bool
                     {
                       \par\noindent
+                      \group_begin:
+                      \tl_use:N \l__enotez_list_format_tl
                       \llap
                         {
                           \enotez_list_number:n
-                            {
-                              \bool_if:NT \l__enotez_hyperfootnotes_bool
-                                {
-                                  \box_move_up:nn { 1em }
-                                    { \hbox:n { \hypertarget { enz.##1 } { } } }
-                                }
-                              \tl_use:N \l__enotez_list_number_format_tl
-                              \tl_if_eq:nxTF { a }
-                                { \prop_get:Nn \g__enotez_endnote_man_prop { ##1 } }
-                                { \enotez_counter_format:V \l__enotez_endnote_mark_tl }
-                                { \tl_use:N \l__enotez_endnote_mark_tl }
-                            }
+                            { \enotez_write_list_number:n { ##1 } }
                           \tl_use:N \c_space_tl
                         }
                       \tl_use:N \l__enotez_endnote_text_tl
+                      \group_end:
                     }
                 }
               \par
@@ -432,13 +474,12 @@
             }
           \int_incr:N \l__enotez_tmpa_int
         }
-    \group_end:
     \enotez_list_postamble:
   }
 
 \DeclareTemplateInterface { enotez-list } { list } { 1 }
   {
-    heading       : function 1 = \section*{#1} ,
+    heading       : function 1 = \enotezlistheading{#1} ,
     format        : tokenlist  = \footnotesize ,
     number        : function 1 = \enmark{#1}   ,
     number-format : tokenlist  = \normalfont   ,
@@ -462,8 +503,6 @@
       }
     \enotez_list_heading:n { \l__enotez_list_name_tl }
     \enotez_list_preamble:
-    \group_begin:
-      \tl_use:N \l__enotez_list_format_tl
       \int_zero:N \l__enotez_tmpa_int
       \int_do_while:nn { \l__enotez_tmpa_int <= \g__enotez_list_printed_int }
         {
@@ -477,7 +516,9 @@
               \tl_if_blank:VF \l__enotez_tmpc_tl
                 {
                   \enotez_get_split_title:n { ##1 }
-                  \begin{\l__enotez_list_type_tl}
+                  \group_begin:
+                    \tl_use:N \l__enotez_list_format_tl
+                    \begin{\l__enotez_list_type_tl}
                 }
               \tl_if_eq:xxT
                 { \int_use:N \l__enotez_tmpa_int }
@@ -489,27 +530,16 @@
                       \item
                         [
                           \enotez_list_number:n
-                            {
-                              \bool_if:NT \l__enotez_hyperfootnotes_bool
-                                {
-                                  \box_move_up:nn { 1em }
-                                    { \hbox:n { \hypertarget { enz.##1 } { } } }
-                                }
-                              \tl_use:N \l__enotez_list_number_format_tl
-                              \tl_if_eq:nxTF { a }
-                                { \prop_get:Nn \g__enotez_endnote_man_prop { ##1 } }
-                                { \enotez_counter_format:V \l__enotez_endnote_mark_tl }
-                                { \tl_use:N \l__enotez_endnote_mark_tl }
-                            }
+                            { \enotez_write_list_number:n { ##1 } }
                         ]
                       \tl_use:N \l__enotez_endnote_text_tl
                     }
                 }
-              \tl_if_blank:VF \l__enotez_tmpc_tl { \end{\l__enotez_list_type_tl} }
+              \tl_if_blank:VF \l__enotez_tmpc_tl
+                { \end{\l__enotez_list_type_tl} \group_end: }
             }
           \int_incr:N \l__enotez_tmpa_int
         }
-    \group_end:
     \enotez_list_postamble:
   }
 
@@ -518,25 +548,38 @@
 \DeclareInstance { enotez-list } { description } { list } {  }
 \DeclareInstance { enotez-list } { itemize } { list } { list-type = itemize }
 
-% the titles in between the splits:
-\cs_new_protected:Npn \enotez_read_splitted_title:nn #1#2
+% --------------------------------------------------------------------------
+% write the mark in the lists:
+\cs_new_protected:Npn \enotez_write_list_number:n #1
   {
-    \group_begin:
-      \tl_set:Nn \l__enotez_tmpa_tl { #1 }
-      \tl_replace_all:Nnx \l__enotez_tmpa_tl { <name> }
-        { \l__enotez_actual_sectioning_tl }
-      \tl_replace_all:Nnx \l__enotez_tmpa_tl { <ref> }
-        { \prop_get:Nn \g__enotez_endnote_sect_prop { #2 } }
-      \tl_gset_eq:NN \l__enotez_tmpb_tl \l__enotez_tmpa_tl
-    \group_end:
+    \bool_if:NT \l__enotez_hyperfootnotes_bool
+      { \box_move_up:nn { 1em } { \hbox:n { \hypertarget { enz.#1 } { } } } }
+    \tl_use:N \l__enotez_list_number_format_tl
+    \tl_if_eq:nxTF { a }
+      { \prop_get:Nn \g__enotez_endnote_man_prop { #1 } }
+      {
+        \bool_if:nTF
+          { \l__enotez_hyperfootnotes_bool && \l__enotez_hyperbackref_bool }
+          {
+            \exp_args:Nnx
+            \hyperlink { enz.#1.backref }
+              { \enotez_counter_format:V \l__enotez_endnote_mark_tl }
+          }
+          { \enotez_counter_format:V \l__enotez_endnote_mark_tl }
+      }
+      {
+        \bool_if:nTF
+          { \l__enotez_hyperfootnotes_bool && \l__enotez_hyperbackref_bool }
+          {
+            \exp_args:Nnx
+            \hyperlink { enz.#1.backref }
+              { \tl_use:N \l__enotez_endnote_mark_tl }
+          }
+          { \tl_use:N \l__enotez_endnote_mark_tl }
+      }
   }
-\cs_generate_variant:Nn \enotez_read_splitted_title:nn { V , x }
-\cs_generate_variant:Nn \tl_replace_all:Nnn { Nnx }
-
-\cs_new_protected:Npn \enotez_first_upper:n #1
-  { \tl_to_uppercase:n { \tl_head:n { #1 } } \tl_tail:n { #1 } }
-\cs_generate_variant:Nn \enotez_first_upper:n { V }
 
+% --------------------------------------------------------------------------
 % determine which note's next:
 \cs_new_protected:Npn \enotez_get_note:nn #1#2
   {
@@ -567,6 +610,26 @@
       }
   }
 
+% --------------------------------------------------------------------------
+% the titles in between the splits:
+\cs_new_protected:Npn \enotez_read_splitted_title:nn #1#2
+  {
+    \group_begin:
+      \tl_set:Nn \l__enotez_tmpa_tl { #1 }
+      \tl_replace_all:Nnx \l__enotez_tmpa_tl { <name> }
+        { \l__enotez_actual_sectioning_tl }
+      \tl_replace_all:Nnx \l__enotez_tmpa_tl { <ref> }
+        { \prop_get:Nn \g__enotez_endnote_sect_prop { #2 } }
+      \tl_gset_eq:NN \l__enotez_tmpb_tl \l__enotez_tmpa_tl
+    \group_end:
+  }
+\cs_generate_variant:Nn \enotez_read_splitted_title:nn { V , x }
+\cs_generate_variant:Nn \tl_replace_all:Nnn { Nnx }
+
+\cs_new_protected:Npn \enotez_first_upper:n #1
+  { \tl_to_uppercase:n { \tl_head:n { #1 } } \tl_tail:n { #1 } }
+\cs_generate_variant:Nn \enotez_first_upper:n { V }
+
 \cs_new_protected:Npn \enotez_get_split_title:n #1
   {
     \prop_get:NnN \g__enotez_endnote_split_prop { #1 } \l__enotez_tmpa_tl
@@ -580,19 +643,23 @@
             \enotez_read_splitted_title:xn
               { \l__enotez_splitted_title_tl }
               { #1 }
+            \cs_set_eq:NN \EnotezCurrentSplitTitle \l__enotez_tmpb_tl
+            \enotez_split_list_preamble:
             \tl_if_blank:VTF \l__enotez_splitted_list_sectioning_tl
               {
                 \tl_if_eq:VnTF \l__enotez_split_tl { section }
                   { \subsection* }
                   { \section* }
               }
-              { \use:c { \l__enotez_splitted_list_sectioning_tl } }
-            { \exp_not:V \l__enotez_tmpb_tl }
+              { \enotezsplitlistheading }
+            { \exp_not:V \EnotezCurrentSplitTitle }% this is the argument to the sectioning command
+            \enotez_split_list_postamble:
           }
       }
     \prop_get:NnN \g__enotez_endnote_split_prop { #1 } \l__enotez_tmpb_tl
   }
 
+% --------------------------------------------------------------------------
 % the marks in the list:
 \cs_new:Npn   \enmark #1 { #1 . }
 
@@ -600,6 +667,7 @@
 \cs_new:Npn   \enmarkstyle { }
 \cs_new_eq:NN \enotezwritemark \textsuperscript
 
+% --------------------------------------------------------------------------
 % internal printendnotes:
 \cs_new_protected:Npn \enotez_print_endnotes:nn #1#2
   {
@@ -675,19 +743,53 @@
 \cs_new_protected:Npn \enotez_set_every_postamble:n #1
   { \tl_gset:Nn \g__enotez_list_every_postamble_tl { #1 } }
 
-\NewDocumentCommand \AtNextEndnotesList { m }
+\NewDocumentCommand \AtNextEndnotesList { +m }
   { \enotez_set_next_preamble:n { #1 } }
 
-\NewDocumentCommand \AtEveryEndnotesList { m }
+\NewDocumentCommand \AtEveryEndnotesList { +m }
   { \enotez_set_every_preamble:n { #1 } }
 
-\NewDocumentCommand \AfterNextEndnotesList { m }
+\NewDocumentCommand \AfterNextEndnotesList { +m }
   { \enotez_set_next_postamble:n { #1 } }
 
-\NewDocumentCommand \AfterEveryEndnotesList { m }
+\NewDocumentCommand \AfterEveryEndnotesList { +m }
   { \enotez_set_every_postamble:n { #1 } }
 
 % --------------------------------------------------------------------------
+% preamble and postamble to the sub-headings in a splitted list:
+\cs_new_protected:Npn \enotez_split_list_preamble:
+  {
+    \tl_if_empty:NF \g__enotez_split_list_preamble_tl
+      {
+        \par
+        \tl_use:N \g__enotez_split_list_preamble_tl
+      }
+  }
+
+\cs_new_protected:Npn \enotez_split_list_postamble:
+  {
+    \tl_if_empty:NF \g__enotez_split_list_postamble_tl
+      {
+        \tl_use:N \g__enotez_split_list_postamble_tl
+        \par
+      }
+  }
+
+\cs_new_protected:Npn \enotez_set_every_split_preamble:n #1
+  { \tl_gset:Nn \g__enotez_split_list_preamble_tl { #1 } }
+
+\cs_new_protected:Npn \enotez_set_every_split_postamble:n #1
+  { \tl_gset:Nn \g__enotez_split_list_postamble_tl { #1 } }
+
+\NewDocumentCommand \AtEveryListSplit { +m }
+  { \enotez_set_every_split_preamble:n { #1 } }
+
+\NewDocumentCommand \AfterEveryListSplit { +m }
+  { \enotez_set_every_split_postamble:n { #1 } }
+
+\cs_new:Npn \EnotezCurrentSplitTitle {}
+
+% --------------------------------------------------------------------------
 % process the options:
 \ProcessKeysOptions { enotez }
 
@@ -809,6 +911,11 @@
 2013/03/18 v0.5a - adapt to deprecated expl3 commands
 2013/04/06 v0.6  - \endnote sets \@currentlabel so endnotes can be referenced
                    with \label{} and \ref{}
+2013/05/01 v0.7  - new option `backref' adds links from the notes in the list
+                   back to the notes in the text (needs `hyperref' loaded)
+                 - new: \AtEveryListSplit, \AfterEveryListSplit,
+                   \EnotezCurrentSplitTitle
+                 - new option: `list-heading'
 
 % --------------------------------------------------------------------------
 % TODO: