[bug#31464] [PATCH] gnu: emacs-orgalist: Fix texinfo markup in description.

[bug#31464] [PATCH] gnu: emacs-orgalist: Fix texinfo markup in description.

[Gábor Boskovits]

* gnu/packages/emacs.scm (emacs-orgalist)[description]: Modify.
---
 gnu/packages/emacs.scm | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/gnu/packages/emacs.scm b/gnu/packages/emacs.scm
index 71e969006..f3d08e810 100644
--- a/gnu/packages/emacs.scm
+++ b/gnu/packages/emacs.scm
@@ -4743,7 +4743,7 @@ specifically, Orgalist supports the syntax of Org mode for numbered,
 unnumbered, description items, checkboxes, and counter cookies.
 
 The library also implements radio lists, i.e., lists written in Org
-syntax later translated into the host format, e.g., @LaTeX{} or HTML.")
+syntax later translated into the host format, e.g., LaTeX or HTML.")
     (license license:gpl3+)))
 
 (define-public emacs-writegood-mode
-- 
2.17.0

[bug#31464] [PATCH] gnu: emacs-orgalist: Fix texinfo markup in description.

[Nicolas Goaziou]

Hello,

Gábor Boskovits <boskovits@gmail.com> writes:

> -syntax later translated into the host format, e.g., @LaTeX{} or HTML.")
> +syntax later translated into the host format, e.g., LaTeX or HTML.")

OOC, why is it necessary?

Regards,

-- 
Nicolas Goaziou                                                0x80A93738

[bug#31464] [PATCH] gnu: emacs-orgalist: Fix texinfo markup in description.

[Gábor Boskovits]

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

2018-05-15 22:14 GMT+02:00 Nicolas Goaziou <mail@nicolasgoaziou.fr>:

> Hello,
>
> Gábor Boskovits <boskovits@gmail.com> writes:
>
> > -syntax later translated into the host format, e.g., @LaTeX{} or HTML.")
> > +syntax later translated into the host format, e.g., LaTeX or HTML.")
>
> OOC, why is it necessary?
>
> Regards,
>
>
This markup breaks guix package -s on current master.
And guix lint also says, that there is invalid markup in the description.
You might mean @dfn{LaTeX}, though.


> --
> Nicolas Goaziou                                                0x80A93738
>

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

[bug#31464] [PATCH] gnu: emacs-orgalist: Fix texinfo markup in description.

[Nicolas Goaziou]

Gábor Boskovits <boskovits@gmail.com> writes:

> This markup breaks guix package -s on current master.
> And guix lint also says, that there is invalid markup in the description.
> You might mean @dfn{LaTeX}, though.

Yet, @LaTeX{} is valid Texinfo code.

[bug#31464] [PATCH] gnu: emacs-orgalist: Fix texinfo markup in description.

[Eric Bavier]

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

On Tue, 15 May 2018 22:55:11 +0200
Nicolas Goaziou <mail@nicolasgoaziou.fr> wrote:

> Gábor Boskovits <boskovits@gmail.com> writes:
> 
> > This markup breaks guix package -s on current master.
> > And guix lint also says, that there is invalid markup in the description.
> > You might mean @dfn{LaTeX}, though.  
> 
> Yet, @LaTeX{} is valid Texinfo code.

Yes, but guile's (texinfo) module does not understand the entire set of
texinfo commands.  I'm not sure whether the subset it does understand
is even clearly documented.

Best thing to do is listen to 'guix lint' and fix any "invalid" markup.

`~Eric

[-- Attachment #2: OpenPGP digital signature --]
[-- Type: application/pgp-signature, Size: 833 bytes --]

[bug#31464] [PATCH] gnu: emacs-orgalist: Fix texinfo markup in description.

[Gábor Boskovits]

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

2018-05-16 5:16 GMT+02:00 Eric Bavier <ericbavier@centurylink.net>:

> On Tue, 15 May 2018 22:55:11 +0200
> Nicolas Goaziou <mail@nicolasgoaziou.fr> wrote:
>
> > Gábor Boskovits <boskovits@gmail.com> writes:
> >
> > > This markup breaks guix package -s on current master.
> > > And guix lint also says, that there is invalid markup in the
> description.
> > > You might mean @dfn{LaTeX}, though.
> >
> > Yet, @LaTeX{} is valid Texinfo code.
>
> Yes, but guile's (texinfo) module does not understand the entire set of
> texinfo commands.  I'm not sure whether the subset it does understand
> is even clearly documented.
>
>
I guess that we can contribute the @LaTeX{} macro to the guile module,
at least a simplified version for sure, but I don't think it will make
before
core-updates next. In my opinion this fix is an acceptable tradeoff.
We might add a comment to modify the markup, once support lands
in guile, if it is deemed necessary. WDYT?


> Best thing to do is listen to 'guix lint' and fix any "invalid" markup.
>
> `~Eric
>

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

bug#31464: [PATCH] gnu: emacs-orgalist: Fix texinfo markup in description.

[Ludovic Courtès]

Hello!

Gábor Boskovits <boskovits@gmail.com> skribis:

> 2018-05-16 5:16 GMT+02:00 Eric Bavier <ericbavier@centurylink.net>:
>
>> On Tue, 15 May 2018 22:55:11 +0200
>> Nicolas Goaziou <mail@nicolasgoaziou.fr> wrote:
>>
>> > Gábor Boskovits <boskovits@gmail.com> writes:
>> >
>> > > This markup breaks guix package -s on current master.
>> > > And guix lint also says, that there is invalid markup in the
>> description.
>> > > You might mean @dfn{LaTeX}, though.
>> >
>> > Yet, @LaTeX{} is valid Texinfo code.
>>
>> Yes, but guile's (texinfo) module does not understand the entire set of
>> texinfo commands.  I'm not sure whether the subset it does understand
>> is even clearly documented.
>>
>>
> I guess that we can contribute the @LaTeX{} macro to the guile module,
> at least a simplified version for sure, but I don't think it will make
> before
> core-updates next. In my opinion this fix is an acceptable tradeoff.
> We might add a comment to modify the markup, once support lands
> in guile, if it is deemed necessary. WDYT?

Clearly Guile’s (texinfo) modules could be improved.  In the meantime,
I’ve pushed this patch to fix the immediate issue.

Note that even when (texinfo) understands @LaTeX{}, we’ll probably
refrain from using it because Guix could be running on an older Guile.

Thanks,
Ludo’.