qbit/go
1
0
Fork 0
mirror of https://github.com/golang/go synced 2024-11-05 17:06:13 -07:00
Code Releases Activity
87c7dcbd5d
go/cmd/godoc/README.godoc-app

57 lines
1.1 KiB
Plaintext
Raw Normal View History

go.tools/cmd/godoc: copy godoc from core reposistory The plan for godoc: - Copy godoc source from the core repo to go.tools (this CL). - Break godoc into several packages inside go.tools, leaving a package main that merely sets up a local file system, interprets the command line, and otherwise delegates the heavy-lifting to the new packages. - Remove godoc from the core repo. - Update cmd/go to install this godoc binary in $GOROOT/bin. - Update misc/dist to include godoc when building binary distributions. R=bradfitz CC=golang-dev https://golang.org/cl/11408043
2013-07-16 22:02:35 -06:00
godoc on appengine
------------------
Prerequisites
-------------
* Go appengine SDK
https://developers.google.com/appengine/downloads#Google_App_Engine_SDK_for_Go
* Go sources at tip under $GOROOT
go.tools/cmd/godoc: fix app engine version; update build script and readme R=golang-dev, dsymonds, bradfitz CC=golang-dev https://golang.org/cl/12897045
2013-10-02 22:29:16 -06:00
* Godoc sources at tip inside $GOPATH
go.tools: use golang.org/x/... import paths Rewrite performed with this command: sed -i '' 's_code.google.com/p/go\._golang.org/x/_g' \ $(grep -lr 'code.google.com/p/go.' *) LGTM=rsc R=rsc CC=golang-codereviews https://golang.org/cl/170920043
2014-11-09 14:50:40 -07:00
(go get -d golang.org/x/tools/cmd/godoc)
go.tools/cmd/godoc: fix app engine version; update build script and readme R=golang-dev, dsymonds, bradfitz CC=golang-dev https://golang.org/cl/12897045
2013-10-02 22:29:16 -06:00
go.tools/cmd/godoc: copy godoc from core reposistory The plan for godoc: - Copy godoc source from the core repo to go.tools (this CL). - Break godoc into several packages inside go.tools, leaving a package main that merely sets up a local file system, interprets the command line, and otherwise delegates the heavy-lifting to the new packages. - Remove godoc from the core repo. - Update cmd/go to install this godoc binary in $GOROOT/bin. - Update misc/dist to include godoc when building binary distributions. R=bradfitz CC=golang-dev https://golang.org/cl/11408043
2013-07-16 22:02:35 -06:00
Directory structure
-------------------
* Let $APPDIR be the directory containing the app engine files.
(e.g., $APPDIR=$HOME/godoc-app)
* $APPDIR contains the following entries (this may change depending on
app-engine release and version of godoc):
app.yaml
go.tools: use golang.org/x/... import paths Rewrite performed with this command: sed -i '' 's_code.google.com/p/go\._golang.org/x/_g' \ $(grep -lr 'code.google.com/p/go.' *) LGTM=rsc R=rsc CC=golang-codereviews https://golang.org/cl/170920043
2014-11-09 14:50:40 -07:00
golang.org/x/tools/cmd/godoc
go.tools/cmd/godoc: copy godoc from core reposistory The plan for godoc: - Copy godoc source from the core repo to go.tools (this CL). - Break godoc into several packages inside go.tools, leaving a package main that merely sets up a local file system, interprets the command line, and otherwise delegates the heavy-lifting to the new packages. - Remove godoc from the core repo. - Update cmd/go to install this godoc binary in $GOROOT/bin. - Update misc/dist to include godoc when building binary distributions. R=bradfitz CC=golang-dev https://golang.org/cl/11408043
2013-07-16 22:02:35 -06:00
godoc.zip
index.split.*
* The app.yaml file is set up per app engine documentation.
For instance:
application: godoc-app
version: 1
runtime: go
api_version: go1
handlers:
- url: /.*
script: _go_app
Configuring and running godoc
-----------------------------
To configure godoc, run
bash setup-godoc-app.bash
go.tools/cmd/godoc: fix app engine version; update build script and readme R=golang-dev, dsymonds, bradfitz CC=golang-dev https://golang.org/cl/12897045
2013-10-02 22:29:16 -06:00
to prepare an $APPDIR as described above. See the script for details on usage.
go.tools/cmd/godoc: copy godoc from core reposistory The plan for godoc: - Copy godoc source from the core repo to go.tools (this CL). - Break godoc into several packages inside go.tools, leaving a package main that merely sets up a local file system, interprets the command line, and otherwise delegates the heavy-lifting to the new packages. - Remove godoc from the core repo. - Update cmd/go to install this godoc binary in $GOROOT/bin. - Update misc/dist to include godoc when building binary distributions. R=bradfitz CC=golang-dev https://golang.org/cl/11408043
2013-07-16 22:02:35 -06:00
go.tools/cmd/godoc: fix app engine version; update build script and readme R=golang-dev, dsymonds, bradfitz CC=golang-dev https://golang.org/cl/12897045
2013-10-02 22:29:16 -06:00
To run godoc locally, using the App Engine development server, run
go.tools/cmd/godoc: copy godoc from core reposistory The plan for godoc: - Copy godoc source from the core repo to go.tools (this CL). - Break godoc into several packages inside go.tools, leaving a package main that merely sets up a local file system, interprets the command line, and otherwise delegates the heavy-lifting to the new packages. - Remove godoc from the core repo. - Update cmd/go to install this godoc binary in $GOROOT/bin. - Update misc/dist to include godoc when building binary distributions. R=bradfitz CC=golang-dev https://golang.org/cl/11408043
2013-07-16 22:02:35 -06:00
go.tools/cmd/godoc: fix app engine version; update build script and readme R=golang-dev, dsymonds, bradfitz CC=golang-dev https://golang.org/cl/12897045
2013-10-02 22:29:16 -06:00
<path to go_appengine>/dev_appserver.py $APPDIR
go.tools/cmd/godoc: copy godoc from core reposistory The plan for godoc: - Copy godoc source from the core repo to go.tools (this CL). - Break godoc into several packages inside go.tools, leaving a package main that merely sets up a local file system, interprets the command line, and otherwise delegates the heavy-lifting to the new packages. - Remove godoc from the core repo. - Update cmd/go to install this godoc binary in $GOROOT/bin. - Update misc/dist to include godoc when building binary distributions. R=bradfitz CC=golang-dev https://golang.org/cl/11408043
2013-07-16 22:02:35 -06:00
godoc should come up at http://localhost:8080 .
Copy Permalink