Giới thiệu
Đây là một số ghi chú về việc đóng góp cho frontend gccgo của GCC. Để biết thông tin về việc đóng góp cho các phần khác của Go ngoài gccgo, xem Đóng góp cho dự án Go. Để biết thông tin về cách tự build gccgo, xem Cài đặt và sử dụng gccgo. Để biết thêm các chi tiết cụ thể về quy trình phát triển với frontend gccgo, xem tệp HACKING trong repository gofrontend.
Điều kiện pháp lý tiên quyết
Bạn phải tuân theo các quy tắc bản quyền của Go đối với mọi thay đổi trong frontend gccgo và thư viện libgo đi kèm. Mã thuộc về GCC chứ không phải gccgo thì phải tuân theo các quy tắc đóng góp chung của GCC.
Mã nguồn
Mã nguồn gốc của frontend gccgo có thể tìm thấy tại https://go.googlesource.com/gofrontend. Chúng được mirror tại https://github.com/golang/gofrontend. Mã nguồn gốc tự nó không build được, mà chỉ build được khi đi cùng GCC (trong tương lai, các compiler khác có thể được hỗ trợ). Các thay đổi đối với frontend gccgo cũng được áp dụng vào repository mã nguồn GCC đặt tại gcc.gnu.org. Trong repository gofrontend, thư mục go được mirror sang thư mục gcc/go/gofrontend trong repository GCC, còn thư mục libgo của gofrontend được mirror sang thư mục libgo của GCC. Ngoài ra, thư mục test từ repository Go chính được mirror sang thư mục gcc/testsuite/go.test/test trong repository GCC.
Các thay đổi trong những thư mục này luôn chảy từ mã nguồn gốc sang repository GCC. Các tệp không bao giờ nên được sửa trong repository GCC, ngoại trừ bằng cách sửa chúng trong mã nguồn gốc rồi mirror sang.
Frontend gccgo được viết bằng C++. Nó tuân theo các chuẩn viết mã C++ của GNU và GCC. Khi viết mã cho frontend, hãy theo cách định dạng của mã xung quanh. Hầu hết mã đặc thù cho GCC không nằm trong bản thân frontend mà nằm trong mã nguồn GCC ở thư mục gcc/go.
Thư viện run-time của gccgo về cơ bản giống với thư viện trong repository Go chính. Mã thư viện trong repository Go được merge định kỳ vào thư mục libgo/go của gofrontend rồi vào repository GCC, bằng shell script libgo/merge.sh. Do đó, phần lớn thay đổi về thư viện nên được thực hiện trong repository Go chính. Các tệp nằm ngoài libgo/go là đặc thù cho gccgo; dù vậy, một số tệp trong libgo/runtime dựa trên các tệp trong src/runtime ở repository Go chính.
Kiểm thử
Mọi patch đều phải được kiểm thử. Một patch gây ra lỗi mới là không chấp nhận được.
Để chạy bộ test của gccgo, hãy chạy make check-go trong thư mục build của bạn. Lệnh này sẽ chạy nhiều test khác nhau trong gcc/testsuite/go.* và cũng sẽ chạy bộ test libgo. Bản sao các test từ repository Go chính này được chạy bằng script DejaGNU nằm trong gcc/testsuite/go.test/go-test.exp.
Phần lớn test mới nên được gửi vào repository Go chính để sau đó được mirror sang repository GCC. Nếu cần các test riêng cho gccgo, chúng nên được đặt trong thư mục gcc/testsuite/go.go-torture hoặc gcc/testsuite/go.dg trong repository GCC.
Gửi thay đổi
Các thay đổi đối với frontend Go nên theo cùng quy trình như với repository Go chính, chỉ khác là dành cho dự án gofrontend và mailing list [email protected] thay vì dự án go và mailing list [email protected]. Những thay đổi đó sau đó sẽ được merge vào mã nguồn GCC.