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/usr.bin/mandoc/cgi.c b/usr.bin/mandoc/cgi.c
index 0b941b6..48d0fc0 100644 (file)
--- a/usr.bin/mandoc/cgi.c
+++ b/usr.bin/mandoc/cgi.c
@@ -1,4 +1,4 @@
-/* $OpenBSD: cgi.c,v 1.117 2022/07/05 14:03:35 schwarze Exp $ */
+/* $OpenBSD: cgi.c,v 1.118 2022/07/06 16:02:52 schwarze Exp $ */
 /*
  * Copyright (c) 2014-2019, 2021, 2022 Ingo Schwarze <schwarze@usta.de>
  * Copyright (c) 2011, 2012 Kristaps Dzonsons <kristaps@bsd.lv>
@@ -458,7 +458,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 &&
@@ -560,7 +560,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"
@@ -584,7 +584,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/usr.bin/mandoc/man_html.c b/usr.bin/mandoc/man_html.c
index 0943c34..8c45d7c 100644 (file)
--- a/usr.bin/mandoc/man_html.c
+++ b/usr.bin/mandoc/man_html.c
@@ -1,4 +1,4 @@
-/* $OpenBSD: man_html.c,v 1.136 2022/07/06 14:27:55 schwarze Exp $ */
+/* $OpenBSD: man_html.c,v 1.137 2022/07/06 16:02:52 schwarze Exp $ */
 /*
  * Copyright (c) 2013-2015,2017-2020,2022 Ingo Schwarze <schwarze@openbsd.org>
  * Copyright (c) 2008-2012, 2014 Kristaps Dzonsons <kristaps@bsd.lv>
@@ -269,7 +269,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);
@@ -292,7 +292,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/usr.bin/mandoc/mdoc_html.c b/usr.bin/mandoc/mdoc_html.c
index 7573c2b..1f5c2f7 100644 (file)
--- a/usr.bin/mandoc/mdoc_html.c
+++ b/usr.bin/mandoc/mdoc_html.c
@@ -1,4 +1,4 @@
-/* $OpenBSD: mdoc_html.c,v 1.224 2022/07/06 15:25:22 schwarze Exp $ */
+/* $OpenBSD: mdoc_html.c,v 1.225 2022/07/06 16:02:52 schwarze Exp $ */
 /*
  * Copyright (c) 2014-2022 Ingo Schwarze <schwarze@openbsd.org>
  * Copyright (c) 2008-2011, 2014 Kristaps Dzonsons <kristaps@bsd.lv>
@@ -454,7 +454,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);
@@ -487,7 +487,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);