Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

x/pkgsite: fails to escape backtick-quotes in doc comments #42666

Closed
bcmills opened this issue Nov 17, 2020 · 1 comment
Closed

x/pkgsite: fails to escape backtick-quotes in doc comments #42666

bcmills opened this issue Nov 17, 2020 · 1 comment
Labels
FrozenDueToAge help wanted NeedsInvestigation Someone must examine and confirm this is a valid issue and not a duplicate of an existing one. pkgsite/dochtml Issues related to package documentation in pkgsite pkgsite

Comments

@bcmills
Copy link
Contributor

bcmills commented Nov 17, 2020

What is the URL of the page with the issue?

https://pkg.go.dev/reflect#DeepEqual

What is your user agent?

Mozilla/5.0 (X11; CrOS x86_64 13421.89.0) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/86.0.4240.183 Safari/537.36

Screenshot

image

What did you do?

Open documentation for reflect.DeepEqual.

What did you expect to see?

The same text as produced by go doc reflect.DeepEqual, with the idiosyncratic backtick-quotes replaced with proper Unicode quotes (per #27759, #41958, and others):

~$ gotip version
go version devel +869e2957b Mon Nov 16 22:24:14 2020 +0000 linux/amd64

~$ gotip doc reflect.DeepEqual | head -n 6
package reflect // import "reflect"

func DeepEqual(x, y interface{}) bool
    DeepEqual reports whether x and y are “deeply equal,” defined as follows.
    Two values of identical type are deeply equal if one of the following cases
    applies. Values of distinct types are never deeply equal.

What did you see instead?

Unescaped backticks and quote characters from the original source code:

go/src/reflect/deepequal.go

Lines 160 to 162 in c53315d

// DeepEqual reports whether x and y are ``deeply equal,'' defined as follows.
// Two values of identical type are deeply equal if one of the following cases applies.
// Values of distinct types are never deeply equal.

@gopherbot gopherbot added this to the Unreleased milestone Nov 17, 2020
@jamalc jamalc modified the milestones: Unreleased, pkgsite/dochtml Nov 17, 2020
@jamalc jamalc added the NeedsInvestigation Someone must examine and confirm this is a valid issue and not a duplicate of an existing one. label Nov 17, 2020
@gopherbot
Copy link

Change https://golang.org/cl/274251 mentions this issue: internal/godoc/dochtml/internal/render: support unicode quotes

@golang golang locked and limited conversation to collaborators Feb 12, 2022
@hyangah hyangah added the pkgsite/dochtml Issues related to package documentation in pkgsite label May 20, 2022
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Labels
FrozenDueToAge help wanted NeedsInvestigation Someone must examine and confirm this is a valid issue and not a duplicate of an existing one. pkgsite/dochtml Issues related to package documentation in pkgsite pkgsite
Projects
None yet
Development

No branches or pull requests

5 participants