bug#66680: PDF version of Elisp manual is missing section about 'rx' regexp format

bug#66680: PDF version of Elisp manual is missing section about 'rx' regexp format

[Marco Antoniotti]

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

Hi

I noted this glitch since 28.x.  Still there in 29.x.

HTML version has the section on 'rx' regexps coding, but it is missing from
the PDFs downloadable from the main site
https://www.gnu.org/software/emacs/manual/emacs.html

All the best

-- 
Marco Antoniotti
Somewhere over the Rainbow

[-- Attachment #2: Type: text/html, Size: 618 bytes --]

bug#66680: PDF version of Elisp manual is missing section about 'rx' regexp format

[Eli Zaretskii]

tags 66680 notabug
thanks

> From: Marco Antoniotti <marcoxa@gmail.com>
> Date: Sun, 22 Oct 2023 14:55:47 +0200
> 
> I noted this glitch since 28.x.  Still there in 29.x.
> 
> HTML version has the section on 'rx' regexps coding, but it is missing from the PDFs downloadable
> from the main site https://www.gnu.org/software/emacs/manual/emacs.html

This is on purpose: the Rx section is excluded from the printed
manual, to keep the printed manual's size at bay.  Several other
sections are also excluded.

This is not a bug.

bug#66680: PDF version of Elisp manual is missing section about 'rx' regexp format

[Marco Antoniotti]

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

Thanks.

A bit confusing though...  Time to re-evaluate this choice?

MA


On Sun, Oct 22, 2023 at 3:23 PM Eli Zaretskii <eliz@gnu.org> wrote:

> tags 66680 notabug
> thanks
>
> > From: Marco Antoniotti <marcoxa@gmail.com>
> > Date: Sun, 22 Oct 2023 14:55:47 +0200
> >
> > I noted this glitch since 28.x.  Still there in 29.x.
> >
> > HTML version has the section on 'rx' regexps coding, but it is missing
> from the PDFs downloadable
> > from the main site https://www.gnu.org/software/emacs/manual/emacs.html
>
> This is on purpose: the Rx section is excluded from the printed
> manual, to keep the printed manual's size at bay.  Several other
> sections are also excluded.
>
> This is not a bug.
>


-- 
Marco Antoniotti
Somewhere over the Rainbow

[-- Attachment #2: Type: text/html, Size: 1460 bytes --]

bug#66680: PDF version of Elisp manual is missing section about 'rx' regexp format

[Eli Zaretskii]

> From: Marco Antoniotti <marcoxa@gmail.com>
> Date: Sun, 22 Oct 2023 15:25:04 +0200
> Cc: 66680@debbugs.gnu.org
> 
> A bit confusing though...  Time to re-evaluate this choice?

Could be.  Feel free to bring it up on emacs-devel.  But the size
issue of the ELisp manual is very real: it already prints as two quite
thick volumes.  So we will continue trying to keep some less important
parts of the manual be excluded from the printed version.

Why don't you use the on-line version, either Info or HTML?  The PDF
version is basically needed for printing the manual, not for reading
it on-line.

bug#66680: PDF version of Elisp manual is missing section about 'rx' regexp format

[Marco Antoniotti]

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

Hi

Understood.

I like the PDF because it is "fully offline".  I am a cheap old geezer who
does not like to be always online and I have an almost three hours train
commute :)

All the best

Marco





On Sun, Oct 22, 2023 at 4:05 PM Eli Zaretskii <eliz@gnu.org> wrote:

> > From: Marco Antoniotti <marcoxa@gmail.com>
> > Date: Sun, 22 Oct 2023 15:25:04 +0200
> > Cc: 66680@debbugs.gnu.org
> >
> > A bit confusing though...  Time to re-evaluate this choice?
>
> Could be.  Feel free to bring it up on emacs-devel.  But the size
> issue of the ELisp manual is very real: it already prints as two quite
> thick volumes.  So we will continue trying to keep some less important
> parts of the manual be excluded from the printed version.
>
> Why don't you use the on-line version, either Info or HTML?  The PDF
> version is basically needed for printing the manual, not for reading
> it on-line.
>


-- 
Marco Antoniotti
Somewhere over the Rainbow

[-- Attachment #2: Type: text/html, Size: 1684 bytes --]

bug#66680: PDF version of Elisp manual is missing section about 'rx' regexp format

[Eli Zaretskii]

> From: Marco Antoniotti <marcoxa@gmail.com>
> Date: Sun, 22 Oct 2023 18:58:13 +0200
> Cc: 66680@debbugs.gnu.org
> 
> Understood.
> 
> I like the PDF because it is "fully offline".  I am a cheap old geezer who does not like to be always
> online and I have an almost three hours train commute :)

?? You can have both the HTML and the Info manuals on your local disk
and use them when you are off-line.

bug#66680: PDF version of Elisp manual is missing section about 'rx' regexp format

[Marco Antoniotti]

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

I know.  I just find the HTML more annoying to handle locally.

I know, I am strange :)

All the best



On Sun, Oct 22, 2023 at 7:42 PM Eli Zaretskii <eliz@gnu.org> wrote:

> > From: Marco Antoniotti <marcoxa@gmail.com>
> > Date: Sun, 22 Oct 2023 18:58:13 +0200
> > Cc: 66680@debbugs.gnu.org
> >
> > Understood.
> >
> > I like the PDF because it is "fully offline".  I am a cheap old geezer
> who does not like to be always
> > online and I have an almost three hours train commute :)
>
> ?? You can have both the HTML and the Info manuals on your local disk
> and use them when you are off-line.
>


-- 
Marco Antoniotti
Somewhere over the Rainbow

[-- Attachment #2: Type: text/html, Size: 1297 bytes --]

bug#66680: PDF version of Elisp manual is missing section about 'rx' regexp format

[Michael Albinus]

Marco Antoniotti <marcoxa@gmail.com> writes:

> Hi

Hi Marco,

> I noted this glitch since 28.x.  Still there in 29.x.
>
> HTML version has the section on 'rx' regexps coding, but it is missing
> from the PDFs downloadable from the main site
> https://www.gnu.org/software/emacs/manual/emacs.html

The section about "Rx Notation" in doc/lispref/searching.texi is embedded with

--8<---------------cut here---------------start------------->8---
@ifnottex
@node Rx Notation
@subsection The @code{rx} Structured Regexp Notation
...
@end ifnottex
--8<---------------cut here---------------end--------------->8---

The commit message of ac1ad3e49abd, which brought it to the manual,
claims

--8<---------------cut here---------------start------------->8---
    The additions are excluded from the print version to avoid making it
    thicker.
--8<---------------cut here---------------end--------------->8---

So it isn't a bug. Closing.

> All the best

Best regards, Michael.