knewstuff/docs/porting.txt

0001 KNewStuff2 Porting Information
0002 ==============================
0003
0004 «Where did all the classes go?»
0005
0006 data/
0007  (GHNS format schemas and example data)
0008  -> see http://ghns.freedesktop.org/spec/ now
0009
0010 downloaddialog.*
0011 uploaddialog.*
0012 providerdialog.*
0013  (graphical dialogs)
0014  -> upload/providerdialog still used, in knewstuff2/ui/
0015  -> the download dialog is the one from okular
0016  -> the old knewstuff1 download dialog is gone
0017
0018 ghns.*
0019 testnewstuff.*
0020  (test applications)
0021  -> see tests/ for some new tests (has its own README.tests)
0022
0023 entry.*
0024 provider.*
0025  (entities/data handling classes)
0026  -> see knewstuff2/core/
0027  -> author, feed and category are now additional entities
0028
0029 security.*
0030  -> see knewstuff2/core/
0031
0032 knewstuffbutton.*
0033  -> TODO
0034  -> will go to knewstuff2/ui/ (there's already kdxsbutton)
0035
0036 engine.*
0037  (non-graphical upload/download functionality)
0038  -> there are 3 engine classes now
0039  -> the one in knewstuff2/core/coreengine.* is similar
0040  -> but it also handles installation and caching
0041  -> the one in knewstuff2/dxs/dxsengine.* implements DXS
0042  -> the one in knewstuff2/engine.* is for applications (use only this one!)
0043
0044 knewstuff.*
0045 knewstuffgeneric.*
0046 knewstuffsecure.*
0047   -> doesn't exist anymore
0048   -> inherited from it? bad luck, was discouraged by tutorial
0049   -> all custom installation etc. is now handled by *.knsrc files
0050