[docs] [Bug 261509] meinproc4: crash with segfault on Mac OS X

[Ian Wadham]

https://bugs.kde.org/show_bug.cgi?id=261509

--- Comment #20 from Ian Wadham <iandw.au at gmail.com> ---
(In reply to RJVB from comment #19)
>> It's not uncommon at all for MacPorts ports to provide documentation through
> an optional variant, for package size considerations.

Meinproc4 provides only the end-user documentation (the handbooks and guides).
It converts XML docbook format into a compressed HTML file, which is
de-compressed only if and when a user requests to see that doco via KDE
application-help menu. But yes, the MacPorts +docs variant does iterate through
the entire dependencies list, providing doco of all types for the entire list,
in a huge range of formats used by FOSS in general.

> There are 2 questions here:
> - does meinproc4 still crash on Mac
> - does meinproc5 crash on Mac
> 
> It seems the answer to both questions is "apparently not" so I think this
> ticket can be closed.

I agree that this bug report can be closed, perhaps with reason WORKSFORME.

However, that still leaves new users of KDE apps and utilities with the message
"There is no documentation available for /<appname>/index.html", if they try to
get the handbook for the Help menu, but that is a real turnoff for newbie
users, besides making it difficult to get acquainted with some of the more
sophisticated KDE4 and KF5packages. And the message  is not actually true for
most KDE4 and KF5 packages, unless there has been a build failure.

May I suggest some possible workarounds in MacPorts:-

    a. Change the above message to refer the user to "https:docs.kde.org",
       where online copies of all documentation can be found nowadays.
    b. Add a similar message to the MacPorts Notes for KDE4 and KF5 builds.
    c. Introduce a variant for KDE4 and KF5 ports (eg. +userdoc) that will
       just provide end-user doco (ie. run meinproc for one package only and
       not all the dependencies).

I believe you had idea c. a while back, René, but someone knocked it on the
head.

-- 
You are receiving this mail because:
You are the assignee for the bug.