Re: [EXTERNAL] Re: Mention pkg-readmes in FAQ

2015-04-26 Thread Nick Holland
On 04/26/15 10:14, Eichert, Diana wrote:
> Point taken, but what about a readme associated with a dependency
> install?  I've seen them buried, even scroll off screen, in pkg
> install with a lot of dependencies.

that's why I added it.

> Then again, most people don't RTFM.

that's why I don't expect to change the world. :)

Nick.

> 
> 
> -Original Message- From: owner-t...@openbsd.org
> [mailto:owner-t...@openbsd.org] On Behalf Of Stuart Henderson Sent:
> Saturday, April 25, 2015 10:07 AM To: trondd Cc: tech@openbsd.org 
> Subject: [EXTERNAL] Re: Mention pkg-readmes in FAQ
> 
> On 2015/04/25 11:21, trondd wrote:
>> Seems like I see a lot of people who don't know about pkg-readmes
>> and it was a long time before I knew about them, too. Note their
>> existence in the package/ports FAQ.
> 
> I don't object to it, but when you install a package with such
> information, it says:
> 
> # pkg_add xl2tpd quirks-2.66 signed on 2015-04-23T10:51:49Z 
> xl2tpd-1.3.1p5: ok The following new rcscripts were installed:
> /etc/rc.d/xl2tpd See rcctl(8) for details. Look in
> /usr/local/share/doc/pkg-readmes for extra documentation.
> 
> If people don't manage to find it when it's right in front of them,
> what hope is there of them noticing it in the FAQ?
> 
>> --- faq15.html  27 Feb 2015 09:16:26 -  1.105 +++
>> faq15.html  25 Apr 2015 15:18:01 - @@ -370,6 +370,9 @@ scaled.
>> Below is the relevant section fr 
>> 
>>  +Additionally, some packages provide configuration and other 
>> +information in a file located in
>> /usr/local/share/docs/pkg-readmes. + Let us now continue
>> with an example of a package which has dependencies:
>> 
>> 
>> 
> 



Re: [EXTERNAL] Re: Mention pkg-readmes in FAQ

2015-04-26 Thread Eichert, Diana
Point taken, but what about a readme associated with a dependency install?  
I've seen them buried, even scroll off screen, in pkg install with a lot of 
dependencies.

Then again, most people don't RTFM.



-Original Message-
From: owner-t...@openbsd.org [mailto:owner-t...@openbsd.org] On Behalf Of 
Stuart Henderson
Sent: Saturday, April 25, 2015 10:07 AM
To: trondd
Cc: tech@openbsd.org
Subject: [EXTERNAL] Re: Mention pkg-readmes in FAQ

On 2015/04/25 11:21, trondd wrote:
> Seems like I see a lot of people who don't know about pkg-readmes and 
> it was a long time before I knew about them, too. Note their existence 
> in the package/ports FAQ.

I don't object to it, but when you install a package with such information, it 
says:

# pkg_add xl2tpd
quirks-2.66 signed on 2015-04-23T10:51:49Z
xl2tpd-1.3.1p5: ok
The following new rcscripts were installed: /etc/rc.d/xl2tpd See rcctl(8) for 
details.
Look in /usr/local/share/doc/pkg-readmes for extra documentation.

If people don't manage to find it when it's right in front of them, what hope 
is there of them noticing it in the FAQ?

> --- faq15.html  27 Feb 2015 09:16:26 -  1.105
> +++ faq15.html  25 Apr 2015 15:18:01 -
> @@ -370,6 +370,9 @@ scaled. Below is the relevant section fr  
> 
> 
>  
> +Additionally, some packages provide configuration and other 
> +information in a file located in /usr/local/share/docs/pkg-readmes.
> +
>  Let us now continue with an example of a package which has dependencies:
> 
>  
>