Bug 355393 - l10n: make understandable the doc
Summary: l10n: make understandable the doc
Status: RESOLVED FIXED
Alias: None
Product: frameworks-kdoctools
Classification: Frameworks and Libraries
Component: general (show other bugs)
Version: unspecified
Platform: Kubuntu Linux
: NOR wishlist
Target Milestone: ---
Assignee: Luigi Toscano
URL:
Keywords:
Depends on:
Blocks:
 
Reported: 2015-11-15 21:03 UTC by Antoni Bella
Modified: 2016-06-19 21:14 UTC (History)
5 users (show)

See Also:
Latest Commit:
Version Fixed In: 5.24


Attachments
Solve this question (2.84 KB, patch)
2015-11-15 21:05 UTC, Antoni Bella
Details

Note You need to log in before you can comment on or make changes to this bug.
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.