<strong>Report forwarded</strong> to <code>debian-bugs-dist@lists.debian.org, Ian Jackson &lt;ian@chiark.greenend.org.uk&gt;</code>:<br>
<code>Bug#7890</code>; Package <code>dpkg-dev</code>.


debian-bugs-dist@lists.debian.orgIan Jackson <ian@chiark.greenend.org.uk>

Subject: Bug#7890: Policy manual contradicts itself about including docs or not.
Reply-To: Santiago Vila Doncel <sanvila@unex.es>, 7890@bugs.debian.org
Resent-From: Santiago Vila Doncel <sanvila@unex.es>
Resent-To: debian-bugs-dist@lists.debian.org
Resent-CC: Ian Jackson <ian@chiark.greenend.org.uk>
Resent-Date: Fri, 07 Mar 1997 09:33:03 GMT
Resent-Message-ID: <handler.7890.B.85772644710204@bugs.debian.org>
Resent-Sender: iwj@debian.org
X-Debian-PR-Package: dpkg-dev
X-Debian-PR-Keywords: 
X-Loop: owner@bugs.debian.org
Received: via spool by bugs@bugs.debian.org id=B.85772644710204
          (code B ref -1); Fri, 07 Mar 1997 09:33:03 GMT
Date: Fri, 7 Mar 1997 10:10:00 +0100 (MET)
From: Santiago Vila Doncel <sanvila@unex.es>
X-Sender: sanvila@cantor
To: Debian Bugs <submit@bugs.debian.org>
Message-ID: <Pine.LNX.3.95.970307095707.2128C-100000@cantor>
MIME-Version: 1.0
Content-Type: TEXT/PLAIN; charset=iso-8859-1
Content-Transfer-Encoding: QUOTED-PRINTABLE

Package: dpkg-dev
Version: 1.4.0.8

The following paragraphs are somewhat contradictory:

1) If a package comes with large amounts of documentation which many
   users of the package will not require you should create a separate
   binary package to contain it, so that it does not take up disk space
   on the machines of users who do not need or want it installed.

2) If your package comes with extensive documentation in a markup format
   that can be converted to various other formats you should if possible
   ship HTML versions in the binary package, in the directory
   /usr/doc/package or its subdirectories.

What if both 1) and 2) are true? i.e. What if a package comes with large
amounts of documentation "which many users of the package will not
require" but it is in texinfo format ("that can be converted easily to
HTML")? This applies to most GNU programs.

I think policy should be clear about this, and state which is more
important, either 1) or 2)

[ In my opinion, it would be better to ship it in a different package,
this way user is free to install or not install the documentation. The
important thing here, I think, is that HTML docs should be "available",
which is not exactly the same as "included in the binary package". ]

BTW: My apologies to Manoj Srivastava and Ramos Gon=E7alves. I read 1) but =
I
didn't remember 2). This bug against policy should have been the first.





<strong>Acknowledgement sent</strong> to <code>Santiago Vila Doncel &lt;sanvila@unex.es&gt;</code>:<br>
New bug report received and forwarded.  Copy sent to <code>Ian Jackson &lt;ian@chiark.greenend.org.uk&gt;</code>.


-t

From: owner@bugs.debian.org (Ian Jackson)
To: Santiago Vila Doncel <sanvila@unex.es>
Subject: Bug#7890: Acknowledgement (was: Policy manual contradicts itself about including docs or not.)
Message-ID: <handler.7890.B.85772644710204.ack@bugs.debian.org>
In-Reply-To: <Pine.LNX.3.95.970307095707.2128C-100000@cantor>
References: <Pine.LNX.3.95.970307095707.2128C-100000@cantor>

Thank you for the problem report you have sent regarding Debian Linux.
This is an automatically generated reply, to let you know your message has
been received.  It is being forwarded to the developers' mailing list for
their attention; they will reply in due course.

Your message has been sent to the package maintainer(s):
 Ian Jackson <ian@chiark.greenend.org.uk>

If you wish to submit further information on your problem, please send
it to 7890@bugs.debian.org (and *not* to
bugs@bugs.debian.org).

Please do not reply to the address at the top of this message,
unless you wish to report a problem with the bug-tracking system.

Ian Jackson
(maintainer, Debian bug tracking system)



Received: (at submit) by bugs.debian.org; 7 Mar 1997 09:20:47 +0000
Received: (qmail 10202 invoked from network); 7 Mar 1997 09:20:47 -0000
Received: from guadiana.unex.es (root@158.49.8.233)
  by master.debian.org with SMTP; 7 Mar 1997 09:20:18 -0000
Received: from cantor (sanvila@[158.49.15.116])
	by guadiana.unex.es (8.8.5/8.8.5) with SMTP id KAA04838
	for <submit@bugs.debian.org>; Fri, 7 Mar 1997 10:11:35 +0100
Date: Fri, 7 Mar 1997 10:10:00 +0100 (MET)
From: Santiago Vila Doncel <sanvila@unex.es>
X-Sender: sanvila@cantor
To: Debian Bugs <submit@bugs.debian.org>
Subject: Policy manual contradicts itself about including docs or not.
Message-ID: <Pine.LNX.3.95.970307095707.2128C-100000@cantor>
MIME-Version: 1.0
Content-Type: TEXT/PLAIN; charset=iso-8859-1
Content-Transfer-Encoding: QUOTED-PRINTABLE

Package: dpkg-dev
Version: 1.4.0.8

The following paragraphs are somewhat contradictory:

1) If a package comes with large amounts of documentation which many
   users of the package will not require you should create a separate
   binary package to contain it, so that it does not take up disk space
   on the machines of users who do not need or want it installed.

2) If your package comes with extensive documentation in a markup format
   that can be converted to various other formats you should if possible
   ship HTML versions in the binary package, in the directory
   /usr/doc/package or its subdirectories.

What if both 1) and 2) are true? i.e. What if a package comes with large
amounts of documentation "which many users of the package will not
require" but it is in texinfo format ("that can be converted easily to
HTML")? This applies to most GNU programs.

I think policy should be clear about this, and state which is more
important, either 1) or 2)

[ In my opinion, it would be better to ship it in a different package,
this way user is free to install or not install the documentation. The
important thing here, I think, is that HTML docs should be "available",
which is not exactly the same as "included in the binary package". ]

BTW: My apologies to Manoj Srivastava and Ramos Gon=E7alves. I read 1) but =
I
didn't remember 2). This bug against policy should have been the first.





<strong>Information forwarded</strong> to <code>debian-bugs-dist@lists.debian.org, Ian Jackson &lt;ian@chiark.greenend.org.uk&gt;</code>:<br>
<code>Bug#7890</code>; Package <code>dpkg-dev</code>.


debian-bugs-dist@lists.debian.orgIan Jackson <ian@chiark.greenend.org.uk>

Subject: Bug#7890: Policy manual contradicts itself about including docs   or not.
Reply-To: J.R.Goncalves@reading.ac.uk, 7890@bugs.debian.org
Resent-From: J.R.Goncalves@reading.ac.uk
Orignal-Sender: sprgncal@reading.ac.uk
Resent-To: debian-bugs-dist@lists.debian.org
Resent-CC: Ian Jackson <ian@chiark.greenend.org.uk>
Resent-Date: Fri, 07 Mar 1997 12:33:03 GMT
Resent-Message-ID: <handler.7890.B7890.85773717919157@bugs.debian.org>
Resent-Sender: iwj@debian.org
X-Debian-PR-Package: dpkg-dev
X-Debian-PR-Keywords: 
X-Loop: owner@bugs.debian.org
Received: via spool by 7890-bugs@bugs.debian.org id=B7890.85773717919157
          (code B ref 7890); Fri, 07 Mar 1997 12:33:03 GMT
X-Mailer: exmh version 2.0gamma 1/27/96
To: Santiago Vila Doncel <sanvila@unex.es>, 7890@bugs.debian.org
In-reply-to: Your message of "Fri, 07 Mar 1997 10:10:00 +0100."
             <Pine.LNX.3.95.970307095707.2128C-100000@cantor> 
From: J.R.Goncalves@reading.ac.uk
Mime-Version: 1.0
Content-Type: text/plain; charset=iso-8859-1
Content-Transfer-Encoding: quoted-printable
Date: Fri, 07 Mar 1997 12:02:33 +0000
Sender: sprgncal@reading.ac.uk

> =

> BTW: My apologies to Manoj Srivastava and Ramos Gon=E7alves. I read 1) =
but I
> didn't remember 2). This bug against policy should have been the first.=

> =

> =


Santiago,

I also apologize for my reply to your bug report. I think you are that
the policy should be clear about it (1 and 2). In wget's case the
*.html is slightly over 100KBytes.

Thanks.

Ramos.

P.S.: Yesterday evening was not a good one, I suppose.


-- =

---     =

     J. RAMOS Goncalves | E-mail: J.R.Goncalves@reading.ac.uk   =

     Department of Physics - University of Reading - England - U.K.





<strong>Acknowledgement sent</strong> to <code>J.R.Goncalves@reading.ac.uk</code>:<br>
Extra info received and forwarded to list.  Copy sent to <code>Ian Jackson &lt;ian@chiark.greenend.org.uk&gt;</code>.


-t

From: owner@bugs.debian.org (Ian Jackson)
To: J.R.Goncalves@reading.ac.uk
Subject: Bug#7890: Info received (was Bug#7890: Policy manual contradicts itself about including docs   or not.)
Message-ID: <handler.7890.B7890.85773717919157.ackinfo@bugs.debian.org>
In-Reply-To: 
References: 

Thank you for the additional information you have supplied regarding
this problem report.  It has been forwarded to the developer(s) and
to the developers' mailing list to accompany the original report.

Your message has been sent to the package maintainer(s):
 Ian Jackson <ian@chiark.greenend.org.uk>

If you wish to continue to submit further information on your problem,
please send it to 7890@bugs.debian.org, as before.

Please do not reply to the address at the top of this message,
unless you wish to report a problem with the bug-tracking system.

Ian Jackson
(maintainer, Debian bug tracking system)



Received: (at 7890) by bugs.debian.org; 7 Mar 1997 12:19:39 +0000
Received: (qmail 19154 invoked from network); 7 Mar 1997 12:19:38 -0000
Received: from sppc17.rdg.ac.uk (134.225.49.17)
  by master.debian.org with SMTP; 7 Mar 1997 12:11:14 -0000
Received: (qmail 9895 invoked from network); 7 Mar 1997 12:02:53 -0000
Received: from localhost (HELO sppc17.rdg.ac.uk) (sprgncal@127.0.0.1)
  by localhost with SMTP; 7 Mar 1997 12:02:53 -0000
