Weird stuff in autogenerated doc

[sbarzowski]

Where does it come from?
https://imgur.com/a/oJMNy

[mqliang]

Those functions are functions from github.com/mjibson/esc, which is used to generate std.go. But I don't know why they are included in the GoDoc.

By the way, how std.go can be generated, can you include the generation script in the repo? And I can't run tests.sh on my laptop, due to missing the tests_path.source files.

[sbarzowski]

Thanks.

To generate std.go it's enough to run go get github.com/mjibson/esc && go generate. No special script needed, just the standard go stuff.

Regarding tests, there are two test suites. One can be run just by running go test. This one was created specifically for go version and it should just work. But there is also an older and more authoritative test suite in the stable C++ version that can be used to find the missing parts. It can be run using ./tests.sh and it needs to be pointed at C++ repo. Hence tests_path.source. If you want to run these tests please clone C++ repo (https://github.com/google/jsonnet). Then create tests_path.source which contains TESTS_PATH="/full/path/to/the/root/of/C++/repo". Then you should be able to run these tests (some of them still fail due to missing features). FYI there are some plans to unify and improve the way tests work.