20091216175517_-0600: Bruce Dubbs <bruce.dubbs at gmail.com> wrote:
> Sean Porterfield wrote:
> >> From: Fernando Oliveira
> > 
> >> The reason: in Groff installation page, the first command is
> >>
> >> PAGE=<paper_size> ./configure --prefix=/usr
> >>
> >> I had not realized, during copy/paste, that the <paper_size> had to be 
> >> defined (for me, A4, but for English speaking users, probably it is 
> >> Letter. After properly recompiling an reistalling Groff, the compilation 
> >> of Man-DB succeeded.
> >>
> >> I believe that Groff page could be improved with some remark to call 
> >> attention for this.
> > 
> > I have to agree with that - I almost missed it too.  I think I read the
> > page a second time before starting and figured it out, but it could be
> > made a bit more obvious.
>
> I supposed we could change it to:
>
>    PAGE=<#paper_size#> ./configure --prefix=/usr
>
> which creates a syntax error it it's not changed.  If we do that, it 
> probably will require a change to ALFS.
>
>    -- Bruce
>

Would it be useful to also wrap the '<#paper_size#>' in a css (or 
similar) style, so that it can readily be made to stand out more, 
visually?

And similarly for other such places in the book(s) where command-lines 
contain place-holder text that needs to be replaced by some literal 
value(s).

((Btw, & fwiw, I think the LFS books are very good: have never e.g. 
found this type of variable-substitution matter to be a problem; 
although, the first install here was not in parallel with a first 
detailed walkthrough of the book - instead, had been familiar to 
various degrees with the book since at least 6.3, incl some fairly 
close read-throughs (with a view to some auto- stuff) prior to 
first-install @ 6.5 . ))


akhiezer




--
-- 
http://linuxfromscratch.org/mailman/listinfo/blfs-support
FAQ: http://www.linuxfromscratch.org/blfs/faq.html
Unsubscribe: See the above information page

Reply via email to