From: Russ Cox Date: Thu, 6 Nov 2014 01:15:48 +0000 (-0500) Subject: doc/go1.4.html: document new subrepo import paths X-Git-Tag: go1.4rc1~46 X-Git-Url: http://www.git.cypherpunks.su/?a=commitdiff_plain;h=67742ef560be186a2ebeb45aaab50399bf81b358;p=gostls13.git doc/go1.4.html: document new subrepo import paths LGTM=r, adg R=adg, r, 0xjnml, dr.volker.dobler CC=golang-codereviews https://golang.org/cl/166980044 --- diff --git a/doc/go1.4.html b/doc/go1.4.html index 3310117a4d..1a18054b95 100644 --- a/doc/go1.4.html +++ b/doc/go1.4.html @@ -120,7 +120,7 @@ compile but is easy to fix by adding an explicit dereference.

Go 1.4 can build binaries for ARM processors running the Android operating system. It can also build a .so library that can be loaded by an Android application -using the supporting packages in the go.mobile repository. +using the supporting packages in the mobile subrepository. A brief description of the plans for this experimental port are available here.

@@ -385,6 +385,24 @@ Further information is in the design document.

+

Import paths for the subrepositories

+ +

+The Go project subrepositories (code.google.com/p/go.tools and so on) +are now available under custom import paths replacing code.google.com/p/go. with golang.org/x/, +as in golang.org/x/tools. +We will add canonical import comments to the code around June 1, 2015, +at which point Go 1.4 and later will stop accepting the old code.google.com paths. +

+ +

+Updating: All code that imports from subrepositories should change +to use the new golang.org paths. +Go 1.0 and later can resolve and import the new paths, so updating will not break +compatibility with older releases. +Code that has not updated will stop compiling with Go 1.4 around June 1, 2015. +

+

The go generate subcommand

@@ -394,8 +412,8 @@ to automate the running of tools to generate source code before compilation. For example, it can be used to run the yacc compiler-compiler on a .y file to produce the Go source file implementing the grammar, or to automate the generation of String methods for typed constants using the new -stringer -tool in the go.tools repository. +stringer +tool in the golang.org/x/tools subrepository.

@@ -480,7 +498,7 @@ rebuild the standard library and commands, to avoid overwriting the installation

In the main Go source repository, the source code for the packages was kept in the directory src/pkg, which made sense but differed from -other repositories, including the Go sub-repositories such as go.tools. +other repositories, including the Go subrepositories. In Go 1.4, the pkg level of the source tree is now gone, so for example the fmt package's source, once kept in directory src/pkg/fmt, now lives one level higher in src/fmt. @@ -591,14 +609,14 @@ separate document.

-A new subrepository, go.sys, +A new subrepository, golang.org/x/sys, has been created to serve as the location for new developments to support system calls on all kernels. It has a nicer structure, with three packages that each hold the implementation of system calls for one of -Unix, -Windows and -Plan 9. +Unix, +Windows and +Plan 9. These packages will be curated more generously, accepting all reasonable changes that reflect kernel interfaces in those operating systems. See the documentation and the article mentioned above for more information. @@ -608,7 +626,7 @@ See the documentation and the article mentioned above for more information. Updating: Existing programs are not affected as the syscall package is largely unchanged from the 1.3 release. Future development that requires system calls not in the syscall package -should build on go.sys instead. +should build on golang.org/x/sys instead.

Minor changes to the library