* README should say how to build the manual
* That said, how is the user supposed to build the manual?
There does not seem to be any rule for it in the Makefile.
* texipdf asdf.texinfo resulted in an error; an asdf.pdf was produced nontheless. See PS for transcript.
* the manual should perhaps start with a "What's new" section which mostly contains links to the appropriate pages.
-T.
PS.
tcr@thaleron:~/src/from-upstream/asdf$ texi2pdf asdf.texinfo This is pdfTeXk, Version 3.141592-1.40.3 (Web2C 7.5.6) file:line:error style messages enabled. %&-line parsing enabled. entering extended mode (./asdf.texinfo (/usr/share/texmf/tex/texinfo/texinfo.tex Loading texinfo [version 2008-04-18.10]: pdf, fonts, page headings, tables, conditionals, indexing, sectioning, toc, environments, defuns, macros, cross references, insertions, (/usr/share/texmf-texlive/tex/generic/epsf/epsf.tex This is `epsf.tex' v2.7.3 <23 July 2005> ) localization, formatting, and turning on texinfo input format.) (./asdf.aux) [1{/var/lib/texmf/fonts/map/pdftex/updmap/pdftex.map}] [2] (./asdf.toc) [-1] (./asdf.toc) (./asdf.toc) Chapter 1 l.149: Undefined cross reference `The object model of ASDF-pg'. Chapter 2 [1] [2] l.288: Undefined cross reference `Getting the latest version-snt'. l.288: Undefined cross reference `Getting the latest version-snt'. l.288: Undefined cross reference `Getting the latest version-pg'. Chapter 3 [3] l.309: Undefined cross reference `Controlling where ASDF searches for systems-s nt'. l.309: Undefined cross reference `Controlling where ASDF searches for systems-s nt'. l.309: Undefined cross reference `Controlling where ASDF searches for systems-p g'. Underfull \hbox (badness 3271) in paragraph at lines 311--318 []@textrm The de-fault lo-ca-tion for a user to in-stall Com-mon Lisp soft-ware is un-der [4] l.458: Undefined cross reference `Controlling where ASDF saves compiled files-s nt'. l.458: Undefined cross reference `Controlling where ASDF saves compiled files-s nt'. l.458: Undefined cross reference `Controlling where ASDF saves compiled files-p g'. Underfull \hbox (badness 6641) in paragraph at lines 460--468 []@textrm The sim-plest way to add a trans-la-tion to your search path, say fro m
Underfull \hbox (badness 4846) in paragraph at lines 460--468 @textrm `@texttt /foo/bar/baz/quux/[]@textrm '[] to `@texttt /where/i/want/my/f asls/[]@textrm '[] is to cre-ate the di-rec-tory [5] Underfull \hbox (badness 3492) in paragraph at lines 484--490 []@textrm Note that your Op-er-at-ing Sys-tem dis-tri-bu-tion or your sys-tem a d-min-is-tra-tor
Underfull \hbox (badness 2229) in paragraph at lines 484--490 @textrm may al-ready have con-fig-ured trans-la-tions for you. In ab-sence of a ny con-fig-u-
Underfull \hbox (badness 2662) in paragraph at lines 484--490 @textrm ra-tion, the de-fault is to redi-rect ev-ery-thing un-der an implementa tion-dependent
Underfull \hbox (badness 10000) in paragraph at lines 484--490 @textrm sub-di-rec-tory of `@texttt ~/.cache/common-lisp/[]@textrm '[]. Once ag ain, see the doc-u-ment Chapter 4 [6] Chapter 5 [7] [8] Overfull \hbox (32.02371pt too wide) in paragraph at lines 766--766 [][] | [9] [10] Underfull \hbox (badness 2951) in paragraph at lines 843--847 []@textrm To use log-i-cal path-names, you will have to pro-vide a path-name ob -ject as a [11] Chapter 6 [12] ./asdf.texinfo:1006: Argument of & has an extra }. <inserted text> @par <to be read again> } @tclose ...n @rawbackslash @plainfrenchspacing #1} @null @codex #1->@tclose {#1} @endgroup <argument> ...eration} @var {system} @code {&rest} @var {initargs} @unskip @defunargs ...ar @font =0 @let @var =@ttslanted #1 @sl @hyphenchar @font =45 ... l.1006 ...@var{system} @code{&rest} @var{initargs}
?