Comments (11)
from language-go.
Want to know if it's ok or if authors have some overriding preference.
On Sat, Apr 26, 2014 at 2:35 PM, Joe Fitzgerald [email protected]
wrote:
👍 Where's the PR @drnic?Reply to this email directly or view it on GitHub:
#16 (comment)
from language-go.
I'm fine trusting interested Go users on this one.
from language-go.
@drnic Pull request to
from language-go.
Further references supporting the desire to prefer //
over /* ... */
:
- http://blog.golang.org/godoc-documenting-go-code
- https://code.google.com/p/go-wiki/wiki/CodeReviewComments
- http://golang.org/doc/effective_go.html#commentary
In summary, it the vast majority of your comments are likely to be line-style. Block-style comments may occasionally be seen in package comments, but even then only in non-trivial packages (likely with examples).
Consequently, //
would be preferable as it is most commonly used, and it would be nice if we had another keyboard shortcut for /* ... */
?
from language-go.
@nathansobo I'm looking across a couple of packages - not sure what it is that defines the comment type for Cmd+/ - can you point me to some examples?
from language-go.
@drnic @nathansobo https://github.com/atom/language-go/blob/master/grammars/go.cson#L300-L324?
from language-go.
@drnic @nathansobo plus this: https://github.com/atom/language-go/blob/master/grammars/go.cson#L11-L15 ?
from language-go.
I think that's just defining that /* ... */ is a valid multi-level comment
syntax. Not that Cmd+/ toggles comment.
On Mon, Apr 28, 2014 at 9:50 AM, Joe Fitzgerald [email protected]:
@drnic https://github.com/drnic @nathansobohttps://github.com/nathansobo
https://github.com/atom/language-go/blob/master/grammars/go.cson#L300-L324
?—
Reply to this email directly or view it on GitHubhttps://github.com//issues/16#issuecomment-41582914
.
Dr Nic Williams
Stark & Wayne LLC - consultancy for Cloud Foundry users
http://drnicwilliams.com
http://starkandwayne.com
cell +1 (415) 860-2185
twitter @drnic
from language-go.
When you comment the editor wraps the text in <span class="comment block go">...</>
. https://github.com/atom/language-go/blob/master/grammars/go.cson#L15 Defines comment.block.empty.go
. https://github.com/atom/language-go/blob/master/grammars/go.cson#L308 defines comment.block.go
.
from language-go.
@drnic Looks like scoped-properties = deliverance: https://github.com/atom/language-yaml/blob/master/scoped-properties/language-yaml.cson#L3
from language-go.
Related Issues (20)
- Differentiate between methods and functions
- Go not highlighted with tree-sitter
- Package variables and types missing syntax highlights HOT 1
- Language-go package seems to not work HOT 2
- Cannot fold up the "case" statement
- Cannot fold up a continuous comment-out code HOT 4
- Import scope is gone HOT 2
- Wrong highlighting for function parameters HOT 2
- Enhancement: Highlight *.gotpl files HOT 1
- In TextMate grammar, string in map declaration is incorrectly scoped HOT 1
- No autocomplete for certain langauge keywords like `return` or `break` etc HOT 1
- Feature request: add scope to all types, not just builtins HOT 3
- Go constants with omitted assignment are not syntax highlighted correctly with TextMate grammar HOT 1
- Support syntax highlighting for changes to number literals introduced in Go 1.13 HOT 2
- Scope of names, types of declarations inconsistent HOT 1
- Adding more common go package snippets HOT 2
- <unknown> is deprecated.
- Question regarding "HTML (Go)" highlighting
- Failed to load a language-go package grammar
- Not possible to fold case within switch
Recommend Projects
-
React
A declarative, efficient, and flexible JavaScript library for building user interfaces.
-
Vue.js
🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
-
Typescript
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
-
TensorFlow
An Open Source Machine Learning Framework for Everyone
-
Django
The Web framework for perfectionists with deadlines.
-
Laravel
A PHP framework for web artisans
-
D3
Bring data to life with SVG, Canvas and HTML. 📊📈🎉
-
Recommend Topics
-
javascript
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
-
web
Some thing interesting about web. New door for the world.
-
server
A server is a program made to process requests and deliver data to clients.
-
Machine learning
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
-
Visualization
Some thing interesting about visualization, use data art
-
Game
Some thing interesting about game, make everyone happy.
Recommend Org
-
Facebook
We are working to build community through open source technology. NB: members must have two-factor auth.
-
Microsoft
Open source projects and samples from Microsoft.
-
Google
Google ❤️ Open Source for everyone.
-
Alibaba
Alibaba Open Source for everyone
-
D3
Data-Driven Documents codes.
-
Tencent
China tencent open source team.
from language-go.