Re: Location of -doc documentation?

2000-12-26 Thread Joey Hess
Nathan E Norman wrote:
 http://.../doc/apache;, while `debconf-doc' puts it under
 http://.../debconf-doc/;. 
 
 I beleive the original point was that debconf-doc places its
 documentation in /usr/share/doc/debconf-doc, while apache-doc places
 its documentation in /usr/share/doc/apache, rather than
 /usr/share/doc/apache-doc.  (Principle of least surprise, I suppose).

Oh, then he was missing a /doc'.

I suppose debconf-doc could do that. Except it includes an expanded
changelog.Debian.gz file (35k).

-- 
see shy jo




Re: Location of -doc documentation?

2000-12-26 Thread Nathan E Norman
On Mon, Dec 25, 2000 at 11:35:06PM -0800, Joey Hess wrote:
 Nathan E Norman wrote:
  http://.../doc/apache;, while `debconf-doc' puts it under
  http://.../debconf-doc/;. 
  
  I beleive the original point was that debconf-doc places its
  documentation in /usr/share/doc/debconf-doc, while apache-doc places
  its documentation in /usr/share/doc/apache, rather than
  /usr/share/doc/apache-doc.  (Principle of least surprise, I suppose).
 
 Oh, then he was missing a /doc'.
 
 I suppose debconf-doc could do that. Except it includes an expanded
 changelog.Debian.gz file (35k).

I'm not willing to argue that one way is better than the other :) on
the one hand, I'd expect the docs to be in a directory named after the
package containing the docs.  On the other hand apache and IIRC bind
put docs in the package directory rather than package-doc, so I've
grown accustomed to this as well.

Consistency would be nice, but I don't think this is a huge issue,
especially given other issues facing the project at this time.

Regards,

-- 
Nathan Norman - Staff Engineer | A good plan today is better
Micromuse Inc. | than a perfect plan tomorrow.
mailto:[EMAIL PROTECTED]   |   -- Patton


pgpPaTcDJjJaW.pgp
Description: PGP signature


Re: Location of -doc documentation?

2000-12-26 Thread Karl M. Hegbloom
 Joey == Joey Hess [EMAIL PROTECTED] writes:

Joey Karl M. Hegbloom wrote:

 I just noticed that `apache-doc' puts the documentation under
 http://.../doc/apache;, while `debconf-doc' puts it under
 http://.../debconf-doc/;. 

Joey Eh? (Debconf-doc is a package, that contains some documentation files.
Joey It doesn't touch the web space at all.)

  s,/debconf-doc/,/doc/debconf-doc/,




Re: Location of -doc documentation?

2000-12-25 Thread Joey Hess
Karl M. Hegbloom wrote:
  I just noticed that `apache-doc' puts the documentation under
  http://.../doc/apache;, while `debconf-doc' puts it under
  http://.../debconf-doc/;. 

Eh? (Debconf-doc is a package, that contains some documentation files.
It doesn't touch the web space at all.)

-- 
see shy jo




Re: Location of -doc documentation?

2000-12-25 Thread Arthur Korn
Joey Hess schrieb:
 Karl M. Hegbloom wrote:
   I just noticed that `apache-doc' puts the documentation under
   http://.../doc/apache;, while `debconf-doc' puts it under
   http://.../debconf-doc/;. 
 
 Eh? (Debconf-doc is a package, that contains some documentation files.
 It doesn't touch the web space at all.)

Well, it touches /usr/doc, and /etc/apache/srm.conf has an Alias
/doc/ /usr/doc/. HTH

ciao, 2ri




Re: Location of -doc documentation?

2000-12-25 Thread Nathan E Norman
On Mon, Dec 25, 2000 at 11:48:32PM +0100, Arthur Korn wrote:
 Joey Hess schrieb:
  Karl M. Hegbloom wrote:
I just noticed that `apache-doc' puts the documentation under
http://.../doc/apache;, while `debconf-doc' puts it under
http://.../debconf-doc/;. 
  
  Eh? (Debconf-doc is a package, that contains some documentation files.
  It doesn't touch the web space at all.)
 
 Well, it touches /usr/doc, and /etc/apache/srm.conf has an Alias
 /doc/ /usr/doc/. HTH

I beleive the original point was that debconf-doc places its
documentation in /usr/share/doc/debconf-doc, while apache-doc places
its documentation in /usr/share/doc/apache, rather than
/usr/share/doc/apache-doc.  (Principle of least surprise, I suppose).

Cheers,

-- 
Nathan Norman - Staff Engineer | A good plan today is better
Micromuse Inc. | than a perfect plan tomorrow.
mailto:[EMAIL PROTECTED]   |   -- Patton


pgp1nRNDcdfpa.pgp
Description: PGP signature