mirror of
https://github.com/gcc-mirror/gcc.git
synced 2026-05-06 14:59:39 +02:00
1f87fb00ff
In some misguided attempt at "cleanup", Google Cloud has decided to retire 'gsutil' in favor of 'gcloud storage' instead of leaving an entirely backwards-compatible wrapper so that client scripts and muscle memory keep working. In addition to breaking customers this way, they are also sending AI bots around "cleaning up" old usages with scary warnings that maybe the changes will break your entire world. This is even more misguided, of course, and resulted in us receiving CL 748661 (originally GitHub PR golang/gofrontend#13) and then me receiving a private email asking for it to be merged. It was easier to recreate the 4-line CL myself than to enumerate everything that was wrong with that CL's commit message. I hope that only Google teams are being subjected to this. This is based on https://go.dev/cl/748900 from the main Go repo by Russ. Reviewed-on: https://go-review.googlesource.com/c/gofrontend/+/749000
See ../README. This is the runtime support library for the Go programming language. This library is intended for use with the Go frontend. This library should not be stripped when it is installed. Go code relies on being able to look up file/line information, which comes from the debugging info using the libbacktrace library. The library has only been tested on GNU/Linux using glibc, and on Solaris. It should not be difficult to port to other operating systems. Directories: go A copy of the Go library from http://golang.org/, with several changes for gccgo. runtime Runtime functions, written in C, which are called directly by the compiler or by the library. Contributing ============ To contribute patches to the files in this directory, please see http://golang.org/doc/gccgo_contribute.html . The master copy of these files is hosted at http://code.google.com/p/gofrontend . Changes to these files require signing a Google contributor license agreement. If you are the copyright holder, you will need to agree to the individual contributor license agreement at http://code.google.com/legal/individual-cla-v1.0.html. This agreement can be completed online. If your organization is the copyright holder, the organization will need to agree to the corporate contributor license agreement at http://code.google.com/legal/corporate-cla-v1.0.html. If the copyright holder for your code has already completed the agreement in connection with another Google open source project, it does not need to be completed again. Debugging ========= This describes how to test libgo when built as part of gccgo. To test a specific package, cd to the libgo build directory (TARGET/libgo) and run `make PKG/check`. For example, `make bytes/check`. To see the exact commands that it runs, including how the compiler is invoked, run `make GOTESTFLAGS=--trace bytes/check`. This will display the commands if the test fails. If the test passes, the commands and other output will be visible in a file named check-testlog in a subdirectory with the name of the package being checked. In the case of bytes/check, this will create bytes/check-testlog. To leave the test program behind, run `make GOTESTFLAGS=--keep bytes/check`. That will leave a gotestNNNN/test directory in the libgo build directory. In that directory you can run `LD_LIBRARY_PATH=../../.libs ./a.out -test.short` to run the tests. You can run specific failing tests using a -test.run option. You can see the tests being run with the -test.v option. You can run the program under a debugger such as gdb.