qbit/go
1
0
Fork 0
mirror of https://github.com/golang/go synced 2024-11-21 22:24:40 -07:00
Code Releases Activity

doc: update gccgo docs

Browse Source 
R=golang-dev, r
CC=golang-dev
https://golang.org/cl/10401046
This commit is contained in:
Ian Lance Taylor 2013-06-20 14:49:15 -07:00
parent 5b0bf9db8e
commit ffde4970d0
2 changed files with 38 additions and 20 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

4
doc/gccgo_contribute.html
View File

@ -10,6 +10,10 @@ For information on contributing to parts of Go other than gccgo,
see <a href="/doc/contribute.html">Contributing to the Go project</a>. For see <a href="/doc/contribute.html">Contributing to the Go project</a>. For
information on building gccgo for yourself, information on building gccgo for yourself,
see <a href="/doc/gccgo_install.html">Setting up and using gccgo</a>. see <a href="/doc/gccgo_install.html">Setting up and using gccgo</a>.
For more of the gritty details on the process of doing development
with the gccgo frontend,
see <a href="https://code.google.com/p/gofrontend/source/browse/HACKING">the
file HACKING</a> in the gofrontend repository.
</p> </p>
<h2>Legal Prerequisites</h2> <h2>Legal Prerequisites</h2>

54
doc/gccgo_install.html
View File

@ -32,10 +32,14 @@ will include Go support.
</p> </p>
<p> <p>
The GCC 4.7.0 release includes Go support that is very close to The GCC 4.7.1 release and all later 4.7 releases include a complete
<a href="/doc/go1.html">Go 1</a>. Due to release timing it will not <a href="/doc/go1.html">Go 1</a> compiler and libraries.
include the last few changes to the Go 1 libraries. The GCC 4.7.1 </p>
release should include a complete Go 1 compiler and libraries.
<p>
Due to timing, the GCC 4.8.0 and 4.8.1 releases are close to but not
identical to Go 1.1. The GCC 4.8.2 release is expected to include a
complete Go 1.1.1 implementation.
</p> </p>
<h2 id="Source_code">Source code</h2> <h2 id="Source_code">Source code</h2>
@ -125,6 +129,8 @@ described on
the <a href="http://gcc.gnu.org/install/prerequisites.html">gcc web the <a href="http://gcc.gnu.org/install/prerequisites.html">gcc web
site</a>. It is important to install all the prerequisites before site</a>. It is important to install all the prerequisites before
running the gcc <code>configure</code> script. running the gcc <code>configure</code> script.
The prerequisite libraries can be conveniently downloaded using the
script <code>contrib/download_prerequisites</code> in the GCC sources.
<h3 id="Build_commands">Build commands</h3> <h3 id="Build_commands">Build commands</h3>
@ -147,11 +153,11 @@ make install
<h3 id="Ubuntu">A note on Ubuntu</h3> <h3 id="Ubuntu">A note on Ubuntu</h3>
<p> <p>
Current versions of Ubuntu and current versions of gcc disagree on Current versions of Ubuntu and versions of GCC before 4.8 disagree on
where system libraries and header files are found. This is not a where system libraries and header files are found. This is not a
gccgo issue, and we hope this will be resolved soon. Until it is, gccgo issue. When building older versions of GCC, setting these
setting these environment variables while configuring and building environment variables while configuring and building gccgo may fix the
gccgo may fix the problem. problem.
</p> </p>
<pre> <pre>
@ -309,7 +315,7 @@ gccgo. Both options take directories to search. The
</p> </p>
<p> <p>
The gccgo compiler does not currently (2012-03-20) record The gccgo compiler does not currently (2013-06-20) record
the file name of imported packages in the object file. You must the file name of imported packages in the object file. You must
arrange for the imported data to be linked into the program. arrange for the imported data to be linked into the program.
</p> </p>
@ -385,23 +391,23 @@ struct __go_slice {
</pre> </pre>
<p> <p>
The type of a Go function with no receiver is equivalent to a C function The type of a Go function is a pointer to a struct (this is
whose parameter types are equivalent. When a Go function returns more <b style="color: red;">subject to change</b>). The first field in the
than one value, the C function returns a struct. For example, these struct points to the code of the function, which will be equivalent to
functions have equivalent types: a pointer to a C function whose parameter types are equivalent, with
an additional trailing parameter. The trailing parameter is the
closure, and the argument to pass is a pointer to the Go function
struct.
When a Go function returns more than one value, the C function returns
a struct. For example, these functions are roughly equivalent:
</p> </p>
<pre> <pre>
func GoFunction(int) (int, float64) func GoFunction(int) (int, float64)
struct { int i; float64 f; } CFunction(int) struct { int i; float64 f; } CFunction(int, void*)
</pre> </pre>
<p>
A pointer to a Go function is equivalent to a pointer to a C function
when the functions have equivalent types (this is
<b style="color: red;">subject to change</b>).
</p>
<p> <p>
Go <code>interface</code>, <code>channel</code>, and <code>map</code> Go <code>interface</code>, <code>channel</code>, and <code>map</code>
types have no corresponding C type (<code>interface</code> is a types have no corresponding C type (<code>interface</code> is a
@ -457,6 +463,14 @@ i := c_open(&amp;name[0], syscall.O_RDONLY, 0);
<code>os.Open</code> function instead). <code>os.Open</code> function instead).
</p> </p>
<p>
Note that if the C function can block, such as in a call
to <code>read</code>, calling the C function may block the Go program.
Unless you have a clear understanding of what you are doing, all calls
between C and Go should be implemented through cgo or SWIG, as for
the <code>gc</code> compiler.
</p>
<p> <p>
The name of Go functions accessed from C is subject to change. At present The name of Go functions accessed from C is subject to change. At present
the name of a Go function that does not have a receiver is the name of a Go function that does not have a receiver is