The set of parse functions provided by the go/parser
package has been reduced to the primary parse function
-ParseFile, and a couple of
-convenience functions ParseDir
-and ParseExpr.
+ParseFile, and a couple of
+convenience functions ParseDir
+and ParseExpr.
-The type names of the go/doc package have been
+The type names of the go/doc package have been
streamlined by removing the Doc suffix: PackageDoc
-is now Package, ValueDoc is Value, etc.
+is now Package, ValueDoc
+is Value, etc.
Also, all types now consistently have a Name field (or Names,
in the case of type Value), Type.Factories has become
-Type.Funcs, and there is a new type Method that describes
-methods in more detail.
+Type.Funcs, and there is a new type
+Method that describes methods in
+more detail.
Instead of calling doc.NewPackageDoc(pkg, importpath),
documentation for a package is created with:
-where the new mode parameter specifies the operation mode:
-if set to AllDecls, all declarations
-(not just exported ones) are considered.
+where the new mode parameter specifies the operation
+Mode: if set to
+AllDecls, all declarations (not just exported ones) are considered.
The function NewFileDoc was removed, and the function
CommentText has become the method
-Text of
-ast.CommentGroup.
+Text of
+ast.CommentGroup.
-In package go/token, the
-token.FileSet method Files
+In package go/token, the
+token.FileSet method Files
(which originally returned a channel of *token.Files) has been replaced
-with the iterator Iterate that
+with the iterator Iterate that
accepts a function argument instead.
Updating:
-Code that uses packages in go will have to be updated by hand; the
-compiler will reject incorrect uses. Templates used in conjuction with any of the
-go/doc types may need manual fixes; the renamed fields will lead
-to run-time errors.
+Code that uses these packages in go will have to be updated by hand;
+the compiler will reject incorrect uses. Templates used in conjuction with any of the
+go/doc types may need manual fixes; the renamed
+fields will lead to run-time errors.