GNU bug report logs - #64548
29.0.92; Modus Themes Info manual is in "Unknown category"

Previous Next

To add a comment to this bug, you must first unarchive it, by sending
a message to control AT debbugs.gnu.org, with unarchive 64548 in the body.
You can then email your comments to 64548 AT debbugs.gnu.org in the normal way.

Toggle the display of automated, internal messages from the tracker.

Message #5 received at submit <at> debbugs.gnu.org (full text, mbox):

From: Stephen Berman <stephen.berman <at> gmx.net>
To: bug-gnu-emacs <at> gnu.org
Subject: 29.0.92; Modus Themes Info manual is in "Unknown category"
Date: Sun, 09 Jul 2023 22:21:55 +0200

After building Emacs from the release branch or from master, the
info/dir file looks like this (excerpted):

[...]
* Menu:

Texinfo documentation system
* Info: (info).                 How to use the documentation browsing system.

Emacs
* Emacs: (emacs).               The extensible self-documenting text editor.
* Emacs FAQ: (efaq).            Frequently Asked Questions about Emacs.

Emacs lisp
* Emacs Lisp Intro: (eintr).    A simple introduction to Emacs Lisp programming.
* Elisp: (elisp).               The Emacs Lisp Reference Manual.
[...]

Emacs misc features
* Autotype: (autotype).         Convenient features for text that you enter
                                  frequently in Emacs.
* Bovine: (bovine).             Semantic bovine parser development.
* Calc: (calc).                 Advanced desk calculator and mathematical tool.
* Dired-X: (dired-x).           Dired Extra Features.
[...]

Unknown category
*     Modus Themes: (modus-themes).      Elegant, highly legible and customizable themes.


The two odds things about the last entry are its category and the extra
space after the asterisk.  This odd category and appearance are only in
emacs-29 and master; in emacs-28 the Modus Themes manual is under the
"Emacs misc features" category and there's no extra space:


Emacs misc features
* Autotype: (autotype).         Convenient features for text that you enter
                                  frequently in Emacs.
* Bovine: (bovine).             Semantic bovine parser development.
* Calc: (calc).                 Advanced desk calculator and mathematical tool.
* Dired-X: (dired-x).           Dired Extra Features.
[...]
* Modus Themes: (modus-themes). Highly accessible themes (WCAG AAA).
* PCL-CVS: (pcl-cvs).           Emacs front-end to CVS.
[...]


I also checked the emacs-28.3-rc1.tar.xz and emacs-29.0.92.tar.xz
tarballs at alpha.gnu.org and the info/dir file in the latter tarball
has the same oddities with Modus Themes, while info/dir in the former
tarball does not.

