Mantis - pkg_get
Viewing Issue Advanced Details
2971 other major always 2008-12-16 23:13 2012-06-24 07:22
kapilt  
phil  
normal  
closed  
not fixable  
none    
none  
0002971: No installation instructions
tried to get past the fork literature, and get on with using opencsw. however there are no docs on how to actually install pkg-get. the user manual completely skips it. seems like a a great way to attrition your user base to zero. seriously, if you want people to use this stuff, you should document how to install it.
Issue History
2008-12-16 23:13 kapilt New Issue
2008-12-19 17:09 phil Status new => assigned
2008-12-19 17:09 phil Assigned To => phil
2008-12-19 17:11 phil Note Added: 0005473
2009-02-27 18:09 philadmin Note Added: 0005584
2009-02-27 18:09 philadmin Status assigned => resolved
2009-02-27 18:09 philadmin Resolution open => not fixable
2009-02-27 18:15 philadmin Status resolved => closed
2009-02-28 19:27 kapilt Note Added: 0005592
2009-02-28 19:27 kapilt Status closed => feedback
2009-02-28 19:27 kapilt Resolution not fixable => reopened
2009-03-09 09:08 user2169 Note Added: 0005611
2009-03-09 17:21 phil Note Added: 0005613
2009-03-10 09:12 user2169 Note Added: 0005617
2012-06-24 07:22 phil Status feedback => closed
2012-06-24 07:22 phil Resolution reopened => not fixable

Notes
(0005473)
phil   
2008-12-19 17:11   
There IS documentation on how to install. However, perhaps you followed a path that did not lead you to the docs.

What "user manual" are you referring to, that does not tell you how to install it?

when you say "manual", I think "Man page". however, if you are reading the manpage, then isnt it already installed? :-)
(0005584)
philadmin   
2009-02-27 18:09   
user unresponsive as to specific needs. closing after 3 months.
(0005592)
kapilt   
2009-02-28 19:27   
okay, say i come to the opencsw.org site, and i want to use opencsw. nothing obvious on the home page. so i click on the next obvious link. the user guide link. i get a documentation page without any information on how to actual install opencsw, just how to use it.
(0005611)
user2169   
2009-03-09 09:08   
I think kapilt means that opencsw.org should have a page similar to http://www.blastwave.org/howto.html [^] - that is, a page which explains how to install pkg-get. In other words, instructions how to get started with opencsw.org with no previous knowledge of it.

I'd suggest putting on the main page, http://www.opencsw.org/, [^] something along the lines of:

-----------------------------------------------------------------------
pkgadd -d http://www.ibiblio.org/pub/solaris/opencsw/pkg_get.pkg [^] all
echo >> /etc/opt/csw/pkg-get.conf \
  "url=ftp://ftp.heanet.ie/pub/opencsw/current/" [^]
pkg-get -U
pkg-get -i vim
-----------------------------------------------------------------------
(0005613)
phil   
2009-03-09 17:21   
I updated things a bit. Please let me know if this helps enough.
Hopefully, the front page is a bit more blatant about "go read this page" now.
(0005617)
user2169   
2009-03-10 09:12   
The new sentence on the front page, "Please see the pkg-get page for details on how to get started with it" definitely helps. If there was an "Installation" header in front of it, it would be even better!