Publican Documentation Packages

Package naming convention

Proposed: Documentation packages be named with version numbering in the package name to allow parallel installation of multiple versions.

Example: fedora-security-guide-11-en-US

Rationale: There are several use cases where installing multiple versions of documentation on the same system is desirable.

See:

• https://bugzilla.redhat.com/show_bug.cgi?id=476471#c57
• https://www.redhat.com/archives/fedora-docs-list/2009-March/msg00154.html

Desktop .spec file

Proposed: Allow the Desktop entry to be included inline in the %install section of the .spec file rather than requiring it as a separate file.

Example:

%install
rm -rf $RPM_BUILD_ROOT
mkdir -p $RPM_BUILD_ROOT%{_datadir}/applications

cat > %{name}.desktop <<'EOF'
[Desktop Entry]
Name=fedora 11: security-guide
Comment=A Guide to Securing Fedora Linux
Exec=%{viewer} %{_docdir}/%{name}-%{version}/index.html
Icon=%{_docdir}/%{name}-%{version}/images/icon.svg
Categories=Documentation;X-Red-Hat-Base;
Type=Application
Encoding=UTF-8
Terminal=false
EOF

See:

• https://bugzilla.redhat.com/show_bug.cgi?id=482972
• https://www.redhat.com/archives/fedora-docs-list/2009-March/msg00153.html