[gentoo-user] sci-libs/{amd,camd}-2.4.6/ doc wierdness

[gentoo-user] sci-libs/{amd,camd}-2.4.6/ doc wierdness

[karl]

Both sci-libs/{amd,camd}-2.4.6 gives this error in their build log:

 ! Package inputenc Error: Unicode character ^^H (U+0008)
 (inputenc)                not set up for use with LaTeX.

And sure enough, somehow theese files begins with backspace. The line 
should be "\begin{verbatim}". My guess something has interpreted the
initial "\b" as an escape instead of letting it through.
 
# head -1 /Net/gentoo/tmpdir/portage/sci-libs/amd-2.4.6/work/amd-2.4.6/Doc/amd_h.tex | od -a
0000000  bs   e   g   i   n   {   v   e   r   b   a   t   i   m   }  nl
0000020
# head -1 /Net/gentoo/tmpdir/portage/sci-libs/camd-2.4.6/work/camd-2.4.6/Doc/camd_h.tex | od -a
0000000  bs   e   g   i   n   {   v   e   r   b   a   t   i   m   }  nl
0000020

Do anyone know what to do about it ?

Hälsningar,
/Karl Hammar

-----------------------------------------------------------------------
Aspö Data
Lilla Aspö 148
S-742 94 Östhammar
Sverige
0173 140 57

Re: [gentoo-user] sci-libs/{amd,camd}-2.4.6/ doc wierdness

[Michael Orlitzky]

On 12/16/20 12:30 PM, karl@aspodata.se wrote:
> Both sci-libs/{amd,camd}-2.4.6 gives this error in their build log:
> 
>   ! Package inputenc Error: Unicode character ^^H (U+0008)
>   (inputenc)                not set up for use with LaTeX.
> 

I can reproduce this... I'll take a look.

Re: [gentoo-user] sci-libs/{amd,camd}-2.4.6/ doc wierdness

[Michael Orlitzky]

On 12/16/20 1:17 PM, Michael Orlitzky wrote:
> On 12/16/20 12:30 PM, karl@aspodata.se wrote:
>> Both sci-libs/{amd,camd}-2.4.6 gives this error in their build log:
>>
>>    ! Package inputenc Error: Unicode character ^^H (U+0008)
>>    (inputenc)                not set up for use with LaTeX.
>>
> 
> I can reproduce this... I'll take a look.
> 

It looks like the Makefile.am for the documentation was only tested with 
bash. Try e.g.,

   CONFIG_SHELL=/bin/bash USE=doc emerge -v1 sci-libs/amd

If that works for you, I'll add it to the ebuilds.

Re: [gentoo-user] sci-libs/{amd,camd}-2.4.6/ doc wierdness

[karl]

Michael:
> On 12/16/20 1:17 PM, Michael Orlitzky wrote:
> > On 12/16/20 12:30 PM, karl@aspodata.se wrote:
> >> Both sci-libs/{amd,camd}-2.4.6 gives this error in their build log:
> >>
> >>    ! Package inputenc Error: Unicode character ^^H (U+0008)
> >>    (inputenc)                not set up for use with LaTeX.
> >>
> > 
> > I can reproduce this... I'll take a look.
> It looks like the Makefile.am for the documentation was only tested with 
> bash.

  Yes, this part:
CAMD_UserGuide.pdf:
        echo '\begin{verbatim}' > camd_h.tex
        expand -8 $(top_srcdir)/Include/camd.h >> camd_h.tex
        echo '\end{verbatim}' >> camd_h.tex
        -ln -s $(srcdir)/*.{tex,bib} .
        $(PDFLATEX) CAMD_UserGuide
        $(BIBTEX)  CAMD_UserGuide
        $(PDFLATEX) CAMD_UserGuide
        $(PDFLATEX) CAMD_UserGuide

 Unfortunately, different echos handles excapes differently, see e.g.
https://helpmanual.io/man1/echo-posix/
 In /bin/sh (dash) echo always converts thoose excapes (a' la sysV),
 where bash needs -e to do it (a' la BSD).

 One could replace the echos with printf "%s\n" as in
$ printf "%s\n" '\begin' | od -a
0000000   \   b   e   g   i   n  nl

Note: echo '\e' is said to be undefined in dashs manual.

///

Also, the $(srcdir) seems defined as ".", and I get this useless link:
# ls -l
total 140
lrwxrwxrwx 1 portage portage    13 Dec 16 16:58 '*.{tex,bib}' -> './*.{tex,bib}'

///

> Try e.g.,
> 
>    CONFIG_SHELL=/bin/bash USE=doc emerge -v1 sci-libs/amd
> 
> If that works for you, I'll add it to the ebuilds.

It will probably, cannot test just now, rust is compiling....

Regards,
/Karl Hammar

Re: [gentoo-user] sci-libs/{amd,camd}-2.4.6/ doc wierdness

[Michael Orlitzky]

On 12/16/20 5:16 PM, karl@aspodata.se wrote:
> 
> It will probably, cannot test just now, rust is compiling....
> 

I'm sorry for your loss. I opened

   https://bugs.gentoo.org/760408

to track this issue, but we will probably hack around it in the ebuild 
for now. Our SuiteSparse ebuilds are far behind the upstream versions 
and had their autotools build system patched in, at a time when the 
upstream build system was junk.

Nowadays upstream is using CMake, so it makes more sense to upgrade and 
switch to CMake than it does to try to fix the evolutionary-dead-end 
autotools patches.

Re: [gentoo-user] sci-libs/{amd,camd}-2.4.6/ doc wierdness

[karl]

Michael:
> On 12/16/20 1:17 PM, Michael Orlitzky wrote:
> > On 12/16/20 12:30 PM, karl@aspodata.se wrote:
> >> Both sci-libs/{amd,camd}-2.4.6 gives this error in their build log:
> >>
> >>    ! Package inputenc Error: Unicode character ^^H (U+0008)
> >>    (inputenc)                not set up for use with LaTeX.
> > I can reproduce this... I'll take a look.
> It looks like the Makefile.am for the documentation was only tested with 
> bash. Try e.g.,
> 
>    CONFIG_SHELL=/bin/bash USE=doc emerge -v1 sci-libs/amd
> 
> If that works for you, I'll add it to the ebuilds.

Yes, with that env.variable, the emerge worked fine and
the files
 /usr/share/doc/camd-2.4.6/CAMD_UserGuide.pdf
 /usr/share/doc/amd-2.4.6/AMD_UserGuide.pdf
looks fine. The header files got verbatim'd just nice.
Thanks!

Regards,
/Karl Hammar