[csw-maintainers] Buildfarm setup - documentation

[Peter FELECAN]

Laurent Blume <laurent at opencsw.org> writes:

> On 04/10/2013 15:18, Peter FELECAN wrote:
Unfortunately you omitted to cite/read what Maciej said:

>> The rest is taken care of by the postinstall script. The database
>> daemon is running and you can connect as the root user.

>> It is not taken care. This is why I'm whining:
>
> Would you please explain what you are referring to?

Aside of what Maciej incorrectly assume, i.e. that the postinstall
script takes care of that, I'm refering to the incorrect message
displayed by the postinstall script:

###  The following messages are from
/var/sadm/pkg/CSWmysql5/install/postinstall.
See /opt/csw/mysql5/share/mysql/doc/README.CSW for packaging changes.
Please ignore references to starting mysqld_safe in the messages above.
  These messages are from mysql_install_db.  See the following
  for starting CSWmysql5.

- the file /opt/csw/mysql5/share/mysql/doc/README.CSW does not exist
- the message does not help someone who installs this, on the contrary
  it sows confusion

> I saw your bug about
> some incorrect old changelog files, I'm cleaning that up.

Read again the issue's rapport. The changelog is a qualification for
what I found in the documentation directory. In general the README.CSW
contains specific instructions for configuring and running our package
when things are different from what people get elsewhere. Those wo
suypply a changelog just name it like that, i.e. ChangeLog.

> But I would not qualify that as «major» in any way, as it's not
> preventing anything. Removing a couple of old files and changing the
> directories of others will wait until 5.5.35.

The qualification is subjective isn't it? I feel it as major because
it's not only non useful but also misleading.

> As for the docs, everything MySQL provides is included, so feel free to
> open a bug upstream if that's a problem with you. Personnally, I use
> Google to search their website.
>
>> # svcs -l svc:/network/cswmysql5:default
>> fmri         svc:/network/cswmysql5:default
>> enabled      false
>> state        disabled
>> next_state   none
>> state_time   Fri Oct 04 12:17:34 2013
>> restarter    svc:/system/svc/restarter:default
>> dependency   require_all/none svc:/system/filesystem/local (online)
>> dependency   require_all/none svc:/network/loopback (online)
>> bash-3.2# svcs -l svc:/network/cswmysql5:default
>> fmri         svc:/network/cswmysql5:default
>> enabled      false
>> state        disabled
>> next_state   none
>> state_time   Fri Oct 04 12:17:34 2013
>> restarter    svc:/system/svc/restarter:default
>> dependency   require_all/none svc:/system/filesystem/local (online)
>> dependency   require_all/none svc:/network/loopback (online)
>
> I have no clue what's supposed to be wrong in those lines. Can you point
> it out?

Nothing. It was included only to show that the postinstall script has
not take care of something. And I'm not saying that it should.

-- 
Peter