add basic manpages for sgml.conf(5) and sgmlwhich(1) (#1612272)

sgml-common.spec

@@ -2,7 +2,7 @@
 
 Name: sgml-common
 Version: 0.6.3
-Release: 50%{?dist}
+Release: 51%{?dist}
 Group: Applications/Text
 
 Summary: Common SGML catalog and DTD files
@@ -26,6 +26,8 @@ Source5: http://www.w3.org/%{xmlxsdver}/xml.xsd
 Source6: http://www.w3.org/TR/xmldsig-core/xmldsig-core-schema.xsd
 Source7: http://www.w3.org/2001/XMLSchema.dtd
 Source8: http://www.w3.org/2001/datatypes.dtd
+Source9: sgmlwhich.1
+Source10: sgml.conf.5
 
 Patch0: sgml-common-umask.patch
 Patch1: sgml-common-xmldir.patch
@@ -128,6 +130,10 @@ install -p -m0644 %{SOURCE1} %{SOURCE2} %{SOURCE3} %{SOURCE4} \
 rm -rf $RPM_BUILD_ROOT%{_datadir}/xml/*
 install -p -m0644 %{SOURCE5} %{SOURCE6} %{SOURCE7} %{SOURCE8} \
 	$RPM_BUILD_ROOT%{_datadir}/xml
+mkdir -p $RPM_BUILD_ROOT%{_mandir}/man1
+mkdir -p $RPM_BUILD_ROOT%{_mandir}/man5
+install -p -m0644 %{SOURCE9} $RPM_BUILD_ROOT%{_mandir}/man1
+install -p -m0644 %{SOURCE10} $RPM_BUILD_ROOT%{_mandir}/man5
 
 # remove installed doc file and prepare installation with %%doc
 rm $RPM_BUILD_ROOT%{_datadir}/doc/*.html
@@ -171,6 +177,8 @@ fi
 %{_bindir}/sgmlwhich
 %{_bindir}/install-catalog
 %{_mandir}/man8/install-catalog.8*
+%{_mandir}/man1/sgmlwhich.1*
+%{_mandir}/man5/sgml.conf.5*
 
 %files -n xml-common
 %doc AUTHORS NEWS ChangeLog COPYING README
@@ -189,6 +197,9 @@ fi
 %{_datadir}/xml/datatypes.dtd
 
 %changelog
+* Fri Oct 05 2018 Ondrej Vasik <ovasik@redhat.com> - 0.6.3-51
+- add basic manpages for sgml.conf(5) and sgmlwhich(1) (#1612272)
+
 * Sat Jul 14 2018 Fedora Release Engineering <releng@fedoraproject.org> - 0.6.3-50
 - Rebuilt for https://fedoraproject.org/wiki/Fedora_29_Mass_Rebuild
 

sgml.conf.5

@@ -0,0 +1,40 @@
+.TH SGML.CONF 5
+.\" NAME should be all caps, SECTION should be 1-8, maybe w/ subsection
+.\" other parms are allowed: see man(7), man(1)
+.SH NAME
+sgml.conf \- basic configuration file for SGML environment variables
+
+.SH "DESCRIPTION"
+This file contains basic variables for SGML environment.
+.HP
+Format of this file is straightforward:
+
+- Lines are either empty lines, comment lines (starting with hash mark) or variable assignments.
+
+- Assigments take form of "variable=value" where whitespace is not allowed. This makes the format Bourne-shell includable.
+
+.SH "VARIABLES"
+.TP
+.B SGML_BASE_DIR
+This variable contains root of the location of sgml components. Suggested value for this variable is /usr/share/sgml.
+.TP
+.B SGML_CATALOGS_DIRS
+This variable contains location of sgml catalog files. Suggested value is /etc/sgml.
+.TP
+.B SGML_EXTRA_BASE_DIRS
+This variable contains the directory name(s) of the root of the location(s) of optional sgml components that the system administrator doesn't want to install to primary SGML_BASE_DIR directory. If multiple directory names are mentioned, they are separated by colons.
+.TP
+.B SGML_BIN_DIR
+This variable contains the directory where executables should be placed. By default /usr/bin.
+.TP
+.B SGML_EXTRA_BIN_DIRS
+This variable contains the directory name(s) where optional executables can be placed. Suggested and default value is /usr/local/bin. If multiple directory names are mentioned, they are separated by colons.
+.TP
+.B SGML_TMP_DIR
+A hint to components where to put temporary files. The suggested and default value is /tmp.
+.TP
+.B SGML_POSTINSTALL_CMD
+A command that is to be executed when new components have been installed. This mechanism is not used by default, sgml components are usually registered by %post scriptlets.
+.SH "SEE ALSO"
+.\" Always quote multiple words for .SH
+.BR xsltproc (1)

sgmlwhich.1

@@ -0,0 +1,21 @@
+.TH SGMLWHICH 1
+.\" NAME should be all caps, SECTION should be 1-8, maybe w/ subsection
+.\" other parms are allowed: see man(7), man(1)
+.SH NAME
+sgmlwhich \- prints location of main sgml configuration file
+.SH SYNOPSIS
+.B sgmlwhich
+
+.SH "DESCRIPTION"
+Simple script which prints location of main sgml configuration file.
+It is provided for consistency with non-LSB platforms.
+
+.SH OPTIONS
+Script doesn't accept any options.
+
+.SH "SEE ALSO"
+.\" Always quote multiple words for .SH
+.BR sgml.conf (5)
+
+.SH AUTHOR
+Eric Bischoff <eric@caldera.de>