Re: make docs

[Jean-Christophe Helary]

> On Dec 23, 2021, at 1:43, Jean-Christophe Helary <lists@traduction-libre.org> 
> wrote:
> 
>> On Dec 23, 2021, at 0:45, Philipp Stephani <p.stephani2@gmail.com> wrote:
>> 
>> Am Mi., 22. Dez. 2021 um 05:44 Uhr schrieb Jean-Christophe Helary
>> <lists@traduction-libre.org>:
>>> 
>>> Why is it that `make docs` builds the whole code set before building the 
>>> documentation ?
>> 
>> Random guess: Some manuals are written in Org-Mode, and to export them
>> to Texinfo you first need to build Org-Mode (and for that you need
>> Emacs).
> 
> I tried and that doesn't seem to be the issue (although generating the 
> org.texi file does take quite some time).

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

....


  CC       save-cwd.o
  AR       libgnu.a
/Library/Developer/CommandLineTools/usr/bin/ranlib: file: libgnu.a(u64.o) has 
no symbols
/Library/Developer/CommandLineTools/usr/bin/ranlib: file: libgnu.a(unistd.o) 
has no symbols
/Library/Developer/CommandLineTools/usr/bin/ranlib: file: libgnu.a(u64.o) has 
no symbols
/Library/Developer/CommandLineTools/usr/bin/ranlib: file: libgnu.a(unistd.o) 
has no symbols
/Library/Developer/CommandLineTools/usr/bin/make -C lib-src all
  CCLD     etags
ld: warning: directory not found for option '-L/usr/local/opt/readline/lib:'
  CCLD     ctags
ld: warning: directory not found for option '-L/usr/local/opt/readline/lib:'
  CCLD     emacsclient
ld: warning: directory not found for option '-L/usr/local/opt/readline/lib:'
  CCLD     ebrowse
ld: warning: directory not found for option '-L/usr/local/opt/readline/lib:'
  CCLD     hexl
ld: warning: directory not found for option '-L/usr/local/opt/readline/lib:'
  CCLD     make-docfile
ld: warning: directory not found for option '-L/usr/local/opt/readline/lib:'
  CCLD     make-fingerprint
ld: warning: directory not found for option '-L/usr/local/opt/readline/lib:'
/Library/Developer/CommandLineTools/usr/bin/make -C src 
VCSWITNESS='$(srcdir)/../.git/logs/HEAD' 
BIN_DESTDIR=''/Users/suzume/Documents/Repositories/emacs-test-build/nextstep/Emacs.app/Contents/MacOS/''
 \
                 
ELN_DESTDIR='/Users/suzume/Documents/Repositories/emacs-test-build/nextstep/Emacs.app/Contents/Frameworks/'
 all
  GEN      lisp.mk
  GEN      globals.h
  CC       dispnew.o
  CC       frame.o
  CC       scroll.o
  CC       xdisp.o
  CC       menu.o

....

  CC       nsimage.o
  CC       macfont.o
macfont.m:3573:15: warning: 'CTGetCoreTextVersion' is deprecated: first 
deprecated in macOS 11.0 - Use -[NSProcessInfo operatingSystemVersion] 
[-Wdeprecated-declarations]
          if (CTGetCoreTextVersion () >= kCTVersionNumber10_9)
              ^
/Library/Developer/CommandLineTools/SDKs/MacOSX.sdk/System/Library/Frameworks/CoreText.framework/Headers/CoreText.h:61:10:
 note: 'CTGetCoreTextVersion' has been explicitly marked deprecated here
uint32_t CTGetCoreTextVersion( void ) CT_DEPRECATED("Use -[NSProcessInfo 
operatingSystemVersion]", macos(10.5, 11.0), ios(3.2, 14.0), watchos(2.0, 7.0), 
tvos(9.0, 14.0));
         ^
1 warning generated.
  CC       terminfo.o
  CC       lastfile.o
