* 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}
?
On 3/19/10 Mar 19 -4:11 PM, Tobias C. Rittweiler wrote:
README should say how to build the manual
That said, how is the user supposed to build the manual?
makeinfo asdf.texinfo makeinfo --html asdf.texinfo
The manual does not build to hardcopy using TeX right now because it has some ampersands in it that confuse TeX. Googling has not revealed to me how to escape an `&'.
For now HTML and info format output will have to do.
Launchpad bug filed, https://bugs.launchpad.net/asdf/+bug/542269
There does not seem to be any rule for it in the Makefile.
I am knocking off for today, so can't do this now.
https://bugs.launchpad.net/asdf/+bug/542272
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.
Please launchpad this one with a description of what you'd like to see, and maybe someone will take it.
In haste, r
-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}
?
asdf-devel mailing list asdf-devel@common-lisp.net http://common-lisp.net/cgi-bin/mailman/listinfo/asdf-devel
On 20 March 2010 01:02, Robert Goldman rpgoldman@sift.info wrote:
The manual does not build to hardcopy using TeX right now because it has some ampersands in it that confuse TeX. Googling has not revealed to me how to escape an `&'.
Put this into the @ifnottex secttion, and use @&key, etc.
@c We use @&key, etc to escape & from TeX in lambda lists -- @c so we need to define them for info as well. @macro &allow-other-keys &allow-other-keys @end macro @macro &optional &optional @end macro @macro &rest &rest @end macro @macro &key &key @end macro @macro &body &body @end macro
Cheers,
-- Nikodemus
Robert Goldman rpgoldman@sift.info writes:
On 3/19/10 Mar 19 -4:11 PM, Tobias C. Rittweiler wrote:
- the manual should perhaps start with a "What's new" section which mostly contains links to the appropriate pages.
Please launchpad this one with a description of what you'd like to see, and maybe someone will take it.
Directory-grovelling system definition search, output translations, upgradability from upstream source;
any other especially noteworthy news?
-T.
The manual already has a "What has changed between ASDF 1 and ASDF 2?" section, with the following subsections: @subsection ASDF can portably name files inside systems and components @subsection Output translations @subsection Source Registry Configuration @subsection Usual operations are made easier to the user @subsection Many bugs have been fixed @subsection ASDF itself is versioned @subsection ASDF can be upgraded @subsection Decoupled release cycle
I could probably have added notes about extensions for ECL, support for ABCL, XCVB compatibility, and more.
[ François-René ÐVB Rideau | Reflection&Cybernethics | http://fare.tunes.org ] May you live all the days of your life. — Jonathan Swift
On 20 March 2010 09:57, Tobias C. Rittweiler tcr@freebits.de wrote:
Robert Goldman rpgoldman@sift.info writes:
On 3/19/10 Mar 19 -4:11 PM, Tobias C. Rittweiler wrote:
- the manual should perhaps start with a "What's new" section which
mostly contains links to the appropriate pages.
Please launchpad this one with a description of what you'd like to see, and maybe someone will take it.
Directory-grovelling system definition search, output translations, upgradability from upstream source;
any other especially noteworthy news?
-T.
asdf-devel mailing list asdf-devel@common-lisp.net http://common-lisp.net/cgi-bin/mailman/listinfo/asdf-devel
Faré fahree@gmail.com writes:
The manual already has a "What has changed between ASDF 1 and ASDF 2?" section, with the following subsections: @subsection ASDF can portably name files inside systems and components @subsection Output translations @subsection Source Registry Configuration @subsection Usual operations are made easier to the user @subsection Many bugs have been fixed @subsection ASDF itself is versioned @subsection ASDF can be upgraded @subsection Decoupled release cycle
I could probably have added notes about extensions for ECL, support for ABCL, XCVB compatibility, and more.
Oh, right, it's in the FAQ. I suggest adding a link from the Introduction section to that question.
-T.
On 21 March 2010 07:28, Tobias C. Rittweiler tcr@freebits.de wrote:
Faré fahree@gmail.com writes:
The manual already has a "What has changed between ASDF 1 and ASDF 2?" section, with the following subsections: @subsection ASDF can portably name files inside systems and components @subsection Output translations @subsection Source Registry Configuration @subsection Usual operations are made easier to the user @subsection Many bugs have been fixed @subsection ASDF itself is versioned @subsection ASDF can be upgraded @subsection Decoupled release cycle
I could probably have added notes about extensions for ECL, support for ABCL, XCVB compatibility, and more.
Oh, right, it's in the FAQ. I suggest adding a link from the Introduction section to that question.
Done.
[ François-René ÐVB Rideau | Reflection&Cybernethics | http://fare.tunes.org ] drug, n: A substance that, injected into a rat, produces a scientific paper.
-
Faré -
Nikodemus Siivola -
Robert Goldman -
Tobias C. Rittweiler