From Fedora Project Wiki

Line 3: Line 3:
==Package naming convention==
==Package naming convention==


Proposed: Documentation packages be named with version numbering in the package name to allow parallel installation of multiple versions.
'''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
'''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.
'''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://bugzilla.redhat.com/show_bug.cgi?id=476471#c57]
'''See:''' [https://bugzilla.redhat.com/show_bug.cgi?id=476471#c57 https://bugzilla.redhat.com/show_bug.cgi?id=476471#c57]
[https://www.redhat.com/archives/fedora-docs-list/2009-March/msg00154.html https://www.redhat.com/archives/fedora-docs-list/2009-March/msg00154.html]
[https://www.redhat.com/archives/fedora-docs-list/2009-March/msg00154.html https://www.redhat.com/archives/fedora-docs-list/2009-March/msg00154.html]



Revision as of 01:45, 30 March 2009

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: 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.

for 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: