From d9f95fa3f771a3ab45a80472721362efc1815697 Mon Sep 17 00:00:00 2001
From: Gerard Vermeulen <gerard.vermeulen@posteo.net>
Date: Thu, 29 Jun 2023 16:25:04 +0200
Subject: [PATCH] Add examples of property syntax, column view, and dynamic
 block use

---
 .gitignore |  4 ++-
 README.org | 96 ++++++++++++++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 99 insertions(+), 1 deletion(-)

diff --git a/.gitignore b/.gitignore
index 4797201..98e69e5 100644
--- a/.gitignore
+++ b/.gitignore
@@ -17,11 +17,13 @@
 *.tex
 *.toc
 
+column-view-demonstration.org
 dir-locals.el
 example.py
 latexmkrc
-pyproject.toml
 org-store-link
+property-syntax-demonstration.org
+pyproject.toml
 setup.cfg
 tree.svg
 worg-backend-dependent-execution-update.org
diff --git a/README.org b/README.org
index 799df91..248b330 100644
--- a/README.org
+++ b/README.org
@@ -2714,6 +2714,102 @@ Set ~org-html-style-default~ option to add =HTML+CSS+JS= for ~mhtml-mode~:
 )
 #+end_src
 
+***  [[info:org#Column View][Column View (info)]] and [[info:org#Property Syntax][Property Syntax (info)]]
+:PROPERTIES:
+:CUSTOM_ID: sec:using-properties
+:END:
+
+Listing [[lst:column-view-demonstration][column view demonstation]] tangles to [[./column-view-demonstration.org][column-view-demonstration.org]] which
+complements the [[https://orgmode.org/worg/org-tutorials/org-column-view-tutorial.html][Org view tutorial]] and the [[https://orgmode.org/worg/org-tutorials/org-column-screencast.html][Org view screencast]].  Listing [[lst:property-syntax-demonstration][property
+syntax demonstation]] tangles to [[./property-syntax-demonstration.org][property-syntax-demonstration.org]] which
+complements [[info:org#Property Syntax][property syntax (info)]].
+
+#+caption[Column view demonstration]:
+#+caption: Column view demonstration.
+#+name: lst:column-view-demonstration
+#+begin_src org -n :tangle column-view-demonstration.org
+,#+TITLE: Column View Demonstration
+,* Column view use
+1. Type "M-x org-columns" in the "Columns view top" tree to turn on column view.
+2. Press "tab" to (un-)fold the "Example 1", "Example 2", and "Example 3" rows.
+3. Move point to the "OK?" cell of the "Example 1" row and type "e" to edit it.
+   - This changes the "Columns view top" row "OK?" field value.
+4. Move point to the "DURATION" cell and type "e"" to edit it.
+   - This changes the "Columns view top" row "DURATION" field value.
+5. Type "q" on one of the column view rows to turn off column view.
+,* Column view top
+SCHEDULED: <2023-06-30 Fri>
+:PROPERTIES:
+:COLUMNS:  %17ITEM %OK(OK?){X} %OWNER %STATUS %DURATION{:} %TODO %16SCHEDULED
+:OWNER_ALL: Ada Bob Carl
+:STATUS_ALL: "Shopping" "Cooking" "Eating"
+:OK_ALL: "[ ]" "[X]"
+:END:
+,** DONE Example 1
+:PROPERTIES:
+:OWNER:    Ada
+:STATUS:   Shopping
+:DURATION: 1:00
+:OK:       [X]
+:END:
+,** DONE Example 2
+:PROPERTIES:
+:OWNER:    Bob
+:STATUS:   Cooking
+:DURATION: 1:00
+:OK:       [X]
+:END:
+,** TODO Example 3
+:PROPERTIES:
+:OWNER:    Carl
+:STATUS:   Eating
+:DURATION: 0:00
+:OK:       [ ]
+:END:
+#+end_src
+
+#+caption[Property syntax demonstration]:
+#+caption: Property syntax demonstration.
+#+name: lst:property-syntax-demonstration
+#+begin_src org :tangle property-syntax-demonstration.org
+,#+TITLE: Property Syntax Demonstration
+,* Column view use
+1. Type "M-x org-columns" in the "CD collection" tree to turn on column view.
+   - The column view appends the value of ":GENRES+:" to that of ":GENRES:".
+2. Type "q" on one of the column view rows to turn off column view.
+,* Dynamic block use
+1. Type "M-x org-insert-columns-dblock" to capture a column view table.
+   - Type headline title of the tree to capture
+   - The block appends the value of ":GENRES+:" to that of ":GENRES:".
+,* CD collection
+:PROPERTIES:
+:NDISK_ALL: 1 2 3 4
+:PUBLISHER_ALL: "Deutsche Grammophon" Philips EMI
+:COLUMNS:  %TITLE %ARTIST %GENRES %NDISK(N) %PUBLISHER
+:ID:       CD collection
+:END:
+,** Classic
+:PROPERTIES:
+:GENRES:   Classic
+:END:
+,*** Goldberg Variations
+:PROPERTIES:
+:TITLE:    Goldberg Variations
+:COMPOSER: J.S. Bach
+:ARTIST:   G. Gould
+:GENRES+:  Baroque
+:NDISK: 1
+:PUBLISHER: Deutsche Grammophon
+:END:
+,#+BEGIN: columnview :hlines 1 :id "CD collection"
+| TITLE               | ARTIST   | GENRES          | N | PUBLISHER           |
+|---------------------+----------+-----------------+---+---------------------|
+|                     |          |                 |   |                     |
+|                     |          | Classic         |   |                     |
+| Goldberg Variations | G. Gould | Classic Baroque | 1 | Deutsche Grammophon |
+,#+END:
+#+end_src
+
 *** Org introspection
 :PROPERTIES:
 :CUSTOM_ID: sec:org-introspection