Re: should XML/SGML documentation ship with sources
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
> > source?
> >
> > Pros:
> > - providing source lets contributors make patches more easily
>
> - It would in theory let software like doc-base dynamically generate
> the documentation formats the user desires after installation.
Isn't it against the spirit of "binary distribution"?
deb-file should contain
Plain text (singe file for grep)
Multi-file HTML
PS
PDF
while source shall contain SGML/XML only with proper build depends
provided.
Osamu
--
~\^o^/~~~ ~\^.^/~~~ ~\^*^/~~~ ~\^_^/~~~ ~\^+^/~~~ ~\^:^/~~~ ~\^v^/~~~ +++++
Osamu Aoki <osamu@debian.org> Cupertino CA USA, GPG-key: A8061F32
.''`. Debian Reference: post-installation user's guide for non-developers
: :' : http://qref.sf.net and http://people.debian.org/~osamu
`. `' "Our Priorities are Our Users and Free Software" --- Social Contract
Reply to: