[prev in list] [next in list] [prev in thread] [next in thread] 

List:       kde-doc-english
Subject:    Re: [kde-doc-english] katepart doc split
From:       Luigi Toscano <luigi.toscano () tiscali ! it>
Date:       2014-02-23 15:21:38
Message-ID: 530A1202.7030107 () tiscali ! it
[Download RAW message or body]

T.C. Hollingsworth wrote:
> The Great KatePart Doc Split has been committed to the frameworks branch!
> 
> The old kwrite doc is gone and replaced with the new katepart doc
> (which looks awfully similar ;-).  All content not specific to kate
> was moved from the kate doc into the katepart doc and replaced by
> links.
Thanks for the effort! (maybe a summary of the change could benefit
translators who do not use summit).


> To compile the new katepart doc, you'll need a recent build of
> kdoctools from git (at least up to 5af7fdb).  With that version it
> passes checkXML5 and compiles with meinproc5 successfully.
> 
> I guess the kwrite Help button goes nowhere now, would a dev mind
> changing it to point at "help:/katepart"?  Wasn't quite sure how to do
> that properly.  (Or even if khelpcenter is working with KF5 right
> now...)
This is a question for kde-frameworks-devel@ I guess. Better ask now that
after the release.


> 
> Anyway, please have a look and make sure I didn't mess anything up.
> :-)  If it all looks good, I'll go ahead and move it over to
> ktexteditor.git in a few days.

If you are going to move an existing file from one repository to another,
maybe it would be better to find a way to extract the history too. Alex Merry
kindly helped me with this and promised to document the procedure.

I have a note about one change:
-<date>2013-11-28</date>
-<releaseinfo>3.12 &kde; 4.12</releaseinfo>
+<date>2013-02-22</date>
+<releaseinfo>5.0 &kde; 5.0</releaseinfo>

Like it or not, there is no KDE 5.0, and we should follow the general naming
schema. I think we need to find a different pattern for this releaseinfo. My
proposals:
- only the program/library version (5.0 in this case)
- program/library version + "KF5 based" (which could be a entity).

Ciao
-- 
Luigi
_______________________________________________
kde-doc-english mailing list
kde-doc-english@kde.org
https://mail.kde.org/mailman/listinfo/kde-doc-english
[prev in list] [next in list] [prev in thread] [next in thread]