Re: Error with make doc

[Carl Sorensen]

On Mon, Jan 22, 2024 at 4:37 PM Carl Sorensen <carl.d.sorensen@gmail.com>
wrote:

>
>
> On Sun, Jan 21, 2024 at 12:33 AM Werner LEMBERG <wl@gnu.org> wrote:
>
>>
>> >> You have to check the log files in `lybook-db` to find the problematic
>> >> `.ly` file(s).  Does `make test` succeed?  You should actually try that
>> >> before running `make doc`...
>> >>
>> >
>> > Interesting -- the CG has make doc show up before make test.  But I
>> > appreciate the suggestion, so I decided to restart
>> >
>> > So I did a make clean, and then a make test.
>>
>> I've never seen the errors you are reporting – as Dan writes, it may
>> be an issue with the `tidy` program.  However, I'm using version 5.4.0
>> on my GNU/Linux box while MacPorts offers the more recent version
>> 5.8.0; maybe there is indeed a problem in the created HTML code that
>> wasn't detected or handled by tidy in earlier versions.
>>
>> Another possibility is that macOS comes with an ancient `tidy` version
>> that doesn't understand HTML 5 stuff like `<figure>`, and you don't
>> have installed `tidy` via MacPorts at all.  In this case we have to
>> update the `output-distance` script to check the `tidy` version before
>> actually using it...
>>
>
> That looks like an issue.    Apparently my 'tidy' is not installed by
> MacPorts.
>
> carl@carls-mbp-2 ly % which tidy
> /usr/bin/tidy
>
> and
>
> carl@Carls-MBP-2 lilypond % tidy --version
>
> HTML Tidy for Mac OS X released on 31 October 2006 - Apple Inc. build 6141
>
>
>
> I didn't see tidy listed as a prerequisite.
>
> After installing tidy in MacPorts, I get
>
> carl@carls-mbp-2 ~ % which tidy
>
> /opt/local/bin/tidy
>
>
> and
>
>
> carl@carls-mbp-2 ~ % tidy --version
>
> HTML Tidy for Apple macOS version 5.8.0
>
>
> I'll try rerunning 'make test' and see where I end up.  I think that you
> have clearly helped me identify a problem with tidy.
>
>
OK.  I deleted the build directory, and redid autogen.sh and ../configure.
And I also did make dist-clean (because I was asked to do so).

../configure succeeded.

'make all' succeeded.

'make test' gave this error:

Processing /Users/carl/Development/lilypond/build/out/lybook-testdb/
snippet-names-ece0c512da6daf7d9aff45809ce97556.ly

Command '/Users/carl/Development/lilypond/build/out/bin/lilypond -I
/Users/carl/Development/lilypond/input/regression -dseparate-page-formats=ps
-dseparate-log-files -ddeterministic -dinclude-eps-fonts -dgs-load-fonts
--header=texidoc -dcheck-internal-types -danti-alias-factor=1  -I
"/Users/carl/Development/lilypond/input/regression"  -I
"/Users/carl/Development/lilypond/build/input/regression"
-daux-files  -dread-file-list -dno-strip-output-dir -dtall-page-formats=eps
"/Users/carl/Development/lilypond/build/out/lybook-testdb/
snippet-names-ece0c512da6daf7d9aff45809ce97556.ly"' returned non-zero exit
status 1.

make[2]: *** [out-test/collated-files.texi] Error 1

make[1]: *** [lysdoc-test] Error 2

make: *** [test] Error 2


I tested the command that returned a non-zero exit status, and it succeeded.


carl@carls-mbp-2 build %
/Users/carl/Development/lilypond/build/out/bin/lilypond        -I
/Users/carl/Development/lilypond/input/regression -dseparate-page-formats=ps
-dseparate-log-files -ddeterministic -dinclude-eps-fonts -dgs-load-fonts
--header=texidoc -dcheck-internal-types -danti-alias-factor=1  -I
"/Users/carl/Development/lilypond/input/regression"  -I
"/Users/carl/Development/lilypond/build/input/regression"
-daux-files  -dread-file-list -dno-strip-output-dir -dtall-page-formats=eps
"/Users/carl/Development/lilypond/build/out/lybook-testdb/
snippet-names-cce821d5aaa438c29a8c2ee16cd514b0.ly"

GNU LilyPond 2.25.13 (running Guile 3.0)

Processing `0f/lily-acefd898.ly'


I did the grep command suggested in the 'make test' output:


% grep -L systems.texi out/lybook-testdb/*/*log | sed s/log/ly/g | xargs
grep -H sourcefilename

out/lybook-testdb/0f/lily-acefd898.ly:\sourcefilename
"/Users/carl/Development/lilypond/input/regression/pdf-copy-paste.ly"


I ran the file identified in the grep output:


carl@carls-mbp-2 build % out/bin/lilypond ../input/regression/
pdf-copy-paste.ly

GNU LilyPond 2.25.13 (running Guile 3.0)

Processing
`/Users/carl/Development/lilypond/build/out/share/lilypond/current/ly/../input/regression/
pdf-copy-paste.ly'

Parsing...

Finding the ideal number of pages...

Fitting music on 1 page...

Drawing systems...

Converting to `pdf-copy-paste.pdf'...

Success: compilation successfully completed


I did the 'find' command suggested in the 'make test' output:

carl@carls-mbp-2 build % find out/lybook-testdb -name "*.log" | xargs grep
-H "\(error\|warning\)"

out/lybook-testdb/0f/lily-acefd898.log:/Users/carl/Development/lilypond/build/out/share/lilypond/current/ly/init.ly:66:2:
error: Guile signaled an error for the expression beginning here


So I ran the file in this log message:


carl@carls-mbp-2 build % out/bin/lilypond out/share/lilypond/current/ly/
init.ly

GNU LilyPond 2.25.13 (running Guile 3.0)

Processing `out/share/lilypond/current/ly/init.ly'

Parsing...

out/share/lilypond/current/ly/init.ly:47:1: error: \maininput not allowed
outside init files


\maininput

out/share/lilypond/current/ly/init.ly:1: warning: no \version statement
found, please add


\version "2.25.13"


for future compatibility

out/share/lilypond/current/ly/init.ly:1: warning: no \version statement
found, please add


\version "2.25.13"


for future compatibility

fatal error: failed files: "out/share/lilypond/current/ly/init.ly"


Now I have found an error in the file -- it appears ist is due to
\maininput not being allowed.


Any thoughts about how to proceed?


Thanks,


Carl




>
>

> Carl
>