X-Mailer: exmh version 2.0gamma 1/27/96
To: Santiago Vila Doncel <sanvila@unex.es>, 7890@bugs.debian.org
Subject: Re: Bug#7890: Policy manual contradicts itself about including docs 
 or not.
In-reply-to: Your message of "Fri, 07 Mar 1997 10:10:00 +0100."
             <Pine.LNX.3.95.970307095707.2128C-100000@cantor> 
From: J.R.Goncalves@reading.ac.uk
Mime-Version: 1.0
Content-Type: text/plain; charset=iso-8859-1
Content-Transfer-Encoding: quoted-printable
Date: Fri, 07 Mar 1997 12:02:33 +0000
Sender: sprgncal@reading.ac.uk

> =

> BTW: My apologies to Manoj Srivastava and Ramos Gon=E7alves. I read 1) =
but I
> didn't remember 2). This bug against policy should have been the first.=

> =

> =


Santiago,

I also apologize for my reply to your bug report. I think you are that
the policy should be clear about it (1 and 2). In wget's case the
*.html is slightly over 100KBytes.

Thanks.

Ramos.

P.S.: Yesterday evening was not a good one, I suppose.


-- =

---     =

     J. RAMOS Goncalves | E-mail: J.R.Goncalves@reading.ac.uk   =

     Department of Physics - University of Reading - England - U.K.





<strong>Information forwarded</strong> to <code>debian-bugs-dist@lists.debian.org, Ian Jackson &lt;ian@chiark.greenend.org.uk&gt;</code>:<br>
<code>Bug#7890</code>; Package <code>dpkg-dev</code>.


debian-bugs-dist@lists.debian.orgIan Jackson <ian@chiark.greenend.org.uk>

Subject: Bug#7890: Policy manual contradicts itself about including docs or not.
Reply-To: Guy Maor <maor@ece.utexas.edu>, 7890@bugs.debian.org
Resent-From: Guy Maor <maor@ece.utexas.edu>
Resent-To: debian-bugs-dist@lists.debian.org
Resent-CC: Ian Jackson <ian@chiark.greenend.org.uk>
Resent-Date: Fri, 07 Mar 1997 19:03:01 GMT
Resent-Message-ID: <handler.7890.B7890.85776101831157@bugs.debian.org>
Resent-Sender: iwj@debian.org
X-Debian-PR-Package: dpkg-dev
X-Debian-PR-Keywords: 
X-Loop: owner@bugs.debian.org
Received: via spool by 7890-bugs@bugs.debian.org id=B7890.85776101831157
          (code B ref 7890); Fri, 07 Mar 1997 19:03:01 GMT
To: 7890@bugs.debian.org
References: <Pine.LNX.3.95.970307095707.2128C-100000@cantor>
From: Guy Maor <maor@ece.utexas.edu>
Date: 07 Mar 1997 12:48:21 -0600
In-Reply-To: Santiago Vila Doncel's message of Fri, 7 Mar 1997 10:10:00 +0100 (MET)
Message-ID: <87g1y7wnau.fsf@slip-64-2.ots.utexas.edu>
Lines: 27
X-Mailer: Gnus v5.3/Emacs 19.34

Santiago Vila Doncel <sanvila@unex.es> writes:

> 1) If a package comes with large amounts of documentation which many
>    users of the package will not require you should create a separate
>    binary package to contain it, so that it does not take up disk space
>    on the machines of users who do not need or want it installed.
> 
> 2) If your package comes with extensive documentation in a markup format
>    that can be converted to various other formats you should if possible
>    ship HTML versions in the binary package, in the directory
>    /usr/doc/package or its subdirectories.
> 
> What if both 1) and 2) are true?

You're reading 2 too literally.  Change `the' to `a' in `ship HTML
versions in the binary package'.  2 is still satisfied if
documentation is shipped in a seperate package.

Btw, I do not think that 2 should apply to texinfo documentation.  Any
other documentation - latex, sgml, etc. should be converted to html.

A Netscape info reader plugin might be a cool thing to have.  It may
even be fairly trivial as we already have a Tcl/Tk reader and you can
get a Tcl/Tk Netscape plugin from Sun.


Guy



<strong>Acknowledgement sent</strong> to <code>Guy Maor &lt;maor@ece.utexas.edu&gt;</code>:<br>
Extra info received and forwarded to list.  Copy sent to <code>Ian Jackson &lt;ian@chiark.greenend.org.uk&gt;</code>.


-t

From: owner@bugs.debian.org (Ian Jackson)
To: Guy Maor <maor@ece.utexas.edu>
Subject: Bug#7890: Info received (was Bug#7890: Policy manual contradicts itself about including docs or not.)
Message-ID: <handler.7890.B7890.85776101831157.ackinfo@bugs.debian.org>
In-Reply-To: <87g1y7wnau.fsf@slip-64-2.ots.utexas.edu>
References: <87g1y7wnau.fsf@slip-64-2.ots.utexas.edu>

Thank you for the additional information you have supplied regarding
this problem report.  It has been forwarded to the developer(s) and
to the developers' mailing list to accompany the original report.

Your message has been sent to the package maintainer(s):
 Ian Jackson <ian@chiark.greenend.org.uk>

If you wish to continue to submit further information on your problem,
please send it to 7890@bugs.debian.org, as before.

Please do not reply to the address at the top of this message,
unless you wish to report a problem with the bug-tracking system.

Ian Jackson
(maintainer, Debian bug tracking system)



Received: (at 7890) by bugs.debian.org; 7 Mar 1997 18:56:58 +0000
Received: (qmail 31155 invoked from network); 7 Mar 1997 18:56:57 -0000
Received: from slip-89-4.ots.utexas.edu (root@128.83.219.148)
  by master.debian.org with SMTP; 7 Mar 1997 18:56:57 -0000
Received: by slip-89-4.ots.utexas.edu
	id m0w34h7-0001eWC
	(Debian Smail-3.2 1996-Jul-4 #2); Fri, 7 Mar 1997 12:48:21 -0600 (CST)
To: 7890@bugs.debian.org
Subject: Re: Bug#7890: Policy manual contradicts itself about including docs or not.
References: <Pine.LNX.3.95.970307095707.2128C-100000@cantor>
From: Guy Maor <maor@ece.utexas.edu>
Date: 07 Mar 1997 12:48:21 -0600
In-Reply-To: Santiago Vila Doncel's message of Fri, 7 Mar 1997 10:10:00 +0100 (MET)
Message-ID: <87g1y7wnau.fsf@slip-64-2.ots.utexas.edu>
Lines: 27
X-Mailer: Gnus v5.3/Emacs 19.34

Santiago Vila Doncel <sanvila@unex.es> writes:

> 1) If a package comes with large amounts of documentation which many
>    users of the package will not require you should create a separate
>    binary package to contain it, so that it does not take up disk space
>    on the machines of users who do not need or want it installed.
> 
> 2) If your package comes with extensive documentation in a markup format
>    that can be converted to various other formats you should if possible
>    ship HTML versions in the binary package, in the directory
>    /usr/doc/package or its subdirectories.
> 
> What if both 1) and 2) are true?

You're reading 2 too literally.  Change `the' to `a' in `ship HTML
versions in the binary package'.  2 is still satisfied if
documentation is shipped in a seperate package.

Btw, I do not think that 2 should apply to texinfo documentation.  Any
other documentation - latex, sgml, etc. should be converted to html.

A Netscape info reader plugin might be a cool thing to have.  It may
even be fairly trivial as we already have a Tcl/Tk reader and you can
get a Tcl/Tk Netscape plugin from Sun.


Guy



<strong>Information forwarded</strong> to <code>debian-bugs-dist@lists.debian.org, Ian Jackson &lt;ian@chiark.greenend.org.uk&gt;</code>:<br>
<code>Bug#7890</code>; Package <code>dpkg-dev</code>.


debian-bugs-dist@lists.debian.orgIan Jackson <ian@chiark.greenend.org.uk>

Subject: Bug#7890: Policy manual contradicts itself about including docs or not.
Reply-To: Manoj Srivastava <srivasta@datasync.com>, 7890@bugs.debian.org
Resent-From: Manoj Srivastava <srivasta@datasync.com>
Orignal-Sender: srivasta@datasync.com
Resent-To: debian-bugs-dist@lists.debian.org
Resent-CC: Ian Jackson <ian@chiark.greenend.org.uk>
Resent-Date: Fri, 07 Mar 1997 21:03:03 GMT
Resent-Message-ID: <handler.7890.B7890.85776807729114@bugs.debian.org>
Resent-Sender: iwj@debian.org
X-Debian-PR-Package: dpkg-dev
X-Debian-PR-Keywords: 
X-Loop: owner@bugs.debian.org
Received: via spool by 7890-bugs@bugs.debian.org id=B7890.85776807729114
          (code B ref 7890); Fri, 07 Mar 1997 21:03:03 GMT
Sender: srivasta@datasync.com
X-Time: Fri Mar  7 14:28:40 1997
X-Mail-System: Vm 6.18 for GNU Emacs 19.34.1
Organization: Manoj Srivastava's Home
To: Guy Maor <maor@ece.utexas.edu>
Cc: 7890@bugs.debian.org, Christian Schwarz <schwarz@monet.m.isar.de>
References: <Pine.LNX.3.95.970307095707.2128C-100000@cantor> <87g1y7wnau.fsf@slip-64-2.ots.utexas.edu>
Mime-Version: 1.0 (generated by tm-edit 7.105)
Content-Type: text/plain; charset=US-ASCII
From: Manoj Srivastava <srivasta@datasync.com>
Date: 07 Mar 1997 14:28:50 -0600
In-Reply-To: Guy Maor's message of 07 Mar 1997 12:48:21 -0600
Message-ID: <87ybbzjvjd.fsf@tiamat.datasync.com>
Lines: 49
X-Mailer: Gnus v5.4.21/Emacs 19.34

Hi,

	I'll accept Guy's interpretation of policy (I still think that
 the `the' should be changed to `a' in the document, and some
 guideline provided to maintainers suggesting when the split to a
 separate doc package happens).

	However, I don't quite follow why this should not apply to
 texinfo documents _in particular_. I was under the impression that we
 are trying to unify documents under HTML, not HTML and/or info.

	If run time conversion is the issue, that should apply to all
 formats, not just texinfo. Or change the policy, and punt on
 unification of documentation. 

	manoj