/Library/Developer/CommandLineTools/usr/bin/make -C ../admin/charsets all
  GEN      ../../etc/charsets/8859-2.map
  GEN      ../../etc/charsets/8859-3.map
  GEN      ../../etc/charsets/8859-4.map
  GEN      ../../etc/charsets/8859-5.map
  GEN      ../../etc/charsets/8859-6.map
  GEN      ../../etc/charsets/8859-7.map

....


  GEN      ../../etc/charsets/MULE-uviscii.map
  GEN      ../../lisp/international/cp51932.el
  GEN      ../../lisp/international/eucjp-ms.el
  GEN      charsets.stamp
/Library/Developer/CommandLineTools/usr/bin/make -C ../admin/unidata 
charscript.el
  GEN      ../../lisp/international/charscript.el
/Library/Developer/CommandLineTools/usr/bin/make -C ../admin/unidata 
emoji-zwj.el
  GEN      ../../lisp/international/emoji-zwj.el
  CCLD     temacs
ld: warning: directory not found for option '-L/usr/local/opt/readline/lib:'
.././build-aux/install-sh -c -d ../etc
/Library/Developer/CommandLineTools/usr/bin/make -C ../lisp update-subdirs
cp -f temacs bootstrap-emacs
rm -f bootstrap-emacs.pdmp
./temacs --batch  -l loadup --temacs=pbootstrap \
                --bin-dest 
/Users/suzume/Documents/Repositories/emacs-test-build/nextstep/Emacs.app/Contents/MacOS/
 --eln-dest 
/Users/suzume/Documents/Repositories/emacs-test-build/nextstep/Emacs.app/Contents/Frameworks/
Loading loadup.el (source)...
Dump mode: pbootstrap
Using load-path (/Users/suzume/Documents/Repositories/emacs-test-build/lisp 
/Users/suzume/Documents/Repositories/emacs-test-build/lisp/emacs-lisp 
/Users/suzume/Documents/Repositories/emacs-test-build/lisp/progmodes 
/Users/suzume/Documents/Repositories/emacs-test-build/lisp/language 
/Users/suzume/Documents/Repositories/emacs-test-build/lisp/international 
/Users/suzume/Documents/Repositories/emacs-test-build/lisp/textmodes 
/Users/suzume/Documents/Repositories/emacs-test-build/lisp/vc)
Loading emacs-lisp/byte-run (source)...
Loading emacs-lisp/backquote (source)...
Loading subr (source)...
Loading keymap (source)...
Loading version (source)...
Loading widget (source)...
Loading custom (source)...
Loading emacs-lisp/map-ynp (source)...
Loading international/mule (source)...
Loading international/mule-conf (source)...
Loading env (source)...
Loading format (source)...
Loading bindings (source)...
Loading window (source)...
Loading /Users/suzume/Documents/Repositories/emacs-test-build/lisp/files.el 
(source)...
Loading 
/Users/suzume/Documents/Repositories/emacs-test-build/lisp/emacs-lisp/macroexp.el
 (source)...
Loading 
/Users/suzume/Documents/Repositories/emacs-test-build/lisp/emacs-lisp/pcase.el 
(source)...
Loading 
/Users/suzume/Documents/Repositories/emacs-test-build/lisp/emacs-lisp/macroexp.el
 (source)...
Loading /Users/suzume/Documents/Repositories/emacs-test-build/lisp/cus-face.el 
(source)...
Loading /Users/suzume/Documents/Repositories/emacs-test-build/lisp/faces.el 
(source)...
Loading 
/Users/suzume/Documents/Repositories/emacs-test-build/lisp/ldefs-boot.el 
(source)...

....

  ELC      vc/vc-src.elc
  ELC      vc/vc-svn.elc
  ELC      vc/vc.elc
  GEN      cus-load.el
  INFO     Scanning files for custom... 
  INFO     Scanning files for custom...10% 

....

and then, at last, if finishes the info files and proceeds to the rest of the 
documentation building.


-- 
Jean-Christophe Helary @brandelune
https://mac4translators.blogspot.com
https://sr.ht/~brandelune/omegat-as-a-book/