(Arne Babenhauserheide)
2017-01-17: update version and documentation with merged kanban-fill update version and documentation with merged kanban-fill
diff --git a/kanban.el b/kanban.el
--- a/kanban.el
+++ b/kanban.el
@@ -1,8 +1,9 @@
;;; kanban.el --- Parse org-todo headlines to use org-tables as Kanban tables
;;
;; Copyright (C) 2012-2016 Arne Babenhauserheide <arne_bab@web.de>
+;; and 2013 stackeffect
-;; Version: 0.1.7
+;; Version: 0.2.0
;; Author: Arne Babenhauserheide <arne_bab@web.de>
;; Keywords: outlines, convenience
@@ -39,7 +40,7 @@
;; * Zero state Kanban: Directly displaying org-mode todo states as kanban board
;;
;; Use the functions kanban-headers and kanban-zero in TBLFM lines to
-;; get your org-mode todo states as kanban table. Update with C-c C-c
+;; get your org-mode todo states as kanban table. Update with C-c C-c
;; on the TBLFM line.
;;
;; Example:
@@ -51,6 +52,15 @@
;; #+TBLFM: @1$1='(kanban-headers)::@2$1..@>$>='(kanban-zero @# $# "TAG" '(list-of-files))
;; "TAG" and the list of files are optional
;;
+;; Faster Example with kanban-fill:
+;;
+;; | | | |
+;; |---+---+---|
+;; | | | |
+;; | | | |
+;; #+TBLFM: @2='(kanban-fill "TAG" '(list-of-files))::@1$1='(kanban-headers $#)::
+;; "TAG" and the list of files are optional
+;;
;; * Stateful Kanban: Use org-mode to retrieve tasks, but track their state in the Kanban board
;;
;; | | | |
@@ -60,15 +70,16 @@
;; #+TBLFM: @1$1='(kanban-headers)::@2$1..@>$1='(kanban-todo @# @2$2..@>$> "TAG" '(list-of-files))
;; "TAG" and the list of files are optional
;;
-;; TODO: The links don’t yet work for tagged entries. Fix that. There
-;; has to be some org-mode function to retrieve the plain header.
-;;
+;; More complex use cases are described in the file sample.org
+;;
;; TODO: kanban-todo sometimes inserts no tasks at all if there are multiple tasks in non-standard states.
;;
;; TODO: bold text in headlines breaks the parser (*bold*).
;;
;; ChangeLog:
;;
+;; - 0.2.0: Finally merge the much faster kanban-fill from stackeffect.
+;; I’m sorry that it took me 3 years to get there.
;; - 0.1.7: strip keyword from link for org-version >= 9 and
;; avoid stripping trailing "* .*" in lines
;; - 0.1.6: defcustom instead of defvar
diff --git a/sample.org b/sample.org
--- a/sample.org
+++ b/sample.org
@@ -20,7 +20,7 @@ Example Kanban File
| | | | | | |
| | | | | | |
| | | | | | |
-#+TBLFM: @2$1..@>$>='(kanban-zero @# $# "+prj-HOLD" '("sample.org"))::@1='(kanban-headers $#)
+#+TBLFM: @1='(kanban-headers $#)::@2$1..@>$>='(kanban-zero @# $# "+prj-HOLD" '("sample.org"))
* Zero state Kanban: kanban-fill: == * Attention * ==
| | | | | WAITING | |