>>"Guy" == Guy Maor <maor@ece.utexas.edu> writes:

Guy> Santiago Vila Doncel <sanvila@unex.es> writes:

>> 1) If a package comes with large amounts of documentation which
>> many users of the package will not require you should create a
>> separate binary package to contain it, so that it does not take up
>> disk space on the machines of users who do not need or want it
>> installed.
>> 
>> 2) If your package comes with extensive documentation in a markup
>> format that can be converted to various other formats you should if
>> possible ship HTML versions in the binary package, in the directory
>> /usr/doc/package or its subdirectories.
>> 
>> What if both 1) and 2) are true?

Guy> You're reading 2 too literally.  Change `the' to `a' in `ship
Guy> HTML versions in the binary package'.  2 is still satisfied if
Guy> documentation is shipped in a seperate package.

Guy> Btw, I do not think that 2 should apply to texinfo documentation.
Guy> Any other documentation - latex, sgml, etc. should be converted
Guy> to html.

Guy> A Netscape info reader plugin might be a cool thing to have.  It
Guy> may even be fairly trivial as we already have a Tcl/Tk reader and
Guy> you can get a Tcl/Tk Netscape plugin from Sun.

-- 
 Semper Fi, dude.
Manoj Srivastava               <url:mailto:srivasta@acm.org>
Mobile, Alabama USA            <url:http://www.datasync.com/%7Esrivasta/>



<strong>Acknowledgement sent</strong> to <code>Manoj Srivastava &lt;srivasta@datasync.com&gt;</code>:<br>
Extra info received and forwarded to list.  Copy sent to <code>Ian Jackson &lt;ian@chiark.greenend.org.uk&gt;</code>.


-t

From: owner@bugs.debian.org (Ian Jackson)
To: Manoj Srivastava <srivasta@datasync.com>
Subject: Bug#7890: Info received (was Bug#7890: Policy manual contradicts itself about including docs or not.)
Message-ID: <handler.7890.B7890.85776807729114.ackinfo@bugs.debian.org>
In-Reply-To: <87ybbzjvjd.fsf@tiamat.datasync.com>
References: <87ybbzjvjd.fsf@tiamat.datasync.com>

Thank you for the additional information you have supplied regarding
this problem report.  It has been forwarded to the developer(s) and
to the developers' mailing list to accompany the original report.

Your message has been sent to the package maintainer(s):
 Ian Jackson <ian@chiark.greenend.org.uk>

If you wish to continue to submit further information on your problem,
please send it to 7890@bugs.debian.org, as before.

Please do not reply to the address at the top of this message,
unless you wish to report a problem with the bug-tracking system.

Ian Jackson
(maintainer, Debian bug tracking system)



Received: (at 7890) by bugs.debian.org; 7 Mar 1997 20:54:37 +0000
Received: (qmail 29111 invoked from network); 7 Mar 1997 20:54:29 -0000
Received: from tiamat.datasync.com (srivasta@205.216.83.252)
  by master.debian.org with SMTP; 7 Mar 1997 20:54:29 -0000
Received: (from srivasta@localhost)
	by tiamat.datasync.com (8.8.5/8.8.5) id OAA20807;
	Fri, 7 Mar 1997 14:28:53 -0600
Sender: srivasta@datasync.com
X-Time: Fri Mar  7 14:28:40 1997
X-Mail-System: Vm 6.18 for GNU Emacs 19.34.1
Organization: Manoj Srivastava's Home
To: Guy Maor <maor@ece.utexas.edu>
Cc: 7890@bugs.debian.org, Christian Schwarz <schwarz@monet.m.isar.de>
Subject: Re: Bug#7890: Policy manual contradicts itself about including docs or not.
References: <Pine.LNX.3.95.970307095707.2128C-100000@cantor> <87g1y7wnau.fsf@slip-64-2.ots.utexas.edu>
Mime-Version: 1.0 (generated by tm-edit 7.105)
Content-Type: text/plain; charset=US-ASCII
From: Manoj Srivastava <srivasta@datasync.com>
Date: 07 Mar 1997 14:28:50 -0600
In-Reply-To: Guy Maor's message of 07 Mar 1997 12:48:21 -0600
Message-ID: <87ybbzjvjd.fsf@tiamat.datasync.com>
Lines: 49
X-Mailer: Gnus v5.4.21/Emacs 19.34

Hi,

	I'll accept Guy's interpretation of policy (I still think that
 the `the' should be changed to `a' in the document, and some
 guideline provided to maintainers suggesting when the split to a
 separate doc package happens).

	However, I don't quite follow why this should not apply to
 texinfo documents _in particular_. I was under the impression that we
 are trying to unify documents under HTML, not HTML and/or info.

	If run time conversion is the issue, that should apply to all
 formats, not just texinfo. Or change the policy, and punt on
 unification of documentation. 

	manoj
>>"Guy" == Guy Maor <maor@ece.utexas.edu> writes:

Guy> Santiago Vila Doncel <sanvila@unex.es> writes:

>> 1) If a package comes with large amounts of documentation which
>> many users of the package will not require you should create a
>> separate binary package to contain it, so that it does not take up
>> disk space on the machines of users who do not need or want it
>> installed.
>> 
>> 2) If your package comes with extensive documentation in a markup
>> format that can be converted to various other formats you should if
>> possible ship HTML versions in the binary package, in the directory
>> /usr/doc/package or its subdirectories.
>> 
>> What if both 1) and 2) are true?

Guy> You're reading 2 too literally.  Change `the' to `a' in `ship
Guy> HTML versions in the binary package'.  2 is still satisfied if
Guy> documentation is shipped in a seperate package.

Guy> Btw, I do not think that 2 should apply to texinfo documentation.
Guy> Any other documentation - latex, sgml, etc. should be converted
Guy> to html.

Guy> A Netscape info reader plugin might be a cool thing to have.  It
Guy> may even be fairly trivial as we already have a Tcl/Tk reader and
Guy> you can get a Tcl/Tk Netscape plugin from Sun.

-- 
 Semper Fi, dude.
Manoj Srivastava               <url:mailto:srivasta@acm.org>
Mobile, Alabama USA            <url:http://www.datasync.com/%7Esrivasta/>



<strong>Information forwarded</strong> to <code>debian-bugs-dist@lists.debian.org, Ian Jackson &lt;ian@chiark.greenend.org.uk&gt;</code>:<br>
<code>Bug#7890</code>; Package <code>dpkg-dev</code>.


debian-bugs-dist@lists.debian.orgIan Jackson <ian@chiark.greenend.org.uk>

Subject: Bug#7890: Policy manual contradicts itself about including docs or not.
Reply-To: Guy Maor <maor@ece.utexas.edu>, 7890@bugs.debian.org
Resent-From: Guy Maor <maor@ece.utexas.edu>
Resent-To: debian-bugs-dist@lists.debian.org
Resent-CC: Ian Jackson <ian@chiark.greenend.org.uk>
Resent-Date: Sat, 08 Mar 1997 03:33:04 GMT
Resent-Message-ID: <handler.7890.B7890.85779126520290@bugs.debian.org>
Resent-Sender: iwj@debian.org
X-Debian-PR-Package: dpkg-dev
X-Debian-PR-Keywords: 
X-Loop: owner@bugs.debian.org
Received: via spool by 7890-bugs@bugs.debian.org id=B7890.85779126520290
          (code B ref 7890); Sat, 08 Mar 1997 03:33:04 GMT
To: 7890@bugs.debian.org
References: <Pine.LNX.3.95.970307095707.2128C-100000@cantor>
	<87g1y7wnau.fsf@slip-64-2.ots.utexas.edu>
	<87ybbzjvjd.fsf@tiamat.datasync.com>
From: Guy Maor <maor@ece.utexas.edu>
Date: 07 Mar 1997 21:12:22 -0600
In-Reply-To: Manoj Srivastava's message of 07 Mar 1997 14:28:50 -0600
Message-ID: <87wwrjuled.fsf@slip-64-2.ots.utexas.edu>
Lines: 12
X-Mailer: Gnus v5.3/Emacs 19.34

Manoj Srivastava <srivasta@datasync.com> writes:

> 	However, I don't quite follow why this should not apply to
>  texinfo documents _in particular_. I was under the impression that we
>  are trying to unify documents under HTML, not HTML and/or info.

To be honest, I'm not completely sure we shouldn't either.  Until we
have a clear decision one way or another, let's agree not to include
html versions of texinfo documentation.


Guy



<strong>Acknowledgement sent</strong> to <code>Guy Maor &lt;maor@ece.utexas.edu&gt;</code>:<br>
Extra info received and forwarded to list.  Copy sent to <code>Ian Jackson &lt;ian@chiark.greenend.org.uk&gt;</code>.


-t

From: owner@bugs.debian.org (Ian Jackson)
To: Guy Maor <maor@ece.utexas.edu>
Subject: Bug#7890: Info received (was Bug#7890: Policy manual contradicts itself about including docs or not.)
Message-ID: <handler.7890.B7890.85779126520290.ackinfo@bugs.debian.org>
In-Reply-To: <87wwrjuled.fsf@slip-64-2.ots.utexas.edu>
References: <87wwrjuled.fsf@slip-64-2.ots.utexas.edu>

Thank you for the additional information you have supplied regarding
this problem report.  It has been forwarded to the developer(s) and
to the developers' mailing list to accompany the original report.

Your message has been sent to the package maintainer(s):
 Ian Jackson <ian@chiark.greenend.org.uk>

If you wish to continue to submit further information on your problem,
please send it to 7890@bugs.debian.org, as before.

Please do not reply to the address at the top of this message,
unless you wish to report a problem with the bug-tracking system.

Ian Jackson
(maintainer, Debian bug tracking system)



Received: (at 7890) by bugs.debian.org; 8 Mar 1997 03:21:05 +0000
Received: (qmail 20241 invoked from network); 8 Mar 1997 03:21:02 -0000
Received: from slip-89-4.ots.utexas.edu (root@128.83.219.148)
  by master.debian.org with SMTP; 8 Mar 1997 03:21:02 -0000
