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  
 /pre/blockquote
 
  p
 +Additionally, some packages provide configuration and other 
 +information in a file located in i/usr/local/share/docs/pkg-readmes/i.
 +p
  Let us now continue with an example of a package which has dependencies:
 
  blockquotepre
 




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 /pre/blockquote
 
 p +Additionally, some packages provide configuration and other 
 +information in a file located in
 i/usr/local/share/docs/pkg-readmes/i. +p Let us now continue
 with an example of a package which has dependencies:
 
 blockquotepre