[BUG] Improve error message "org-back-to-heading: Before first headline at position 1" [9.6.8 (release_9.6.8-3-g21171d @/usr/local/share/emacs/29.1.50/lisp/org/)]

[c.buhtz@posteo.jp]

Hello,

using the first time this Emacs in build bug report thing. But have to 
send the mail via copy & paste because the bug reporter didn't work out 
of the box.
The "From" field is not valid. Modified it manually in the buffer. But 
didn't work.
Emacs tried to use STARTTLS with posteo.de:25 which is wrong I think. 
Should be port 587 but don't know how to set this.

OK, now the real problem:

This is not a support question about how to solve a problem or the error
message I do report here. It is a request to improve that error message
to help users understand the real problem and find a solution by their
own.

I get the this error message in context when using the Org attachments
feature (C-c C-a plus c).

     "org-back-to-heading: Before first headline at position 1 in 
buffer..."

I have no idea about the brackground here. And I also not a regular user
of orgs attachment feature. So I can not provide a better error
message. This will be up to you. Thank you.

Kind
Christian Buhtz

Your bug report will be posted to the Org mailing list.
------------------------------------------------------------------------



Emacs  : GNU Emacs 29.1.50 (build 1, aarch64-unknown-linux-gnu)
  of 2023-09-14
Package: Org mode version 9.6.8 (release_9.6.8-3-g21171d @ 
/usr/local/share/emacs/29.1.50/lisp/org/)

current state:
==============
(setq
  org-link-elisp-confirm-function 'yes-or-no-p
  org-roam-db-gc-threshold 314572800
  org-hide-emphasis-markers t
  org-bibtex-headline-format-function #[257 "\300\236A\207" [:title] 3 
"\n\n(fn ENTRY)"]
  org-download-file-format-function 'org-download-file-format-default
  org-roam-node-display-template #("${title:*} ${tags:20}" 11 21 (face 
org-tag))
  org-persist-after-read-hook '(org-element--cache-persist-after-read)
  org-export-before-parsing-hook '(org-attach-expand-links)
  org-cycle-tab-first-hook '(org-babel-hide-result-toggle-maybe 
org-babel-header-arg-expand)
  org-roam-find-file-hook '(org-roam-buffer--setup-redisplay-h
                            org-roam--register-completion-functions-h
                            org-roam--replace-roam-links-on-save-h
                            org-roam-db-autosync--setup-update-on-save-h)
  org-archive-hook '(org-attach-archive-delete-maybe)
  org-edit-src-content-indentation 0
  org-cycle-hook '(org-cycle-hide-archived-subtrees 
org-cycle-show-empty-lines
                   org-cycle-optimize-window-after-visibility-change
                   org-cycle-display-inline-images)
  org-persist-before-read-hook '(org-element--cache-persist-before-read)
  org-mode-hook '(#[0 "\301\211\207" [imenu-create-index-function
  org-imenu-get-tree] 2]
                  buhtzology/org-mode-visual-fill org-bullets-mode
                  #[0 "\300\301\302\303\304$\207"
                    [add-hook change-major-mode-hook org-fold-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
  buhtzology/org-mode-setup
                  (closure (t) nil (display-line-numbers-mode 0)))
  org-roam-ref-annotation-function 'org-roam-ref-read--annotation
  org-roam-directory "~/.my.org-roam"
  org-ellipsis "↓"
  org-roam-db-node-include-function #[0 "\300\207" [t] 1]
  org-download-abbreviate-filename-function 'file-relative-name
  org-confirm-shell-link-function 'yes-or-no-p
  org-download-annotate-function 'org-download-annotate-default
  outline-isearch-open-invisible-function 'outline-isearch-open-invisible
  org-roam-capture-preface-hook '(org-roam-capture--try-capture-to-ref-h)
  org-agenda-before-write-hook '(org-agenda-add-entry-text)
  org-capture-prepare-finalize-hook 
'(org-roam-capture--install-finalize-h)
  org-roam-preview-function 'org-roam-preview-default-function
  org-src-mode-hook '(org-src-babel-configure-edit-buffer 
org-src-mode-configure-edit-buffer)
  org-roam-db-autosync-mode t
  org-confirm-elisp-link-function 'yes-or-no-p
  org-log-buffer-setup-hook '(org-roam-log--setup)
  org-roam-capture-new-node-hook 
