[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

Re: response on ddp policy, 3.1

Osamu Aoki <osamu@debian.org> writes:

> OK.  How about "debiandoc-sgml, docbook-sgml, and docbook-xml are the
> recommended formats."

I would think it might be better to just say docbook-xml and not

> It was discussed on this mailing list.  In short, the answer given was 
> "we do not need to use all the tags". 

> >  - since it's simpler, the output is going to be more consistent
> I think the existence of "best practice document" shall fix this
> issue.

I'm dubious but I'm willing to accept it's possible.  If you really
want to commit to a reduced tag set, we can produce a customization of
the DocBook DTD stripped to the tags we think are most useful.  Seems
like a bit of a maintenance headache tho.  I think we might need to
work out a DocBook customization, OTOH, to add <systemitem
class="package"> or something.

> Also, making some debian customized stylesheet maybe an good option.

Required option, IMHO.

I don't really think it's worth discussing all that much at this
point, though.  

> > In fact, I would go even further and state that we should make this
> > change, and Ardo should close most of the wishlists for new tags and
> > features in debiandoc-sgml.  DebianDoc should explicitly be a
> > *simple*, 80% solution.  If folks want bells and whistles, use
> > DocBook.  This way, both have a place in our galaxy and Ardo doesn't
> > have to feel bad about all the things he doesn't do that DocBook does.
> Sure but Ardo's time may be better spent on improving text output of
> docbook or debian customization of docbook output.  That up to him to
> decide, I guess.

Uh, do you mean debiandoc or docbook here?

Of course it's up to Ardo what he wants to do.  I'm just making a
suggest that will help him clear out bugs.
> As I posted separately, Philippe Batailler's script may require some
> iteration of optimization before becoming version 1.0 :-)

Yes, you did a good job.  It's does seem to do a poor job and need
work on tag translation, from my first look.

...Adam Di Carlo..<adam@onshore-devel.com>...<URL:http://www.onshored.com/>

Reply to: