Note: This bug is displayed in read-only format because the product is no longer active in Red Hat Bugzilla.

Bug 1061456

Summary: postgresql92 meta package should include LICENSE, README and postgresql92 man page files
Product: Red Hat Software Collections Reporter: Honza Horak <hhorak>
Component: postgresqlAssignee: Jozef Mlich <jmlich>
Status: CLOSED ERRATA QA Contact: Jakub Prokes <jprokes>
Severity: unspecified Docs Contact:
Priority: unspecified    
Version: postgresql92CC: databases-maint, drieden, hhorak, jmlich, jprokes
Target Milestone: beta   
Target Release: 1.1   
Hardware: Unspecified   
OS: Unspecified   
Whiteboard:
Fixed In Version: postgresql92-1.1-19.el6 Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2014-06-04 06:44:56 UTC Type: ---
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: ---
oVirt Team: --- RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: --- Target Upstream Version:
Embargoed:
Bug Depends On:    
Bug Blocks: 1061439, 1082031    
Attachments:
Description Flags
README template with some grammar corrections
none
README template with some grammar corrections none

Description Honza Horak 2014-02-04 21:04:58 UTC
Meta package of postgresql92 software collection should include the following files:
* LICENSE file with proper license text for meta package's license
* README file with postgresql92 collection description, usage and examples
* postgresql92.7 man page, which is located under /opt/rh and contains information related to postgresql92 collection -- description, usage and examples

The tracking bug 1061439 proposes a generic way how to use RPM macros in the README file, how such file can be structured and also cointains an example how to generate the man page from such a README file. See bug 1061439 for more information.

Proposed content of the README file, generated for postgresql92 collection (please check and change things specific for postgresql92 collection), where RPM macros are used (see tracking bug 1061439 how to expand them in the spec file):
------------------------------------------
Package %{scl_name} provides PostgreSQL database management system delivered using Software
Collections concept. For more information about Software Collections
concept, read scl(1). By installing %{scl_name} collection, you will get
the minimum working set of packages to have working PostgreSQL database management system.

Usage: scl enable %{scl} 'psql'

Software Collections concept allows to build and execute applications
which are not located in the filesystem root hierarchy but are present
in an alternative location, which is %{scl_prefix}
in case of %{scl_name} collection.

PostgreSQL is an advanced Object-Relational database management system (DBMS).
The postgresql-server package contains the programs needed to create
and run a PostgreSQL server, which will in turn allow you to create
and maintain PostgreSQL databases.

When working with %{scl_name} collection, use scl utility (see scl(1)
for usage) to enable scl environment properly.

Configuration for the %{scl_name} software collection is located under %{_sysconfdir}.

Examples:
scl enable %{scl_name} 'command --arg'
  Run a specific command with argument --arg within %{scl_name} software collections
  environment.

scl enable %{scl_name} 'psql'
  Run psql from %{scl_name} software collection.

scl enable %{scl_name} bash
  Run interactive shell where %{scl_name} software collection is enabled.

scl enable %{scl_name} 'man psql'
  Show man pages for psql command, which is part of the %{scl_name} software
  collection.

Comment 2 Honza Horak 2014-02-10 20:25:49 UTC
FYI, tracking bug #1061439 now contains adjusted and a bit simplified patch to generate man page from the README file attached here.

After discussion, it seems better to generate the man page in %build section, provide meaningful version in the man page and include notice about reporting bugs.

It was also agreed that the version of meta package should correspond with version of the RHSCL.

Comment 3 Honza Horak 2014-02-12 15:23:03 UTC
Created attachment 862378 [details]
README template with some grammar corrections

There were some grammar issues in the original README template. This is a grammar correction of the general README template from Petr Kovar:
http://etherpad.corp.redhat.com/XYVrBLTLow

And README template for postgresql92 is attached.

Comment 4 Honza Horak 2014-02-12 15:55:40 UTC
Created attachment 862401 [details]
README template with some grammar corrections

Few grammar fixes more.

Comment 13 errata-xmlrpc 2014-06-04 06:44:56 UTC
Since the problem described in this bug report should be
resolved in a recent advisory, it has been closed with a
resolution of ERRATA.

For information on the advisory, and where to find the updated
files, follow the link below.

If the solution does not work for you, open a new bug report.

http://rhn.redhat.com/errata/RHBA-2014-0616.html