'(org-roam-capture--insert-captured-ref-h)
  org-structure-template-alist '(("rc" . "src rconsole") ("r" . "src R") 
("pc"
  . "src PyCon")
                                 ("p" . "src Python") ("a" . "export 
ascii")
  ("c" . "center")
                                 ("C" . "comment") ("e" . "example") ("E"
  . "export")
                                 ("h" . "export html") ("l" . "export 
latex")
  ("q" . "quote")
                                 ("s" . "src") ("v" . "verse"))
  org-speed-command-hook '(org-speed-command-activate 
org-babel-speed-command-activate)
  org-bullets-bullet-list '("■" "○" "●" "○" "●" "○" "●")
  org-fold-core-isearch-open-function 'org-fold--isearch-reveal
  org-persist-before-write-hook 
'(org-element--cache-persist-before-write)
  org-tab-first-hook '(org-babel-hide-result-toggle-maybe 
org-babel-header-arg-expand)
  org-link-shell-confirm-function 'yes-or-no-p
  org-babel-pre-tangle-hook '(save-buffer)
  org-roam-completion-everywhere t
  org-agenda-loop-over-headlines-in-active-region nil
  org-occur-hook '(org-first-headline-recenter)
  org-roam-log-setup-hook '(org-roam--register-completion-functions-h)
  org-metadown-hook '(org-babel-pop-to-session-maybe)
  org-roam-node-annotation-function 'org-roam-node-read--annotation
  org-link-parameters '(("eww" :follow org-eww-open :store 
org-eww-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 :insert-description
  org-info-description-as-command)
                        ("gnus" :follow org-gnus-open :store
  org-gnus-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)
                        ("w3m" :store org-w3m-store-link)
                        ("doi" :follow org-link-doi-open :export
  org-link-doi-export)
                        ("roam" :follow org-roam-link-follow-link)
                        ("attachment" :follow org-attach-follow :complete
                         org-attach-complete-link)
                        ("id" :follow org-roam-id-open) ("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 :store
  org-link--store-help)
                        ("file" :complete org-link-complete-file)
                        ("elisp" :follow org-link--open-elisp))
  org-roam-capture-templates '(("d" "default" plain "%?" :if-new
                                (file+head "%<%Y%m%d%H%M%S>-${slug}.org"
                                 "#+title: ${title}\n#+date: [%<%Y-%m-%d
  %H:%M>]")
                                :unnarrowed t)
                               ("b" "Bibliographic notes" plain
                                "\n* Source\n- Author :: %^{Author}\n- 
Title ::
  ${title}\n- Year :: %^{Year}\n- doi :: 
[[https://doi.org/%^{DOI}][%\\3]]\n\n*
  Summary\n%?"
                                :if-new
                                (file+head "%<%Y%m%d%H%M%S>-${slug}.org"
                                 "#+title: ${title}\n#+date: [%<%Y-%m-%d
  %H:%M>]\n#+filetags: Bib")
                                :unnarrowed t)
                               ("p" "project" plain
                                "* Goals\n\n%?\n\n* Tasks\n\n** TODO Add 
initial
  tasks\n\n* Dates\n\n"
                                :if-new
                                (file+head "%<%Y%m%d%H%M%S>-${slug}.org"
                                 "#+title: ${title}\n#+date: [%<%Y-%m-%d
  %H:%M>]\n#+filetags: Project")
                                :unnarrowed t)
                               ("w" "Wiki" plain "%?" :if-new
                                (file+head "%<%Y%m%d%H%M%S>-${slug}.org"
                                 "#+title: ${title}\n#+date: [%<%Y-%m-%d
  %H:%M>]\n#+filetags: Wiki")
                                :unnarrowed t)
                               ("m" "Meta" plain "* 
${title}\nSammelbecken zum
  Thema\n%?"
                                :if-new
                                (file+head "%<%Y%m%d%H%M%S>-${slug}.org"
                                 "#+title: ${title}\n#+date: [%<%Y-%m-%d
  %H:%M>]\n#+filetags: Meta")
                                :unnarrowed t)
                               )
  org-metaup-hook '(org-babel-load-in-session-maybe)
  org-download-link-format-function 
'org-download-link-format-function-default
  org-download-image-dir "./attachments/images"
  org-roam-indirect-buffer-hook 
'(org-roam--register-completion-functions-h)
  )