bug#39609: 26.3; Packaging system: Package documentation in the *Help* buffer

bug#39609: 26.3; Packaging system: Package documentation in the *Help* buffer

[H. Dieter Wilhelm]

Hello Emacs

The Elisp manual (GNU Emacs 26.3 (build 1, x86_64-pc-linux-gnu, GTK+
Version 3.22.30) of 2019-12-14) states that a README file in the content
directory of a package will be used as a package description (C-h P).

Please check

  (info "(elisp) Multi-file Packages").

Yet this isn't working!  By looking at other packages It seems that
there must be a file `PACKAGE-NAME-readme.txt' BELOW the content
directory to get a description in the package help.

Thanks for resolving this issue


        Dieter



In GNU Emacs 26.3 (build 1, x86_64-pc-linux-gnu, GTK+ Version 3.22.30)
 of 2019-12-14 built on ping
Windowing system distributor 'The X.Org Foundation', version 11.0.11906000
System Description:	Ubuntu 18.04 LTS (beaver-three-eyed-raven X92)

Recent messages:
nnimap read 12k from imap.1und1.de
Reading active file from archive via nnfolder...done
Reading active file via nndraft...done
Checking new news...done
Opening nnimap server on 1und1...done
nnimap read 0k from imap.1und1.de
No more unseen articles
Quit [3 times]
No more unseen articles
Mark set [2 times]
execute-extended-command: ‘’ is not a valid command name
Configured features:
XPM JPEG TIFF GIF PNG RSVG IMAGEMAGICK SOUND GPM DBUS GSETTINGS GLIB
NOTIFY ACL LIBSELINUX GNUTLS LIBXML2 FREETYPE M17N_FLT LIBOTF XFT ZLIB
TOOLKIT_SCROLL_BARS GTK3 X11 XDBE XIM THREADS LCMS2

Important settings:
  value of $LC_MONETARY: de_DE.UTF-8
  value of $LC_NUMERIC: de_DE.UTF-8
  value of $LC_TIME: de_DE.UTF-8
  value of $LANG: en_GB.UTF-8
  value of $XMODIFIERS: @im=ibus
  locale-coding-system: utf-8-unix

Major mode: Article

Minor modes in effect:
  diff-auto-refine-mode: t
  icomplete-mode: t
  display-battery-mode: t
  display-time-mode: t
  show-paren-mode: t
  electric-pair-mode: t
  shell-dirtrack-mode: t
  async-bytecomp-package-mode: t
  tooltip-mode: t
  global-eldoc-mode: t
  electric-indent-mode: t
  mouse-wheel-mode: t
  menu-bar-mode: t
  file-name-shadow-mode: t
  global-font-lock-mode: t
  font-lock-mode: t
  blink-cursor-mode: t
  auto-composition-mode: t
  auto-encryption-mode: t
  auto-compression-mode: t
  buffer-read-only: t
  column-number-mode: t
  line-number-mode: t
  transient-mark-mode: t
  abbrev-mode: 1

Load-path shadows:
/home/dieter/.emacs.d/elpa/apdl-mode-20.1.0/apdl-initialise hides ~/ansys-mode/apdl-initialise
/home/dieter/.emacs.d/elpa/apdl-mode-20.1.0/apdl-mode hides ~/ansys-mode/apdl-mode
/home/dieter/.emacs.d/elpa/apdl-mode-20.1.0/apdl-mode-pkg hides ~/ansys-mode/apdl-mode-pkg
/home/dieter/.emacs.d/elpa/apdl-mode-20.1.0/apdl-process hides ~/ansys-mode/apdl-process
/home/dieter/.emacs.d/elpa/apdl-mode-20.1.0/apdl-template hides ~/ansys-mode/apdl-template
/home/dieter/.emacs.d/elpa/apdl-mode-20.1.0/apdl-keyword hides ~/ansys-mode/apdl-keyword
/home/dieter/.emacs.d/elpa/org-plus-contrib-20200205/ob hides /usr/local/src/emacs/emacs-26.3/lisp/org/ob
/home/dieter/.emacs.d/elpa/org-plus-contrib-20200205/ob-hledger hides /usr/local/src/emacs/emacs-26.3/lisp/org/ob-hledger
/home/dieter/.emacs.d/elpa/org-plus-contrib-20200205/org-datetree hides /usr/local/src/emacs/emacs-26.3/lisp/org/org-datetree
/home/dieter/.emacs.d/elpa/org-plus-contrib-20200205/ob-css hides /usr/local/src/emacs/emacs-26.3/lisp/org/ob-css
/home/dieter/.emacs.d/elpa/org-plus-contrib-20200205/ob-io hides /usr/local/src/emacs/emacs-26.3/lisp/org/ob-io
/home/dieter/.emacs.d/elpa/org-plus-contrib-20200205/ob-sed hides /usr/local/src/emacs/emacs-26.3/lisp/org/ob-sed
/home/dieter/.emacs.d/elpa/org-plus-contrib-20200205/ob-sqlite hides /usr/local/src/emacs/emacs-26.3/lisp/org/ob-sqlite
/home/dieter/.emacs.d/elpa/org-plus-contrib-20200205/org-compat hides /usr/local/src/emacs/emacs-26.3/lisp/org/org-compat
/home/dieter/.emacs.d/elpa/org-plus-contrib-20200205/ox-org hides /usr/local/src/emacs/emacs-26.3/lisp/org/ox-org
/home/dieter/.emacs.d/elpa/org-plus-contrib-20200205/ox-publish hides /usr/local/src/emacs/emacs-26.3/lisp/org/ox-publish
/home/dieter/.emacs.d/elpa/org-plus-contrib-20200205/ob-ref hides /usr/local/src/emacs/emacs-26.3/lisp/org/ob-ref
/home/dieter/.emacs.d/elpa/org-plus-contrib-20200205/ob-java hides /usr/local/src/emacs/emacs-26.3/lisp/org/ob-java
/home/dieter/.emacs.d/elpa/org-plus-contrib-20200205/ob-perl hides /usr/local/src/emacs/emacs-26.3/lisp/org/ob-perl
/home/dieter/.emacs.d/elpa/org-plus-contrib-20200205/ob-org hides /usr/local/src/emacs/emacs-26.3/lisp/org/ob-org
/home/dieter/.emacs.d/elpa/org-plus-contrib-20200205/org-entities hides /usr/local/src/emacs/emacs-26.3/lisp/org/org-entities
/home/dieter/.emacs.d/elpa/org-plus-contrib-20200205/ob-R hides /usr/local/src/emacs/emacs-26.3/lisp/org/ob-R
/home/dieter/.emacs.d/elpa/org-plus-contrib-20200205/ob-forth hides /usr/local/src/emacs/emacs-26.3/lisp/org/ob-forth
/home/dieter/.emacs.d/elpa/org-plus-contrib-20200205/org-inlinetask hides /usr/local/src/emacs/emacs-26.3/lisp/org/org-inlinetask
/home/dieter/.emacs.d/elpa/org-plus-contrib-20200205/org-capture hides /usr/local/src/emacs/emacs-26.3/lisp/org/org-capture
/home/dieter/.emacs.d/elpa/org-plus-contrib-20200205/org-duration hides /usr/local/src/emacs/emacs-26.3/lisp/org/org-duration
/home/dieter/.emacs.d/elpa/org-plus-contrib-20200205/ob-C hides /usr/local/src/emacs/emacs-26.3/lisp/org/ob-C
/home/dieter/.emacs.d/elpa/org-plus-contrib-20200205/ob-maxima hides /usr/local/src/emacs/emacs-26.3/lisp/org/ob-maxima
/home/dieter/.emacs.d/elpa/org-plus-contrib-20200205/ob-dot hides /usr/local/src/emacs/emacs-26.3/lisp/org/ob-dot
/home/dieter/.emacs.d/elpa/org-plus-contrib-20200205/org-plot hides /usr/local/src/emacs/emacs-26.3/lisp/org/org-plot
/home/dieter/.emacs.d/elpa/org-plus-contrib-20200205/ob-clojure hides /usr/local/src/emacs/emacs-26.3/lisp/org/ob-clojure
/home/dieter/.emacs.d/elpa/org-plus-contrib-20200205/org-lint hides /usr/local/src/emacs/emacs-26.3/lisp/org/org-lint
/home/dieter/.emacs.d/elpa/org-plus-contrib-20200205/ob-asymptote hides /usr/local/src/emacs/emacs-26.3/lisp/org/ob-asymptote
/home/dieter/.emacs.d/elpa/org-plus-contrib-20200205/ob-stan hides /usr/local/src/emacs/emacs-26.3/lisp/org/ob-stan
/home/dieter/.emacs.d/elpa/org-plus-contrib-20200205/org-version hides /usr/local/src/emacs/emacs-26.3/lisp/org/org-version
/home/dieter/.emacs.d/elpa/org-plus-contrib-20200205/org-indent hides /usr/local/src/emacs/emacs-26.3/lisp/org/org-indent
/home/dieter/.emacs.d/elpa/org-plus-contrib-20200205/ob-exp hides /usr/local/src/emacs/emacs-26.3/lisp/org/ob-exp
/home/dieter/.emacs.d/elpa/org-plus-contrib-20200205/org-table hides /usr/local/src/emacs/emacs-26.3/lisp/org/org-table
/home/dieter/.emacs.d/elpa/org-plus-contrib-20200205/ob-ruby hides /usr/local/src/emacs/emacs-26.3/lisp/org/ob-ruby
/home/dieter/.emacs.d/elpa/org-plus-contrib-20200205/org-agenda hides /usr/local/src/emacs/emacs-26.3/lisp/org/org-agenda
/home/dieter/.emacs.d/elpa/org-plus-contrib-20200205/org-mobile hides /usr/local/src/emacs/emacs-26.3/lisp/org/org-mobile
/home/dieter/.emacs.d/elpa/org-plus-contrib-20200205/ox-latex hides /usr/local/src/emacs/emacs-26.3/lisp/org/ox-latex
/home/dieter/.emacs.d/elpa/org-plus-contrib-20200205/org-mouse hides /usr/local/src/emacs/emacs-26.3/lisp/org/org-mouse
/home/dieter/.emacs.d/elpa/org-plus-contrib-20200205/ob-makefile hides /usr/local/src/emacs/emacs-26.3/lisp/org/ob-makefile
/home/dieter/.emacs.d/elpa/org-plus-contrib-20200205/org-list hides /usr/local/src/emacs/emacs-26.3/lisp/org/org-list
/home/dieter/.emacs.d/elpa/org-plus-contrib-20200205/ob-eval hides /usr/local/src/emacs/emacs-26.3/lisp/org/ob-eval
/home/dieter/.emacs.d/elpa/org-plus-contrib-20200205/ob-lua hides /usr/local/src/emacs/emacs-26.3/lisp/org/ob-lua
/home/dieter/.emacs.d/elpa/org-plus-contrib-20200205/ox-man hides /usr/local/src/emacs/emacs-26.3/lisp/org/ox-man
/home/dieter/.emacs.d/elpa/org-plus-contrib-20200205/ox-odt hides /usr/local/src/emacs/emacs-26.3/lisp/org/ox-odt
/home/dieter/.emacs.d/elpa/org-plus-contrib-20200205/ob-sql hides /usr/local/src/emacs/emacs-26.3/lisp/org/ob-sql
/home/dieter/.emacs.d/elpa/org-plus-contrib-20200205/ob-ebnf hides /usr/local/src/emacs/emacs-26.3/lisp/org/ob-ebnf
/home/dieter/.emacs.d/elpa/org-plus-contrib-20200205/ob-calc hides /usr/local/src/emacs/emacs-26.3/lisp/org/ob-calc
/home/dieter/.emacs.d/elpa/org-plus-contrib-20200205/org-feed hides /usr/local/src/emacs/emacs-26.3/lisp/org/org-feed
/home/dieter/.emacs.d/elpa/org-plus-contrib-20200205/ob-shen hides /usr/local/src/emacs/emacs-26.3/lisp/org/ob-shen
/home/dieter/.emacs.d/elpa/org-plus-contrib-20200205/ob-mscgen hides /usr/local/src/emacs/emacs-26.3/lisp/org/ob-mscgen
/home/dieter/.emacs.d/elpa/org-plus-contrib-20200205/org-protocol hides /usr/local/src/emacs/emacs-26.3/lisp/org/org-protocol
/home/dieter/.emacs.d/elpa/org-plus-contrib-20200205/ob-plantuml hides /usr/local/src/emacs/emacs-26.3/lisp/org/ob-plantuml
/home/dieter/.emacs.d/elpa/org-plus-contrib-20200205/ob-sass hides /usr/local/src/emacs/emacs-26.3/lisp/org/ob-sass
/home/dieter/.emacs.d/elpa/org-plus-contrib-20200205/org-element hides /usr/local/src/emacs/emacs-26.3/lisp/org/org-element
/home/dieter/.emacs.d/elpa/org-plus-contrib-20200205/ob-J hides /usr/local/src/emacs/emacs-26.3/lisp/org/ob-J
/home/dieter/.emacs.d/elpa/org-plus-contrib-20200205/ob-fortran hides /usr/local/src/emacs/emacs-26.3/lisp/org/ob-fortran
/home/dieter/.emacs.d/elpa/org-plus-contrib-20200205/ob-table hides /usr/local/src/emacs/emacs-26.3/lisp/org/ob-table
/home/dieter/.emacs.d/elpa/org-plus-contrib-20200205/ox hides /usr/local/src/emacs/emacs-26.3/lisp/org/ox
/home/dieter/.emacs.d/elpa/org-plus-contrib-20200205/org-colview hides /usr/local/src/emacs/emacs-26.3/lisp/org/org-colview
/home/dieter/.emacs.d/elpa/org-plus-contrib-20200205/ox-icalendar hides /usr/local/src/emacs/emacs-26.3/lisp/org/ox-icalendar
/home/dieter/.emacs.d/elpa/org-plus-contrib-20200205/ob-scheme hides /usr/local/src/emacs/emacs-26.3/lisp/org/ob-scheme
/home/dieter/.emacs.d/elpa/org-plus-contrib-20200205/ob-core hides /usr/local/src/emacs/emacs-26.3/lisp/org/ob-core
/home/dieter/.emacs.d/elpa/org-plus-contrib-20200205/org-src hides /usr/local/src/emacs/emacs-26.3/lisp/org/org-src
/home/dieter/.emacs.d/elpa/org-plus-contrib-20200205/ob-awk hides /usr/local/src/emacs/emacs-26.3/lisp/org/ob-awk
/home/dieter/.emacs.d/elpa/org-plus-contrib-20200205/org-timer hides /usr/local/src/emacs/emacs-26.3/lisp/org/org-timer
/home/dieter/.emacs.d/elpa/org-plus-contrib-20200205/ob-ledger hides /usr/local/src/emacs/emacs-26.3/lisp/org/ob-ledger
/home/dieter/.emacs.d/elpa/org-plus-contrib-20200205/ob-latex hides /usr/local/src/emacs/emacs-26.3/lisp/org/ob-latex
/home/dieter/.emacs.d/elpa/org-plus-contrib-20200205/ob-tangle hides /usr/local/src/emacs/emacs-26.3/lisp/org/ob-tangle
/home/dieter/.emacs.d/elpa/org-plus-contrib-20200205/ob-lob hides /usr/local/src/emacs/emacs-26.3/lisp/org/ob-lob
/home/dieter/.emacs.d/elpa/org-plus-contrib-20200205/org-archive hides /usr/local/src/emacs/emacs-26.3/lisp/org/org-archive
/home/dieter/.emacs.d/elpa/org-plus-contrib-20200205/ob-processing hides /usr/local/src/emacs/emacs-26.3/lisp/org/ob-processing
/home/dieter/.emacs.d/elpa/org-plus-contrib-20200205/org-habit hides /usr/local/src/emacs/emacs-26.3/lisp/org/org-habit
/home/dieter/.emacs.d/elpa/org-plus-contrib-20200205/org-crypt hides /usr/local/src/emacs/emacs-26.3/lisp/org/org-crypt
/home/dieter/.emacs.d/elpa/org-plus-contrib-20200205/ob-comint hides /usr/local/src/emacs/emacs-26.3/lisp/org/ob-comint
/home/dieter/.emacs.d/elpa/org-plus-contrib-20200205/org hides /usr/local/src/emacs/emacs-26.3/lisp/org/org
/home/dieter/.emacs.d/elpa/org-plus-contrib-20200205/ob-ditaa hides /usr/local/src/emacs/emacs-26.3/lisp/org/ob-ditaa
/home/dieter/.emacs.d/elpa/org-plus-contrib-20200205/ox-html hides /usr/local/src/emacs/emacs-26.3/lisp/org/ox-html
/home/dieter/.emacs.d/elpa/org-plus-contrib-20200205/ox-ascii hides /usr/local/src/emacs/emacs-26.3/lisp/org/ox-ascii
/home/dieter/.emacs.d/elpa/org-plus-contrib-20200205/org-install hides /usr/local/src/emacs/emacs-26.3/lisp/org/org-install
/home/dieter/.emacs.d/elpa/org-plus-contrib-20200205/ob-coq hides /usr/local/src/emacs/emacs-26.3/lisp/org/ob-coq
/home/dieter/.emacs.d/elpa/org-plus-contrib-20200205/org-attach hides /usr/local/src/emacs/emacs-26.3/lisp/org/org-attach
/home/dieter/.emacs.d/elpa/org-plus-contrib-20200205/org-footnote hides /usr/local/src/emacs/emacs-26.3/lisp/org/org-footnote
/home/dieter/.emacs.d/elpa/org-plus-contrib-20200205/ob-haskell hides /usr/local/src/emacs/emacs-26.3/lisp/org/ob-haskell
/home/dieter/.emacs.d/elpa/org-plus-contrib-20200205/ox-md hides /usr/local/src/emacs/emacs-26.3/lisp/org/ox-md
/home/dieter/.emacs.d/elpa/org-plus-contrib-20200205/ob-vala hides /usr/local/src/emacs/emacs-26.3/lisp/org/ob-vala
/home/dieter/.emacs.d/elpa/org-plus-contrib-20200205/ox-texinfo hides /usr/local/src/emacs/emacs-26.3/lisp/org/ox-texinfo
/home/dieter/.emacs.d/elpa/org-plus-contrib-20200205/org-ctags hides /usr/local/src/emacs/emacs-26.3/lisp/org/org-ctags
/home/dieter/.emacs.d/elpa/org-plus-contrib-20200205/org-macro hides /usr/local/src/emacs/emacs-26.3/lisp/org/org-macro
/home/dieter/.emacs.d/elpa/org-plus-contrib-20200205/ob-picolisp hides /usr/local/src/emacs/emacs-26.3/lisp/org/ob-picolisp
/home/dieter/.emacs.d/elpa/org-plus-contrib-20200205/ob-js hides /usr/local/src/emacs/emacs-26.3/lisp/org/ob-js
/home/dieter/.emacs.d/elpa/org-plus-contrib-20200205/ob-groovy hides /usr/local/src/emacs/emacs-26.3/lisp/org/ob-groovy
/home/dieter/.emacs.d/elpa/org-plus-contrib-20200205/org-clock hides /usr/local/src/emacs/emacs-26.3/lisp/org/org-clock
/home/dieter/.emacs.d/elpa/org-plus-contrib-20200205/ob-screen hides /usr/local/src/emacs/emacs-26.3/lisp/org/ob-screen
/home/dieter/.emacs.d/elpa/org-plus-contrib-20200205/ob-emacs-lisp hides /usr/local/src/emacs/emacs-26.3/lisp/org/ob-emacs-lisp
/home/dieter/.emacs.d/elpa/org-plus-contrib-20200205/ob-lilypond hides /usr/local/src/emacs/emacs-26.3/lisp/org/ob-lilypond
/home/dieter/.emacs.d/elpa/org-plus-contrib-20200205/org-macs hides /usr/local/src/emacs/emacs-26.3/lisp/org/org-macs
/home/dieter/.emacs.d/elpa/org-plus-contrib-20200205/org-loaddefs hides /usr/local/src/emacs/emacs-26.3/lisp/org/org-loaddefs
/home/dieter/.emacs.d/elpa/org-plus-contrib-20200205/ob-python hides /usr/local/src/emacs/emacs-26.3/lisp/org/ob-python
/home/dieter/.emacs.d/elpa/org-plus-contrib-20200205/ob-shell hides /usr/local/src/emacs/emacs-26.3/lisp/org/ob-shell
/home/dieter/.emacs.d/elpa/org-plus-contrib-20200205/ob-lisp hides /usr/local/src/emacs/emacs-26.3/lisp/org/ob-lisp
/home/dieter/.emacs.d/elpa/org-plus-contrib-20200205/org-faces hides /usr/local/src/emacs/emacs-26.3/lisp/org/org-faces
/home/dieter/.emacs.d/elpa/org-plus-contrib-20200205/org-pcomplete hides /usr/local/src/emacs/emacs-26.3/lisp/org/org-pcomplete
/home/dieter/.emacs.d/elpa/org-plus-contrib-20200205/ob-octave hides /usr/local/src/emacs/emacs-26.3/lisp/org/ob-octave
/home/dieter/.emacs.d/elpa/org-plus-contrib-20200205/ob-gnuplot hides /usr/local/src/emacs/emacs-26.3/lisp/org/ob-gnuplot
/home/dieter/.emacs.d/elpa/org-plus-contrib-20200205/ob-abc hides /usr/local/src/emacs/emacs-26.3/lisp/org/ob-abc
/home/dieter/.emacs.d/elpa/org-plus-contrib-20200205/org-id hides /usr/local/src/emacs/emacs-26.3/lisp/org/org-id
/home/dieter/.emacs.d/elpa/org-plus-contrib-20200205/ob-matlab hides /usr/local/src/emacs/emacs-26.3/lisp/org/ob-matlab
/home/dieter/.emacs.d/elpa/org-plus-contrib-20200205/ox-beamer hides /usr/local/src/emacs/emacs-26.3/lisp/org/ox-beamer
/home/dieter/.emacs.d/elpa/org-plus-contrib-20200205/ob-ocaml hides /usr/local/src/emacs/emacs-26.3/lisp/org/ob-ocaml
/home/dieter/.emacs.d/elpa/let-alist-1.0.6/let-alist hides /usr/local/src/emacs/emacs-26.3/lisp/emacs-lisp/let-alist

Features:
(shadow emacsbug flow-fill canlock ibuf-ext ibuffer ibuffer-loaddefs
cl-print mailalias bbdb-message sendmail sort gnus-cite smiley shr-color
color shr svg dom mail-extr gnus-bcklg pp cus-edit cus-start cus-load
skeleton autoload cal-iso cal-move tar-mode package-x wdired man novice
gnus-async qp gnus-ml nndraft nnmh nnmbox utf-7 nnfolder bbdb-gnus
bbdb-mua bbdb-com crm epa-file gnus-agent gnus-srvr gnus-score
score-mode nnvirtual gnus-msg gnus-art mm-uu mml2015 mm-view mml-smime
smime dig nntp gnus-cache conf-mode mm-archive network-stream starttls
url-cache package-recipe-mode package-build-badges package-build
package-recipe term disp-table ehelp pulse flyspell view package-lint
finder lisp-mnt checkdoc rect pcase flycheck subr-x ispell eieio-opt
speedbar sb-image ezimage dframe help-fns radix-tree tmm term/xterm
xterm apdl-mode align apdl-initialise apdl-process apdl-template
apdl-keyword dired-aux time-stamp face-remap misearch multi-isearch
sh-script smie executable cursor-sensor vc-mtn vc-hg vc-git diff-mode
vc-bzr vc-src vc-sccs vc-svn vc-cvs vc-rcs vc vc-dispatcher imenu
ess-r-mode ess-r-flymake flymake-proc flymake thingatpt ess-r-xref xref
ess-trns ess-r-package ess-r-completion ess-roxy ess-r-syntax ess-rd
hideshow ess-s-lang ess-help ess-mode ess-inf project ess-tracebug ess
ess-utils ess-custom compile rx cl-extra help-mode icomplete cal-china
lunar solar cal-dst cal-bahai cal-islam cal-hebrew holidays hol-loaddefs
appt diary-lib diary-loaddefs battery time server org-eldoc ol-eww
ol-rmail ol-mhe ol-irc ol-info ol-gnus nnir gnus-sum gnus-group
gnus-undo gnus-start gnus-cloud nnimap nnmail mail-source utf7 netrc
nnoo parse-time gnus-spec gnus-int gnus-range gnus-win gnus nnheader
wid-edit ol-docview doc-view jka-compr image-mode ol-bbdb ol-w3m dired-x
bbdb bbdb-site ox-koma-letter paren elec-pair pdf-loader ob-org
ob-octave ob-latex ob-shell shell ob-calc calc-store calc-trail calc-ext
calc calc-loaddefs calc-macs ob-R ob-python org-capture org-passwords
org-ref org-ref-helm-bibtex org-ref-helm helm-utils helm-bibtex
bibtex-completion filenotify biblio biblio-download biblio-dissemin
biblio-ieee biblio-hal biblio-dblp biblio-crossref biblio-arxiv timezone
biblio-doi biblio-core let-alist url-queue ido hl-line helm-net
browse-url xml helm-help helm helm-source eieio-compat helm-multi-match
helm-lib helm-config helm-easymenu async-bytecomp async org-ref-core
warnings edmacro kmacro reftex-cite reftex reftex-loaddefs reftex-vars
parsebib ox-odt rng-loc rng-uri rng-parse rng-match rng-dt rng-util
rng-pttrn nxml-parse nxml-ns nxml-enc xmltok nxml-util ox-latex
ox-icalendar ox-html table ox-ascii ox-publish ox org-ref-glossary
org-ref-bibtex org-ref-citeproc org-element avl-tree generator message
dired dired-loaddefs rfc822 mml mml-sec epa derived epg gnus-util rmail
rmail-loaddefs mm-decode mm-bodies mm-encode mailabbrev mail-utils
gmm-utils mailheader key-chord hydra lv doi-utils org-ref-utils
org-ref-pdf url-http tls gnutls url url-proxy url-privacy url-expand
url-methods url-history mailcap url-auth mail-parse rfc2231 rfc2047
rfc2045 mm-util ietf-drums mail-prsvr url-cookie url-domsuf url-util
url-gw nsm rmc puny ol-bibtex org ob ob-tangle ob-ref ob-lob ob-table
ob-exp org-macro org-footnote org-src ob-comint org-pcomplete pcomplete
comint ansi-color ring org-list org-faces org-entities noutline outline
easy-mmode org-version ob-emacs-lisp ob-core ob-eval org-table ol
org-keys org-compat advice org-macs org-loaddefs format-spec find-func
cal-menu calendar cal-loaddefs json map bibtex htmlize cl f s dash
finder-inf info package easymenu epg-config url-handlers url-parse
auth-source cl-seq eieio eieio-core cl-macs eieio-loaddefs
password-cache url-vars seq byte-opt gv bytecomp byte-compile cconv
cl-loaddefs cl-lib time-date mule-util tooltip eldoc electric uniquify
ediff-hook vc-hooks lisp-float-type mwheel term/x-win x-win
term/common-win x-dnd tool-bar dnd fontset image regexp-opt fringe
tabulated-list replace newcomment text-mode elisp-mode lisp-mode
prog-mode register page menu-bar rfn-eshadow isearch timer select
scroll-bar mouse jit-lock font-lock syntax facemenu font-core
term/tty-colors frame cl-generic cham georgian utf-8-lang misc-lang
vietnamese tibetan thai tai-viet lao korean japanese eucjp-ms cp51932
hebrew greek romanian slovak czech european ethiopic indian cyrillic
chinese composite charscript charprop case-table epa-hook jka-cmpr-hook
help simple abbrev obarray minibuffer cl-preloaded nadvice loaddefs
button faces cus-face macroexp files text-properties overlay sha1 md5
base64 format env code-pages mule custom widget hashtable-print-readable
backquote threads dbusbind inotify lcms2 dynamic-setting
system-font-setting font-render-setting move-toolbar gtk x-toolkit x
multi-tty make-network-process emacs)

Memory information:
((conses 16 2291490 224766)
 (symbols 48 79361 56)
 (miscs 40 2040 2285)
 (strings 32 412282 32289)
 (string-bytes 1 28323888)
 (vectors 16 106492)
 (vector-slots 8 2463820 83458)
 (floats 8 1192 1079)
 (intervals 56 265189 2205)
 (buffers 992 117))

-- 
Best wishes
H. Dieter Wilhelm
Zwingenberg, Germany

bug#39609: 26.3; Packaging system: Package documentation in the *Help* buffer

[Lars Ingebrigtsen]

dieter@duenenhof-wilhelm.de (H. Dieter Wilhelm) writes:

> The Elisp manual (GNU Emacs 26.3 (build 1, x86_64-pc-linux-gnu, GTK+
> Version 3.22.30) of 2019-12-14) states that a README file in the content
> directory of a package will be used as a package description (C-h P).
>
> Please check
>
>   (info "(elisp) Multi-file Packages").
>
> Yet this isn't working!  By looking at other packages It seems that
> there must be a file `PACKAGE-NAME-readme.txt' BELOW the content
> directory to get a description in the package help.

