GNU logs - #69734, boring messages

Message sent to bug-gnu-emacs@HIDDEN:

Subject: bug#69734: BUG: Inconsistent Emacs documentation...
Resent-From: Mikael Larsson <mikael.x.larsson@HIDDEN>
Original-Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
Resent-CC: bug-gnu-emacs@HIDDEN
Resent-Date: Mon, 11 Mar 2024 15:02:01 +0000
Resent-Message-ID: <handler.69734.B.171016930926115 <at> debbugs.gnu.org>
Resent-Sender: help-debbugs@HIDDEN
To: 69734 <at> debbugs.gnu.org
MIME-Version: 1.0
From: Mikael Larsson <mikael.x.larsson@HIDDEN>
Date: Mon, 11 Mar 2024 14:34:35 +0100
Message-ID: <CAKVZV+B9XUui=Lcu6-Fvf07Kszu8sdgvy4fX0qz39m+5qXMjTQ@HIDDEN>
Content-Type: multipart/alternative; boundary="000000000000ec2cd70613629a93"
Received-SPF: pass client-ip=2607:f8b0:4864:20::1035;
 envelope-from=mikael.x.larsson@HIDDEN; helo=mail-pj1-x1035.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, T_SCC_BODY_TEXT_LINE=-0.01 autolearn=ham autolearn_force=no
X-Spam_action: no action
X-Spam-Score: -1.3 (-)
X-Mailman-Approved-At: Mon, 11 Mar 2024 11:01:46 -0400
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.18
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/>
List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org>
List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help>
List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe>
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
X-Spam-Score: -2.3 (--)

--000000000000ec2cd70613629a93
Content-Type: text/plain; charset="UTF-8"
Content-Transfer-Encoding: quoted-printable

 To Whom It May Concern,

I just downloaded the documentation for Emacs 29.2 as a pdf file. Comparing
this to the version online I can see that the content is not the same. At
least one of the versions is faulty or out of date. I'm referring to links
on the following page:
https://www.gnu.org/software/emacs/manual/emacs.html

Looking at "HTML - one page per node" I can see that chapter 15.22 is "Line
Truncation". If I look at the pdf version "Main PDF file", that chapter is
11.22. The pdf document is labeled as consistent with version 29.2 on page
T-3. I assume this is just an issue with generating the pdf version.
Thanks in advance for your help.

Best regards,
Mikael Larsson
Buried in 3 feet of snow in the north of Sweden and struggling with
elisp...=F0=9F=A5=BA

*Q*: How can I get the full output of the macro expansion below? I assume
it's some variable that needs tweaking, but I can't find it in the manual.
Thank you.

