add missing calendar-syntax doc

[WnP]

Syntax documentation is listed in the documentation content but not present

this is a starting point based on what I found, but I missed some points

• how to create a few days event (example: from 2014-10-10 to 2014-10-12), and is it possible to specified starting and finishing hours for this kind of events?
• is it possible to add notes to event?

extra question:

• is it possible to see event notes directly in the vim interface?

btw, thanks a lot this is a realy good plugin ;-)

[itchyny]

By calendar-syntax, I meant the syntax name for highlighting (CalendarSunday or CalendarToday or something like that). But you're right, the document body is missing. I'll add the document later.

Your request looks nice, because the plugin has some special syntaxes for inputting the events and texts as you know. So I'll accept your request. Any suggestion for better section name? (calendar-input-syntax or calendar-format or whatever) Answers to your questions.

• To create a few days event, you can use 10/10-10/12 test or 2014/10/10-2014/10/12 test, 2014-10-10-2014-10-12 test. You can also use visual mode (press v).
• To create an event with both days and hours range, you can input as 10/10 19:00-10/11 21:00 or with the year specified. Again this time you can use visual mode in n-days view.
• I think there's no notes for event (for reference https://developers.google.com/google-apps/calendar/v3/reference/events). If you mean description, it is not possible to add to an event.
• I do not get what you mean by vim interface. If you mean Vim Script interface, you can use the autoload function of this plugin. For example, calendar#google#calendar#getEvents(2014, 10). But it may change the behaviour with breaking compatibility.

I'm not going to merge right away so please fill the document and improve this pull request.

[WnP]

I choose calendar-input-format for this section name, let me know if it sounds good to you

it looks like that google's calender API alow communication with the description field, it could be nice if we could both create and edit it in the calendar.vim user interface, but as this feature is not implemented I think it's another topic and we must talk about it out of this pull request

let me know

[itchyny]

Merged. Thank you for your pull request. I will improve the document from now on.