Mailinglist Archive: opensuse-features (434 mails)

< Previous Next >
[openFATE 306404] Provide access to manuals
  • From: fate_noreply@xxxxxxx
  • Date: Tue, 1 Dec 2009 16:50:11 +0100 (CET)
  • Message-id: <feature-306404-17@xxxxxxxxxxxxxx>
Feature changed by: Frank Sundermeyer (fsundermeyer)
Feature #306404, revision 17
Title: Provide access to manuals

openSUSE-11.2: Evaluation
Requester: Important

openSUSE-11.3: Evaluation
Requester: Mandatory

Requested by: Frank Sundermeyer (fsundermeyer)

In openSUSE 11.1 it is almost impossible for a regular user to access
the official manuals.
By default, only the complete set of HTML manuals is installed, while
the PDFs are not installed by default. There is no way of easily
locating the packages containing them unless you know the package
names. In order to improve this
* the term "manual" has to appear in the package name or at least in
the summary of the package
* a Pattern "Manuals" is needed
- The HTML set is either accessible via the KDE or GNOME help center.
- This has certain disadvantages:
+ Theoretically the HTML manuals should be accessible via the KDE or
+ GNOME help center. In the past the help centers have made lots of
+ trouble when integrating the manuals, so they almost always were either
+ not available in KDE or GNOME. Since the release of KDE4, for example,
+ they can no longer be integrated into the KDE help center. Apart from
+ that, the help center has certain disadvantages:
* no proper search within the manuals
* too many clicks are needed to access a manual
* not printable
* users of other GUIs have no easy access to the manuals (via the
filesystem only)
- * in the past the help centers have made lots of trouble when
- integrating the manuals - on openSUSE 11.1, for example, the manuals
- are not displayed at all in the KDE4 help center, so being unaccessible
- for KDE4 users
Therefore the PDFs have to be installed by default, too. Additionally
an entry "Manuals" with links to the PDFs has to be added to the main
menus of the GUIs (KDE, GNOME, XFCE,...).

Documentation Impact:
Evaluate if RPMs can postinstall the unpacked PDFs from the install-

#1: Michael Löffler (michl19) (2009-06-05 16:15:21)
Having the manuals accessible in the Help Center is sufficient, adding
pdfs imo just nice to have.

#2: Frank Sundermeyer (fsundermeyer) (2009-12-01 16:39:11) (reply to
As I pointed out in the initial description: Since the release of KDE4 the
manuals are no longer available from the KDE help center.

openSUSE Feature:

< Previous Next >
This Thread