Commit e4127614 authored by Shenghou Ma's avatar Shenghou Ma

cmd/godoc: update App Engine README and script for Go 1

R=adg, dsymonds
CC=golang-dev
https://golang.org/cl/5849053
parent a09e9811
...@@ -8,8 +8,8 @@ godoc on appengine ...@@ -8,8 +8,8 @@ godoc on appengine
Prerequisites Prerequisites
------------- -------------
* Go appengine SDK 1.5.5 - 2011-10-11 * Go appengine SDK
http://code.google.com/appengine/downloads.html#Google_App_Engine_SDK_for_Go https://developers.google.com/appengine/downloads#Google_App_Engine_SDK_for_Go
* Go sources at tip under $GOROOT * Go sources at tip under $GOROOT
...@@ -23,10 +23,6 @@ Directory structure ...@@ -23,10 +23,6 @@ Directory structure
* $APPDIR contains the following entries (this may change depending on * $APPDIR contains the following entries (this may change depending on
app-engine release and version of godoc): app-engine release and version of godoc):
alt/
encoding/binary/
go/*
index/suffixarray/
app.yaml app.yaml
godoc.zip godoc.zip
godoc/ godoc/
...@@ -36,31 +32,16 @@ Directory structure ...@@ -36,31 +32,16 @@ Directory structure
For instance: For instance:
application: godoc-app application: godoc-app
version: 1-5-5 version: 1
runtime: go runtime: go
api_version: 3 api_version: go1
handlers: handlers:
- url: /.* - url: /.*
script: _go_app script: _go_app
* The godoc/ directory contains a copy of the files under $GOROOT/src/cmd/godoc * The godoc/ directory contains a copy of the files under $GOROOT/src/cmd/godoc
with modifications: with doc.go excluded (it belongs to pseudo-package "documentation")
- doc.go is excluded (it belongs to pseudo-package ÒdocumentationÓ)
- main.go is excluded (appinit.go is taking its place)
Additional manual modifications are required to refer to the alt/ packages
where the app-engine library is not up-to-date with the godoc version.
* The alt/ directory contains up-to-date copies of Go packages that a tip-based
godoc is dependent on but which do not yet exist in the current app-engine SDK.
At the time of this writing (10/14/2011) this is the entire go directory tree
(for the missing FileSet serialization code in go/token) as well as the
index/suffixarray package (for the missing suffix array serialization code).
The latest (alt/)index/suffixarray package internally requires the latest
version of encoding/binary, which is why it also needs to be present under
alt/.
Configuring and running godoc Configuring and running godoc
......
...@@ -44,8 +44,8 @@ getArgs() { ...@@ -44,8 +44,8 @@ getArgs() {
if [ ! -d $GOROOT ]; then if [ ! -d $GOROOT ]; then
error "$GOROOT is not a directory" error "$GOROOT is not a directory"
fi fi
if [ ! -x $GOROOT/src/cmd/godoc/godoc ]; then if [ ! -x $GOROOT/bin/godoc ]; then
error "$GOROOT/src/cmd/godoc/godoc does not exist or is not executable" error "$GOROOT/bin/godoc does not exist or is not executable"
fi fi
if [ ! -d $APPDIR ]; then if [ ! -d $APPDIR ]; then
error "$APPDIR is not a directory" error "$APPDIR is not a directory"
...@@ -72,15 +72,15 @@ cleanup() { ...@@ -72,15 +72,15 @@ cleanup() {
makeZipfile() { makeZipfile() {
echo "*** make $APPDIR/$ZIPFILE" echo "*** make $APPDIR/$ZIPFILE"
zip -q -r $APPDIR/$ZIPFILE $GOROOT -i \*.go -i \*.html -i \*.css -i \*.js -i \*.txt -i \*.c -i \*.h -i \*.s -i \*.png -i \*.jpg -i \*.sh -i \*.ico zip -q -r $APPDIR/$ZIPFILE $GOROOT -i \*.go -i \*.html -i \*.xml -i \*.css -i \*.js -i \*.txt -i \*.c -i \*.h -i \*.s -i \*.png -i \*.jpg -i \*.sh -i \*.ico
} }
makeIndexfile() { makeIndexfile() {
echo "*** make $APPDIR/$INDEXFILE" echo "*** make $APPDIR/$INDEXFILE"
OUT=/tmp/godoc.out OUT=/tmp/godoc.out
$GOROOT/src/cmd/godoc/godoc -write_index -index_files=$APPDIR/$INDEXFILE -zip=$APPDIR/$ZIPFILE 2> $OUT $GOROOT/bin/godoc -write_index -index_files=$APPDIR/$INDEXFILE -zip=$APPDIR/$ZIPFILE 2> $OUT
if [ $? != 0 ]; then if [ $? != 0 ]; then
error "$GOROOT/src/cmd/godoc/godoc failed - see $OUT for details" error "$GOROOT/bin/godoc failed - see $OUT for details"
fi fi
} }
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment