Documentation ¶
Overview ¶
Package doc contains functions to generate the HTML User's Guide and the man page for the Go Doctor.
Index ¶
- func PrintInstallGuide(aboutText string, flags *flag.FlagSet, out io.Writer)
- func PrintManPage(aboutText string, flags *flag.FlagSet, out io.Writer)
- func PrintUserGuide(aboutText string, flags *flag.FlagSet, out io.Writer)
- func PrintUserGuideAsGiven(aboutText string, flags *flag.FlagSet, ctnt *UserGuideContent, out io.Writer)
- func PrintVimdoc(aboutText string, flags *flag.FlagSet, out io.Writer)
- type UserGuideContent
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
func PrintInstallGuide ¶
PrintInstallGuide outputs the (HTML) Installation Guide for the Go Doctor.
func PrintManPage ¶
PrintManPage outputs a man page for the godoctor command line tool.
func PrintUserGuide ¶
PrintUserGuide outputs the User's Guide for the Go Doctor (in HTML).
Both the godoctor man page and the Vim plugin reference are generated and included in the User's Guide. The man page content is piped through groff to convert it to HTML.
func PrintUserGuideAsGiven ¶
func PrintUserGuideAsGiven(aboutText string, flags *flag.FlagSet, ctnt *UserGuideContent, out io.Writer)
PrintUserGuideAsGiven outputs the User's Guide for the Go Doctor (in HTML). However, if the content's ManPageHTML and/or VimdocHTML is nonempty, the given content is used rather than generating the content. This is used by the online documentation, which cannot execute groff to convert the man page to HTML (due to an App Engine restriction), and which uses a Vim-colored version of the Vim plugin documentation.