(macroexpand-1 '(cl-defstruct queue head tail))
(progn (defvar cl-struct-queue-tags) (cl-defsubst queue-p (cl-x) (declare
(side-effect-free error-free) (pure t)) (and (memq ...
cl-struct-queue-tags) t)) (eval-and-compile (define-symbol-prop 'queue
'cl-deftype-satisfies 'queue-p)) (cl-defsubst queue-head (cl-x) "Access
slot \"head\" of `queue' struct CL-X." (declare (side-effect-free t))
(progn (or ... ...) (aref cl-x 1))) (cl-defsubst queue-tail (cl-x) "Access
slot \"tail\" of `queue' struct CL-X." (declare (side-effect-free t))
(progn (or ... ...) (aref cl-x 2))) (defalias 'copy-queue #'copy-sequence)
(cl-defsubst make-queue (&cl-defs (nil ... ... ...) &key head tail)
"Constructor for objects of type `queue'." (declare (side-effect-free t))
(record 'queue head tail)) :autoload-end (eval-and-compile
(cl-struct-define 'queue nil 'cl-structure-object 'record nil '(... ...
...) 'cl-struct-queue-tags 'queue 't)) 'queue)

--000000000000ec2cd70613629a93
Content-Type: text/html; charset="UTF-8"
Content-Transfer-Encoding: quoted-printable

<div dir=3D"ltr">
<div><span style=3D"font-weight:400">To Whom It May Concern,</span></div><d=
iv><span style=3D"font-weight:400"><br></span></div><div><span style=3D"fon=
t-weight:400">I just downloaded the documentation for Emacs 29.2 as a pdf f=
ile. Comparing this to the version online I can see that the content is not=
 the same. At least one of the versions is faulty or out of date. I&#39;m r=
eferring to links on the following page:</span></div><div><a href=3D"https:=
//www.gnu.org/software/emacs/manual/emacs.html">https://www.gnu.org/softwar=
e/emacs/manual/emacs.html</a></div><div><br></div><div>Looking at &quot;HTM=
L - one page per node&quot; I can see that chapter 15.22 is &quot;Line Trun=
cation&quot;. If I look at the pdf version &quot;Main PDF file&quot;, that =
chapter is 11.22. The pdf document is labeled as consistent with version 29=
.2 on page T-3. <span style=3D"font-weight:400">I assume this is just an is=
sue with generating the pdf version. <br></span></div><div><span style=3D"f=
ont-weight:400">Thanks in advance for your help.</span></div><div><span sty=
le=3D"font-weight:400"><br></span></div><div><span style=3D"font-weight:400=
">Best regards,</span></div><div><span style=3D"font-weight:400">Mikael Lar=
sson</span></div><div><span style=3D"font-weight:400">Buried in 3 feet of s=
now in the north of Sweden and struggling with elisp...=F0=9F=A5=BA<br></sp=
an></div><div><span style=3D"font-weight:400"><br></span></div><div><span s=
tyle=3D"font-weight:400"><b>Q</b>: How can I get the full output of the mac=
ro expansion below? I assume it&#39;s some variable that needs tweaking, bu=
t I can&#39;t find it in the manual. Thank you.<br></span></div><div><br>(m=
acroexpand-1 &#39;(cl-defstruct queue head tail))<br>(progn (defvar cl-stru=
ct-queue-tags) (cl-defsubst queue-p (cl-x) (declare (side-effect-free error=
-free) (pure t)) (and (memq ... cl-struct-queue-tags) t)) (eval-and-compile=
 (define-symbol-prop &#39;queue &#39;cl-deftype-satisfies &#39;queue-p)) (c=
l-defsubst queue-head (cl-x) &quot;Access slot \&quot;head\&quot; of `queue=
&#39; struct CL-X.&quot; (declare (side-effect-free t)) (progn (or ... ...)=
 (aref cl-x 1))) (cl-defsubst queue-tail (cl-x) &quot;Access slot \&quot;ta=
il\&quot; of `queue&#39; struct CL-X.&quot; (declare (side-effect-free t)) =
(progn (or ... ...) (aref cl-x 2))) (defalias &#39;copy-queue #&#39;copy-se=
quence) (cl-defsubst make-queue (&amp;cl-defs (nil ... ... ...) &amp;key he=
ad tail) &quot;Constructor for objects of type `queue&#39;.&quot; (declare =
(side-effect-free t)) (record &#39;queue head tail)) :autoload-end (eval-an=
d-compile (cl-struct-define &#39;queue nil &#39;cl-structure-object &#39;re=
cord nil &#39;(... ... ...) &#39;cl-struct-queue-tags &#39;queue &#39;t)) &=
#39;queue)<span style=3D"font-weight:400"><br></span></div><div><span style=
=3D"font-weight:400"><br></span></div>

</div>

--000000000000ec2cd70613629a93--

Message sent:

Content-Disposition: inline
Content-Transfer-Encoding: quoted-printable
MIME-Version: 1.0
X-Mailer: MIME-tools 5.505 (Entity 5.505)
Content-Type: text/plain; charset=utf-8
X-Loop: help-debbugs@HIDDEN
From: help-debbugs@HIDDEN (GNU bug Tracking System)
To: Mikael Larsson <mikael.x.larsson@HIDDEN>
Subject: bug#69734: Acknowledgement (BUG: Inconsistent Emacs documentation...)
Message-ID: <handler.69734.B.171016930926115.ack <at> debbugs.gnu.org>
References: <CAKVZV+B9XUui=Lcu6-Fvf07Kszu8sdgvy4fX0qz39m+5qXMjTQ@HIDDEN>
X-Gnu-PR-Message: ack 69734
X-Gnu-PR-Package: emacs
Reply-To: 69734 <at> debbugs.gnu.org
Date: Mon, 11 Mar 2024 15:02:01 +0000

Thank you for filing a new bug report with debbugs.gnu.org.

This is an automatically generated reply to let you know your message
has been received.

Your message is being forwarded to the package maintainers and other
interested parties for their attention; they will reply in due course.

Your message has been sent to the package maintainer(s):
 bug-gnu-emacs@HIDDEN

If you wish to submit further information on this problem, please
send it to 69734 <at> debbugs.gnu.org.

Please do not send mail to help-debbugs@HIDDEN unless you wish
to report a problem with the Bug-tracking system.

--=20
69734: https://debbugs.gnu.org/cgi/bugreport.cgi?bug=3D69734
GNU Bug Tracking System
Contact help-debbugs@HIDDEN with problems

Message sent to bug-gnu-emacs@HIDDEN:

Subject: bug#69734: BUG: Inconsistent Emacs documentation...
Resent-From: Eli Zaretskii <eliz@HIDDEN>
Original-Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
Resent-CC: bug-gnu-emacs@HIDDEN
Resent-Date: Mon, 11 Mar 2024 16:45:01 +0000
Resent-Message-ID: <handler.69734.B69734.171017546525850 <at> debbugs.gnu.org>
Resent-Sender: help-debbugs@HIDDEN
To: Mikael Larsson <mikael.x.larsson@HIDDEN>
Cc: 69734 <at> debbugs.gnu.org
Date: Mon, 11 Mar 2024 18:43:39 +0200
Message-Id: <86zfv4u3b8.fsf@HIDDEN>
From: Eli Zaretskii <eliz@HIDDEN>
In-Reply-To: <CAKVZV+B9XUui=Lcu6-Fvf07Kszu8sdgvy4fX0qz39m+5qXMjTQ@HIDDEN>
 (message from Mikael Larsson on Mon, 11 Mar 2024 14:34:35 +0100)
References: <CAKVZV+B9XUui=Lcu6-Fvf07Kszu8sdgvy4fX0qz39m+5qXMjTQ@HIDDEN>
Precedence: list
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>

> From: Mikael Larsson <mikael.x.larsson@HIDDEN>
> Date: Mon, 11 Mar 2024 14:34:35 +0100
> 
> I just downloaded the documentation for Emacs 29.2 as a pdf file. Comparing this to the version online I can
> see that the content is not the same. At least one of the versions is faulty or out of date. I'm referring to links
> on the following page:
> https://www.gnu.org/software/emacs/manual/emacs.html
> 
> Looking at "HTML - one page per node" I can see that chapter 15.22 is "Line Truncation". If I look at the pdf
> version "Main PDF file", that chapter is 11.22. The pdf document is labeled as consistent with version 29.2 on
> page T-3. I assume this is just an issue with generating the pdf version. 
> Thanks in advance for your help.

This is normal: the printed version of the manual omits some of the
material, to make the printed book smaller and less expensive.  You
are well advised to use an on-line version, either HTML or the Info
version (the latter is part of a standard Emacs installation).

> Q: How can I get the full output of the macro expansion below? I assume it's some variable that needs
> tweaking, but I can't find it in the manual. Thank you.

I think you are looking for the answer in the wrong manual.  You
should look in the ELisp Reference manual, there's a section there
named "Expansion of a Macro Call".

Message sent to bug-gnu-emacs@HIDDEN:

Subject: bug#69734: BUG: Inconsistent Emacs documentation...
Resent-From: Eli Zaretskii <eliz@HIDDEN>
Original-Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
Resent-CC: bug-gnu-emacs@HIDDEN
Resent-Date: Fri, 15 Mar 2024 11:45:01 +0000
Resent-Message-ID: <handler.69734.B69734.17105030934473 <at> debbugs.gnu.org>
Resent-Sender: help-debbugs@HIDDEN
To: Mikael Larsson <mikael.x.larsson@HIDDEN>
Cc: 69734 <at> debbugs.gnu.org
Date: Fri, 15 Mar 2024 13:44:04 +0200
Message-Id: <86jzm390u3.fsf@HIDDEN>
From: Eli Zaretskii <eliz@HIDDEN>
In-Reply-To: <CAKVZV+CPKFS7bO3V_+OWkPyiLojBiDm1hEeA7EtrKH-T+ZUDeg@HIDDEN>
 (message from Mikael Larsson on Fri, 15 Mar 2024 11:49:26 +0100)
References: <CAKVZV+B9XUui=Lcu6-Fvf07Kszu8sdgvy4fX0qz39m+5qXMjTQ@HIDDEN>
 <86zfv4u3b8.fsf@HIDDEN>
 <CAKVZV+CPKFS7bO3V_+OWkPyiLojBiDm1hEeA7EtrKH-T+ZUDeg@HIDDEN>
Precedence: list
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>

severity 69734 wishlist
thanks

Resending Mikael's response, which was sent only to me:

> From: Mikael Larsson <mikael.x.larsson@HIDDEN>
> Date: Fri, 15 Mar 2024 11:49:26 +0100
> 
> Hi Eli,
> 
> Thank you for your reply!
> A few comments on your answer:
> Please consider making two PDFs available on the download page. The current one that is a copy of the
> printed version and a new one with the full documentation. It's most convenient to have the full documentation
> in PDF, making full search easy.  This will also offload searches on your website as well.
> 
> Kind regards and have a nice weekend,
> Mikael Larsson

Thank you for your comments.  For now, we don't have the resources to
produce two versions if each PDF manual, but maybe one day in the
future.

I've now converted this bug report to a feature request.

Message received at control <at> debbugs.gnu.org:

Received: (at control) by debbugs.gnu.org; 15 Mar 2024 11:44:53 +0000
From debbugs-submit-bounces <at> debbugs.gnu.org Fri Mar 15 07:44:53 2024
Received: from localhost ([127.0.0.1]:52201 helo=debbugs.gnu.org)
	by debbugs.gnu.org with esmtp (Exim 4.84_2)
	(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
	id 1rl5zZ-0001A6-6g
	for submit <at> debbugs.gnu.org; Fri, 15 Mar 2024 07:44:53 -0400
Received: from eggs.gnu.org ([209.51.188.92]:43704)
 by debbugs.gnu.org with esmtp (Exim 4.84_2)
 (envelope-from <eliz@HIDDEN>)
 id 1rl5zW-00019n-TQ; Fri, 15 Mar 2024 07:44:51 -0400
Received: from fencepost.gnu.org ([2001:470:142:3::e])
 by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256)
 (Exim 4.90_1) (envelope-from <eliz@HIDDEN>)
 id 1rl5yq-0004xw-U5; Fri, 15 Mar 2024 07:44:08 -0400
DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org;
 s=fencepost-gnu-org; h=References:Subject:In-Reply-To:To:From:Date:
 mime-version; bh=uXwgMpRrbKgYaq8pw/SgEhwL4rXHtht7K9ig+DfVsJI=; b=ljeRiokxs6Ze
 Q2eOT6uoxiepxu8F2y3+MnfJFLfgmge5KuVOIcv08zKBk7qpodfvbhuVSUfw0fPD75Se8vT9+YadD
 Ceyg6BNf4RA9VIKlMbXeZcQAiaV30G4jeNiBF+uHmttkx5GBnhbupN94fsgTkkJDG/GnLdZLbMF25
 EwH1ypCfpRjy6oNozECeLBSOa5M/xDVk+i848Hbo4h//Pgl4SZR3X2ZQCcW8hUOzdmJLlH2FU2Nrx
 RXbBRrTedhSwRA0MAhruVEMK9gC+Rtzi5UgFE61PhKqwA0uieO3gFm12MaVSC2Q8H6URWa5rdZwkh
 UizYSi59RjetFH3leOSriw==;
Date: Fri, 15 Mar 2024 13:44:04 +0200
Message-Id: <86jzm390u3.fsf@HIDDEN>
From: Eli Zaretskii <eliz@HIDDEN>
To: Mikael Larsson <mikael.x.larsson@HIDDEN>
In-Reply-To: <CAKVZV+CPKFS7bO3V_+OWkPyiLojBiDm1hEeA7EtrKH-T+ZUDeg@HIDDEN>
 (message from Mikael Larsson on Fri, 15 Mar 2024 11:49:26 +0100)
Subject: Re: bug#69734: BUG: Inconsistent Emacs documentation...
References: <CAKVZV+B9XUui=Lcu6-Fvf07Kszu8sdgvy4fX0qz39m+5qXMjTQ@HIDDEN>
 <86zfv4u3b8.fsf@HIDDEN>
 <CAKVZV+CPKFS7bO3V_+OWkPyiLojBiDm1hEeA7EtrKH-T+ZUDeg@HIDDEN>
X-Spam-Score: -2.3 (--)
X-Debbugs-Envelope-To: control
Cc: 69734 <at> debbugs.gnu.org
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.18
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/>
List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org>
List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help>
List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe>
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
X-Spam-Score: -3.3 (---)

severity 69734 wishlist
thanks

Resending Mikael's response, which was sent only to me:

> From: Mikael Larsson <mikael.x.larsson@HIDDEN>
> Date: Fri, 15 Mar 2024 11:49:26 +0100
> 
> Hi Eli,
> 
> Thank you for your reply!
> A few comments on your answer:
> Please consider making two PDFs available on the download page. The current one that is a copy of the
> printed version and a new one with the full documentation. It's most convenient to have the full documentation
> in PDF, making full search easy.  This will also offload searches on your website as well.
> 
> Kind regards and have a nice weekend,
> Mikael Larsson

Thank you for your comments.  For now, we don't have the resources to
produce two versions if each PDF manual, but maybe one day in the
future.

I've now converted this bug report to a feature request.

Last modified: Fri, 15 Mar 2024 12:00:02 UTC

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997 nCipher Corporation Ltd, 1994-97 Ian Jackson.