On Jun 2, 2012, at 9:22 PM, Bruce Dubbs wrote:
> This is mostly for Matt, but others may take note.
>
> I was adding new pages to LFS and had a hard time getting pkg-config to
> be recognized by jhalfs. What I found out was that the xml code:
>
> <?dbhtml filename="pkg-config.html"?>
>
> and the file name
>
> pkg-config-0.26-internal-glib.tar.gz
>
> are related.
Other than history, is there a reason that LFS has to be XML first,
then parsed into scripts by automated systems?
How about inverting it? We could have LFS scripts, and when it's
time to render the book, simply add some steps to that process to
"inject" the contents of those scripts?
The scripts don't have to be "working scripts", per se, but simply the
snippets in the book.
Point being, automated systems could take these scripts (perhaps with
comment-based annotations) and wrap whatever else they needed to
around them (e.g., package systems).
Surely, this would kill many birds with one stone; i.e., it would be
possible to have release faster (since the root work-product is code),
and if the book is rendered from the scripts, it would allow better
testing by automated systems.
And, since the book remains a work-product, (regardless of it being
rendered partly from scripts--which would be transparent to the
reader), it would still give folks the flexibility to roll their own
customizations.
This also has the benefit, then, of being treatable as a more regular
software project; i.e., the code can be released as soon as it's been
tested (which would be easier to verify if multiple automated systems
could demonstrate that a particular snapshot/release-candidate built
properly). Then, the book can follow.
This seems like a way for a broader technical audience to contribute
to the project in technical ways, without getting caught up in the
strangeness that is editing the book; i.e., there must be more people
who are Unix/Linux hackers than there are people who are versed in
editing DocBook XML and also happen to be hackers.
Q
--
http://linuxfromscratch.org/mailman/listinfo/lfs-dev
FAQ: http://www.linuxfromscratch.org/faq/
Unsubscribe: See the above information page
