1
0
mirror of https://github.com/golang/go synced 2024-11-20 10:44:41 -07:00
go/doc
Russ Cox cb2f6cb05d godoc: generate package toc in template, not in JavaScript
1. Generate TOC for package pages using template,
instead of using JavaScript magic.  This makes the
pages generated by godoc -html easier to export
to other systems.

2. Make TOC one column.  It's hard to do two columns
portably without invoking JavaScript.

3. Since the TOC is only one column, show full type
signatures for functions and methods.  Many times
that's all you need to see anyway.

4. Name the section after the TOC "Overview".
Naming it something is important, to set it off
from the TOC and so that there's a quick link to
it in the TOC.

For now, some illustrative examples:

http://swtch.com:6060/pkg/io/
http://swtch.com:6060/pkg/strings/
http://swtch.com:6060/pkg/tabwriter/
http://swtch.com:6060/pkg/unicode/

Fixes #1982.

R=gri, bradfitz, r
CC=golang-dev
https://golang.org/cl/5303044
2011-10-18 16:23:35 -04:00
..
codelab/wiki doc/codelab/wiki: fix Makefile 2011-08-29 09:24:24 -04:00
codewalk doc/codewalk: new Markov chain codewalk 2011-08-17 15:53:17 +10:00
devel doc: document release.r60.3 2011-10-18 10:43:22 +11:00
gopher doc/gopher: add a small gif to use as an app engine logo on GAE pages. 2011-06-14 17:25:57 +10:00
play godoc: add dummy playground.js to silence godoc warning at start-up 2011-08-22 14:06:07 -07:00
progs ld: Fixes issue 1899 ("cannot create 8.out.exe") 2011-10-14 20:37:07 +01:00
talks doc/talks/io2010: handle the errors 2011-07-19 14:10:12 +10:00
all.css go/doc, godoc, gotest: support for reading example documentation 2011-10-06 11:56:17 -07:00
button_background.png golang.org redesign 2010-09-16 14:01:02 +10:00
code.html doc: there's no such thing as a .cgo file 2011-03-04 16:28:27 +11:00
codereview_with_mq.html doc: various changes for validating HTML 2010-08-30 09:58:27 +10:00
community.html golang.org redesign 2010-09-16 14:01:02 +10:00
contrib.html doc: put Release History link on 'Documentation' page 2011-05-27 16:07:30 +10:00
contribute.html contrib*.html: make "golang-dev" the default reviewer. 2011-05-13 16:25:31 -07:00
debugging_with_gdb.html documentation: Debugging Go code with GDB tutorial. 2011-10-05 10:49:23 -07:00
docs.html doc: add go-tour-kr, a Korean translation of A Tour of Go 2011-10-15 08:42:31 +11:00
effective_go.html Effective Go: IntArray -> IntSlice 2011-10-06 10:46:18 -07:00
effective_go.tmpl Effective Go: IntArray -> IntSlice 2011-10-06 10:46:18 -07:00
ExpressivenessOfGo.pdf fix bug in example. need to convert Value to float in Abs example 2010-10-18 16:05:50 -07:00
frontpage.css doc: add I/O 2011 talks to talks/, docs.html, and front page. 2011-05-17 13:46:54 +10:00
gccgo_contribute.html docs: make "runtime" a word only as a name for the package. 2011-03-01 13:54:22 -08:00
gccgo_install.html doc: when configuring gold for gccgo, use --enable-gold=default 2011-09-19 11:54:07 -07:00
go_faq.html FAQ: variant types, unions 2011-08-06 11:21:59 +10:00
go_for_cpp_programmers.html docs: make "runtime" a word only as a name for the package. 2011-03-01 13:54:22 -08:00
go_mem.html doc: fix memory model read visibility bug 2011-09-26 12:54:30 -04:00
go_spec.html runtime: random offset for map iteration 2011-10-17 18:49:02 -04:00
go_tutorial.html doc: fix tutorial and Makefile PATH without dot 2011-10-10 11:16:04 +11:00
go_tutorial.tmpl doc: fix tutorial and Makefile PATH without dot 2011-10-10 11:16:04 +11:00
go-logo-black.png
go-logo-blue.png
go-logo-white.png
GoCourseDay1.pdf doc/GoCourseDay1: shrink the PDF by rewriting it using ps2pdf. 2011-06-20 12:36:14 +10:00
GoCourseDay2.pdf docs: Update notes for 3-day Go course. 2011-06-10 15:05:51 +10:00
GoCourseDay3.pdf docs: Update notes for 3-day Go course. 2011-06-10 15:05:51 +10:00
godocs.js godoc: generate package toc in template, not in JavaScript 2011-10-18 16:23:35 -04:00
ie.css golang.org redesign 2010-09-16 14:01:02 +10:00
install.html doc: link to A Tour of Go 2011-10-05 11:12:07 -07:00
logo-153x55.png
logo.png golang.org redesign 2010-09-16 14:01:02 +10:00
Makefile doc: fix tutorial and Makefile PATH without dot 2011-10-10 11:16:04 +11:00
makehtml effective_go: convert to use tmpltohtml. 2011-08-21 09:46:19 +10:00
play_overlay.png golang.org redesign 2010-09-16 14:01:02 +10:00
playground.html playground.html: filesystem is not a word. 2010-10-06 23:56:13 +02:00
popups.js
root.html doc: minor homepage tweak 2011-10-13 09:03:24 -07:00
sieve.gif
tmpltohtml.go doc/tmpltohtml: update to new template package. 2011-08-21 09:04:21 +10:00
video-001.png golang.org redesign 2010-09-16 14:01:02 +10:00
video-002.png golang.org redesign 2010-09-16 14:01:02 +10:00
video-003.png golang.org redesign 2010-09-16 14:01:02 +10:00
video-004.png doc: add Practical Go Programming to front page and docs.html 2010-12-03 06:57:30 +09:00
video-005.jpg doc: add I/O 2011 talks to talks/, docs.html, and front page. 2011-05-17 13:46:54 +10:00