kernel-source/kernel-docs.spec

#
# spec file for package kernel-docs
#
# Copyright (c) 2017 SUSE LINUX GmbH, Nuernberg, Germany.
#
# All modifications and additions to the file contributed by third parties
# remain the property of their copyright owners, unless otherwise agreed
# upon. The license for this file, and modifications and additions to the
# file, is the same license as for the pristine package itself (unless the
# license for the pristine package is not an Open Source License, in which
# case the license is the MIT License). An "Open Source License" is a
# license that conforms to the Open Source Definition (Version 1.9)
# published by the Open Source Initiative.

# Please submit bugfixes or comments via http://bugs.opensuse.org/
#


%define patchversion 4.10.8
%define variant %{nil}

%include %_sourcedir/kernel-spec-macros

%define use_fop	1

%if %{?is_opensuse}
%define use_sphinx 1
%else
%define use_sphinx 0
%endif

# copy the whole tree to generate some images (sigh...)
%define local_copy 1
%if %local_copy
%define linux_src .
%else
%define linux_src /usr/src/linux%variant
%define make_arg "-C %linux_src"
%endif

Name:           kernel-docs
Summary:        Kernel Documentation (man pages)
License:        GPL-2.0
Group:          Documentation/Man
Version:        4.10.8
%if 0%{?is_kotd}
Release:        <RELEASE>.gea9dcd4
%else
Release:        0
%endif
BuildRequires:  kernel-source%variant
%if %use_sphinx
BuildRequires:  graphviz
BuildRequires:  python-Sphinx
# rst2pdf is broken with Sphinx 1.3.x, so disabled for now
# BuildRequires:  python-rst2pdf
%endif
BuildRequires:  xmlto
%if %use_fop
BuildRequires:  fop
%else
BuildRequires:  docbook-toys
BuildRequires:  docbook-utils
BuildRequires:  texlive-courier
BuildRequires:  texlive-dvips
BuildRequires:  texlive-ec
BuildRequires:  texlive-helvetic
BuildRequires:  texlive-jadetex
BuildRequires:  texlive-times
%endif
Url:            http://www.kernel.org/
Provides:       %name = %version-%source_rel
BuildArch:      noarch
BuildRoot:      %{_tmppath}/%{name}-%{version}-build
Source:         kernel-spec-macros

%description
These are the man pages (section 9) built from the current kernel sources.

%source_timestamp

%package pdf
Summary:        Kernel Documentation (PDF)
Group:          Documentation/Other

%description pdf
These are PDF documents built from the current kernel sources.

%source_timestamp

%package html
Summary:        Kernel Documentation (HTML)
Group:          Documentation/HTML

%description html
These are HTML documents built from the current kernel sources.

%source_timestamp

%prep
%if !%use_fop
cp -av /etc/texmf/web2c/texmf.cnf .
cat << EOF >> texmf.cnf
main_memory.pdfjadetex = 5000000
hash_extra.pdfjadetex = 140000
max_strings.pdfjadetex = 240000
save_size.pdfjadetex = 20000
EOF
%endif
%setup -T -c
%if %local_copy
# FIXME: need to copy locally to generate some images...
cp -a /usr/src/linux%variant/* .
%endif

%build
%if !%use_fop
# use texmf.cnf from local source
export TEXMFCNF=$RPM_BUILD_DIR
%endif
export LANG=en_US
mkdir -p man
make %{?make_arg} O=$PWD/man mandocs %{?jobs:-j%jobs}
mkdir -p html
make %{?make_arg} O=$PWD/html htmldocs
mkdir -p pdf
make \
%if %use_fop
    XMLTOFLAGS="-m %linux_src/Documentation/DocBook/stylesheet.xsl --skip-validation --with-fop" \
%endif
  %{?make_arg} O=$PWD/pdf pdfdocs

%install
install -d $RPM_BUILD_ROOT/%{_mandir}/man9
# filter out obscure device drivers - they clutter up the rpm and don't add any real value
find man/Documentation/DocBook/ -name '*.9.gz' | 
grep -E -v 'man/(sis[69]|rio|fsl|struct_rio|RIO|mpc85|set_rx_mode|mdio_(read|write)|mii_ioctl|mca_|z8530|nand|sppp|piix|(read|write)_zs)' |  
while read i ; do
	cp $i $RPM_BUILD_ROOT/%{_mandir}/man9
done
if [ -d man/Documentation/kdb ] ; then
    for i in man/Documentation/kdb/*.m* ; do
	k=`basename $i`
	k=${k/man/9}
	k=${k/mm/9}
	cp $i $RPM_BUILD_ROOT/%{_mandir}/man9/$k
    done
fi

ln -s %{_mandir}/man9/request_threaded_irq.9.gz $RPM_BUILD_ROOT%{_mandir}/man9/request_irq.9.gz

install -d $RPM_BUILD_ROOT%{_datadir}/doc/kernel/pdf
cp -a pdf/Documentation/DocBook/*.pdf $RPM_BUILD_ROOT%{_datadir}/doc/kernel/pdf || true
%if %use_sphinx
# copy PDF files generated by sphinx (once when it really works...)
for i in pdf/Documentation/output/*.pdf; do
    test -s $i && cp -a $i $RPM_BUILD_ROOT%{_datadir}/doc/kernel/pdf
done
%endif

install -d $RPM_BUILD_ROOT%{_datadir}/doc/kernel/html/DocBook
cp -a html/Documentation/DocBook/* $RPM_BUILD_ROOT%{_datadir}/doc/kernel/html/DocBook || true
rm -f $RPM_BUILD_ROOT%{_datadir}/doc/kernel/html/DocBook/*.xml
rm -f $RPM_BUILD_ROOT%{_datadir}/doc/kernel/html/DocBook/*.db
rm -f $RPM_BUILD_ROOT%{_datadir}/doc/kernel/html/DocBook/*.{gif,png}
rm -f $RPM_BUILD_ROOT%{_datadir}/doc/kernel/html/DocBook/*/*.proc
install -d $RPM_BUILD_ROOT%{_datadir}/doc/kernel/html/rst
%if %use_sphinx
cp -a html/Documentation/output/* $RPM_BUILD_ROOT%{_datadir}/doc/kernel/html/rst || true
%endif

%if !%local_copy
cp -a %linux_src/{COPYING,CREDITS,MAINTAINERS,README} .
%endif

%files
%defattr(-,root,root)
%doc COPYING CREDITS MAINTAINERS README
%{_mandir}/man9/*

%files pdf
%defattr(-,root,root)
%dir %{_datadir}/doc/kernel
%docdir %{_datadir}/doc/kernel/pdf
%{_datadir}/doc/kernel/pdf

%files html
%defattr(-,root,root)
%dir %{_datadir}/doc/kernel
%docdir %{_datadir}/doc/kernel/html
%{_datadir}/doc/kernel/html

%changelog