NetBSD Problem Report #56984

From www@netbsd.org  Sun Aug 28 09:58:09 2022
Return-Path: <www@netbsd.org>
Received: from mail.netbsd.org (mail.netbsd.org [199.233.217.200])
	(using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits))
	(Client CN "mail.NetBSD.org", Issuer "mail.NetBSD.org CA" (not verified))
	by mollari.NetBSD.org (Postfix) with ESMTPS id 159AE1A921F
	for <gnats-bugs@gnats.NetBSD.org>; Sun, 28 Aug 2022 09:58:09 +0000 (UTC)
Message-Id: <20220828095737.484961A923A@mollari.NetBSD.org>
Date: Sun, 28 Aug 2022 09:57:37 +0000 (UTC)
From: ray.phillips@gmail.com
Reply-To: ray.phillips@gmail.com
To: gnats-bugs@NetBSD.org
Subject: "typo" in web page
X-Send-Pr-Version: www-1.0

>Number:         56984
>Category:       misc
>Synopsis:       "typo" in web page
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    misc-bug-people
>State:          open
>Class:          doc-bug
>Submitter-Id:   net
>Arrival-Date:   Sun Aug 28 10:00:00 +0000 2022
>Last-Modified:  Mon Aug 29 05:20:01 +0000 2022
>Originator:     Ray Phillips
>Release:        N/A
>Organization:
>Environment:
N/A
>Description:
This web page:

https://man.netbsd.org/re_format.7

contains the string:

or=

twice. The `=' shouldn't be there. Clearly this is not a matter of life or death. I guess it's crept in somehow when the man page was converted to html?

The page's source show it's actually:

or=
>How-To-Repeat:

>Fix:

>Release-Note:

>Audit-Trail:
From: Ray Phillips <ray.phillips@gmail.com>
To: gnats-bugs@netbsd.org
Cc: 
Subject: Re: misc/56984
Date: Sun, 28 Aug 2022 20:12:02 +1000

 --0000000000009322e305e74a6152
 Content-Type: text/plain; charset="UTF-8"

 Now I see that the string

 =

 occurs sixteen times in various places in that web page's source.

 I suppose it could be scattered through many other pages on
 https://man.netbsd.org/


 On Sun, 28 Aug 2022 at 20:00, <gnats-admin@netbsd.org> wrote:

 > Thank you very much for your problem report.
 > It has the internal identification `misc/56984'.
 > The individual assigned to look at your
 > report is: misc-bug-people.
 >
 > >Category:       misc
 > >Responsible:    misc-bug-people
 > >Synopsis:       "typo" in web page
 > >Arrival-Date:   Sun Aug 28 10:00:00 +0000 2022
 >
 >

 --0000000000009322e305e74a6152
 Content-Type: text/html; charset="UTF-8"
 Content-Transfer-Encoding: quoted-printable

 <div dir=3D"ltr"><div dir=3D"ltr"><div dir=3D"ltr"><div dir=3D"ltr"><div>No=
 w I see that the string</div><div><br></div><div>&lt;b&gt;=3D&lt;/b&gt;<br>=
 </div><div><br></div><div>occurs sixteen times in various places in that we=
 b page&#39;s source.</div><div><br></div><div>I suppose it could be scatter=
 ed through many other pages on=C2=A0=C2=A0<a href=3D"https://man.netbsd.org=
 /">https://man.netbsd.org/</a></div><div><br></div><br><div class=3D"gmail_=
 quote"><div dir=3D"ltr" class=3D"gmail_attr">On Sun, 28 Aug 2022 at 20:00, =
 &lt;<a href=3D"mailto:gnats-admin@netbsd.org">gnats-admin@netbsd.org</a>&gt=
 ; wrote:<br></div><blockquote class=3D"gmail_quote" style=3D"margin:0px 0px=
  0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">Thank y=
 ou very much for your problem report.<br>
 It has the internal identification `misc/56984&#39;.<br>
 The individual assigned to look at your<br>
 report is: misc-bug-people. <br>
 <br>
 &gt;Category:=C2=A0 =C2=A0 =C2=A0 =C2=A0misc<br>
 &gt;Responsible:=C2=A0 =C2=A0 misc-bug-people<br>
 &gt;Synopsis:=C2=A0 =C2=A0 =C2=A0 =C2=A0&quot;typo&quot; in web page<br>
 &gt;Arrival-Date:=C2=A0 =C2=A0Sun Aug 28 10:00:00 +0000 2022<br>
 <br>
 </blockquote></div></div></div></div></div>

 --0000000000009322e305e74a6152--

From: Harold Gutch <logix@foobar.franken.de>
To: gnats-bugs@NetBSD.org
Cc: ray.phillips@gmail.com
Subject: Re: misc/56984: "typo" in web page
Date: Sun, 28 Aug 2022 13:58:20 +0200

 Technically the web page is rendered correctly, see the last sentence
 of the first paragraph:

      `=' marks decisions on these aspects that may not be fully
      portable to other IEEE Std 1003.2 (``POSIX.2'') implementations.

 But in practice this should of course be rendered differently, e.g.,
 as "(=)", or (like when read in a terminal) as "(*)".

Responsible-Changed-From-To: misc-bug-people->kim
Responsible-Changed-By: hgutch@NetBSD.org
Responsible-Changed-When: Sun, 28 Aug 2022 12:11:28 +0000
Responsible-Changed-Why:
When rendering \(dd to html, this should not end up as "=", at least
for this one page.


Responsible-Changed-From-To: kim->misc-bug-people
Responsible-Changed-By: kim@NetBSD.org
Responsible-Changed-When: Sun, 28 Aug 2022 13:03:16 +0000
Responsible-Changed-Why:
Nroff renders the double dagger as the equal sign for ISO-8859-1, which
is the character set used on man.netbsd.org.

I do not know how to change this for nroff in general or the mdoc macros
more specifically.

Possibly related files:
- /usr/share/tmac/tty-char.tmac (although tty.tmac does not load this)
- /usr/share/tmac/latin1.tmac
- /usr/share/tmac/ascii.tmac (for the C locale we get [++] from here?)


From: Thomas Klausner <wiz@NetBSD.org>
To: gnats-bugs@netbsd.org
Cc: kim@NetBSD.org
Subject: Re: misc/56984 ("typo" in web page)
Date: Sun, 28 Aug 2022 22:29:43 +0200

 Why not use mandoc's html backend instead?
  Thomas

From: Martin Husemann <martin@duskware.de>
To: gnats-bugs@netbsd.org
Cc: 
Subject: Re: misc/56984 ("typo" in web page)
Date: Mon, 29 Aug 2022 07:16:33 +0200

 Or use utf8 for the generated html?

 Martin

>Unformatted:

Home	PR Database Search