Re: make docs

[Eli Zaretskii]

> From: Jean-Christophe Helary <lists@traduction-libre.org>
> Date: Thu, 23 Dec 2021 13:34:24 +0900
> Cc: emacs-devel <emacs-devel@gnu.org>
> 
> I’ cloned emacs anew, did autogen/configure/make docs and this is what 
> happened:
> 
> 
> ....
> 
> (/Users/suzume/Documents/Repositories/emacs-test-build/doc/emacs/fortran-xtra.t
> exi (Fortran Mode) [29]
> Underfull \hbox (badness 10000) in paragraph at lines 82--85
>  @textttsl C-c C-n[]@textrm Move to the be-gin-ning of the next state-ment 
> (@te
> xttt fortran-next-
> [30]
> Underfull \hbox (badness 10000) in paragraph at lines 131--136
> []@textrm The com-mands @texttt fortran-beginning-of-subprogram[] @textrm and 
> @
> texttt fortran-end-of-
> [31] [32] [33] [34] [35])
> (/Users/suzume/Documents/Repositories/emacs-test-build/doc/emacs/msdos-xtra.tex
> i (Emacs and MS-DOS) [36] [37] [38] [39] [40] [41] [42]) Appendix A [43]
> (/Users/suzume/Documents/Repositories/emacs-test-build/doc/emacs/doclicense.tex
> i [44] [45] [46] [47] [48] [49] [50]) (Index) [51]
> (/Users/suzume/Documents/Repositories/emacs-test-build/doc/emacs/emacs-xtra.cps
> [52] [53] [54]) [55] )
> (see the transcript file for additional information)
> Output written on emacs-xtra.dvi (59 pages, 290760 bytes).
> Transcript written on emacs-xtra.log.
> /Library/Developer/CommandLineTools/usr/bin/make -C lib all
>   GEN      alloca.h
>   GEN      byteswap.h
>   GEN      dirent.h
>   GEN      malloc/dynarray.gl.h
> 
> ....
> 
> and then, at last, if finishes the info files and proceeds to the rest of the 
> documentation building.

This shows that it started building Emacs after producing the Emacs
manual.  But it doesn't show why.

You've removed the most interesting parts of the build transcript --
the ones that follow the Emacs build part -- which leaves me unable to
guess which parts of the doc directory need to build Emacs.  Philipp's
guess that it's those manuals which are provided in *.org format is
still the winner in my book, btw.

When you present evidence, please never remove any parts of it, unless
you know precisely what happened, and therefore can distinguish
between what's important and what isn't.  Otherwise, the evidence you
present can easily omit the most important parts, and therefore be
useless.

Thanks.