feats: a little bunch of them. see description.

.gitignore

@@ -1 +1,3 @@
 .cask
+test.sh
+x.sh

.travis.yml

@@ -5,6 +5,7 @@ env:
   - EVM_EMACS=emacs-24.5-travis
   - EVM_EMACS=emacs-25.3-travis
   - EVM_EMACS=emacs-26.1-travis
+  - EVM_EMACS=emacs-27.1-travis
   - EVM_EMACS=emacs-git-snapshot-travis
 before_install:
   - curl -fsSkL https://gist.github.com/rejeep/ebcd57c3af83b049833b/raw > x.sh && source ./x.sh
@@ -16,4 +17,8 @@ script:
 matrix:
   fast_finish: true
   allow_failures:
+    - env: EVM_EMACS=emacs-24.4-travis
+    - env: EVM_EMACS=emacs-24.5-travis
+    - env: EVM_EMACS=emacs-25.3-travis
+    - env: EVM_EMACS=emacs-26.1-travis
     - env: EVM_EMACS=emacs-git-snapshot-travis

README.md

@@ -14,11 +14,44 @@ After you install this package from MELPA Stable, add the following line to your
 
 # How it works
 
-This package adds a graphical view of the agenda after the last agenda line.  By default the display starts at 5 AM today and goes up to 4 AM next day (this covers 24 hours).
+This package adds a graphical view of the agenda after the last agenda line.  By default the display starts at 5 AM today and goes up to 4 AM next day (this covers 24 hours). This value can be customized with `org-timeline-beginning-of-day-hour`.
 
-Scheduled tasks or tasks with time ranges are rendered in the display with `org-timeline-block` face.  Clocked entires are displayed in `org-timeline-clocked` face.  The background of timeslots which are in the past is highlighted with `org-timeline-elapsed` face.
+Scheduled tasks or tasks with time ranges are rendered in the display with `org-timeline-block` face.  Clocked entries are displayed in `org-timeline-clocked` face.  The background of timeslots which are in the past is highlighted with `org-timeline-elapsed` face.
 
 You can use custom color for a task by adding the property `TIMELINE_FACE` with either a string which is a color name or a list which specifies the face properties or a symbol which is taken to be a face name.
+You can choose to show the task's headlines in blocks, by setting `org-timeline-show-text-in-blocks` to a non-nil value. You can customize the text for a task with by adding the property `TIMELINE_TEXT` with a string.
+
+# Further customization
+
+## Overlapping blocks
+By default, if two blocks overlap, one of them is drawn in the `org-timeline-overlap` face. You can set `org-timeline-overlap-in-new-line` to t, and overlapping blocks will be drawn in separate lines.
+You can also be task-specific, and add the property `TIMELINE_DO_NOT_OVERLAP` with a non-nil value.
+
+## Consecutive blocks
+In order to make consecutive blocks distinct, every other consecutive block is decorated with a white overline. 
+
+For the same reason, a character is added at the beginning of every block, if `org-timeline-show-text-in-blocks` is non-nil. By default, this character is a heavy vertical bar ❚, but it can be customized with `org-timeline-insert-before-text`.
+
+## Special entries
+By default, clocked entries will be shown in a dedicated line, in `org-timeline-clocked` face. If you do not like this, you can set `org-timeline-dedicated-clocked-line` to nil. 
+
+You can also emphasize the next block to happen with `org-timeline-emphasize-next-block`. If non-nil, the next-block in today's line will be drawn in `org-timeline-next-block` face.
+
+## Groups
+You can add the string property `TIMELINE_GROUP` to your tasks. Every task with the same group name will be shown in a separate, dedicated line for that day.
+The first three characters of the name will be shown at the beginning of that line.
+
+## Rolling 24h cycle
+You can set up org-timeline and org-agenda so that the timeline will show a rolling 24h cycle, starting a certain number of hours before now.
+- Set `org-agenda-span` to 2 
+- Set `org-timeline-beginning-of-day-hour` to 0 
+- Set `org-timeline-keep-elapsed` to a positive integer (5, for example).
+
+Run `org-agenda` in day mode.
+
+# Other details
+You can click on a block, it will take you to the corresponding task in the buffer.
+The info line (just below the timeline) shows the details of the next task to happen. You can hit 'r' outside of the timeline to refresh the agenda and show the next task again.
 
 # TODO