From Fedora Project Wiki

Proposed Packaging Guidelines for Documentation Packages generated by Publican

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:

Desktop .spec file

Proposed: Allow the Desktop entry to be included inline in the %install section of the .spec file rather than require 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

Rationale: Publican is an automated tool that handles rpm generation from source in English and in translation. To duplicate the volume of work that Publican does using a manual process would be hugely inefficient (and greatly prone to error). Currently we don't have resources to modify the output of Publican to separate the desktop entry out of the spec file.

See: