Announce use of dpub-ARIA role "doc-footnote"

instead of ARIA role "note" for footnotes in Docutils 0.20.

Cf. [bugs:#450].

git-svn-id: https://svn.code.sf.net/p/docutils/code/trunk@9080 929543f6-e4f2-0310-98a6-ba3bd3dd1d04

2 files changed, 20 insertions, 15 deletions

diff --git a/docutils/RELEASE-NOTES.txt b/docutils/RELEASE-NOTES.txt
index fe6ab1803..8bdeeaa15 100644
--- a/docutils/RELEASE-NOTES.txt
+++ b/docutils/RELEASE-NOTES.txt
@@ -36,10 +36,8 @@ Future changes
     ``[role="doc-noteref"]`` instead of ``.footnote-reference``
     (see minimal.css for examples).
 
-  - Remove option ``--embed-images`` (obsoleted by "image_loading_")
-    in Docutils 2.0.
-
-    .. _image_loading: docs/user/config.html#image-loading
+  - Use dpub-ARIA role "doc-footnote" (instead of ARIA role "note")
+    for footnotes in Docutils 0.20.
 
   - Move attribution behind the blockquote to comply with the `"living
     standard"`__. (HTML5__ allows <cite> elements inside a blockquote.)
@@ -48,6 +46,11 @@ Future changes
     __ https://www.w3.org/TR/2014/REC-html5-20141028/grouping-content.html
        #the-blockquote-element
 
+  - Remove option ``--embed-images`` (obsoleted by "image_loading_")
+    in Docutils 2.0.
+
+    .. _image_loading: docs/user/config.html#image-loading
+
 * `latex2e` writer:
 
   - Change default of use_latex_citations_ setting to True
@@ -58,7 +61,7 @@ Future changes
 
   - Remove ``use_verbatim_when_possible`` setting
     (use literal_block_env_: verbatim) in Docutils 2.0.
-    
+
   - Do not insert ``\usepackage[utf8]{inputenc}`` into UTF-8 encoded
     LaTeX sources. UTF-8 is the default encoding for LaTeX2e since 2018.
 
diff --git a/docutils/docs/ref/doctree.txt b/docutils/docs/ref/doctree.txt
index f16021629..14410a4ea 100644
--- a/docutils/docs/ref/doctree.txt
+++ b/docutils/docs/ref/doctree.txt
@@ -2263,23 +2263,25 @@ Details
 
     The `DocBook "footnote"`_ element combines features of ``footnote``
     and footnote_reference_.
+    
+    The DPub ARIA role `"doc-footnote"`__ may be used to mark a (conforming__)
+    `HTML emulation`__ as "ancillary information, such as a citation or
+    commentary, that provides additional context to a referenced passage
+    of text".
 
-    The `ARIA role "note"`__ may be used to mark a (conforming__)
-    `HTML emulation`__ as "a section whose content is parenthetic or
-    ancillary to the main content of the resource".
+    For collections of notes that occur at the end of a section, the
+    the DPub ARIA role `"doc-endnotes"`__ is more appropriate.
 
-    Depending on the note's position, the `epub:type`__ *footnote* or
-    *endnote* and the DPub ARIA role `"doc-footnote"`__ or
-    `"doc-endnote"`__ may be applicable.
+    The corresponding types in the `EPUB 3 Structural Semantics
+    Vocabulary`__ are "footnote" and "endnote".
 
     .. _DocBook "footnote": https://tdg.docbook.org/tdg/5.1/footnote.html
-    __ https://www.w3.org/TR/wai-aria-1.1/#note
+    __ https://www.w3.org/TR/dpub-aria-1.0/#doc-footnote
     __ https://www.w3.org/TR/html-aria/#docconformance
     __ https://www.w3.org/TR/html51/
        common-idioms-without-dedicated-elements.html#footnotes
-    __ https://idpf.github.io/epub-vocabs/structure/#notes
-    __ https://www.w3.org/TR/dpub-aria-1.0/#doc-footnote
-    __ https://www.w3.org/TR/dpub-aria-1.0/#doc-endnote
+    __ https://www.w3.org/TR/dpub-aria-1.0/#doc-endnotes
+    __ https://www.w3.org/TR/epub-ssv-11/#notes
 
 :Processing:
     A ``footnote`` element should be set off from the rest of the