Subject: Re: Reformatting faq.xml
To: Julio M. Merino Vidal <>
From: Hubert Feyrer <>
List: tech-pkg
Date: 06/01/2005 23:38:46
On Wed, 1 Jun 2005, Julio M. Merino Vidal wrote:
> Hmm yes, a new chapter may be good if we want to keep the FAQ one at a
> minimum.

Yes, please! A seperate section with a more appropriate heading than "FAQ" 
is welcome in most cases, FAQ will become a "wastedump" over time (again) 
anyways (generally speaking ;-).

> I think I've opened a can of worms touching this... you know ;)

No, really? ;-) ;-) ;-)
(All of our documentation is a can of worms! :/)

> Started resorting that question and ended up creating a new chapter
> about the pkginstall framework.  It's still incomplete, but you can see
> the outline and the "configuration files" section already written in:
> Comments about the structure/ideas?

Looks very good!

> If it's OK, should I first commit it as is (incomplete), saying that
> it's a rewrite of we have now (no more "unrelated" things), or should
> everything be added at once?

Hm... if you think the new (incomplete) version's better than what we have 
now, commit it, and update the PDF/HTML/etc. files. I guess you can always 
commit the XML files, I'm not doing any work on the pkgsrc guide, and I 
don't know if someone else does. (If someone asks me I'll try to remember 
you're working on it ;)

  - Hubert

Genervt von Viren und von Viren versandten Spam-Mails?  ->
Fed up from viruses & virus-originated spam mail?       ->