Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!
Bug 851762 - go-module.eclass: Eclass documentation awk example truncated in manpage
Summary: go-module.eclass: Eclass documentation awk example truncated in manpage
Status: UNCONFIRMED
Alias: None
Product: Gentoo Linux
Classification: Unclassified
Component: Eclasses (show other bugs)
Hardware: All Linux
: Normal normal (vote)
Assignee: William Hubbs
URL:
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2022-06-13 21:47 UTC by Enzo Venturi
Modified: 2022-06-13 22:11 UTC (History)
1 user (show)

See Also:
Package list:
Runtime testing required: ---


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description Enzo Venturi 2022-06-13 21:47:50 UTC
Hi.

There's a mistake (maybe due to man2html) to explain how to manually extract the contents of `go.sum`.

https://devmanual.gentoo.org/eclass-reference/go-module.eclass/index.html

It should be as the eclass script shows:

> cat go.sum | cut -d" " -f1,2 | awk '{print "\t\"" $0 "\""}'

Instead of:

> cat go.sum | cut -d" " -f1,2 | awk '{print "	

Moreover, you can do that job using only awk:

> awk '{printf ("\"%s %s\"\n", $1, $2)}' go.sum
Comment 1 Ulrich Müller gentoo-dev 2022-06-13 22:10:40 UTC
Not a Devmanual problem. The line is already truncated in the output of "man 5 go-module.eclass".

Because \t is interpreted by nroff, the backslash should be escaped by \\ in order to show up in the output. (Which would make the source code hard to read, so maybe find another way?)

Reassigning to eclass maintainer.