Received: by slip-89-4.ots.utexas.edu
	id m0w3CYs-0001eZC
	(Debian Smail-3.2 1996-Jul-4 #2); Fri, 7 Mar 1997 21:12:22 -0600 (CST)
To: 7890@bugs.debian.org
Subject: Re: Bug#7890: Policy manual contradicts itself about including docs or not.
References: <Pine.LNX.3.95.970307095707.2128C-100000@cantor>
	<87g1y7wnau.fsf@slip-64-2.ots.utexas.edu>
	<87ybbzjvjd.fsf@tiamat.datasync.com>
From: Guy Maor <maor@ece.utexas.edu>
Date: 07 Mar 1997 21:12:22 -0600
In-Reply-To: Manoj Srivastava's message of 07 Mar 1997 14:28:50 -0600
Message-ID: <87wwrjuled.fsf@slip-64-2.ots.utexas.edu>
Lines: 12
X-Mailer: Gnus v5.3/Emacs 19.34

Manoj Srivastava <srivasta@datasync.com> writes:

> 	However, I don't quite follow why this should not apply to
>  texinfo documents _in particular_. I was under the impression that we
>  are trying to unify documents under HTML, not HTML and/or info.

To be honest, I'm not completely sure we shouldn't either.  Until we
have a clear decision one way or another, let's agree not to include
html versions of texinfo documentation.


Guy



<strong>Information forwarded</strong> to <code>debian-bugs-dist@lists.debian.org, Ian Jackson &lt;ian@chiark.greenend.org.uk&gt;</code>:<br>
<code>Bug#7890</code>; Package <code>dpkg-dev</code>.


debian-bugs-dist@lists.debian.orgIan Jackson <ian@chiark.greenend.org.uk>

Subject: Bug#7890: Policy manual contradicts itself about   including docs or not.
Reply-To: Philippe Troin <phil@fifi.org>, 7890@bugs.debian.org
Resent-From: Philippe Troin <phil@fifi.org>
Resent-To: debian-bugs-dist@lists.debian.org
Resent-CC: Ian Jackson <ian@chiark.greenend.org.uk>
Resent-Date: Sat, 08 Mar 1997 04:33:02 GMT
Resent-Message-ID: <handler.7890.B7890.8577952681152@bugs.debian.org>
Resent-Sender: iwj@debian.org
X-Debian-PR-Package: dpkg-dev
X-Debian-PR-Keywords: 
X-Loop: owner@bugs.debian.org
Received: via spool by 7890-bugs@bugs.debian.org id=B7890.8577952681152
          (code B ref 7890); Sat, 08 Mar 1997 04:33:02 GMT
Message-Id: <199703080417.UAA10105@tantale.fifi.org>
X-Mailer: exmh version 1.6.9 8/22/96
To: Guy Maor <maor@ece.utexas.edu>, 7890@bugs.debian.org
In-reply-to: Your message of "07 Mar 1997 12:48:21 CST."
             <87g1y7wnau.fsf@slip-64-2.ots.utexas.edu> 
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Date: Fri, 07 Mar 1997 20:17:29 -0800
From: Philippe Troin <phil@fifi.org>


On 07 Mar 1997 12:48:21 CST Guy Maor (maor@ece.utexas.edu) wrote:

> A Netscape info reader plugin might be a cool thing to have.  It may
> even be fairly trivial as we already have a Tcl/Tk reader and you can
> get a Tcl/Tk Netscape plugin from Sun.

Let me point out that the tcl/tk plugin from Sun comes with a license.
I feel the whole tcl/tk think drifting away from the free software world. 

Phil.





<strong>Acknowledgement sent</strong> to <code>Philippe Troin &lt;phil@fifi.org&gt;</code>:<br>
Extra info received and forwarded to list.  Copy sent to <code>Ian Jackson &lt;ian@chiark.greenend.org.uk&gt;</code>.


-t

From: owner@bugs.debian.org (Ian Jackson)
To: Philippe Troin <phil@fifi.org>
Subject: Bug#7890: Info received (was Bug#7890: Policy manual contradicts itself about   including docs or not.)
Message-ID: <handler.7890.B7890.8577952681152.ackinfo@bugs.debian.org>
In-Reply-To: <199703080417.UAA10105@tantale.fifi.org>
References: <199703080417.UAA10105@tantale.fifi.org>

Thank you for the additional information you have supplied regarding
this problem report.  It has been forwarded to the developer(s) and
to the developers' mailing list to accompany the original report.

Your message has been sent to the package maintainer(s):
 Ian Jackson <ian@chiark.greenend.org.uk>

If you wish to continue to submit further information on your problem,
please send it to 7890@bugs.debian.org, as before.

Please do not reply to the address at the top of this message,
unless you wish to report a problem with the bug-tracking system.

Ian Jackson
(maintainer, Debian bug tracking system)



Received: (at 7890) by bugs.debian.org; 8 Mar 1997 04:27:48 +0000
Received: (qmail 1150 invoked from network); 8 Mar 1997 04:27:46 -0000
Received: from ppp-gw.fifi.org (HELO tantale.fifi.org) (root@207.104.147.8)
  by master.debian.org with SMTP; 8 Mar 1997 04:27:45 -0000
Received: from tantale.fifi.org (phil@localhost [127.0.0.1])
	by tantale.fifi.org (8.8.5/8.8.5) with ESMTP id UAA10105;
	Fri, 7 Mar 1997 20:17:30 -0800
Message-Id: <199703080417.UAA10105@tantale.fifi.org>
X-Mailer: exmh version 1.6.9 8/22/96
To: Guy Maor <maor@ece.utexas.edu>, 7890@bugs.debian.org
Subject: Re: Bug#7890: Policy manual contradicts itself about 
 including docs or not.
In-reply-to: Your message of "07 Mar 1997 12:48:21 CST."
             <87g1y7wnau.fsf@slip-64-2.ots.utexas.edu> 
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Date: Fri, 07 Mar 1997 20:17:29 -0800
From: Philippe Troin <phil@fifi.org>


On 07 Mar 1997 12:48:21 CST Guy Maor (maor@ece.utexas.edu) wrote:

> A Netscape info reader plugin might be a cool thing to have.  It may
> even be fairly trivial as we already have a Tcl/Tk reader and you can
> get a Tcl/Tk Netscape plugin from Sun.

Let me point out that the tcl/tk plugin from Sun comes with a license.
I feel the whole tcl/tk think drifting away from the free software world. 

Phil.





<strong>Information forwarded</strong> to <code>debian-bugs-dist@lists.debian.org, Ian Jackson &lt;ian@chiark.greenend.org.uk&gt;</code>:<br>
<code>Bug#7890</code>; Package <code>dpkg-dev</code>.


debian-bugs-dist@lists.debian.orgIan Jackson <ian@chiark.greenend.org.uk>

Subject: Bug#7890: Policy manual contradicts itself about   including docs or not.
Reply-To: Philippe Troin <phil@fifi.org>, 7890@bugs.debian.org
Resent-From: Philippe Troin <phil@fifi.org>
Resent-To: debian-bugs-dist@lists.debian.org
Resent-CC: Ian Jackson <ian@chiark.greenend.org.uk>
Resent-Date: Sat, 08 Mar 1997 04:33:04 GMT
Resent-Message-ID: <handler.7890.B7890.8577953521162@bugs.debian.org>
Resent-Sender: iwj@debian.org
X-Debian-PR-Package: dpkg-dev
X-Debian-PR-Keywords: 
X-Loop: owner@bugs.debian.org
Received: via spool by 7890-bugs@bugs.debian.org id=B7890.8577953521162
          (code B ref 7890); Sat, 08 Mar 1997 04:33:04 GMT
Message-Id: <199703080418.UAA10124@tantale.fifi.org>
X-Mailer: exmh version 1.6.9 8/22/96
To: Guy Maor <maor@ece.utexas.edu>, 7890@bugs.debian.org
In-reply-to: Your message of "07 Mar 1997 21:12:22 CST."
             <87wwrjuled.fsf@slip-64-2.ots.utexas.edu> 
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Date: Fri, 07 Mar 1997 20:18:56 -0800
From: Philippe Troin <phil@fifi.org>


On 07 Mar 1997 21:12:22 CST Guy Maor (maor@ece.utexas.edu) wrote:

> Manoj Srivastava <srivasta@datasync.com> writes:
> 
> > 	However, I don't quite follow why this should not apply to
> >  texinfo documents _in particular_. I was under the impression that we
> >  are trying to unify documents under HTML, not HTML and/or info.
> 
> To be honest, I'm not completely sure we shouldn't either.  Until we
> have a clear decision one way or another, let's agree not to include
> html versions of texinfo documentation.

The problem with htmlified texinfo docs is that they cannot be reverted to info documentation. Texinfo files can be converted on the fly to html.
Some people prefer info over www. I do.

Phil.





<strong>Acknowledgement sent</strong> to <code>Philippe Troin &lt;phil@fifi.org&gt;</code>:<br>
Extra info received and forwarded to list.  Copy sent to <code>Ian Jackson &lt;ian@chiark.greenend.org.uk&gt;</code>.


-t

From: owner@bugs.debian.org (Ian Jackson)
To: Philippe Troin <phil@fifi.org>
Subject: Bug#7890: Info received (was Bug#7890: Policy manual contradicts itself about   including docs or not.)
Message-ID: <handler.7890.B7890.8577953521162.ackinfo@bugs.debian.org>
In-Reply-To: <199703080418.UAA10124@tantale.fifi.org>
References: <199703080418.UAA10124@tantale.fifi.org>

Thank you for the additional information you have supplied regarding
this problem report.  It has been forwarded to the developer(s) and
to the developers' mailing list to accompany the original report.

Your message has been sent to the package maintainer(s):
 Ian Jackson <ian@chiark.greenend.org.uk>

If you wish to continue to submit further information on your problem,
please send it to 7890@bugs.debian.org, as before.

Please do not reply to the address at the top of this message,
unless you wish to report a problem with the bug-tracking system.

Ian Jackson
(maintainer, Debian bug tracking system)



Received: (at 7890) by bugs.debian.org; 8 Mar 1997 04:29:12 +0000
Received: (qmail 1160 invoked from network); 8 Mar 1997 04:29:11 -0000
Received: from ppp-gw.fifi.org (HELO tantale.fifi.org) (root@207.104.147.8)
  by master.debian.org with SMTP; 8 Mar 1997 04:29:10 -0000
Received: from tantale.fifi.org (phil@localhost [127.0.0.1])
	by tantale.fifi.org (8.8.5/8.8.5) with ESMTP id UAA10124;
	Fri, 7 Mar 1997 20:18:56 -0800
Message-Id: <199703080418.UAA10124@tantale.fifi.org>
X-Mailer: exmh version 1.6.9 8/22/96
To: Guy Maor <maor@ece.utexas.edu>, 7890@bugs.debian.org
Subject: Re: Bug#7890: Policy manual contradicts itself about 
 including docs or not.
In-reply-to: Your message of "07 Mar 1997 21:12:22 CST."
             <87wwrjuled.fsf@slip-64-2.ots.utexas.edu> 
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Date: Fri, 07 Mar 1997 20:18:56 -0800
From: Philippe Troin <phil@fifi.org>


On 07 Mar 1997 21:12:22 CST Guy Maor (maor@ece.utexas.edu) wrote:

> Manoj Srivastava <srivasta@datasync.com> writes:
> 
> > 	However, I don't quite follow why this should not apply to
> >  texinfo documents _in particular_. I was under the impression that we
> >  are trying to unify documents under HTML, not HTML and/or info.
> 
> To be honest, I'm not completely sure we shouldn't either.  Until we
> have a clear decision one way or another, let's agree not to include
> html versions of texinfo documentation.

The problem with htmlified texinfo docs is that they cannot be reverted to info documentation. Texinfo files can be converted on the fly to html.
Some people prefer info over www. I do.

Phil.





<strong>Information forwarded</strong> to <code>debian-bugs-dist@lists.debian.org, Ian Jackson &lt;ian@chiark.greenend.org.uk&gt;</code>:<br>
<code>Bug#7890</code>; Package <code>dpkg-dev</code>.


debian-bugs-dist@lists.debian.orgIan Jackson <ian@chiark.greenend.org.uk>

Subject: Bug#7890: Policy manual contradicts itself about   including docs or not.
Reply-To: Manoj Srivastava <srivasta@datasync.com>, 7890@bugs.debian.org
Resent-From: Manoj Srivastava <srivasta@datasync.com>
Orignal-Sender: srivasta@datasync.com
Resent-To: debian-bugs-dist@lists.debian.org
Resent-CC: Ian Jackson <ian@chiark.greenend.org.uk>
Resent-Date: Sat, 08 Mar 1997 06:03:01 GMT
Resent-Message-ID: <handler.7890.B7890.85780086110543@bugs.debian.org>
Resent-Sender: iwj@debian.org
X-Debian-PR-Package: dpkg-dev
X-Debian-PR-Keywords: 
X-Loop: owner@bugs.debian.org
Received: via spool by 7890-bugs@bugs.debian.org id=B7890.85780086110543
          (code B ref 7890); Sat, 08 Mar 1997 06:03:01 GMT
Sender: srivasta@datasync.com
X-Time: Fri Mar  7 23:50:22 1997
X-Mail-System: Vm 6.18 for GNU Emacs 19.34.1
Organization: Manoj Srivastava's Home
To: Philippe Troin <phil@fifi.org>
Cc: 7890@bugs.debian.org, Christian Schwarz <schwarz@monet.m.isar.de>
References: <199703080418.UAA10124@tantale.fifi.org>
Mime-Version: 1.0 (generated by tm-edit 7.105)
Content-Type: text/plain; charset=US-ASCII
From: Manoj Srivastava <srivasta@datasync.com>
Date: 07 Mar 1997 23:50:26 -0600
In-Reply-To: Philippe Troin's message of Fri, 07 Mar 1997 20:18:56 -0800
Message-ID: <87hgin3pah.fsf@tiamat.datasync.com>
Lines: 19
X-Mailer: Gnus v5.4.22/Emacs 19.34

Hi.

	I was not really suggesting replacing the info documentation
 (or the man pages, for that matter), I meant in addition to. The
 policy *does* say that HTML is our preferred format, so it should
 also be provided -- we need an authoritative interpretation of policy
 Bruce did say that HTML is important, but he was in favour of on the
 fly conversion, Maybe hte source format (sgml, texinfo) should always
 be supplied, to be converted into the preferred format on the fly
 (and kept around for a bit, like catman directories for nroff sources
 converted on the fly).

	As I said, The policy Manager should probably take control of
 this discussion (and move it to debian-devel) now.

	manoj
-- 
Manoj Srivastava               <url:mailto:srivasta@acm.org>
Mobile, Alabama USA            <url:http://www.datasync.com/%7Esrivasta/>



<strong>Acknowledgement sent</strong> to <code>Manoj Srivastava &lt;srivasta@datasync.com&gt;</code>:<br>
Extra info received and forwarded to list.  Copy sent to <code>Ian Jackson &lt;ian@chiark.greenend.org.uk&gt;</code>.


-t

From: owner@bugs.debian.org (Ian Jackson)
To: Manoj Srivastava <srivasta@datasync.com>
Subject: Bug#7890: Info received (was Bug#7890: Policy manual contradicts itself about   including docs or not.)
Message-ID: <handler.7890.B7890.85780086110543.ackinfo@bugs.debian.org>
In-Reply-To: <87hgin3pah.fsf@tiamat.datasync.com>
References: <87hgin3pah.fsf@tiamat.datasync.com>

Thank you for the additional information you have supplied regarding
this problem report.  It has been forwarded to the developer(s) and
to the developers' mailing list to accompany the original report.

Your message has been sent to the package maintainer(s):
 Ian Jackson <ian@chiark.greenend.org.uk>

If you wish to continue to submit further information on your problem,
please send it to 7890@bugs.debian.org, as before.

Please do not reply to the address at the top of this message,
unless you wish to report a problem with the bug-tracking system.

Ian Jackson
(maintainer, Debian bug tracking system)



Received: (at 7890) by bugs.debian.org; 8 Mar 1997 06:01:01 +0000
Received: (qmail 10541 invoked from network); 8 Mar 1997 06:00:59 -0000
Received: from tiamat.datasync.com (srivasta@205.216.83.252)
  by master.debian.org with SMTP; 8 Mar 1997 06:00:58 -0000
Received: (from srivasta@localhost)
	by tiamat.datasync.com (8.8.5/8.8.5) id XAA10312;
	Fri, 7 Mar 1997 23:50:27 -0600
Sender: srivasta@datasync.com
X-Time: Fri Mar  7 23:50:22 1997
X-Mail-System: Vm 6.18 for GNU Emacs 19.34.1
Organization: Manoj Srivastava's Home
To: Philippe Troin <phil@fifi.org>
Cc: 7890@bugs.debian.org, Christian Schwarz <schwarz@monet.m.isar.de>
Subject: Re: Bug#7890: Policy manual contradicts itself about   including docs or not.
References: <199703080418.UAA10124@tantale.fifi.org>
Mime-Version: 1.0 (generated by tm-edit 7.105)
Content-Type: text/plain; charset=US-ASCII
From: Manoj Srivastava <srivasta@datasync.com>
Date: 07 Mar 1997 23:50:26 -0600
In-Reply-To: Philippe Troin's message of Fri, 07 Mar 1997 20:18:56 -0800
Message-ID: <87hgin3pah.fsf@tiamat.datasync.com>
Lines: 19
X-Mailer: Gnus v5.4.22/Emacs 19.34

Hi.

	I was not really suggesting replacing the info documentation
 (or the man pages, for that matter), I meant in addition to. The
 policy *does* say that HTML is our preferred format, so it should
 also be provided -- we need an authoritative interpretation of policy
 Bruce did say that HTML is important, but he was in favour of on the
 fly conversion, Maybe hte source format (sgml, texinfo) should always
 be supplied, to be converted into the preferred format on the fly
 (and kept around for a bit, like catman directories for nroff sources
 converted on the fly).

	As I said, The policy Manager should probably take control of
 this discussion (and move it to debian-devel) now.

	manoj
-- 
Manoj Srivastava               <url:mailto:srivasta@acm.org>
Mobile, Alabama USA            <url:http://www.datasync.com/%7Esrivasta/>



<strong>Information forwarded</strong> to <code>debian-bugs-dist@lists.debian.org, Ian Jackson &lt;ian@chiark.greenend.org.uk&gt;</code>:<br>
<code>Bug#7890</code>; Package <code>dpkg-dev</code>.


debian-bugs-dist@lists.debian.orgIan Jackson <ian@chiark.greenend.org.uk>

Subject: Bug#7890: Policy manual contradicts itself about   including docs or not.
Reply-To: Philippe Troin <phil@fifi.org>, 7890@bugs.debian.org
Resent-From: Philippe Troin <phil@fifi.org>
Resent-To: debian-bugs-dist@lists.debian.org
Resent-CC: Ian Jackson <ian@chiark.greenend.org.uk>
Resent-Date: Sat, 08 Mar 1997 06:18:04 GMT
Resent-Message-ID: <handler.7890.B7890.85780113910612@bugs.debian.org>
Resent-Sender: iwj@debian.org
X-Debian-PR-Package: dpkg-dev
X-Debian-PR-Keywords: 
X-Loop: owner@bugs.debian.org
Received: via spool by 7890-bugs@bugs.debian.org id=B7890.85780113910612
          (code B ref 7890); Sat, 08 Mar 1997 06:18:04 GMT
Message-Id: <199703080555.VAA11780@tantale.fifi.org>
X-Mailer: exmh version 1.6.9 8/22/96
To: Manoj Srivastava <srivasta@datasync.com>
cc: 7890@bugs.debian.org, Christian Schwarz <schwarz@monet.m.isar.de>
In-reply-to: Your message of "07 Mar 1997 23:50:26 CST."
             <87hgin3pah.fsf@tiamat.datasync.com> 
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Date: Fri, 07 Mar 1997 21:55:20 -0800
From: Philippe Troin <phil@fifi.org>


On 07 Mar 1997 23:50:26 CST Manoj Srivastava (srivasta@datasync.com) 
wrote:

> 	I was not really suggesting replacing the info documentation
>  (or the man pages, for that matter), I meant in addition to. The
>  policy *does* say that HTML is our preferred format, so it should
>  also be provided -- we need an authoritative interpretation of policy
>  Bruce did say that HTML is important, but he was in favour of on the
>  fly conversion, Maybe hte source format (sgml, texinfo) should always
>  be supplied, to be converted into the preferred format on the fly
>  (and kept around for a bit, like catman directories for nroff sources
>  converted on the fly).

Seconded !

> 	As I said, The policy Manager should probably take control of
>  this discussion (and move it to debian-devel) now.

Agreed too...

Phil.





<strong>Acknowledgement sent</strong> to <code>Philippe Troin &lt;phil@fifi.org&gt;</code>:<br>
Extra info received and forwarded to list.  Copy sent to <code>Ian Jackson &lt;ian@chiark.greenend.org.uk&gt;</code>.


-t

From: owner@bugs.debian.org (Ian Jackson)
To: Philippe Troin <phil@fifi.org>
Subject: Bug#7890: Info received (was Bug#7890: Policy manual contradicts itself about   including docs or not.)
Message-ID: <handler.7890.B7890.85780113910612.ackinfo@bugs.debian.org>
In-Reply-To: <199703080555.VAA11780@tantale.fifi.org>
References: <199703080555.VAA11780@tantale.fifi.org>

Thank you for the additional information you have supplied regarding
this problem report.  It has been forwarded to the developer(s) and
to the developers' mailing list to accompany the original report.

Your message has been sent to the package maintainer(s):
 Ian Jackson <ian@chiark.greenend.org.uk>

If you wish to continue to submit further information on your problem,
please send it to 7890@bugs.debian.org, as before.

Please do not reply to the address at the top of this message,
unless you wish to report a problem with the bug-tracking system.

Ian Jackson
(maintainer, Debian bug tracking system)



Received: (at 7890) by bugs.debian.org; 8 Mar 1997 06:05:39 +0000
Received: (qmail 10610 invoked from network); 8 Mar 1997 06:05:38 -0000
Received: from ppp-gw.fifi.org (HELO tantale.fifi.org) (root@207.104.147.8)
  by master.debian.org with SMTP; 8 Mar 1997 06:05:37 -0000
Received: from tantale.fifi.org (phil@localhost [127.0.0.1])
	by tantale.fifi.org (8.8.5/8.8.5) with ESMTP id VAA11780;
	Fri, 7 Mar 1997 21:55:22 -0800
Message-Id: <199703080555.VAA11780@tantale.fifi.org>
X-Mailer: exmh version 1.6.9 8/22/96
To: Manoj Srivastava <srivasta@datasync.com>
cc: 7890@bugs.debian.org, Christian Schwarz <schwarz@monet.m.isar.de>
Subject: Re: Bug#7890: Policy manual contradicts itself about 
 including docs or not.
In-reply-to: Your message of "07 Mar 1997 23:50:26 CST."
             <87hgin3pah.fsf@tiamat.datasync.com> 
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Date: Fri, 07 Mar 1997 21:55:20 -0800
From: Philippe Troin <phil@fifi.org>


On 07 Mar 1997 23:50:26 CST Manoj Srivastava (srivasta@datasync.com) 
wrote:

> 	I was not really suggesting replacing the info documentation
>  (or the man pages, for that matter), I meant in addition to. The
>  policy *does* say that HTML is our preferred format, so it should
>  also be provided -- we need an authoritative interpretation of policy
>  Bruce did say that HTML is important, but he was in favour of on the
>  fly conversion, Maybe hte source format (sgml, texinfo) should always
>  be supplied, to be converted into the preferred format on the fly
>  (and kept around for a bit, like catman directories for nroff sources
>  converted on the fly).

Seconded !

> 	As I said, The policy Manager should probably take control of
>  this discussion (and move it to debian-devel) now.

Agreed too...

Phil.





<strong>Bug reassigned from package `dpkg-dev' to `debian-policy'.</strong>
Request was from <code>Klee Dienes &lt;klee@mit.edu&gt;</code>
to <code>control@bugs.debian.org</code>. 


Received: (at control) by bugs.debian.org; 2 May 1997 05:38:43 +0000
Received: (qmail 15150 invoked from network); 2 May 1997 05:38:37 -0000
Received: from nhv-ct1-03.ix.netcom.com (HELO sauron.fashion-technology.com) (mail@205.184.152.35)
  by master.debian.org with SMTP; 2 May 1997 05:38:28 -0000
Received: from klee by sauron.fashion-technology.com with local (Exim 1.61 #1)
	id 0wNB2U-0004Y9-00 (Debian); Fri, 2 May 1997 01:37:30 -0400
From: Klee Dienes <klee@mit.edu>
Reply-To: Klee Dienes <klee@mit.edu>
To: control@bugs.debian.org
Subject: reassign 7890 debian-policy
Message-Id: <E0wNB2U-0004Y9-00@sauron.fashion-technology.com>
Sender: Klee Dienes <klee@fashion-technology.com>
Date: Fri, 2 May 1997 01:37:30 -0400


reassign 7890 debian-policy



<strong>Information forwarded</strong> to <code>debian-bugs-dist@lists.debian.org, Debian Policy List &lt;debian-policy@lists.debian.org&gt;</code>:<br>
<code>Bug#7890</code>; Package <code>debian-policy</code>.


debian-bugs-dist@lists.debian.orgDebian Policy List <debian-policy@lists.debian.org>

Subject: Bug#7890: {PROPOSAL} #7890: Policy manual contradicts itself about including docs
Reply-To: apharris@burrito.onshore.com (Adam P. Harris), 7890@bugs.debian.org
Resent-From: apharris@burrito.onshore.com (Adam P. Harris)
Resent-To: debian-bugs-dist@lists.debian.org
Resent-CC: Debian Policy List <debian-policy@lists.debian.org>
Resent-Date: Tue, 22 Sep 1998 06:03:05 GMT
Resent-Message-ID: <handler.7890.B7890.90644358227457@bugs.debian.org>
Resent-Sender: iwj@debian.org
X-Debian-PR-Message: report 7890
X-Debian-PR-Package: debian-policy
X-Debian-PR-Keywords: 
X-Loop: owner@bugs.debian.org
Received: via spool by 7890-bugs@bugs.debian.org id=B7890.90644358227457
          (code B ref 7890); Tue, 22 Sep 1998 06:03:05 GMT
To: debian-policy@lists.debian.org
cc: 7890@bugs.debian.org
References: <871zp4g3fv.fsf@tiamat.datasync.com>
Mime-Version: 1.0 (generated by tm-edit 7.108)
Content-Type: text/plain; charset=US-ASCII
From: apharris@burrito.onshore.com (Adam P. Harris)
Date: 22 Sep 1998 01:52:55 -0400
In-Reply-To: Manoj Srivastava's message of "21 Sep 1998 23:46:12 -0500"
Message-ID: <oahfy066dk.fsf@burrito.fake>
Lines: 18
X-Mailer: Gnus v5.5/XEmacs 20.4 - "Emerald"

Manoj Srivastava <srivasta@datasync.com> writes:
> 	I also further stated:
>         I was not really suggesting replacing the info documentation
>     (or the man pages, for that matter), I meant in addition to. The
>     policy *does* say that HTML is our preferred format, so it should
>     also be provided

Yes, I mostly agree.  The *source* of the documentation should also be
shipped if possible (i.e., SGML, TeX).  This enables people to patch
documenatation and send in diffs; it also enables them to possibly
format the source into whatever media they like.

One other point which is possibly worth mentioning is that our
suggested format for native debian documentation is debiandoc-sgml.

.....A. P. Harris...apharris@onShore.com...<URL:http://www.onShore.com/>

Post-sig:  Manoj, shouldn't we be CC'ing the BTS for discussion?



<strong>Acknowledgement sent</strong> to <code>apharris@burrito.onshore.com (Adam P. Harris)</code>:<br>
Extra info received and forwarded to list.  Copy sent to <code>Debian Policy List &lt;debian-policy@lists.debian.org&gt;</code>.


-t

From: owner@bugs.debian.org (Debian Bug Tracking System)
To: apharris@burrito.onshore.com (Adam P. Harris)
Subject: Bug#7890: Info received (was {PROPOSAL} #7890: Policy manual contradicts itself about including docs)
Message-ID: <handler.7890.B7890.90644358227457.ackinfo@bugs.debian.org>
In-Reply-To: <oahfy066dk.fsf@burrito.fake>
References: <oahfy066dk.fsf@burrito.fake>
X-Debian-PR-Message: ack-info-maintonly 7890

Thank you for the additional information you have supplied regarding
this problem report.  It has been forwarded to the developer(s) and
to the developers' mailing list to accompany the original report.

Your message has been sent to the package maintainer(s):
 Debian Policy List <debian-policy@lists.debian.org>

If you wish to continue to submit further information on your problem,
please send it to 7890@bugs.debian.org, as before.

Please do not reply to the address at the top of this message,
unless you wish to report a problem with the bug-tracking system.

Ian Jackson
(administrator, Debian bugs database)



Received: (at 7890) by bugs.debian.org; 22 Sep 1998 05:53:02 +0000
Received: (qmail 27454 invoked from network); 22 Sep 1998 05:53:02 -0000
Received: from astor.interport.net (199.184.165.18)
  by master.debian.org with SMTP; 22 Sep 1998 05:53:02 -0000
Received: from burrito.fake (mail@usrts3p202.port.net [207.237.106.202])
	by astor.interport.net (8.8.5/8.8.5) with ESMTP id BAA28240;
	Tue, 22 Sep 1998 01:53:57 -0400 (EDT)
Received: from apharris by burrito.fake with local (Exim 1.92 #1 (Debian))
	id 0zLLNf-0008VT-00; Tue, 22 Sep 1998 01:52:55 -0400
To: debian-policy@lists.debian.org
cc: 7890@bugs.debian.org
Subject: Re: {PROPOSAL} #7890: Policy manual contradicts itself about including docs
References: <871zp4g3fv.fsf@tiamat.datasync.com>
Mime-Version: 1.0 (generated by tm-edit 7.108)
Content-Type: text/plain; charset=US-ASCII
From: apharris@burrito.onshore.com (Adam P. Harris)
Date: 22 Sep 1998 01:52:55 -0400
In-Reply-To: Manoj Srivastava's message of "21 Sep 1998 23:46:12 -0500"
Message-ID: <oahfy066dk.fsf@burrito.fake>
Lines: 18
X-Mailer: Gnus v5.5/XEmacs 20.4 - "Emerald"

Manoj Srivastava <srivasta@datasync.com> writes:
> 	I also further stated:
>         I was not really suggesting replacing the info documentation
>     (or the man pages, for that matter), I meant in addition to. The
>     policy *does* say that HTML is our preferred format, so it should
>     also be provided

Yes, I mostly agree.  The *source* of the documentation should also be
shipped if possible (i.e., SGML, TeX).  This enables people to patch
documenatation and send in diffs; it also enables them to possibly
format the source into whatever media they like.

One other point which is possibly worth mentioning is that our
suggested format for native debian documentation is debiandoc-sgml.

.....A. P. Harris...apharris@onShore.com...<URL:http://www.onShore.com/>

Post-sig:  Manoj, shouldn't we be CC'ing the BTS for discussion?



<strong>Information forwarded</strong> to <code>debian-bugs-dist@lists.debian.org, Debian Policy List &lt;debian-policy@lists.debian.org&gt;</code>:<br>
<code>Bug#7890</code>; Package <code>debian-policy</code>.


debian-bugs-dist@lists.debian.orgDebian Policy List <debian-policy@lists.debian.org>

Subject: Bug#7890: {PROPOSAL} #7890: Policy manual contradicts itself about including docs
Reply-To: karlheg@inetarena.com (Karl M. Hegbloom), 7890@bugs.debian.org
Resent-From: karlheg@inetarena.com (Karl M. Hegbloom)
Resent-To: debian-bugs-dist@lists.debian.org
Resent-CC: Debian Policy List <debian-policy@lists.debian.org>
Resent-Date: Wed, 23 Sep 1998 03:33:02 GMT
Resent-Message-ID: <handler.7890.B7890.90652086410929@bugs.debian.org>
Resent-Sender: iwj@debian.org
X-Debian-PR-Message: report 7890
X-Debian-PR-Package: debian-policy
X-Debian-PR-Keywords: 
X-Loop: owner@bugs.debian.org
Received: via spool by 7890-bugs@bugs.debian.org id=B7890.90652086410929
          (code B ref 7890); Wed, 23 Sep 1998 03:33:02 GMT
To: apharris@burrito.onshore.com (Adam P. Harris)
Cc: debian-policy@lists.debian.org, 7890@bugs.debian.org
References: <871zp4g3fv.fsf@tiamat.datasync.com> <oahfy066dk.fsf@burrito.fake>
X-Face: /Q}=yl}1_v7nP)xXo5XjG8+tl@=uVu7o5u6)f]zN?+<hB!K.m9:[|*p34jVN`O;:XZXVSy>/\R>qDt(t8w!-i{(y0"`jFw^uk8inzO9wXabd'CdjUWfC\GHi:6nO*YC89#-qD>Q4r%9!V"<RYJ=7D#$";q=zML5'!=wvXk^$`6FT=5CMofQX)WUKt0p:OKl.mFOXx/D
Mime-Version: 1.0 (generated by tm-edit 1.1.1.4)
Content-Type: text/plain; charset=US-ASCII
From: karlheg@inetarena.com (Karl M. Hegbloom)
Date: 22 Sep 1998 20:22:16 -0700
In-Reply-To: apharris@burrito.onshore.com's message of "22 Sep 1998 01:52:55 -0400"
Message-ID: <8790jbqzrr.fsf@bittersweet.inetarena.com>
Lines: 15
X-Mailer: Gnus v5.6.43/XEmacs 21.2(beta2) - "Aether-pre5"

>>>>> "Adam" == Adam P Harris <apharris@burrito.onshore.com> writes:

    Adam> Manoj Srivastava <srivasta@datasync.com> writes:
    >> I also further stated: I was not really suggesting replacing
    >> the info documentation (or the man pages, for that matter), I
    >> meant in addition to. The policy *does* say that HTML is our
    >> preferred format, so it should also be provided

    Adam> Yes, I mostly agree.  The *source* of the documentation
    Adam> should also be shipped if possible (i.e., SGML, TeX).  This
    Adam> enables people to patch documenatation and send in diffs; it
    Adam> also enables them to possibly format the source into
    Adam> whatever media they like.

 The source is available in the source package.



<strong>Acknowledgement sent</strong> to <code>karlheg@inetarena.com (Karl M. Hegbloom)</code>:<br>
Extra info received and forwarded to list.  Copy sent to <code>Debian Policy List &lt;debian-policy@lists.debian.org&gt;</code>.


-t

From: owner@bugs.debian.org (Debian Bug Tracking System)
To: karlheg@inetarena.com (Karl M. Hegbloom)
Subject: Bug#7890: Info received (was {PROPOSAL} #7890: Policy manual contradicts itself about including docs)
Message-ID: <handler.7890.B7890.90652086410929.ackinfo@bugs.debian.org>
In-Reply-To: <8790jbqzrr.fsf@bittersweet.inetarena.com>
References: <8790jbqzrr.fsf@bittersweet.inetarena.com>
X-Debian-PR-Message: ack-info-maintonly 7890

Thank you for the additional information you have supplied regarding
this problem report.  It has been forwarded to the developer(s) and
to the developers' mailing list to accompany the original report.

Your message has been sent to the package maintainer(s):
 Debian Policy List <debian-policy@lists.debian.org>

If you wish to continue to submit further information on your problem,
please send it to 7890@bugs.debian.org, as before.

Please do not reply to the address at the top of this message,
unless you wish to report a problem with the bug-tracking system.

Ian Jackson
(administrator, Debian bugs database)



Received: (at 7890) by bugs.debian.org; 23 Sep 1998 03:21:04 +0000
Received: (qmail 10926 invoked from network); 23 Sep 1998 03:21:03 -0000
Received: from bittersweet.inetarena.com (karlheg@206.129.216.38)
  by master.debian.org with SMTP; 23 Sep 1998 03:21:03 -0000
Received: (from karlheg@localhost)
	by bittersweet.inetarena.com (8.9.1/8.9.1/Debian/GNU) id UAA22813;
	Tue, 22 Sep 1998 20:22:16 -0700
To: apharris@burrito.onshore.com (Adam P. Harris)
Cc: debian-policy@lists.debian.org, 7890@bugs.debian.org
Subject: Re: {PROPOSAL} #7890: Policy manual contradicts itself about including docs
References: <871zp4g3fv.fsf@tiamat.datasync.com> <oahfy066dk.fsf@burrito.fake>
X-Face: /Q}=yl}1_v7nP)xXo5XjG8+tl@=uVu7o5u6)f]zN?+<hB!K.m9:[|*p34jVN`O;:XZXVSy>/\R>qDt(t8w!-i{(y0"`jFw^uk8inzO9wXabd'CdjUWfC\GHi:6nO*YC89#-qD>Q4r%9!V"<RYJ=7D#$";q=zML5'!=wvXk^$`6FT=5CMofQX)WUKt0p:OKl.mFOXx/D
Mime-Version: 1.0 (generated by tm-edit 1.1.1.4)
Content-Type: text/plain; charset=US-ASCII
From: karlheg@inetarena.com (Karl M. Hegbloom)
Date: 22 Sep 1998 20:22:16 -0700
In-Reply-To: apharris@burrito.onshore.com's message of "22 Sep 1998 01:52:55 -0400"
Message-ID: <8790jbqzrr.fsf@bittersweet.inetarena.com>
Lines: 15
X-Mailer: Gnus v5.6.43/XEmacs 21.2(beta2) - "Aether-pre5"

>>>>> "Adam" == Adam P Harris <apharris@burrito.onshore.com> writes:

    Adam> Manoj Srivastava <srivasta@datasync.com> writes:
    >> I also further stated: I was not really suggesting replacing
    >> the info documentation (or the man pages, for that matter), I
    >> meant in addition to. The policy *does* say that HTML is our
    >> preferred format, so it should also be provided

    Adam> Yes, I mostly agree.  The *source* of the documentation
    Adam> should also be shipped if possible (i.e., SGML, TeX).  This
    Adam> enables people to patch documenatation and send in diffs; it
    Adam> also enables them to possibly format the source into
    Adam> whatever media they like.

 The source is available in the source package.



<strong>Information forwarded</strong> to <code>debian-bugs-dist@lists.debian.org, Debian Policy List &lt;debian-policy@lists.debian.org&gt;</code>:<br>
<code>Bug#7890</code>; Package <code>debian-policy</code>.


debian-bugs-dist@lists.debian.orgDebian Policy List <debian-policy@lists.debian.org>

Subject: Bug#7890: {PROPOSAL} #7890: Policy manual contradicts itself about including docs
Reply-To: Manoj Srivastava <srivasta@datasync.com>, 7890@bugs.debian.org
Resent-From: Manoj Srivastava <srivasta@datasync.com>
Orignal-Sender: srivasta@datasync.com
Resent-To: debian-bugs-dist@lists.debian.org
Resent-CC: Debian Policy List <debian-policy@lists.debian.org>
Resent-Date: Wed, 23 Sep 1998 18:33:01 GMT
Resent-Message-ID: <handler.7890.B7890.90657549613912@bugs.debian.org>
Resent-Sender: iwj@debian.org
X-Debian-PR-Message: report 7890
X-Debian-PR-Package: debian-policy
X-Debian-PR-Keywords: 
X-Loop: owner@bugs.debian.org
Received: via spool by 7890-bugs@bugs.debian.org id=B7890.90657549613912
          (code B ref 7890); Wed, 23 Sep 1998 18:33:01 GMT
Sender: srivasta@datasync.com
X-Time: Wed Sep 23 13:30:45 1998
X-Mail-System: Vm 6.62 for GNU Emacs 19.34.1
Mail-Copies-To: never
Organization: Manoj Srivastava's Home
To: Adam P Harris <apharris@burrito.onshore.com>, 7890@bugs.debian.org
References: <871zp4g3fv.fsf@tiamat.datasync.com> <oahfy066dk.fsf@burrito.fake>
Mime-Version: 1.0 (generated by tm-edit 7.106)
Content-Type: text/plain; charset=US-ASCII
From: Manoj Srivastava <srivasta@datasync.com>
Date: 23 Sep 1998 13:30:53 -0500
In-Reply-To: apharris@burrito.onshore.com's message of "22 Sep 1998 01:52:55 -0400"
Message-ID: <87r9x2heaq.fsf@tiamat.datasync.com>
Lines: 40
X-Mailer: Gnus v5.6.43/Emacs 19.34

Hi,
>>"Adam" == Adam P Harris <apharris@burrito.onshore.com> writes:

 Adam> Manoj Srivastava <srivasta@datasync.com> writes:
 >> I also further stated:
 >> I was not really suggesting replacing the info documentation
 >> (or the man pages, for that matter), I meant in addition to. The
 >> policy *does* say that HTML is our preferred format, so it should
 >> also be provided

 Adam> Yes, I mostly agree.

	Does that mean you second the proposal? I suggest we implement
 this part of the proposal first, and leave the issue of the source of
 the documentation to another ptoposal, since that is turning out to
 be controversial.

	This proposal has only one second at the moment. I would like
 to see if there are others, and to move the non-controversial part of
 the proposal out of the way.

 Adam> The *source* of the documentation should also be
 Adam> shipped if possible (i.e., SGML, TeX).  This enables people to patch
 Adam> documenatation and send in diffs; it also enables them to possibly
 Adam> format the source into whatever media they like.

	I personally tend to agree, but I think this is grist for
 another proposal. 

	I shall retitle this bug and start the count down as soon as I
 get another second (I am saying that since it seems to me that the
 proposal I submitted is not controversial and can be handled quickly,
 reducing the number of open issues on policy).

	manoj
 not responsible for his sig generator
-- 
 You cannot see the wood for the trees. John Heywood
Manoj Srivastava  <srivasta@acm.org> <http://www.datasync.com/%7Esrivasta/>
Key C7261095 fingerprint = CB D9 F4 12 68 07 E4 05  CC 2D 27 12 1D F5 E8 6E



<strong>Acknowledgement sent</strong> to <code>Manoj Srivastava &lt;srivasta@datasync.com&gt;</code>:<br>
Extra info received and forwarded to list.  Copy sent to <code>Debian Policy List &lt;debian-policy@lists.debian.org&gt;</code>.


-t

From: owner@bugs.debian.org (Debian Bug Tracking System)
To: Manoj Srivastava <srivasta@datasync.com>
Subject: Bug#7890: Info received (was {PROPOSAL} #7890: Policy manual contradicts itself about including docs)
Message-ID: <handler.7890.B7890.90657549613912.ackinfo@bugs.debian.org>
In-Reply-To: <87r9x2heaq.fsf@tiamat.datasync.com>
References: <87r9x2heaq.fsf@tiamat.datasync.com>
X-Debian-PR-Message: ack-info-maintonly 7890

Thank you for the additional information you have supplied regarding
this problem report.  It has been forwarded to the developer(s) and
to the developers' mailing list to accompany the original report.

Your message has been sent to the package maintainer(s):
 Debian Policy List <debian-policy@lists.debian.org>

If you wish to continue to submit further information on your problem,
please send it to 7890@bugs.debian.org, as before.

Please do not reply to the address at the top of this message,
unless you wish to report a problem with the bug-tracking system.

Ian Jackson
(administrator, Debian bugs database)



Received: (at 7890) by bugs.debian.org; 23 Sep 1998 18:31:36 +0000
Received: (qmail 13909 invoked from network); 23 Sep 1998 18:31:34 -0000
Received: from tiamat.datasync.com (root@206.96.246.252)
  by master.debian.org with SMTP; 23 Sep 1998 18:31:34 -0000
Received: (from srivasta@localhost)
	by tiamat.datasync.com (8.9.1a/8.9.1/Debian/GNU) id NAA07515;
	Wed, 23 Sep 1998 13:30:54 -0500
Sender: srivasta@datasync.com
X-Time: Wed Sep 23 13:30:45 1998
X-Mail-System: Vm 6.62 for GNU Emacs 19.34.1
Mail-Copies-To: never
Organization: Manoj Srivastava's Home
To: Adam P Harris <apharris@burrito.onshore.com>, 7890@bugs.debian.org
Subject: Re: {PROPOSAL} #7890: Policy manual contradicts itself about including docs
References: <871zp4g3fv.fsf@tiamat.datasync.com> <oahfy066dk.fsf@burrito.fake>
Mime-Version: 1.0 (generated by tm-edit 7.106)
Content-Type: text/plain; charset=US-ASCII
From: Manoj Srivastava <srivasta@datasync.com>
Date: 23 Sep 1998 13:30:53 -0500
In-Reply-To: apharris@burrito.onshore.com's message of "22 Sep 1998 01:52:55 -0400"
Message-ID: <87r9x2heaq.fsf@tiamat.datasync.com>
Lines: 40
X-Mailer: Gnus v5.6.43/Emacs 19.34

Hi,
>>"Adam" == Adam P Harris <apharris@burrito.onshore.com> writes:

 Adam> Manoj Srivastava <srivasta@datasync.com> writes:
 >> I also further stated:
 >> I was not really suggesting replacing the info documentation
 >> (or the man pages, for that matter), I meant in addition to. The
 >> policy *does* say that HTML is our preferred format, so it should
 >> also be provided

 Adam> Yes, I mostly agree.

	Does that mean you second the proposal? I suggest we implement
 this part of the proposal first, and leave the issue of the source of
 the documentation to another ptoposal, since that is turning out to
 be controversial.

	This proposal has only one second at the moment. I would like
 to see if there are others, and to move the non-controversial part of
 the proposal out of the way.

 Adam> The *source* of the documentation should also be
 Adam> shipped if possible (i.e., SGML, TeX).  This enables people to patch
 Adam> documenatation and send in diffs; it also enables them to possibly
 Adam> format the source into whatever media they like.

	I personally tend to agree, but I think this is grist for
 another proposal. 

	I shall retitle this bug and start the count down as soon as I
 get another second (I am saying that since it seems to me that the
 proposal I submitted is not controversial and can be handled quickly,
 reducing the number of open issues on policy).

	manoj
 not responsible for his sig generator
-- 
 You cannot see the wood for the trees. John Heywood
Manoj Srivastava  <srivasta@acm.org> <http://www.datasync.com/%7Esrivasta/>
Key C7261095 fingerprint = CB D9 F4 12 68 07 E4 05  CC 2D 27 12 1D F5 E8 6E



<strong>Information forwarded</strong> to <code>debian-bugs-dist@lists.debian.org, Debian Policy List &lt;debian-policy@lists.debian.org&gt;</code>:<br>
<code>Bug#7890</code>; Package <code>debian-policy</code>.


debian-bugs-dist@lists.debian.orgDebian Policy List <debian-policy@lists.debian.org>

Subject: Bug#7890: {PROPOSAL} #7890: Policy manual contradicts itself about including docs 
Reply-To: "Adam P. Harris" <apharris@burrito.onshore.com>, 7890@bugs.debian.org
Resent-From: "Adam P. Harris" <apharris@burrito.onshore.com>
Resent-To: debian-bugs-dist@lists.debian.org
Resent-CC: Debian Policy List <debian-policy@lists.debian.org>
Resent-Date: Wed, 23 Sep 1998 19:03:12 GMT
Resent-Message-ID: <handler.7890.B7890.9065772641917@bugs.debian.org>
Resent-Sender: iwj@debian.org
X-Debian-PR-Message: report 7890
X-Debian-PR-Package: debian-policy
X-Debian-PR-Keywords: 
X-Loop: owner@bugs.debian.org
Received: via spool by 7890-bugs@bugs.debian.org id=B7890.9065772641917
          (code B ref 7890); Wed, 23 Sep 1998 19:03:12 GMT
To: Manoj Srivastava <srivasta@datasync.com>
cc: 7890@bugs.debian.org
In-reply-to: Your message of "23 Sep 1998 13:30:53 CDT."
             <87r9x2heaq.fsf@tiamat.datasync.com> 
Date: Wed, 23 Sep 1998 15:00:47 -0400
From: "Adam P. Harris" <apharris@burrito.onshore.com>
Message-Id: <E0zLu9g-000314-00@burrito.fake>


Manoj Srivastava <srivasta@datasync.com> writes:
Adam> Yes, I mostly agree.

> 	Does that mean you second the proposal? I suggest we implement
> this part of the proposal first, and leave the issue of the source
> of the documentation to another ptoposal, since that is turning out
> to be controversial.

> 	This proposal has only one second at the moment. I would like
> to see if there are others, and to move the non-controversial part
> of the proposal out of the way.

Yes, I second.  I agree that the "controversial" part is worthy of
it's own report (and is low priority too).

.....A. P. Harris...apharris@onShore.com...<URL:http://www.onShore.com/>



<strong>Acknowledgement sent</strong> to <code>&quot;Adam P. Harris&quot; &lt;apharris@burrito.onshore.com&gt;</code>:<br>
Extra info received and forwarded to list.  Copy sent to <code>Debian Policy List &lt;debian-policy@lists.debian.org&gt;</code>.


-t

From: owner@bugs.debian.org (Debian Bug Tracking System)
To: "Adam P. Harris" <apharris@burrito.onshore.com>
Subject: Bug#7890: Info received (was {PROPOSAL} #7890: Policy manual contradicts itself about including docs )
Message-ID: <handler.7890.B7890.9065772641917.ackinfo@bugs.debian.org>
In-Reply-To: <E0zLu9g-000314-00@burrito.fake>
References: <E0zLu9g-000314-00@burrito.fake>
X-Debian-PR-Message: ack-info-maintonly 7890

Thank you for the additional information you have supplied regarding
this problem report.  It has been forwarded to the developer(s) and
to the developers' mailing list to accompany the original report.

Your message has been sent to the package maintainer(s):
 Debian Policy List <debian-policy@lists.debian.org>

If you wish to continue to submit further information on your problem,
please send it to 7890@bugs.debian.org, as before.

Please do not reply to the address at the top of this message,
unless you wish to report a problem with the bug-tracking system.

Ian Jackson
(administrator, Debian bugs database)



Received: (at 7890) by bugs.debian.org; 23 Sep 1998 19:01:04 +0000
Received: (qmail 1886 invoked from network); 23 Sep 1998 19:01:03 -0000
Received: from astor.interport.net (199.184.165.18)
  by master.debian.org with SMTP; 23 Sep 1998 19:01:03 -0000
Received: from burrito.fake (mail@usrts5p220.port.net [207.237.108.220])
	by astor.interport.net (8.8.5/8.8.5) with ESMTP id PAA00901;
	Wed, 23 Sep 1998 15:01:51 -0400 (EDT)
Received: from localhost (burrito.fake) [127.0.0.1] (apharris)
	by burrito.fake with esmtp (Exim 1.92 #1 (Debian))
	id 0zLu9g-000314-00; Wed, 23 Sep 1998 15:00:48 -0400
To: Manoj Srivastava <srivasta@datasync.com>
cc: 7890@bugs.debian.org
Subject: Re: {PROPOSAL} #7890: Policy manual contradicts itself about including docs 
In-reply-to: Your message of "23 Sep 1998 13:30:53 CDT."
             <87r9x2heaq.fsf@tiamat.datasync.com> 
Date: Wed, 23 Sep 1998 15:00:47 -0400
From: "Adam P. Harris" <apharris@burrito.onshore.com>
Message-Id: <E0zLu9g-000314-00@burrito.fake>


Manoj Srivastava <srivasta@datasync.com> writes:
Adam> Yes, I mostly agree.

> 	Does that mean you second the proposal? I suggest we implement
> this part of the proposal first, and leave the issue of the source
> of the documentation to another ptoposal, since that is turning out
> to be controversial.

> 	This proposal has only one second at the moment. I would like
> to see if there are others, and to move the non-controversial part
> of the proposal out of the way.

Yes, I second.  I agree that the "controversial" part is worthy of
it's own report (and is low priority too).

.....A. P. Harris...apharris@onShore.com...<URL:http://www.onShore.com/>