From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: dalanicolai Newsgroups: gmane.emacs.bugs Subject: bug#51660: 28.0.50; No mention of compilation step in section 'Package Installation' of the Emacs manual Date: Sun, 7 Nov 2021 14:13:39 +0100 Message-ID: Mime-Version: 1.0 Content-Type: multipart/alternative; boundary="000000000000bab6a405d032a51d" Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="3458"; mail-complaints-to="usenet@ciao.gmane.io" To: 51660@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Sun Nov 07 14:14:39 2021 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane-mx.org Original-Received: from lists.gnu.org ([209.51.188.17]) by ciao.gmane.io with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1mji0K-0000g1-M5 for geb-bug-gnu-emacs@m.gmane-mx.org; Sun, 07 Nov 2021 14:14:36 +0100 Original-Received: from localhost ([::1]:58720 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1mji0I-0007Mm-KJ for geb-bug-gnu-emacs@m.gmane-mx.org; Sun, 07 Nov 2021 08:14:34 -0500 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:45074) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1mjhzn-0007Lk-1w for bug-gnu-emacs@gnu.org; Sun, 07 Nov 2021 08:14:03 -0500 Original-Received: from debbugs.gnu.org ([209.51.188.43]:40491) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1mjhzm-000684-Mr for bug-gnu-emacs@gnu.org; Sun, 07 Nov 2021 08:14:02 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1mjhzm-0000lv-F8 for bug-gnu-emacs@gnu.org; Sun, 07 Nov 2021 08:14:02 -0500 X-Loop: help-debbugs@gnu.org Resent-From: dalanicolai Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sun, 07 Nov 2021 13:14:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 51660 X-GNU-PR-Package: emacs X-Debbugs-Original-To: bug-gnu-emacs@gnu.org Original-Received: via spool by submit@debbugs.gnu.org id=B.16362908402949 (code B ref -1); Sun, 07 Nov 2021 13:14:02 +0000 Original-Received: (at submit) by debbugs.gnu.org; 7 Nov 2021 13:14:00 +0000 Original-Received: from localhost ([127.0.0.1]:52037 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1mjhzj-0000lU-D2 for submit@debbugs.gnu.org; Sun, 07 Nov 2021 08:13:59 -0500 Original-Received: from lists.gnu.org ([209.51.188.17]:60180) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1mjhzh-0000lM-1w for submit@debbugs.gnu.org; Sun, 07 Nov 2021 08:13:58 -0500 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:45054) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1mjhzf-0007E2-71 for bug-gnu-emacs@gnu.org; Sun, 07 Nov 2021 08:13:56 -0500 Original-Received: from mail-ua1-x929.google.com ([2607:f8b0:4864:20::929]:42951) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1mjhzc-0005pJ-Qq for bug-gnu-emacs@gnu.org; Sun, 07 Nov 2021 08:13:54 -0500 Original-Received: by mail-ua1-x929.google.com with SMTP id t13so11006725uad.9 for ; Sun, 07 Nov 2021 05:13:51 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112; h=mime-version:from:date:message-id:subject:to; bh=P6ueMUcXbRXctI6y5JuXR7nAjrqXWOCBayEdCtOl3T0=; b=EGBb+8AaKvpDkiO0CahlFyuMwl78I+GlmJormpi5+dV7KJF0Kmlh3DA4ATr4+AYfN3 iV9jkfEPdzvTwim2/hCdbp5BQvqvJWUfMMqFwO2phz5u/7AvgBC2+g3xz6M54rWLLKh8 0JvyMb9angvgCMwgNOzXIaXGL8F+RAQ46E5zEhyaBTC1WHZR/m1fXivbrfBrBFgBbaiM 7xcUsfPKWfw8zth6B6KajEiFzSG2FxAC2Z0r9RyNgO1JIb7lUD85TIA/qfRE/7MTFITq QKcHvvOjD54eGfgBVAQTL4iV046nqr/Kp+V7EBdP052NnMQrHfoOFizj5lNiUUmqWXct M5Gg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=x-gm-message-state:mime-version:from:date:message-id:subject:to; bh=P6ueMUcXbRXctI6y5JuXR7nAjrqXWOCBayEdCtOl3T0=; b=OGDCvVY0R2p7Vax7LY2Qd+RVoyoV1bdItHJ1ck9Br+T0hknUer8I9SL/Yf+7HIeg0b LR6rKrf1Ph9iyZuI1FlDNE+FNvrRCAIAyScJV6BHV2aI9i2npms+k+TMVWpPQfOFAul0 iBaU5QI11HwM+A/4mmEGI3II2xfmuq6J4FovKWb7agxRqkISom1zebWbQjdtWvYYefVi RkeOpb6c/oCmdUFqFqMXr9KYL6cAtlwOmjfpwez5tnbx2LRoeK4jLG8r6QTVwvZSIXIY D4r4n05MFPHJWwmNtwGdSZ28dc5DTcUV4/SLg3BHedHiNJWKdiO5ZNLR2FxLCAHRJkTV Q5ww== X-Gm-Message-State: AOAM5325udou4FNKXb4TBz74sRkSeb03rlhim15KmO9B9yJuFlg2UbDw TxlpvXgrjTLk71VMPQAnucQfJi4rlaFOlSd93NHlOW+opzs= X-Google-Smtp-Source: ABdhPJyOawlArESLvjhHCT1YJaEEiKNpLU5KsOkF9UuqRPDZZe81+zmnp5PiGT2zJOgRA0Lqrl50Yva8aQwosAbv9vE= X-Received: by 2002:a67:2fd0:: with SMTP id v199mr79093185vsv.35.1636290830971; Sun, 07 Nov 2021 05:13:50 -0800 (PST) Received-SPF: pass client-ip=2607:f8b0:4864:20::929; envelope-from=dalanicolai@gmail.com; helo=mail-ua1-x929.google.com X-Spam_score_int: -20 X-Spam_score: -2.1 X-Spam_bar: -- X-Spam_report: (-2.1 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, FREEMAIL_FROM=0.001, HTML_MESSAGE=0.001, RCVD_IN_DNSWL_NONE=-0.0001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-BeenThere: bug-gnu-emacs@gnu.org List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Original-Sender: "bug-gnu-emacs" Xref: news.gmane.io gmane.emacs.bugs:219235 Archived-At: --000000000000bab6a405d032a51d Content-Type: text/plain; charset="UTF-8" This report is about a minor documentation bug. Because of some confusion about some seemingly 'inconsistent' error (FYI it is described at https://github.com/jkitchin/org-ref/issues/925#issuecomment-958185510), I was trying to confirm (look up) if installation of a package implies compilation of the package also. Then I found that it (the word 'compile') is not mentioned in section '48.3 Package Installation' ( https://www.gnu.org/software/emacs/manual/html_node/emacs/Package-Installation.html ) of the Emacs manual. It is 'implied' in section `48 Emacs Lisp Packages` and it is explicitly mentioned in section '41.1 Packaging Basics` of the Elisp manual. But I would prefer (consider it better practice/more helpful) to mention again, explicitly, in section '48.3 Package Installation' what it means for a package to get installed, as that is the section a user typically looks at/finds first. This is just a suggestion (notification) of course, just because now I could not 'easily/intuitively' find the correct answer. In GNU Emacs 28.0.50 (build 3, x86_64-pc-linux-gnu, GTK+ Version 3.24.30, cairo version 1.17.4) of 2021-09-06 built on daniel-fedora Repository revision: c4724add006e62b81f847937db56335a81bdcc74 Repository branch: master Windowing system distributor 'The X.Org Foundation', version 11.0.12101002 System Description: Fedora 34 (Workstation Edition) Configured using: 'configure --with-mailutils --with-cairo --with-modules --with-pgtk --with-native-compilation' Configured features: ACL CAIRO DBUS FREETYPE GIF GLIB GMP GNUTLS GPM GSETTINGS HARFBUZZ JPEG JSON LCMS2 LIBOTF LIBSELINUX LIBSYSTEMD LIBXML2 M17N_FLT MODULES NATIVE_COMP NOTIFY INOTIFY PDUMPER PNG RSVG SECCOMP SOUND THREADS TIFF TOOLKIT_SCROLL_BARS X11 XDBE XIM XPM GTK3 ZLIB Important settings: value of $LANG: en_US.UTF-8 locale-coding-system: utf-8-unix Major mode: Lisp Interaction Minor modes in effect: tooltip-mode: t global-eldoc-mode: t eldoc-mode: t electric-indent-mode: t mouse-wheel-mode: t tool-bar-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 line-number-mode: t indent-tabs-mode: t transient-mark-mode: t Load-path shadows: None found. Features: (shadow sort mail-extr emacsbug message rmc puny dired dired-loaddefs rfc822 mml mml-sec epa derived epg rfc6068 epg-config gnus-util rmail rmail-loaddefs auth-source cl-seq eieio eieio-core cl-macs eieio-loaddefs password-cache json map text-property-search time-date subr-x seq byte-opt gv bytecomp byte-compile cconv mm-decode mm-bodies mm-encode mail-parse rfc2231 mailabbrev gmm-utils mailheader cl-loaddefs cl-lib sendmail rfc2047 rfc2045 ietf-drums mm-util mail-prsvr mail-utils iso-transl 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 tab-bar menu-bar rfn-eshadow isearch easymenu timer select scroll-bar mouse jit-lock font-lock syntax font-core term/tty-colors frame minibuffer 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 cl-preloaded nadvice button loaddefs faces cus-face macroexp files window 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 cairo move-toolbar gtk x-toolkit x multi-tty make-network-process native-compile emacs) Memory information: ((conses 16 67485 9074) (symbols 48 6625 0) (strings 32 19331 1625) (string-bytes 1 659499) (vectors 16 13095) (vector-slots 8 260905 11713) (floats 8 22 32) (intervals 56 223 0) (buffers 992 11)) --000000000000bab6a405d032a51d Content-Type: text/html; charset="UTF-8" Content-Transfer-Encoding: quoted-printable
This report is about= a minor documentation bug.
=
Because of some confusion a= bout some seemingly 'inconsistent' error
(FYI it is described at
I was trying to confirm (look up) if installati= on of a package implies
comp= ilation of the package also.

Then I found that it (the = word 'compile') is not mentioned in section '48.3 Package Insta= llation'
of the Emacs manual.

It is '= implied' in section `48 Emacs Lisp Packages` and it is explicitly
mentioned in section '41.1 Pa= ckaging Basics` of the Elisp manual. But I
would prefer (consider it better practice/more helpful) to m= ention again, explicitly, in section '48.3 Package Installation' wh= at it means for a
package to= get installed, as that is the section a user typically looks at/finds firs= t.

This is just a suggestion (notification) of course, = just because now I could not 'easily/intuitively' find the correct = answer.


=C2= =A0of 2021-09-06 built on daniel-fedora
Repository revision: c4724add006e62b81f847937db56335a81bdcc74
Repository branch: master
=
Windowing system distributor &#= 39;The X.Org Foundation', version 11.0.12101002
System Description: Fedora 34 (Workstation Edition)=

Configured using:
=C2=A0'configure --with-mailutils --with-cairo --with-module= s --with-pgtk
=C2=A0--with-n= ative-compilation'

<= /div>
Configured features:
ACL CAIRO DBUS FREETYPE GIF GLIB GMP GN= UTLS GPM GSETTINGS HARFBUZZ JPEG
JSON LCMS2 LIBOTF LIBSELINUX LIBSYSTEMD LIBXML2 M17N_FLT MODULES
NATIVE_COMP NOTIFY INOTIFY PDUMPE= R PNG RSVG SECCOMP SOUND THREADS TIFF
TOOLKIT_SCROLL_BARS X11 XDBE XIM XPM GTK3 ZLIB

=C2=A0= value of $LANG: en_US.UTF-8
=C2=A0 locale-coding-system: utf-8-unix

Major mode: Li= sp Interaction

Minor modes in effect:
=C2=A0 tooltip-mode: t
=C2=A0 global-eldoc-mode: t
=C2=A0 eldoc-mode: t
=C2=A0 electric-indent-mode: t
=C2=A0 mouse-wheel-mode: t
=C2=A0 tool-bar-mode: t
=C2=A0 menu-bar-mode: t
=C2=A0 file-name-shadow-mode: t
=C2=A0 global-font-lock-mode: t
=C2=A0 font-lock-mode: t
=C2=A0 blink-cursor-mode: t
=C2=A0 auto-composition-mode: t
=C2=A0 auto-encryption-mode: t
=C2=A0 auto-compression-mode: t
=C2=A0 line-number-mode: t
=C2=A0 indent-tabs-mode: t
=C2=A0 transient-mark-mode: t

Load-path shadows:
None f= ound.

Features:
(shadow sort mail-extr emacsbug message rmc puny dired dired-load= defs
rfc822 mml mml-sec epa = derived epg rfc6068 epg-config gnus-util rmail
rmail-loaddefs auth-source cl-seq eieio eieio-core cl-ma= cs
eieio-loaddefs password-c= ache json map text-property-search time-date
subr-x seq byte-opt gv bytecomp byte-compile cconv mm-deco= de mm-bodies
mm-encode mail-= parse rfc2231 mailabbrev gmm-utils mailheader cl-loaddefs
cl-lib sendmail rfc2047 rfc2045 ietf-drums mm= -util mail-prsvr mail-utils
= iso-transl 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 tab-bar menu-bar
rfn-eshadow isearch easymenu timer select scroll-bar mouse ji= t-lock
font-lock syntax font= -core term/tty-colors frame minibuffer cl-generic
cham georgian utf-8-lang misc-lang vietnamese tibetan= thai tai-viet lao
korean ja= panese eucjp-ms cp51932 hebrew greek romanian slovak czech
european ethiopic indian cyrillic chinese co= mposite charscript charprop
= case-table epa-hook jka-cmpr-hook help simple abbrev obarray
cl-preloaded nadvice button loaddefs faces= cus-face macroexp files
win= dow text-properties overlay sha1 md5 base64 format env code-pages
=
mule custom widget hashtable-print-re= adable backquote threads dbusbind
inotify lcms2 dynamic-setting system-font-setting font-render-setting=
cairo move-toolbar gtk x-to= olkit x multi-tty make-network-process
native-compile emacs)

Memory information:
((conses 16 67485 9074)
=C2=A0(symbols 48 6625 0)
=C2=A0(strings 32 19331 1625)
=C2=A0(string-bytes 1 659499)
<= /div>
=C2=A0(vectors 16 13095)
=C2=A0(vector-slots 8 260905 11713)=
=C2=A0(floats 8 22 32)
<= /div>
=C2=A0(intervals 56 223 0)
=C2=A0(buffers 992 11))
=

--000000000000bab6a405d032a51d--