I tried `C-h P ada-mode RET' and got a *Help* buffer that included the
README file for the ada-mode package, so I seem to be unable to
reproduce this bug.

Do you have a precise recipe to reproduce it, starting from "emacs -Q"?

-- 
(domestic pets only, the antidote for overdose, milk.)
   bloggy blog: http://lars.ingebrigtsen.no

bug#39609: 26.3; Packaging system: Package documentation in the *Help* buffer

[H. Dieter Wilhelm]

[-- Attachment #1: Type: text/plain, Size: 1384 bytes --]

Hello Lars

thank you for looking into this!

Lars Ingebrigtsen <larsi@gnus.org> writes:

> dieter@duenenhof-wilhelm.de (H. Dieter Wilhelm) writes:
>
>> The Elisp manual (GNU Emacs 26.3 (build 1, x86_64-pc-linux-gnu, GTK+
>> Version 3.22.30) of 2019-12-14) states that a README file in the content
>> directory of a package will be used as a package description (C-h P).
>>
>> Please check
>>
>>   (info "(elisp) Multi-file Packages").
>>
>> Yet this isn't working!  By looking at other packages It seems that
>> there must be a file `PACKAGE-NAME-readme.txt' BELOW the content
>> directory to get a description in the package help.

> I tried `C-h P ada-mode RET' and got a *Help* buffer that included the
> README file for the ada-mode package, so I seem to be unable to
> reproduce this bug.

> Do you have a precise recipe to reproduce it, starting from "emacs -Q"?

I prepared a multi-file package for you.  Under Emacs 26.3 or earlier
you won't see any "long description" at all (unless you include a
PACKAGE-NAME-readme.txt in the package archive).  Under 27.1 it shows
now the ;;; Commentary: section of the PACKAGE-NAME.el file.  But NOT
the content of the accompanying README!

Please unpack the archive inform-1.4.tar into an empty DIRECTORY and
install the package interactively with package-install-file pointing to
the DIRECTORY.

Thank you for your help

       Dieter

[-- Attachment #2: inform-1.4.tar --]
[-- Type: application/x-tar, Size: 61440 bytes --]

[-- Attachment #3: Type: text/plain, Size: 56 bytes --]


-- 
Best wishes
H. Dieter Wilhelm
Zwingenberg, Germany

bug#39609: 26.3; Packaging system: Package documentation in the *Help* buffer

[Lars Ingebrigtsen]

"H. Dieter Wilhelm" <dieter@duenenhof-wilhelm.de> writes:

>> Do you have a precise recipe to reproduce it, starting from "emacs -Q"?
>
> I prepared a multi-file package for you.  Under Emacs 26.3 or earlier
> you won't see any "long description" at all (unless you include a
> PACKAGE-NAME-readme.txt in the package archive).  Under 27.1 it shows
> now the ;;; Commentary: section of the PACKAGE-NAME.el file.  But NOT
> the content of the accompanying README!

The package didn't really clarify anything.

Could you instead give a precise recipe to reproduce the bug, starting
from "emacs -Q"? 

-- 
(domestic pets only, the antidote for overdose, milk.)
   bloggy blog: http://lars.ingebrigtsen.no

bug#39609: 26.3; Packaging system: Package documentation in the *Help* buffer

[Lars Ingebrigtsen]

(Please keep the debbugs address in the Cc's -- otherwise the message
won't reach the bug tracker.)

"H. Dieter Wilhelm" <dieter@duenenhof-wilhelm.de> writes:

> I'm sorry I should have made it clear that the problem occurs most
> clearly for packages which are not installed from Gnu Elpa or other
> package archives.  After installing from a package archive the
> documentation is not taken out of the package README, despite the Elisp
> documentation in (elisp) Multi-file Packages.
>
> So please check this with Emacs- Q (possibly in a sandboxed
> environment), do (package-initialize) and install the attached package.
> To that end please extract the tar archive to a DIRECTORY and M-x
> package-install-file DIRECTORY.  Then you'll see that the content of C-h
> P inform is not the content of the package's README.  For Emacs-26.3
> you'll see no documentation at all and for Emacs-27.1 you'll see
> inform.el's ;;; Commentary section.
>
> Thank you
>
>         Dieter
>
> PS: The inform package is now available via Melpa, just in case...

OK, so the test case is

emacs -Q
M-x list-packages
then install "inform" from Melpa
And then

C-h P inform RET

?

bug#39609: 26.3; Packaging system: Package documentation in the *Help* buffer

[Lars Ingebrigtsen]

Lars Ingebrigtsen <larsi@gnus.org> writes:

> OK, so the test case is
>
> emacs -Q
> M-x list-packages
> then install "inform" from Melpa
> And then
>
> C-h P inform RET
>
> ?

More information was requested, but no response was given within a
month, so I'm closing this bug report.  If further progress can be made,
please respond to this email and we'll reopen the bug report.

-- 
(domestic pets only, the antidote for overdose, milk.)
   bloggy blog: http://lars.ingebrigtsen.no