bug#64339: 29.0.50; incorrect org-mode dynamic blocks docs

bug#64339: 29.0.50; incorrect org-mode dynamic blocks docs

[pva-outdoor]

Hello, team!

Please check the following documentation (or implementation) of org-mode
dynamic blocks:

1. It seems that dynamic blocks can't have inner headlines (the
org-dblock-write:xxx should not produce them). Otherwise the block will
be parsed incorrectly (not mentioned in docs for org-mode).

Example: Create the following 1.org and export it to unicode text (press
C-c C-e t U). You will see "#+BEGIN: block2" as text.

  * Block2
  
  #+BEGIN: block2
  ** Section 1
  asdasdsad
  #+END:
  
2. Org-mode info file says:

     Dynamic blocks, like any other block, can be narrowed with
  ‘org-narrow-to-block’.

That would not work because of implementation of org-narrow-to-block:

(defun org-narrow-to-block ()
  "Narrow buffer to the current block."
  (interactive)
  (let* ((case-fold-search t)
	 (blockp (org-between-regexps-p "^[ \t]*#\\+begin_.*"  <----
					"^[ \t]*#\\+end_.*")))
    (if blockp
	(narrow-to-region (car blockp) (cdr blockp))
      (user-error "Not in a block"))))



There is also a minor bug in org-mode (sould I report it
in it's own mail?):

If you press C-c C-, [RET] [RET] You'll get:

#+begin_
#+end_nil

while one could expect either begin_nil or end_. 



In GNU Emacs 29.0.50 (build 4, x86_64-pc-linux-gnu, GTK+ Version 3.24.34, cairo version 1.17.6)
 of 2022-07-15 built on pva-msi
Repository revision: ed4ba79ea8f2be2d01f6447910e2c8319908d0d6
Repository branch: master
Windowing system distributor 'The X.Org Foundation', version 11.0.12101008
System Description: Arch Linux

Configured features:
ACL CAIRO DBUS FREETYPE GIF GLIB GMP GNUTLS GPM GSETTINGS HARFBUZZ JPEG
JSON LCMS2 LIBOTF LIBSYSTEMD LIBXML2 M17N_FLT MODULES NOTIFY INOTIFY
PDUMPER PNG RSVG SECCOMP SOUND SQLITE3 THREADS TIFF TOOLKIT_SCROLL_BARS
WEBP X11 XDBE XIM XINPUT2 XPM GTK3 ZLIB

-- 
Best reqards,
Andrey Petrov.

bug#64339: 29.0.50; incorrect org-mode dynamic blocks docs

[Eli Zaretskii]

> From: pva-outdoor@yandex.ru
> Date: Thu, 29 Jun 2023 01:36:00 +0500
> 
> Please check the following documentation (or implementation) of org-mode
> dynamic blocks:
> 
> 1. It seems that dynamic blocks can't have inner headlines (the
> org-dblock-write:xxx should not produce them). Otherwise the block will
> be parsed incorrectly (not mentioned in docs for org-mode).
> 
> Example: Create the following 1.org and export it to unicode text (press
> C-c C-e t U). You will see "#+BEGIN: block2" as text.
> 
>   * Block2
>   
>   #+BEGIN: block2
>   ** Section 1
>   asdasdsad
>   #+END:
>   
> 2. Org-mode info file says:
> 
>      Dynamic blocks, like any other block, can be narrowed with
>   ‘org-narrow-to-block’.
> 
> That would not work because of implementation of org-narrow-to-block:
> 
> (defun org-narrow-to-block ()
>   "Narrow buffer to the current block."
>   (interactive)
>   (let* ((case-fold-search t)
> 	 (blockp (org-between-regexps-p "^[ \t]*#\\+begin_.*"  <----
> 					"^[ \t]*#\\+end_.*")))
>     (if blockp
> 	(narrow-to-region (car blockp) (cdr blockp))
>       (user-error "Not in a block"))))
> 
> 
> 
> There is also a minor bug in org-mode (sould I report it
> in it's own mail?):
> 
> If you press C-c C-, [RET] [RET] You'll get:
> 
> #+begin_
> #+end_nil
> 
> while one could expect either begin_nil or end_. 

Could you please report this to the Org developers first?  It sounds
like a problem in Org or its documentation.

Thanks.