New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
[WIP] July Newsletter #52
Merged
Merged
Changes from 23 commits
Commits
Show all changes
26 commits
Select commit
Hold shift + click to select a range
bbfb257
Move July newsletter from _drafts/ into _posts/
jdavis de931f7
Add section on License change, fix Twitter tag
jdavis 666bcd9
Add note on License change
jdavis 3eba552
Change formatting of License note, next issue date
jdavis 9a0d66f
Add two more links to CLA section
jdavis 58f5a5f
Add section on compiling on Windows
jdavis 4abec4a
Add opener & link to the building Wiki page
jdavis 3d6a2d2
Add section on string handling
jdavis 3af4ef7
Add placeholder sections
jdavis 09cc2d5
Add possible title
jdavis 8673d6f
Add section on Doxygen + bot
jdavis 2bb8c3b
Add two more possible sections
jdavis 3534418
Move note after proper section
jdavis 2ecad74
Add section on neovim.org documentation
jdavis 11f01f3
Add another relevant issue to libcall section
jdavis 492612f
Add planned translation section
jdavis 392c0a6
Finish section on Neovim.org documentation
jdavis af7fb9d
Add translation section as per @philix
jdavis 24e0463
Standardize links depending on section, sort links
jdavis 641fdbe
Add section on garray
jdavis 9b21f54
Add section on colorscheme contest as per @justinmk
jdavis 3fc0cdf
Add section on Doxygen theme
jdavis 85762df
Add FileID section that continues last newsletter
jdavis 579a979
Add section on libcall as per @aktau
jdavis d64c957
Fix struct reference from stat.h to libuv
jdavis 829cff2
Finish @tarruda's section in the newsletter
jdavis File filter
Filter by extension
Conversations
Failed to load comments.
Jump to
Jump to file
Failed to load files.
Diff view
Diff view
There are no files selected for viewing
This file was deleted.
Oops, something went wrong.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,199 @@ | ||
--- | ||
layout: newsletter | ||
title: "Issue #2 - Perchance to Dream" | ||
category: newsletter | ||
permalink: /news/2014/july/ | ||
--- | ||
|
||
Welcome to the second monthly newsletter for Neovim, the project that dreams to | ||
be the next text editor that we'll all love. | ||
|
||
## General News | ||
|
||
### Colorscheme Contest | ||
|
||
In the discussion about [default Neovim settings][color-defaults], the idea of | ||
having a default colorscheme was brought up. A [later issue][color-discussion] | ||
was started to determine what colorscheme would be used. | ||
|
||
It was decided that a new colorscheme would be great for Neovim. To do this, the | ||
Neovim collaborators will create a contest that will allow submissions of | ||
colorschemes. After some time, the submissions will close and then a new Poll | ||
will be started to let the community pick the winner. | ||
|
||
The winner(s) will be awarded the prize money and their colorschemes will | ||
forever be enshrined in distributions of Neovim. | ||
|
||
Stay tuned to the [Neovim Twitter][info-twitter] for when the submission | ||
guidelines and process are announced. | ||
|
||
## Development News | ||
|
||
### Clarification of Neovim's License | ||
|
||
[Concern arose][license-concern] over Neovim using [Vim's | ||
license][license-vim]. While the Vim license still applies to the original Vim | ||
code, newly written code wasn't explicitly being addressed and could be | ||
relicensed. | ||
|
||
The community settled on using [Apache 2.0][license-apache]. The license info | ||
was then [updated][license-update] and all contributors have been asked to sign | ||
a [CLA][license-cla] by filling out [this document][license-cla-doc] and adding | ||
your name to [this Wiki page][license-cla-wiki]. | ||
|
||
#### Note | ||
|
||
> This means that if you've contributed code *before* the switch to Apache 2.0, | ||
> your code is still under the old Vim license. It won't become part of Apache 2.0 | ||
> *unless* you sign the CLA. | ||
|
||
### Compiling under Windows | ||
|
||
The ability to build Neovim on Windows has been popular and a [target for | ||
months][windows-months]. The entire discussion can be viewed in [this | ||
issue][windows-master]. | ||
|
||
[Recent progress][windows-equalsraf] has been made by @equalsraf in his attempt | ||
to build Neovim under [MinGW][windows-mingw]. | ||
|
||
For help building on other platforms, be sure to check out the newly minted | ||
[Building Neovim page][windows-building] on the Wiki for all things related to | ||
compiling. | ||
|
||
### String Handling | ||
|
||
[Effort was made][string-strncpy] to replace `vim_strncpy` with `strlcpy` and | ||
it was merged in successfully. However there was a bit of | ||
[fallout][string-fallout] from the changes. | ||
|
||
In response, @aktau created a [master issue][string-master] to collaborate on | ||
the process and discuss the best way forward. | ||
|
||
To quote @philix, he summed it up best in [his comment][string-comment]: | ||
|
||
> String handling is really important in a text editor and the current codebase | ||
> doesn't have good abstractions for string handling (even though we've been | ||
> slowly improving it). It's a miracle how much can be accomplished with so | ||
> little abstraction (and a lot of low level code). | ||
|
||
### Growable Array Additions | ||
|
||
[Garray.c][garray-code] is a data structure from Vim that provides a | ||
"**g**rowable **array**" to the editor. It has been the target of many [pull | ||
requests][garray-issues] in the past. | ||
|
||
The [latest addition][garray-append-init] by @philix gives an easier way to | ||
append to the array. While `garray` is still being improved, eventually it will | ||
be phased out by a more robust solution. | ||
|
||
### Implement VimL libcall Section Here | ||
|
||
- https://github.com/neovim/neovim/pull/802 | ||
- https://github.com/neovim/neovim/issues/795 | ||
|
||
### Thiago's Progress Section Here | ||
|
||
- https://github.com/neovim/neovim/pull/853 | ||
- https://github.com/neovim/neovim/pull/872 | ||
|
||
### Doxygen Theme | ||
|
||
@stefan991 customized the Doxygen theme to style it similar to how Neovim.org | ||
looks. It was then [added to the codebase][docs-theme] for future builds. | ||
|
||
### Continued File Function Refactoring | ||
|
||
In last month's issue, we talked about the [changes to `mch_stat` | ||
calls][file-previous]. This refactoring was [continued][file-continued] by | ||
@stefan991 to add a new structure that encapsulates `st_dev` and `st_ino` of | ||
libc's [stat.h][file-stat-h] attributes of the `struct stat`. | ||
|
||
### Translations | ||
|
||
Contributors to Neovim live in countries all over the world. Many native | ||
speakers have been busy updating the translations in their native languages. | ||
|
||
Translations that already have been updated include | ||
[German][translation-german] and [Brazilian Portuguese][translation-pt-br]. With | ||
others like [Spanish][translation-spanish] and [Swedish][translation-swedish] in | ||
the works. | ||
|
||
## Shape of Things to Come | ||
|
||
### Documentation on Neovim.org | ||
|
||
Neovim's [development documentation][docs-dev] that is autogenerated by Doxygen | ||
is in the process of being [moved to the neovim.org][docs-doxygen] domain. | ||
|
||
In addition to that, the user documentation for Neovim is being [moved there as | ||
well][docs-user]. | ||
|
||
To aid in the process, @Marvim, Neovim's newly appointed resident automaton (aka | ||
bot), will be configured to automate the process. Just don't [talk to him about | ||
life][docs-quotes]. | ||
|
||
### Donating | ||
|
||
If you'd like to help support development, you may donate using Bitcoins here: | ||
`1Evu6wPrzjsjrNPdCYbHy3HT6ry2EzXFyQ` or back the team on the [Neovim | ||
Bountysource][info-bountysource] page. | ||
|
||
### Contributing | ||
|
||
If you an experienced developer or inexperienced but wanting to learn, visit the | ||
[GitHub repo][info-github] and check out the [README][info-readme], | ||
[CONTRIBUTING][info-contrib] guide, and finally the [Wiki][info-wiki] to learn more. | ||
|
||
There are plenty of opportunities to help out and plenty of things to do. | ||
|
||
## That's a Wrap | ||
|
||
Do you have any feedback or suggestions regarding this first newsletter? Feel | ||
free to reach out through the [Neovim Twitter][info-twitter]. | ||
|
||
Also be sure to subscribe to the [RSS feed][info-rss] to stay up-to-date on what is | ||
happening in the Neovim world. The next newsletter will be released the first | ||
Friday of August. | ||
|
||
Until next time. `:wq` | ||
|
||
[docs-dev]: http://neovim.menkar.uberspace.de/devdoc/ | ||
[docs-doxygen]: https://github.com/neovim/neovim.github.io/issues/48 | ||
[docs-quotes]: http://hitchhikers.wikia.com/wiki/Marvin#Quotes_by_Marvin | ||
[docs-user]: https://github.com/neovim/neovim.github.io/issues/55 | ||
[docs-theme]: https://github.com/neovim/neovim/pull/824 | ||
[info-bountysource]: https://www.bountysource.com/teams/neovim | ||
[info-contrib]: https://github.com/neovim/neovim/blob/master/CONTRIBUTING.md | ||
[info-github]: https://github.com/neovim/neovim/ | ||
[info-readme]: https://github.com/neovim/neovim/blob/master/README.md | ||
[info-rss]: {{ site.news.feed }} | ||
[info-twitter]: https://twitter.com/Neovim | ||
[info-wiki]: https://github.com/neovim/neovim/wiki | ||
[license-apache]: https://tldrlegal.com/license/apache-license-2.0-(apache-2.0) | ||
[license-cla-doc]: https://docs.google.com/forms/d/1u54bpbwzneDIRltFx1TGi2evKxY3w0cOV3vlpj8DPbg/viewform | ||
[license-cla-wiki]: https://github.com/neovim/neovim/wiki/CLA-confirmation-page | ||
[license-cla]: http://en.wikipedia.org/wiki/Contributor_License_Agreement | ||
[license-concern]: https://github.com/neovim/neovim/issues/878 | ||
[license-update]: https://github.com/neovim/neovim/pull/883 | ||
[license-vim]: http://vimdoc.sourceforge.net/htmldoc/uganda.html#license | ||
[string-comment]: https://github.com/neovim/neovim/issues/859#issuecomment-46429356 | ||
[string-fallout]: https://github.com/neovim/neovim/issues/858 | ||
[string-master]: https://github.com/neovim/neovim/issues/859 | ||
[string-strncpy]: https://github.com/neovim/neovim/pull/743 | ||
[translation-german]: https://github.com/neovim/neovim/pull/780 | ||
[translation-pt-br]: https://github.com/neovim/neovim/pull/892 | ||
[translation-spanish]: https://github.com/neovim/neovim/pull/913 | ||
[translation-swedish]: https://github.com/neovim/neovim/pull/913 | ||
[windows-building]: https://github.com/neovim/neovim/wiki/Building-Neovim | ||
[windows-equalsraf]: https://github.com/neovim/neovim/pull/810 | ||
[windows-master]: https://github.com/neovim/neovim/issues/696 | ||
[windows-mingw]: http://www.mingw.org/ | ||
[windows-months]: https://github.com/neovim/neovim/issues/328 | ||
[garray-code]: https://github.com/neovim/neovim/blob/master/src/nvim/garray.c | ||
[garray-issues]: https://github.com/neovim/neovim/search?q=garray&ref=cmdform&type=Issues | ||
[garray-append-init]: https://github.com/neovim/neovim/pull/830 | ||
[color-discussion]: https://github.com/neovim/neovim/issues/793 | ||
[color-defaults]: https://github.com/neovim/neovim/issues/276 | ||
[file-previous]: https://github.com/neovim/neovim/pull/619 | ||
[file-continued]: https://github.com/neovim/neovim/pull/775 | ||
[file-stat-h]: http://www.gnu.org/software/libc/manual/html_node/Attribute-Meanings.html |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
It's not libc's
struct stat
but libuv'suv_stat_t
(https://github.com/joyent/libuv/blob/b9b386ac5a8bf772af95e7238c3f0b6673626923/include/uv.h#L441). Not sure if this detail is relevant for the readers of the newsletter.