[docgen] Update doc/orgmode.txt

skip-checks: true

Author: github-actions

doc/orgmode.txt

@@ -144,26 +144,27 @@ CONTENTS                                                        *orgmode-content
             1.3.6.8. around_subtree_from_root...|orgmode-around_subtree_from_root|
         1.3.7. Dot repeat.....................................|orgmode-dot_repeat|
     1.4. Document Diagnostics.......................|orgmode-document_diagnostics|
-    1.5. Autocompletion...................................|orgmode-autocompletion|
-    1.6. Abbreviations.....................................|orgmode-abbreviations|
-    1.7. Colors...................................................|orgmode-colors|
-        1.7.1. Highlight Groups.........................|orgmode-highlight_groups|
-    1.8. Advanced search.................................|orgmode-advanced_search|
-    1.9. Notifications (experimental).......|orgmode-notifications_(experimental)|
-        1.9.1. Cron.................................................|orgmode-cron|
-    1.10. Clocking..............................................|orgmode-clocking|
-                1.10.1. Clock in................................|orgmode-clock_in|
-                1.10.2. Clock out..............................|orgmode-clock_out|
-                1.10.3. Clock cancel........................|orgmode-clock_cancel|
-                1.10.4. Clock goto............................|orgmode-clock_goto|
-                1.10.5. Set effort............................|orgmode-set_effort|
-                1.10.6. Clock report table............|orgmode-clock_report_table|
-                1.10.7. Automatic updates of totals.|orgmode-automatic_updates_of_totals|
-                1.10.8. Recalculating totals........|orgmode-recalculating_totals|
-                1.10.9. Statusline function..........|orgmode-statusline_function|
-    1.11. Changelog............................................|orgmode-changelog|
-            1.11.1. 24 October 2021......................|orgmode-24_october_2021|
-            1.11.2. 10 October 2021......................|orgmode-10_october_2021|
+    1.5. Tables...................................................|orgmode-tables|
+    1.6. Autocompletion...................................|orgmode-autocompletion|
+    1.7. Abbreviations.....................................|orgmode-abbreviations|
+    1.8. Colors...................................................|orgmode-colors|
+        1.8.1. Highlight Groups.........................|orgmode-highlight_groups|
+    1.9. Advanced search.................................|orgmode-advanced_search|
+    1.10. Notifications (experimental)......|orgmode-notifications_(experimental)|
+        1.10.1. Cron................................................|orgmode-cron|
+    1.11. Clocking..............................................|orgmode-clocking|
+                1.11.1. Clock in................................|orgmode-clock_in|
+                1.11.2. Clock out..............................|orgmode-clock_out|
+                1.11.3. Clock cancel........................|orgmode-clock_cancel|
+                1.11.4. Clock goto............................|orgmode-clock_goto|
+                1.11.5. Set effort............................|orgmode-set_effort|
+                1.11.6. Clock report table............|orgmode-clock_report_table|
+                1.11.7. Automatic updates of totals.|orgmode-automatic_updates_of_totals|
+                1.11.8. Recalculating totals........|orgmode-recalculating_totals|
+                1.11.9. Statusline function..........|orgmode-statusline_function|
+    1.12. Changelog............................................|orgmode-changelog|
+            1.12.1. 24 October 2021......................|orgmode-24_october_2021|
+            1.12.2. 10 October 2021......................|orgmode-10_october_2021|
 
 ================================================================================
 TABLE OF CONTENT                                        *orgmode-table_of_content*
@@ -182,13 +183,14 @@ TABLE OF CONTENT                                        *orgmode-table_of_conten
     6.  Text objects (#text-objects)
     7.  Dot repeat (#dot-repeat)
 4.  Document Diagnostics (#document-diagnostics)
-5.  Autocompletion (#autocompletion)
-6.  Abbreviations (#abbreviations)
-7.  Colors (#colors)
-8.  Advanced search (#advanced-search)
-9.  Notifications (experimental) (#notifications-experimental)
-10. Clocking (#clocking)
-11. Changelog (#changelog)
+5.  Tables (#tables)
+6.  Autocompletion (#autocompletion)
+7.  Abbreviations (#abbreviations)
+8.  Colors (#colors)
+9.  Advanced search (#advanced-search)
+10. Notifications (experimental) (#notifications-experimental)
+11. Clocking (#clocking)
+12. Changelog (#changelog)
 
 --------------------------------------------------------------------------------
 GETTING STARTED WITH ORGMODE                *orgmode-getting_started_with_orgmode*
@@ -1310,6 +1312,29 @@ DOCUMENT DIAGNOSTICS                                *orgmode-document_diagnostic
 Since tree-sitter parser is being used to parse the file, if there are some syntax errors,
 it can potentially fail to parse specific parts of document when needed.
 
+--------------------------------------------------------------------------------
+TABLES                                                            *orgmode-tables*
+
+Tables can be formatted via built in `formatexpr` (see `:help gq`)
+
+For example, having this content:
+>
+    * TODO My headline
+      DEADLINE: <2022-05-22 Sun>
+      |Header 1|Header 2
+      |-
+      | col 1| col 2|
+<
+
+And going to line `4` and pressing `gqgq`, it will format it to this:
+>
+    * TODO My headline
+      DEADLINE: <2022-05-22 Sun>
+      | Header 1 | Header 2 |
+      |----------+----------|
+      | col 1    | col 2    |
+<
+
 --------------------------------------------------------------------------------
 AUTOCOMPLETION                                            *orgmode-autocompletion*