Bug 355393

Summary:	l10n: make understandable the doc
Product:	[Frameworks and Libraries] frameworks-kdoctools	Reporter:	Antoni Bella <antonibella5>
Component:	general	Assignee:	Luigi Toscano <luigi.toscano>
Status:	RESOLVED FIXED
Severity:	wishlist	CC:	aacid, kde-doc-english, kdelibs-bugs-null, luigi.toscano, yurchor
Priority:	NOR
Version First Reported In:	unspecified
Target Milestone:	---
Platform:	Kubuntu
OS:	Linux
Latest Commit:		Version Fixed In:	5.24
Sentry Crash Report:
Attachments:	Solve this question

Description Antoni Bella 2015-11-15 21:03:35 UTC

kdoctools5 - 5.15.0
I try to improve the translations, a little bit more logical.

Reproducible: Always

Comment 1 Antoni Bella 2015-11-15 21:05:56 UTC

Created attachment 95520 [details]
Solve this question

Comment 2 Yuri Chornoivan 2015-11-16 17:54:19 UTC

Just a +1 for these changes.

Comment 3 Albert Astals Cid 2015-11-19 23:42:51 UTC

Luigi you're the kdoctools maintainer, what do you think?

Comment 4 Luigi Toscano 2015-11-20 08:17:59 UTC

Yes, I think it should be fixed. In fact messages are marked with QCoreApplication::translate, but the messages are not extracted. Given that some messages are used by the (ugly and for now static) library used by KIO, I guess I need to extracted the messages to a different po file (which can be used for Qt-only bits of kdoctools). I remember that we can have only one Qt-style po file per framework, but is there anything which prevents having additional "i18n-style" po-files?

Comment 5 Albert Astals Cid 2015-11-20 19:04:37 UTC

I'm confused by "messages are marked with QCoreApplication::translate", isn't this just a patch to a docbook file?

Comment 6 Luigi Toscano 2015-11-20 21:13:41 UTC

Sorry, I mixed up the emails. Ok, I have few comments about the changes.

- I prefer to expand KF5 ("KDE Frameworks 5" or simply "Frameworks 5")
- not sure about "User's Manual" at all. One is "Common options for Qt5 applications", the other "Common options for Frameworks 5 applications" (not sure now about camel cases too)
- the truth is that both files would need a more complete recheck, I'm sure that some options are not valid anymore. 
- changes like missing dots at the end of sentence can go immediately of course
- can we discuss on reviewboard?

Comment 7 Albert Astals Cid 2015-12-03 23:19:38 UTC

Antoni?

Comment 8 Antoni Bella 2015-12-07 14:53:55 UTC

I agree with Luigi.

But, I think you can apply all into KDE4 (for the web) and KF5 (awaiting improvement).

+1 for "KDE Frameworks 5"

Comment 9 Luigi Toscano 2016-06-19 21:14:37 UTC

Sorry for the long delay. 
The two man pages have been updated to the real options available for Qt 5 and (most of) Frameworks 5 applications, so the patch does not apply anymore. Nevertheless, the issues highlighted (lack of missing dots at the end of sentences and search for better titles for the man pages) have been addressed in the last changes in the current master and which will be released as part of the upcoming Frameworks 5.24.