[asdf-devel] Minor comments regarding manual on HEAD

[Tobias C. Rittweiler]

* 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 at 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 ... at var{system} @code{&rest} @var{initargs}
                                                  
?