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

Bug#147201: Bug#345628: man page documents faulty default



On Tuesday 03 January 2006 04:16, you wrote:
> On Mon, Jan 02, 2006 at 05:03:44PM +0100, cobaco (aka Bart Cornelis) 
wrote:
> > On Monday 02 January 2006 16:36, you wrote:
> > > On Mon, Jan 02, 2006 at 01:27:08PM +0200, cobaco (aka Bart Cornelis)

> > What suprised me is not the precedence order (that's clear to me,
> > though adding something about it won't hurt), but that the
> > documentation doesn't describe the out-of-the-box situation (i.e. even
> > though I haven't changed anything the documentation doesn't describe
> > the actual situation)
> >
> > So maybe add a section to the man-page saying something like
> > "the debian ssh package ships with the following non-default settings:
> > - option A set to X
> > - option B set to Y
>
> Probably easier and more effective to add a line or two to the
> conffiles /etc/ssh/ssh{d,}_config;
>
> Instead of:
>
> # Package generated configuration file
>
> use
>
> # This file overrides the internal defaults of the ssh{d,} executable.
> # Environment variables and commandline arguments override the values
> # here.
>
> Would this satisfy your request?
not really:
- the preference order between the settings is (and was) clear
- what surprised me was that the man page describes the upstream, builtin
  defaults instead of the ones the Debian package ships with (and I expected
  the documentation to describe the shipped situation).

  To be fair the documentation does say that /etc/ssh/sshd_config
  overwrites the defaults. Its just that I hadn't changed that file and thus
  didn't expect to have to go check it also.
-- 
Cheers, cobaco (aka Bart Cornelis)
  
1. Encrypted mail preferred (GPG KeyID: 0x86624ABB)
2. Plain-text mail recommended since I move html and double
    format mails to a low priority folder (they're mainly spam)

Attachment: pgpUHFupUUw78.pgp
Description: PGP signature


Reply to: