Re: should XML/SGML documentation ship with sources

2002-12-12 Thread Junichi Uekawa
> >- It would in theory let software like doc-base dynamically generate > > the documentation formats the user desires after installation. > > The more I think about this idea of building on install, though, the > more I think it's completely insane. At least until the XML/SGML > builders out

Re: should XML/SGML documentation ship with sources

2002-12-12 Thread Colin Walters
On Wed, 2002-12-11 at 18:58, Adam DiCarlo wrote: > The consensus we arrived at on debian-doc list (with the exception of > Colin Walters) was that XML/SGML source is in fact source and > shouldn't be there bloating binary pkgs. FYI, I wasn't really against the consensus; just pointing out somethi

Re: should XML/SGML documentation ship with sources

2002-12-11 Thread Osamu Aoki
On Wed, Dec 11, 2002 at 05:58:17PM -0600, Adam DiCarlo wrote: > > The consensus we arrived at on debian-doc list (with the exception of > Colin Walters) was that XML/SGML source is in fact source and > shouldn't be there bloating binary pkgs. Thanks for summarizing. I should have responded to d

Re: should XML/SGML documentation ship with sources

2002-12-11 Thread Osamu Aoki
On Sun, Dec 08, 2002 at 04:32:10PM -0600, Adam DiCarlo wrote: > > I have a question for further discussion, which I'm unsure about. May > or may not be a policy issue. > > Is it a good practice for SGML or XML documentation to ship with > source? > > Pros: > - providing source lets contributor

Re: should XML/SGML documentation ship with sources

2002-12-11 Thread Osamu Aoki
On Sun, Dec 08, 2002 at 10:44:18PM -0500, Colin Walters wrote: > On Sun, 2002-12-08 at 17:32, Adam DiCarlo wrote: > > I have a question for further discussion, which I'm unsure about. May > > or may not be a policy issue. > > > > Is it a good practice for SGML or XML documentation to ship with >

Re: should XML/SGML documentation ship with sources

2002-12-11 Thread Adam DiCarlo
The consensus we arrived at on debian-doc list (with the exception of Colin Walters) was that XML/SGML source is in fact source and shouldn't be there bloating binary pkgs. Just FYI. Not that I'm proposing this as a policy item, although it might become DDP policy, who knows. -- ...Adam Di Car

Re: should XML/SGML documentation ship with sources

2002-12-10 Thread Josip Rodin
On Tue, Dec 10, 2002 at 11:23:41PM +1100, Brendan O'Dea wrote: > >Is it a good practice for SGML or XML documentation to ship with > >source? > > My preference would be to include the source plus both text and html > renderings. This provides both convieniently pre-formated output for > on-line v

Re: should XML/SGML documentation ship with sources

2002-12-10 Thread Brendan O'Dea
On Sun, Dec 08, 2002 at 04:32:10PM -0600, Adam DiCarlo wrote: >Is it a good practice for SGML or XML documentation to ship with >source? My preference would be to include the source plus both text and html renderings. This provides both convieniently pre-formated output for on-line viewing plus t

Re: should XML/SGML documentation ship with sources

2002-12-09 Thread Javier Fernández-Sanguino Peña
On Sun, Dec 08, 2002 at 04:32:10PM -0600, Adam DiCarlo wrote: > > I have a question for further discussion, which I'm unsure about. May > or may not be a policy issue. > > Is it a good practice for SGML or XML documentation to ship with > source? > I think you have retracted the question (i.e.

Re: should XML/SGML documentation ship with sources

2002-12-09 Thread Adam DiCarlo
Colin Walters <[EMAIL PROTECTED]> writes: >- It would in theory let software like doc-base dynamically generate > the documentation formats the user desires after installation. The more I think about this idea of building on install, though, the more I think it's completely insane. At least

Re: should XML/SGML documentation ship with sources

2002-12-08 Thread Colin Walters
On Sun, 2002-12-08 at 17:32, Adam DiCarlo wrote: > I have a question for further discussion, which I'm unsure about. May > or may not be a policy issue. > > Is it a good practice for SGML or XML documentation to ship with > source? > > Pros: > - providing source lets contributors make patches m

should XML/SGML documentation ship with sources

2002-12-08 Thread Adam DiCarlo
I have a question for further discussion, which I'm unsure about. May or may not be a policy issue. Is it a good practice for SGML or XML documentation to ship with source? Pros: - providing source lets contributors make patches more easily Cons: - wastes disk space - why bother, just get