I eyeballed doc/misc/modus-themes.texi, which is generated from
modus-themes.org, in emacs-29 and master, and the beginning of that file
appears similar to the start of other .texi files in that directory and
also to the start of org.texi, which is also generated (from org.org).
(One difference between modus-themes.org and org.org is that the latter
uses org-setup.org to generate the .texi file, while modus-themes.org
includes similar lines in the file itself instead of in a setup file.)
And the resulting modus-themes.info file also appears to be fine.
Moreover, when I execute `install-info ./modus-themes.info ./dir' from
the shell, using the modus-themes.info from the emacs-29 builds, the
resulting dir file contains the entry for Modus Themes under the "Emacs
misc features" category.  So it seems that problematic dir file results
from some other part of the build process, but I couldn't figure out
which.


In GNU Emacs 29.0.92 (build 1, x86_64-pc-linux-gnu, GTK+ Version
 3.24.38, cairo version 1.17.6) of 2023-07-02 built on strobelfssd
Repository revision: 37ed3d15f38339400eba67647c87fad85de3a384
Repository branch: emacs-29
Windowing system distributor 'The X.Org Foundation', version 11.0.12101008
System Description: Linux From Scratch r11.3-100-systemd

Configured using:
 'configure -C --with-xwidgets 'CFLAGS=-Og -g3'
 PKG_CONFIG_PATH=/opt/qt5/lib/pkgconfig'

Configured features:
ACL CAIRO DBUS FREETYPE GIF GLIB GMP GNUTLS GPM GSETTINGS HARFBUZZ JPEG
JSON LCMS2 LIBSYSTEMD LIBXML2 MODULES NOTIFY INOTIFY PDUMPER PNG RSVG
SECCOMP SOUND SQLITE3 THREADS TIFF TOOLKIT_SCROLL_BARS WEBP X11 XDBE XIM
XINPUT2 XPM XWIDGETS GTK3 ZLIB

Message #8 received at 64548 <at> debbugs.gnu.org (full text, mbox):

From: Stephen Berman <stephen.berman <at> gmx.net>
To: 64548 <at> debbugs.gnu.org
Subject: Re: bug#64548: 29.0.92; Modus Themes Info manual is in "Unknown
 category"
Date: Mon, 10 Jul 2023 12:20:10 +0200

[Message part 1 (text/plain, inline)]

On Sun, 09 Jul 2023 22:21:55 +0200 Stephen Berman <stephen.berman <at> gmx.net> wrote:

> After building Emacs from the release branch or from master, the
> info/dir file looks like this (excerpted):
>
> [...]
> * Menu:
>
> Texinfo documentation system
> * Info: (info).                 How to use the documentation browsing system.
>
> Emacs
> * Emacs: (emacs).               The extensible self-documenting text editor.
> * Emacs FAQ: (efaq).            Frequently Asked Questions about Emacs.
>
> Emacs lisp
> * Emacs Lisp Intro: (eintr).    A simple introduction to Emacs Lisp programming.
> * Elisp: (elisp).               The Emacs Lisp Reference Manual.
> [...]
>
> Emacs misc features
> * Autotype: (autotype).         Convenient features for text that you enter
>                                   frequently in Emacs.
> * Bovine: (bovine).             Semantic bovine parser development.
> * Calc: (calc).                 Advanced desk calculator and mathematical tool.
> * Dired-X: (dired-x).           Dired Extra Features.
> [...]
>
> Unknown category
> *     Modus Themes: (modus-themes).      Elegant, highly legible and customizable themes.
>
>
> The two odds things about the last entry are its category and the extra
> space after the asterisk.  This odd category and appearance are only in
> emacs-29 and master; in emacs-28 the Modus Themes manual is under the
> "Emacs misc features" category and there's no extra space:
>
>
> Emacs misc features
> * Autotype: (autotype).         Convenient features for text that you enter
>                                   frequently in Emacs.
> * Bovine: (bovine).             Semantic bovine parser development.
> * Calc: (calc).                 Advanced desk calculator and mathematical tool.
> * Dired-X: (dired-x).           Dired Extra Features.
> [...]
> * Modus Themes: (modus-themes). Highly accessible themes (WCAG AAA).
> * PCL-CVS: (pcl-cvs).           Emacs front-end to CVS.
> [...]
>
>
> I also checked the emacs-28.3-rc1.tar.xz and emacs-29.0.92.tar.xz
> tarballs at alpha.gnu.org and the info/dir file in the latter tarball
> has the same oddities with Modus Themes, while info/dir in the former
> tarball does not.
>
> I eyeballed doc/misc/modus-themes.texi, which is generated from
> modus-themes.org, in emacs-29 and master, and the beginning of that file
> appears similar to the start of other .texi files in that directory and
> also to the start of org.texi, which is also generated (from org.org).
> (One difference between modus-themes.org and org.org is that the latter
> uses org-setup.org to generate the .texi file, while modus-themes.org
> includes similar lines in the file itself instead of in a setup file.)
> And the resulting modus-themes.info file also appears to be fine.
> Moreover, when I execute `install-info ./modus-themes.info ./dir' from
> the shell, using the modus-themes.info from the emacs-29 builds, the
> resulting dir file contains the entry for Modus Themes under the "Emacs
> misc features" category.  So it seems that problematic dir file results
> from some other part of the build process, but I couldn't figure out
> which.

I bisected the problem to the following commit:

8a9839348fb8762c8843362595f2ca9de60d515c is the first bad commit
commit 8a9839348fb8762c8843362595f2ca9de60d515c
Author: Protesilaos Stavrou <info <at> protesilaos.com>
Date:   Wed Aug 3 14:32:38 2022 +0300

    Update modus-themes to their version 2.5.0

And the problem is due, to my surprise, to whitespace in the Org markup
at the beginning of modus-themes.org.  This suggests to me a problem
somewhere in org/ox-texinfo.el, but I'm not familiar with that code, so
I'll leave pursuing it to someone who is.  In the meantime, building
with the attached patch against current emacs-29 restores the correct
dir file.

Steve Berman

[Message part 2 (text/x-patch, attachment)]

Message #11 received at 64548 <at> debbugs.gnu.org (full text, mbox):

