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

[Luigi Toscano]

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

--- Comment #23 from Luigi Toscano  ---
If KHelpCenter is not installed, the "foobar Handbook" link from the Help menu
of Frameworks applications redirects to docs.kde.org.

If KHelpCenter is installed, the issue is on KHelpCenter (and I think it's
already reported), but anyway out of scope for this bug...

-- 
You are receiving this mail because:
You are watching all bug changes.

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

[RJVB]

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

--- Comment #22 from RJVB  ---
It should be possible to perform an automatic search of the online
documentation first, no? In fact, it should be possible to provide all existing
handbooks online at least for projects that are part of KF5 Applications and
Plasma5. Would be considerably more user-friendly!

-- 
You are receiving this mail because:
You are watching all bug changes.

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

[Burkhard Lueck]

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

--- Comment #21 from Burkhard Lueck  ---
(In reply to Ian Wadham from comment #20)
> However, that still leaves new users of KDE apps and utilities with the
> message "There is no documentation available for //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.

If you build frameworks/kio with documentation you will not see the
message "There is no documentation available for //index.html", 
but this page in khelpcenter:

https://docs.kde.org/trunk5/en/frameworks/kioslave5/help/documentationnotfound/index.html

-- 
You are receiving this mail because:
You are watching all bug changes.

[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  ---
(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 //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 watching all bug changes.

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

[RJVB]

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

--- Comment #19 from RJVB  ---
Hi Ian!

>Conversely, AFAIK, nobody has ever managed to persuade the MacPorts developers
>to make "KDE with documentation" the default build, not even with versions of

Off-topic, but:
It's not uncommon at all for MacPorts ports to provide documentation through an
optional variant, for package size considerations.

>KDE4, meinproc4 and DrKonqi more recent than 2010. So, again AFAIK, it is not
>known if the original problem, reported in 2010 still exists.

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. It can always be reopened if needed, and problem with
meinproc5 would probably need to be addressed via a separate ticket (or a patch
review if I catch and fix them myself).

-- 
You are receiving this mail because:
You are watching all bug changes.

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

[Ian Wadham]

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

--- Comment #18 from Ian Wadham  ---
See Jeremy Lavergne's original report of this bug on 2010-12-29.

AFAIK it has only ever occurred during large MacPorts builds, possibly/probably
on MacPorts servers that supply binaries and certainly on servers that are used
to test ports of FOSS software in general onto Apple OS X. The symptoms were
death of the entire build, with the loss of builds of many KDE modules and many
FOSS modules other than KDE. It would strike at random in most builds that
required meinproc4 to run --- but at varying points in the build.

At the time (2010) DrKonqi was not working at all in Apple OS X (beginning with
a crash in KCrash...), so no KDE crash report was available.

The solution adopted by the MacPorts developers was to make the default variant
for KDE builds to be "no documentation" --- a sad state of affairs, especially
for potential users of KDE software on Apple OS X, but better than having major
builds crashing.

DrKonqi, KCrash and successors in KF5 have been fixed in Apple OS X now. Stress
tests of meinproc4 on Apple OS X, by me and others, in our home machines, have
never experienced a failure.

Conversely, AFAIK, nobody has ever managed to persuade the MacPorts developers
to make "KDE with documentation" the default build, not even with versions of
KDE4, meinproc4 and DrKonqi more recent than 2010. So, again AFAIK, it is not
known if the original problem, reported in 2010 still exists.

-- 
You are receiving this mail because:
You are watching all bug changes.

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

[Burkhard Lueck]

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

Burkhard Lueck  changed:

   What|Removed |Added

 CC||lu...@hube-lueck.de

--- Comment #17 from Burkhard Lueck  ---
Yes, see https://cgit.kde.org/kdoctools.git/tree/KF5DocToolsMacros.cmake

-- 
You are receiving this mail because:
You are watching all bug changes.

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

[RJVB]

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

--- Comment #16 from RJVB  ---
I've never yet seen any indication of meinproc5 crashing on Mac, and I don't
have any particular patches for it either.

That said, I wouldn't actually know when it's called. Each time documentation
is built?

-- 
You are receiving this mail because:
You are watching all bug changes.

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

[Luigi Toscano]

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

--- Comment #15 from Luigi Toscano  ---
Is this still an issue? The question applies both to meinproc4 and meinproc5.

-- 
You are receiving this mail because:
You are watching all bug changes.