Bug: table editor documentation [9.4.6 (9.4.6-7-gc09356-elpa @ /Users/alanwehmann/.emacs.d/elpa/org-20210621/)]

[Alan Wehmann]

--text follows this line--

Info node "(org) Built-in Table Editor"

says:

‘M-<RET>’ (‘org-table-wrap-region’)

     Split the current field at point position and move the rest to the

     line below.  If there is an active region, and both point and mark

     are in the same column, the text in the column is wrapped to

     minimum width for the given number of lines.  A numeric prefix

     argument may be used to change the number of desired lines.  If

     there is no region, but you specify a prefix argument, the current

     field is made blank, and the content is appended to the field

     above.

But M-<RET> is mapped to "org-meta-return".  That function's documentation says:

When called with

an argument, unconditionally call ‘org-insert-heading’.

------------------------------------------------------------------------

which conflicts with what the Info node says.  Using M-<RET> with a prefix argument and no region does not work as described by the Info node.  Instead of using the key mapping, one can evaluate (org-table-wrap-region '(4)) and that will work as described.

My setup:

Emacs  : GNU Emacs 27.1 (build 1, x86_64-apple-darwin18.7.0, NS appkit-1671.60 Version 10.14.6 (Build 18G95))
 of 2020-08-12
Package: Org mode version 9.4.6 (9.4.6-7-gc09356-elpa @ /Users/alanwehmann/.emacs.d/elpa/org-20210621/)

current state:
==============
(setq
 org-src-mode-hook '(org-src-babel-configure-edit-buffer
     org-src-mode-configure-edit-buffer)
 org-link-shell-confirm-function 'yes-or-no-p
 org-metadown-hook '(org-babel-pop-to-session-maybe)
 org-clock-out-hook '(org-clock-remove-empty-clock-drawer)
 org-modules '(ol-bbdb ol-bibtex ol-docview ol-eww ol-gnus ol-info ol-irc ol-mhe
       ol-rmail ol-w3m ol-vm)
 org-mode-hook '(#[0 "\300\301\302\303\304$\207"
   [add-hook change-major-mode-hook org-show-all append local] 5]
 #[0 "\300\301\302\303\304$\207"
   [add-hook change-major-mode-hook org-babel-show-result-all
    append local]
   5]
 org-babel-result-hide-spec org-babel-hide-all-hashes)
 org-archive-hook '(org-attach-archive-delete-maybe)
 org-confirm-elisp-link-function 'yes-or-no-p
 org-agenda-before-write-hook '(org-agenda-add-entry-text)
 org-metaup-hook '(org-babel-load-in-session-maybe)
 org-bibtex-headline-format-function #[257 "\300
\236A\207" [:title] 3 "\n\n(fn ENTRY)"]
 org-adapt-indentation nil
 org-babel-pre-tangle-hook '(save-buffer)
 org-tab-first-hook '(org-babel-hide-result-toggle-maybe
      org-babel-header-arg-expand)
 org-load-hook '((lambda nil (define-key org-mode-map (kbd "M-q") #'fill-region)))
 org-agenda-loop-over-headlines-in-active-region nil
 org-src-lang-modes '(("redis" . redis) ("php" . php) ("arduino" . arduino)
      ("C" . c) ("C++" . c++) ("asymptote" . asy) ("bash" . sh)
      ("beamer" . latex) ("calc" . fundamental) ("cpp" . c++)
      ("ditaa" . artist) ("dot" . fundamental)
      ("elisp" . emacs-lisp) ("ocaml" . tuareg)
      ("screen" . shell-script) ("shell" . sh) ("sqlite" . sql))
 org-catch-invisible-edits 'show-and-error
 org-occur-hook '(org-first-headline-recenter)
 org-cycle-hook '(org-cycle-hide-archived-subtrees org-cycle-hide-drawers
  org-cycle-show-empty-lines
  org-optimize-window-after-visibility-change)
 org-speed-command-hook '(org-speed-command-activate
  org-babel-speed-command-activate)
 org-export-before-parsing-hook '(org-attach-expand-links)
 org-confirm-shell-link-function 'yes-or-no-p
 org-link-parameters '(("attachment" :follow org-attach-follow :complete
org-attach-complete-link)
       ("id" :follow org-id-open)
       ("vm-imap" :follow org-vm-imap-open)
       ("vm" :follow org-vm-open :store org-vm-store-link)
       ("w3m" :store org-w3m-store-link)
       ("rmail" :follow org-rmail-open :store org-rmail-store-link)
       ("mhe" :follow org-mhe-open :store org-mhe-store-link)
       ("irc" :follow org-irc-visit :store org-irc-store-link
:export org-irc-export)
       ("info" :follow org-info-open :export org-info-export :store
org-info-store-link)
       ("gnus" :follow org-gnus-open :store org-gnus-store-link)
       ("eww" :follow org-eww-open :store org-eww-store-link)
       ("docview" :follow org-docview-open :export
org-docview-export :store org-docview-store-link)
       ("bibtex" :follow org-bibtex-open :store
org-bibtex-store-link)
       ("bbdb" :follow org-bbdb-open :export org-bbdb-export
:complete org-bbdb-complete-link :store org-bbdb-store-link)
       ("bookmark-other-win" :follow bookmark-jump-other-window
:export nil)
       ("bookmark" :follow bookmark-jump :export nil) ("file+sys")
       ("file+emacs") ("shell" :follow org-link--open-shell)
       ("news" :follow
#[514 "\301\300\302Q\"\207" ["news" browse-url ":"] 6
  "\n\n(fn URL ARG)"]
)
       ("mailto" :follow
#[514 "\301\300\302Q\"\207" ["mailto" browse-url ":"] 6
  "\n\n(fn URL ARG)"]
)
       ("https" :follow
#[514 "\301\300\302Q\"\207" ["https" browse-url ":"] 6
  "\n\n(fn URL ARG)"]
)
       ("http" :follow
#[514 "\301\300\302Q\"\207" ["http" browse-url ":"] 6
  "\n\n(fn URL ARG)"]
)
       ("ftp" :follow
#[514 "\301\300\302Q\"\207" ["ftp" browse-url ":"] 6
  "\n\n(fn URL ARG)"]
)
       ("help" :follow org-link--open-help)
       ("file" :complete org-link-complete-file)
       ("elisp" :follow org-link--open-elisp)
       ("doi" :follow org-link--open-doi))
 org-link-elisp-confirm-function 'yes-or-no-p
 outline-minor-mode-prefix ""
 )
-- 
Alan Wehmann
Alan.Wehmann@gmail.com

Alan Wehmann

alan.wehmann@gmail.com