#1721: Some installation instructions are not generated correctly when using 
 Reporter:  pierre  |      Owner:  alfs-log@…
     Type:  defect  |     Status:  new
 Priority:  normal  |  Milestone:  3.0
Component:  ablfs   |    Version:  SVN
 Severity:  normal  |   Keywords:
 Generating installation instructions for BLFS, taking into account whether
 running as user or root, whether using porg, destdir package management or
 nothing is a complicated task because markup in the book is not very
 - The only indication telling a <screen><userinput> tag is an installation
 instructions is that <screen> has a role="root" attribute, and that the
 tag occurs in a sect2 with role="installation" attribute. But some of
 those tags are not installation instructions: for example, they can be
 user or group adding, or some database updating (mime, desktop, icons,
 - There may be several <screen><userinput> tags, which should be grouped
 in order to generate the porg logging correctly. But if they are
 interspersed with config instructions, this is hard...

 This may lead to buggy instructions, for example beginning with porg
 opening stanzas and finishing without closing stanzas, or converse...
 Also, some single quotes may be escaped (as `'\''`), when not needed,
 leading to errors when running the script...

 This can be improved in two directions:
 - improve the stylesheet generating those instructions.
 - improve the book itself so that different types of instructions are more
 clearly identified (and of course adapt the stylesheet to use that).

Ticket URL: <http://wiki.linuxfromscratch.org/alfs/ticket/1721>
ALFS Trac <http://wiki.linuxfromscratch.org/alfs/>
Automated Linux From Scratch
Unsubscribe: See the above information page

Reply via email to