From: Philip Kaludercic <philipk <at> posteo.net>
To: Stephen Berman <stephen.berman <at> gmx.net>
Cc: Protesilaos Stavrou <info <at> protesilaos.com>, 64548 <at> debbugs.gnu.org
Subject: Re: bug#64548: 29.0.92; Modus Themes Info manual is in "Unknown
 category"
Date: Mon, 10 Jul 2023 14:08:30 +0000

I've added Protesilaos to the CCs, in case he hasn't seen the bug
report.  (Generally it is recommended to add a "X-Debbugs-CC" header if
you can find the maintainer).

Stephen Berman <stephen.berman <at> gmx.net> writes:

> On Sun, 09 Jul 2023 22:21:55 +0200 Stephen Berman <stephen.berman <at> gmx.net> wrote:
>
>> After building Emacs from the release branch or from master, the
>> info/dir file looks like this (excerpted):
>>
>> [...]
>> * Menu:
>>
>> Texinfo documentation system
>> * Info: (info).                 How to use the documentation browsing system.
>>
>> Emacs
>> * Emacs: (emacs).               The extensible self-documenting text editor.
>> * Emacs FAQ: (efaq).            Frequently Asked Questions about Emacs.
>>
>> Emacs lisp
>> * Emacs Lisp Intro: (eintr).    A simple introduction to Emacs Lisp programming.
>> * Elisp: (elisp).               The Emacs Lisp Reference Manual.
>> [...]
>>
>> Emacs misc features
>> * Autotype: (autotype).         Convenient features for text that you enter
>>                                   frequently in Emacs.
>> * Bovine: (bovine).             Semantic bovine parser development.
>> * Calc: (calc).                 Advanced desk calculator and mathematical tool.
>> * Dired-X: (dired-x).           Dired Extra Features.
>> [...]
>>
>> Unknown category
>> *     Modus Themes: (modus-themes).      Elegant, highly legible and customizable themes.
>>
>>
>> The two odds things about the last entry are its category and the extra
>> space after the asterisk.  This odd category and appearance are only in
>> emacs-29 and master; in emacs-28 the Modus Themes manual is under the
>> "Emacs misc features" category and there's no extra space:
>>
>>
>> Emacs misc features
>> * Autotype: (autotype).         Convenient features for text that you enter
>>                                   frequently in Emacs.
>> * Bovine: (bovine).             Semantic bovine parser development.
>> * Calc: (calc).                 Advanced desk calculator and mathematical tool.
>> * Dired-X: (dired-x).           Dired Extra Features.
>> [...]
>> * Modus Themes: (modus-themes). Highly accessible themes (WCAG AAA).
>> * PCL-CVS: (pcl-cvs).           Emacs front-end to CVS.
>> [...]
>>
>>
>> I also checked the emacs-28.3-rc1.tar.xz and emacs-29.0.92.tar.xz
>> tarballs at alpha.gnu.org and the info/dir file in the latter tarball
>> has the same oddities with Modus Themes, while info/dir in the former
>> tarball does not.
>>
>> I eyeballed doc/misc/modus-themes.texi, which is generated from
>> modus-themes.org, in emacs-29 and master, and the beginning of that file
>> appears similar to the start of other .texi files in that directory and
>> also to the start of org.texi, which is also generated (from org.org).
>> (One difference between modus-themes.org and org.org is that the latter
>> uses org-setup.org to generate the .texi file, while modus-themes.org
>> includes similar lines in the file itself instead of in a setup file.)
>> And the resulting modus-themes.info file also appears to be fine.
>> Moreover, when I execute `install-info ./modus-themes.info ./dir' from
>> the shell, using the modus-themes.info from the emacs-29 builds, the
>> resulting dir file contains the entry for Modus Themes under the "Emacs
>> misc features" category.  So it seems that problematic dir file results
>> from some other part of the build process, but I couldn't figure out
>> which.
>
> I bisected the problem to the following commit:
>
> 8a9839348fb8762c8843362595f2ca9de60d515c is the first bad commit
> commit 8a9839348fb8762c8843362595f2ca9de60d515c
> Author: Protesilaos Stavrou <info <at> protesilaos.com>
> Date:   Wed Aug 3 14:32:38 2022 +0300
>
>     Update modus-themes to their version 2.5.0
>
> And the problem is due, to my surprise, to whitespace in the Org markup
> at the beginning of modus-themes.org.  This suggests to me a problem
> somewhere in org/ox-texinfo.el, 

Why do you think this is a problem with exporting, rather than with
parsing?  Either way, it might be worth involving some Org people in
this report.

>                                 but I'm not familiar with that code, so
> I'll leave pursuing it to someone who is.  In the meantime, building
> with the attached patch against current emacs-29 restores the correct
> dir file.
>
> Steve Berman
>
> diff --git a/doc/misc/modus-themes.org b/doc/misc/modus-themes.org
> index 4bf78379c10..8cfa22df923 100644
> --- a/doc/misc/modus-themes.org
> +++ b/doc/misc/modus-themes.org
> @@ -1,23 +1,23 @@
> -#+title:                 Modus themes for GNU Emacs
> -#+author:                Protesilaos Stavrou
> -#+email:                 info <at> protesilaos.com
> -#+language:              en
> -#+options:               ':t toc:nil author:t email:t num:t
> -#+startup:               content
> -#+macro:                 stable-version 3.0.0
> -#+macro:                 release-date 2022-10-28
> -#+macro:                 development-version 3.1.0-dev
> -#+macro:                 file @@texinfo:@file{@@$1@@texinfo:}@@
> -#+macro:                 space @@texinfo:@: @@
> -#+macro:                 kbd @@texinfo:@kbd{@@$1@@texinfo:}@@
> -#+texinfo_filename:      modus-themes.info
> -#+texinfo_dir_category:  Emacs misc features
> -#+texinfo_dir_title:     Modus Themes: (modus-themes)
> -#+texinfo_dir_desc:      Elegant, highly legible and customizable themes
> -#+texinfo_header:        @set MAINTAINERSITE @uref{https://protesilaos.com,maintainer webpage}
> -#+texinfo_header:        @set MAINTAINER Protesilaos Stavrou
> -#+texinfo_header:        @set MAINTAINEREMAIL @email{info <at> protesilaos.com}
> -#+texinfo_header:        @set MAINTAINERCONTACT @uref{mailto:info <at> protesilaos.com,contact the maintainer}
> +#+title: Modus themes for GNU Emacs
> +#+author: Protesilaos Stavrou
> +#+email: info <at> protesilaos.com
> +#+language: en
> +#+options: ':t toc:nil author:t email:t num:t
> +#+startup: content
> +#+macro: stable-version 3.0.0
> +#+macro: release-date 2022-10-28
> +#+macro: development-version 3.1.0-dev
> +#+macro: file @@texinfo:@file{@@$1@@texinfo:}@@
> +#+macro: space @@texinfo:@: @@
> +#+macro: kbd @@texinfo:@kbd{@@$1@@texinfo:}@@
> +#+texinfo_filename: modus-themes.info
> +#+texinfo_dir_category: Emacs misc features
> +#+texinfo_dir_title: Modus Themes: (modus-themes)
> +#+texinfo_dir_desc: Elegant, highly legible and customizable themes
> +#+texinfo_header: @set MAINTAINERSITE @uref{https://protesilaos.com,maintainer webpage}
> +#+texinfo_header: @set MAINTAINER Protesilaos Stavrou
> +#+texinfo_header: @set MAINTAINEREMAIL @email{info <at> protesilaos.com}
> +#+texinfo_header: @set MAINTAINERCONTACT @uref{mailto:info <at> protesilaos.com,contact the maintainer}
>
>  #+texinfo: @insertcopying

Message #14 received at 64548 <at> debbugs.gnu.org (full text, mbox):

From: Protesilaos Stavrou <info <at> protesilaos.com>
To: Philip Kaludercic <philipk <at> posteo.net>, Stephen Berman
 <stephen.berman <at> gmx.net>
Cc: 64548 <at> debbugs.gnu.org
Subject: Re: bug#64548: 29.0.92; Modus Themes Info manual is in "Unknown
 category"
Date: Mon, 10 Jul 2023 22:49:20 +0300

> From: Philip Kaludercic <philipk <at> posteo.net>
> Date: Mon, 10 Jul 2023 14:08:30 +0000
>
> I've added Protesilaos to the CCs, in case he hasn't seen the bug
> report.  (Generally it is recommended to add a "X-Debbugs-CC" header if
> you can find the maintainer).

Thank you Philip, Stephen!

Stephen, I am fine with the patch.  I was not expecting the spaces to
create such a problem.

All the best,
Protesilaos (or simply "Prot")

-- 
Protesilaos Stavrou
https://protesilaos.com

Message #17 received at 64548 <at> debbugs.gnu.org (full text, mbox):

From: Stephen Berman <stephen.berman <at> gmx.net>
To: Philip Kaludercic <philipk <at> posteo.net>
Cc: Protesilaos Stavrou <info <at> protesilaos.com>, 64548 <at> debbugs.gnu.org
Subject: Re: bug#64548: 29.0.92; Modus Themes Info manual is in "Unknown
 category"
Date: Mon, 10 Jul 2023 22:09:30 +0200

On Mon, 10 Jul 2023 14:08:30 +0000 Philip Kaludercic <philipk <at> posteo.net> wrote:

> I've added Protesilaos to the CCs, in case he hasn't seen the bug
> report.  (Generally it is recommended to add a "X-Debbugs-CC" header if
> you can find the maintainer).
>
> Stephen Berman <stephen.berman <at> gmx.net> writes:
>
>> On Sun, 09 Jul 2023 22:21:55 +0200 Stephen Berman <stephen.berman <at> gmx.net> wrote:
>>
>>> After building Emacs from the release branch or from master, the
>>> info/dir file looks like this (excerpted):
>>>
>>> [...]
>>> Unknown category
>>> * Modus Themes: (modus-themes).  Elegant, highly legible and customizable
>>> themes.
>>>
>>>
>>> The two odds things about the last entry are its category and the extra
>>> space after the asterisk.
>>> [...]
>>
>> I bisected the problem to the following commit:
>>
>> 8a9839348fb8762c8843362595f2ca9de60d515c is the first bad commit
>> commit 8a9839348fb8762c8843362595f2ca9de60d515c
>> Author: Protesilaos Stavrou <info <at> protesilaos.com>
>> Date:   Wed Aug 3 14:32:38 2022 +0300
>>
>>     Update modus-themes to their version 2.5.0
>>
>> And the problem is due, to my surprise, to whitespace in the Org markup
>> at the beginning of modus-themes.org.  This suggests to me a problem
>> somewhere in org/ox-texinfo.el,
>
> Why do you think this is a problem with exporting, rather than with
> parsing?

I wasn't thinking of any specific cause, I just saw that ox-texinfo.el
is used in the Makefile, but I know nothing about it.

>           Either way, it might be worth involving some Org people in
> this report.

Yes, that I did mean to suggest.

>>                                 but I'm not familiar with that code, so
>> I'll leave pursuing it to someone who is.  In the meantime, building
>> with the attached patch against current emacs-29 restores the correct
>> dir file.
[...]

On Mon, 10 Jul 2023 22:49:20 +0300 Protesilaos Stavrou <info <at> protesilaos.com> wrote:

>> From: Philip Kaludercic <philipk <at> posteo.net>
>> Date: Mon, 10 Jul 2023 14:08:30 +0000
>>
>> I've added Protesilaos to the CCs, in case he hasn't seen the bug
>> report.  (Generally it is recommended to add a "X-Debbugs-CC" header if
>> you can find the maintainer).
>
> Thank you Philip, Stephen!
>
> Stephen, I am fine with the patch.  I was not expecting the spaces to
> create such a problem.

Thanks.  I do hope an Org developer familiar with the generation of
.texi files from .org sources will chime in, and in any case it's up to
Eli to decide whether the patch should be installed.

Steve Berman

Message #22 received at 64548-done <at> debbugs.gnu.org (full text, mbox):

From: Eli Zaretskii <eliz <at> gnu.org>
To: Protesilaos Stavrou <info <at> protesilaos.com>
Cc: philipk <at> posteo.net, stephen.berman <at> gmx.net, 64548-done <at> debbugs.gnu.org
Subject: Re: bug#64548: 29.0.92;
 Modus Themes Info manual is in "Unknown category"
Date: Tue, 11 Jul 2023 14:11:06 +0300

> Cc: 64548 <at> debbugs.gnu.org
> From: Protesilaos Stavrou <info <at> protesilaos.com>
> Date: Mon, 10 Jul 2023 22:49:20 +0300
> 
> > From: Philip Kaludercic <philipk <at> posteo.net>
> > Date: Mon, 10 Jul 2023 14:08:30 +0000
> >
> > I've added Protesilaos to the CCs, in case he hasn't seen the bug
> > report.  (Generally it is recommended to add a "X-Debbugs-CC" header if
> > you can find the maintainer).
> 
> Thank you Philip, Stephen!
> 
> Stephen, I am fine with the patch.  I was not expecting the spaces to
> create such a problem.

Thanks, installed on the emacs-29 branch.

I suggest to bring this issue to the attention of the Org developers.

Previous Next

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