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

Re: Opt out style recommends

Wookey wrote:
> +++ Josh Triplett [2016-04-08 10:31 -0700]:
> > I wonder if debian-policy section 12 should talk about the desired
> > package relationship between <package> and <package>-doc? 
> The world has changed since the policy was originally written. I do
> like to have -doc package for most things installed and find it
> very annoying that often the 'help' in an app just takes you to a
> web-page somewhere, which is particulaly galling when you have no net
> connection, or only an expensive one.

If the app has a help option or built-in help, then the help should
absolutely be a Recommends.

> But I agree that this is now the exception rather than the norm and a
> lot of the time recommends for a second copy of the docs is too strong.
> >  For instance,
> > "If <package> is a build tool, command-line tool, or library, <package>
> > already provides documentation in man, info, or text format, and
> > <package>-doc provides HTML or other formats, <package> should have a
> > 'Suggests: <package>-doc'.  Otherwise, <package> should have a
> > 'Recommends: <package>-doc'."
> That seems a sensible default position.

Would you be willing to make this Policy proposal on my behalf?  IANADD.

- Josh Triplett

Reply to: