https://www.w3.org/WAI/ARIA/apg/practices/names-and-descriptions/ says:

"Start names with a capital letter;
it helps some screen readers speak them with appropriate inflection."
Anna Vyalkova already did that correctly when sending patches,
but i ruined it when committing, so fix it now.

diff --git a/cgi.c b/cgi.c
index 271f9b0a7ff4cc6d60661cc5fbc69f33122c6c76..421cb9bd9d0e07bc12572be8baff806fc3f1c583 100644 (file)
--- a/cgi.c
+++ b/cgi.c
@@ -1,4 +1,4 @@
-/* $Id: cgi.c,v 1.178 2022/07/05 14:04:25 schwarze Exp $ */
+/* $Id: cgi.c,v 1.179 2022/07/06 16:05:40 schwarze Exp $ */
 /*
  * Copyright (c) 2014-2019, 2021, 2022 Ingo Schwarze <schwarze@usta.de>
  * Copyright (c) 2011, 2012 Kristaps Dzonsons <kristaps@bsd.lv>
@@ -462,7 +462,7 @@ resp_searchform(const struct req *req, enum focus focus)
 
        /* Write section selector. */
 
-       puts("    <select name=\"sec\" aria-label=\"manual section\">");
+       puts("    <select name=\"sec\" aria-label=\"Manual section\">");
        for (i = 0; i < sec_MAX; i++) {
                printf("      <option value=\"%s\"", sec_numbers[i]);
                if (NULL != req->q.sec &&
@@ -564,7 +564,7 @@ pg_index(const struct req *req)
        resp_searchform(req, FOCUS_QUERY);
        printf("</header>\n"
               "<main>\n"
-              "<p role=\"doc-notice\" aria-label=\"usage\">\n"
+              "<p role=\"doc-notice\" aria-label=\"Usage\">\n"
               "This web interface is documented in the\n"
               "<a class=\"Xr\" href=\"/%s%sman.cgi.8\""
               " aria-label=\"man dot CGI, section 8\">man.cgi(8)</a>\n"
@@ -588,7 +588,7 @@ pg_noresult(const struct req *req, int code, const char *http_msg,
        resp_searchform(req, FOCUS_QUERY);
        puts("</header>");
        puts("<main>");
-       puts("<p role=\"doc-notice\" aria-label=\"no result\">");
+       puts("<p role=\"doc-notice\" aria-label=\"No result\">");
        puts(user_msg);
        puts("</p>");
        puts("</main>");

diff --git a/man_html.c b/man_html.c
index 6ad355787a2df20a8f216f30d06e3507e69e9cbe..16bd9a44fb761cbf5c45db93e7779ca748600c5e 100644 (file)
--- a/man_html.c
+++ b/man_html.c
@@ -1,4 +1,4 @@
-/* $Id: man_html.c,v 1.183 2022/07/06 14:34:59 schwarze Exp $ */
+/* $Id: man_html.c,v 1.184 2022/07/06 16:05:40 schwarze Exp $ */
 /*
  * Copyright (c) 2013-2015,2017-2020,2022 Ingo Schwarze <schwarze@openbsd.org>
  * Copyright (c) 2008-2012, 2014 Kristaps Dzonsons <kristaps@bsd.lv>
@@ -271,7 +271,7 @@ man_root_pre(const struct roff_meta *man, struct html *h)
        mandoc_asprintf(&title, "%s(%s)", man->title, man->msec);
 
        t = print_otag(h, TAG_DIV, "cr?", "head", "doc-pageheader",
-           "aria-label", "manual header line");
+           "aria-label", "Manual header line");
 
        print_otag(h, TAG_SPAN, "c", "head-ltitle");
        print_text(h, title);
@@ -294,7 +294,7 @@ man_root_post(const struct roff_meta *man, struct html *h)
        struct tag      *t;
 
        t = print_otag(h, TAG_DIV, "cr?", "foot", "doc-pagefooter",
-           "aria-label", "manual footer line");
+           "aria-label", "Manual footer line");
 
        print_otag(h, TAG_SPAN, "c", "foot-left");
        print_stagq(h, t);

diff --git a/mdoc_html.c b/mdoc_html.c
index a6a707b48df6b902c2bb25b965f76ad7c02f7990..74d753a76bfb40d0ad56273e12af1a9e4086de1c 100644 (file)
--- a/mdoc_html.c
+++ b/mdoc_html.c
@@ -1,4 +1,4 @@
-/* $Id: mdoc_html.c,v 1.349 2022/07/06 15:26:23 schwarze Exp $ */
+/* $Id: mdoc_html.c,v 1.350 2022/07/06 16:05:40 schwarze Exp $ */
 /*
  * Copyright (c) 2014-2022 Ingo Schwarze <schwarze@openbsd.org>
  * Copyright (c) 2008-2011, 2014 Kristaps Dzonsons <kristaps@bsd.lv>
@@ -456,7 +456,7 @@ mdoc_root_post(const struct roff_meta *meta, struct html *h)
        struct tag      *t;
 
        t = print_otag(h, TAG_DIV, "cr?", "foot", "doc-pagefooter",
-           "aria-label", "manual footer line");
+           "aria-label", "Manual footer line");
 
        print_otag(h, TAG_SPAN, "c", "foot-left");
        print_stagq(h, t);
@@ -489,7 +489,7 @@ mdoc_root_pre(const struct roff_meta *meta, struct html *h)
                    meta->title, meta->msec);
 
        t = print_otag(h, TAG_DIV, "cr?", "head", "doc-pageheader",
-           "aria-label", "manual header line");
+           "aria-label", "Manual header line");
 
        print_otag(h, TAG_SPAN, "c", "head-ltitle");
        print_text(h, title);