{"id":292107,"date":"2022-10-28T14:55:07","date_gmt":"2022-10-28T13:55:07","guid":{"rendered":"https:\/\/blog.jetbrains.com\/?post_type=go&p=292107"},"modified":"2022-11-03T16:43:03","modified_gmt":"2022-11-03T15:43:03","slug":"goland-2022-3-eap-5-support-for-links-lists-and-new-headings-in-go-doc-comments","status":"publish","type":"go","link":"https:\/\/blog.jetbrains.com\/zh-hans\/go\/2022\/10\/28\/goland-2022-3-eap-5-support-for-links-lists-and-new-headings-in-go-doc-comments","title":{"rendered":"GoLand 2022.3 EAP #5: Support for Links, Lists, and New Headings in Go Doc Comments"},"content":{"rendered":"\n

The fifth build of the GoLand 2022.3 EAP is now available! <\/p>\n\n\n\n

You can get the EAP build via the Toolbox App<\/a>, download it from our website<\/a>, use a snap package (for Ubuntu), or from inside GoLand, select Check IDE updates for Early Access Program<\/em> in Preferences\/Settings<\/em> | Appearance & Behavior<\/em> | System<\/em> Settings<\/em> | Updates<\/em>.<\/p>\n\n\n\n

\n \n Download GoLand 2022.3 EAP #5\n <\/a>\n<\/p>\n\n\n\n

Updates to Go doc comments<\/h2>\n\n\n\n

The latest Go release, version 1.19, has added support for links, lists, and new headings in doc comments. <\/p>\n\n\n\n

Starting from this EAP build, GoLand also supports these new features. <\/p>\n\n\n\n

Support for links <\/h3>\n\n\n\n

There are two types of links<\/a> in Go doc comments: links and doc links. <\/p>\n\n\n\n

Here\u2019s what links look like: <\/p>\n\n\n\n

\/\/ Package json implements encoding and decoding of JSON as defined in\n\/\/ [RFC 7159]. The mapping between JSON and Go values is described\n\/\/ in the documentation for the Marshal and Unmarshal functions.\n\/\/\n\/\/ For an introduction to this package, see the article\n\/\/ \u201c[JSON and Go].\u201d\n\/\/\n\/\/ [RFC 7159]: https:\/\/tools.ietf.org\/html\/rfc7159\n\/\/ [JSON and Go]: https:\/\/golang.org\/doc\/articles\/json_and_go.html<\/pre>\n\n\n\n
Doc links are \u201clinks of the form [Name1]<\/code> or [Name1.Name2]<\/code> to refer to exported identifiers in the current package, or [pkg]<\/code>, [pkg.Name1]<\/code>, or [pkg.Name1.Name2]<\/code> to refer to identifiers in other packages\u201d.<\/p>\n\n\n\n
Here\u2019s an example from the Go documentation<\/a>: <\/p>\n\n\n\n
\/\/ ReadFrom reads data from r until EOF and appends it to the buffer, growing\n\/\/ the buffer as needed. The return value n is the number of bytes read. Any\n\/\/ error except [io.EOF] encountered during the read is also returned. If the\n\/\/ buffer becomes too large, ReadFrom will panic with [ErrTooLarge].\nfunc (b *Buffer) ReadFrom(r io.Reader) (n int64, err error) {\n    ...\n}<\/pre>\n\n\n\n
We\u2019ve added references to doc links in GoLand. Clicking on them leads to the referenced element, while clicking on a text link leads to a text-link definition. <\/p>\n\n\n\n
Both text and doc links are rendered as links in the Quick Documentation<\/em> popup and the Documentation<\/em> tool window.<\/p>\n\n\n\n
To see the Quick Documentation<\/em> popup, press F1<\/em> (Ctrl\u2009+\u2009Q<\/em>). To open the Documentation<\/em> tool window, press F1<\/em> (Ctrl\u2009+\u2009Q<\/em>) again. <\/p>\n\n\n\n
Support for new headings <\/h3>\n\n\n\n
Starting from Go 1.19, a  heading is a line that begins with a number sign (#<\/code>) followed by a space and the heading text. Before, headings were identified<\/a> \u201cimplicitly by single-line paragraphs satisfying certain conditions, most notably the lack of any terminating punctuation\u201d.<\/p>\n\n\n\n
New headings are rendered as HTML headings in GoLand\u2019s Quick Documentation<\/em> popup and the Documentation<\/em> tool window.<\/p>\n\n\n\n
\"\"<\/figure>\n\n\n\n
Support for lists<\/h3>\n\n\n\n
A list item consists of a star, plus, dash, or Unicode bullet, followed by a space or tab and then text. Lists are rendered as HTML lists in GoLand\u2019s Quick Documentation<\/em> popup and the Documentation<\/em> tool window. <\/p>\n\n\n\n
\"\"<\/figure>\n\n\n\n
Databases: Redis support<\/h2>\n\n\n\n
A preliminary iteration of long-awaited support for Redis<\/a> has been implemented. <\/p>\n\n\n\n
\"\"<\/figure>\n\n\n\n
<\/p>\n\n\n\n
User interface <\/h2>\n\n\n\n
Improved Tips of the Day<\/em><\/h3>\n\n\n\n
We\u2019ve enhanced the Tips of the Day<\/em> feature \u2013 a learning tool that helps you explore GoLand and its features. <\/p>\n\n\n\n
Each tip now has a heading to help you understand which area of the IDE is being described and decide whether you want to learn more about the topic or skip it.<\/p>\n\n\n\n
We\u2019ve fine-tuned the algorithm that determines which tips appear so you\u2019ll see the ones that are most relevant to your experience with the IDE and the project you\u2019re working on. <\/p>\n\n\n\n
With the new approach to sorting, you\u2019ll first see tips about features you\u2019ve never used before while tips that are considered irrelevant to the specific project (based on the file extensions and technologies being used) won\u2019t be shown initially.<\/p>\n\n\n\n
\"\"<\/figure>\n\n\n\n
Updated bookmarks <\/h3>\n\n\n\n
We\u2019ve implemented a few UI improvements to fine-tune the Bookmarks <\/em>functionality after the merge of the Favorites<\/em> and Bookmarks<\/em> instances in the 2021.3 release<\/a>.<\/p>\n\n\n\n
It is once again possible to bookmark files from editor tabs. Just right-click on a tab to invoke the context menu and select Bookmarks<\/em>.<\/p>\n\n\n\n
Installers for Windows ARM64<\/h3>\n\n\n\n
We\u2019ve started distributing installers for Windows ARM64 \u2013 you can already download them from our website<\/a> or the Toolbox App<\/a>.<\/p>\n\n\n\n
That\u2019s it for today! We\u2019d love to hear what you think about the new features. Ping us on Twitter<\/a>, leave your comments here, open an issue in our tracker<\/a>, or drop us a message in the Gophers Slack<\/a> #goland channel. Thanks for reading!<\/p>\n","protected":false},"author":1254,"featured_media":281514,"comment_status":"closed","ping_status":"closed","template":"","categories":[826],"tags":[7140,91],"cross-post-tag":[],"acf":[],"_links":{"self":[{"href":"https:\/\/blog.jetbrains.com\/zh-hans\/wp-json\/wp\/v2\/go\/292107"}],"collection":[{"href":"https:\/\/blog.jetbrains.com\/zh-hans\/wp-json\/wp\/v2\/go"}],"about":[{"href":"https:\/\/blog.jetbrains.com\/zh-hans\/wp-json\/wp\/v2\/types\/go"}],"author":[{"embeddable":true,"href":"https:\/\/blog.jetbrains.com\/zh-hans\/wp-json\/wp\/v2\/users\/1254"}],"replies":[{"embeddable":true,"href":"https:\/\/blog.jetbrains.com\/zh-hans\/wp-json\/wp\/v2\/comments?post=292107"}],"version-history":[{"count":10,"href":"https:\/\/blog.jetbrains.com\/zh-hans\/wp-json\/wp\/v2\/go\/292107\/revisions"}],"predecessor-version":[{"id":294590,"href":"https:\/\/blog.jetbrains.com\/zh-hans\/wp-json\/wp\/v2\/go\/292107\/revisions\/294590"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/blog.jetbrains.com\/zh-hans\/wp-json\/wp\/v2\/media\/281514"}],"wp:attachment":[{"href":"https:\/\/blog.jetbrains.com\/zh-hans\/wp-json\/wp\/v2\/media?parent=292107"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/blog.jetbrains.com\/zh-hans\/wp-json\/wp\/v2\/categories?post=292107"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/blog.jetbrains.com\/zh-hans\/wp-json\/wp\/v2\/tags?post=292107"},{"taxonomy":"cross-post-tag","embeddable":true,"href":"https:\/\/blog.jetbrains.com\/zh-hans\/wp-json\/wp\/v2\/cross-post-tag?post=292107"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}