Projects/Kooka - Revision history

Marten: Update to reflect move to Git

2011-03-07T16:34:58Z

Update to reflect move to Git

Marten: Added 146874 to list of addressed bugs

2010-05-20T09:28:00Z

Added 146874 to list of addressed bugs

Marten: Added 79245 to list of addressed bugs

2010-05-13T14:15:34Z

Added 79245 to list of addressed bugs

Marten: Updated status of KDE4 port

2010-05-08T15:46:41Z

Updated status of KDE4 port

Marten: Updated for KDE4 port

2009-11-20T08:07:10Z

Updated for KDE4 port

Sars: Glimpse is now known as Skanlite

2008-12-06T18:26:10Z

Glimpse is now known as Skanlite

Tampakrap: changed kolorpaint -> kolourpaint for those interested in this app being able to find it

2008-07-13T19:04:23Z

changed kolorpaint -> kolourpaint for those interested in this app being able to find it

Dhaumann: Kooka moved to Projects/Kooka: use subpages, just like all the other apps. Maybe we can introduce Projects/Apps/* ? ... or maybe we should release our wiki-new.kde.org without any restrictions, just like wiki.kde.org?

2008-04-29T18:16:40Z

Kooka moved to Projects/Kooka: use subpages, just like all the other apps. Maybe we can introduce Projects/Apps/* ? ... or maybe we should release our wiki-new.kde.org without any restrictions, just like wiki.kde.org?

Marten: Resolve conflicting edits

2008-04-26T11:41:09Z

Resolve conflicting edits

Marten: Consistent years

2008-04-26T11:29:31Z

Consistent years

@@ Line 7: / Line 7: @@
 and
 [http://dot.kde.org/1201910126/1201918220/ dot.kde.org 1&nbsp;Feb&nbsp;08].
 {{note|Don't panic! Although Kooka is no longer present in KDE4, scanning is still available via the [[kolourpaint]] and [[KOffice]] applications among others.  These use the [[libksane]] library which is included as standard in kdegraphics.
 <br><br>There is also the scanning application [[Skanlite]] which is available in extragear.}}
-Any contributions that you can make to Kooka&nbsp;- code, documentation, translation, or artwork&nbsp;-
+Now would be a good time to introduce myself: Jonathan&nbsp;Marten, the current Kooka maintainer.  I was motivated to volunteer for this after having got a new networked scanner (an HP&nbsp;OfficeJet all-in-one) and finding that it didn't work with Kooka, although it did with SANE.  Getting it to work with Kooka was a fairly simple fix, but it was obvious that there was a lot more in the application that could be improved.
-will be greatly appreciated!
 == Current Status ==
 There is still a lot of documentation and other information on
-the [http://kooka.kde.org original Kooka web pages].  The intention is that that content will eventually migrate to these TechBase wiki-based pages.  For the moment this page provides information on the current state of Kooka, and instructions for downloading and building the development (SVN) version.
+the [http://kooka.kde.org original Kooka web pages].  The intention is that that content will eventually migrate to these TechBase wiki-based pages.  For the moment this page provides information on the current state of Kooka, and instructions for downloading and building the development (Git) version.
 These are some of the bugs and popular wishes that have been addressed in the development version so far.  If you are affected by any of these, please try out that version (see the "Running the Development Version" section below) and update the bug if there is anything to report.
@@ Line 42: / Line 41: @@
 will list all of the bugs that have been addressed in the development version.
-== KDE4 Porting ==
+== Future Development ==
-There is a port of Kooka to KDE4.  Almost all of the original Kooka functionality is present and working, with the exception of printing (not yet addressed because the KDE4 printing system is still under heavy development).  It uses [[Development/Architecture/KDE4/Sonnet|Sonnet]] for OCR spell checking. The dock widget interface ({{bug|71252}} and its many duplicates) has gone.
+Any contributions that you can make to Kooka&nbsp;- code, documentation, translation, or artwork&nbsp;-
 New features needed include configurability for the user interface layout.
@@ Line 56: / Line 56: @@
 == Running the Development Version ==
-If you want to try running the latest development version of Kooka, it is available from KDE SVN.  If you are not familiar with SVN then instructions are below;  you do not need an SVN account unless you will be contributing code yourself, although you should be familiar with compiling and installing from source.  See the TechBase articles
+If you want to try running the latest development version of Kooka, it is available from KDE Git.  If you are not familiar with Git then instructions are below;  you do not need an [http://identity.kde.org identity.kde.org] account unless you will be contributing code yourself, although you should be familiar with compiling and installing from source.  See the TechBase
-[[Getting_Started/Sources/Anonymous SVN|Anonymous SVN Quickstart Guide]]
+[[Development/Git]] page for more information on Git.
-and
-[[Getting_Started/Sources/Using Subversion with KDE|Using Subversion with KDE]] for more information on SVN.
-The current development version (the KDE4 port) is at <tt>branches/work/kooka-kde4</tt>, if you just want to browse the files you can do so using the
+The current KDE4 development version is at <tt>playground/graphics/kooka</tt>, if you just want to browse the files you can do so using
-[http://websvn.kde.org/branches/work/kooka-kde4/ KDE WebSVN].
+[http://projects.kde.org/projects/playground/graphics/kooka/repository projects.kde.org] or [http://quickgit.kde.org/?p=kooka.git KDE QuickGit].
 To check out a copy of the current sources, do the following:
    cd [to a suitable place, e.g. your home directory]
-   svn co svn://anonsvn.kde.org/home/kde/branches/work/kooka-kde4
+   git clone git://anongit.kde.org/kooka
 This will download the current sources to a subdirectory
-{{path|kooka-kde4}}.
+{{path|kooka}}.
 To compile and install them, do the following:
-   mkdir kooka-kde4-build
+   mkdir kooka-build
-   cd kooka-kde4-build
+   cd kooka-build
-   cmake ../kooka-kde4 [with any options needed, you should not need to use any]
+   cmake ../kooka [with any options needed, you should not need to use any]
    make
@@ Line 87: / Line 85: @@
 or from the desktop or K-menu in the usual way.
-{{tip|You may need to install some additional software or packages (your distro may call them "development" packages) to obtain SVN and cmake, or the autotools needed for the KDE3 version.}}
+{{tip|You may need to install some additional software or packages (your distro may call them "development" packages) to obtain Git and cmake, or the autotools needed for the KDE3 version.}}
-The KDE3 development version is still available, although it is no longer being updated - any bug fixes or improvements will appear in the KDE4 version only.  To check out and build/install this version, do:
+To check out and build/install this version, do:
-   svn co svn://anonsvn.kde.org/home/kde/branches/work/kooka-kde3
+   cd kooka
-   cd kooka-kde3
+   git checkout master-kde3
    make -f Makefile.cvs
    ./configure [with any options needed]

@@ Line 37: / Line 37: @@
 * {{bug|71252}}  Docking widgets unintuitive, configuration can be badly messed up
 * {{bug|79245}} 3-pass scanner not working
 [http://bugs.kde.org/buglist.cgi?product=kooka&bug_status=ASSIGNED This Bugzilla query]

← Older revision		Revision as of 14:15, 13 May 2010
Line 36:		Line 36:

	* {{bug\|71252}} Docking widgets unintuitive, configuration can be badly messed up		* {{bug\|71252}} Docking widgets unintuitive, configuration can be badly messed up
		+	* {{bug\|79245}} 3-pass scanner not working

	[http://bugs.kde.org/buglist.cgi?product=kooka&bug_status=ASSIGNED This Bugzilla query]		[http://bugs.kde.org/buglist.cgi?product=kooka&bug_status=ASSIGNED This Bugzilla query]

@@ Line 31: / Line 31: @@
 * {{bug|132699}} Images in nested folders are not shown
 * {{bug|70473}}  Deleting items from the Kooka Gallery does not decrement...
 * {{bug|141927}} Spelling settings not preserved for OCR in a single...
 [http://bugs.kde.org/buglist.cgi?product=kooka&bug_status=ASSIGNED This Bugzilla query]
@@ Line 38: / Line 42: @@
 == KDE4 Porting ==
-Porting of Kooka to KDE4 has now started.  At the moment the application runs, scans and saves.  Major areas still to be ported are the image thumbnail view, gallery drag and drop, printing/copying, and OCR spell checking.  New features needed include configurability for the user interface layout.  The dock widget interface ({{bug|71252}} and its many duplicates) has gone.
+There is a port of Kooka to KDE4.  Almost all of the original Kooka functionality is present and working, with the exception of printing (not yet addressed because the KDE4 printing system is still under heavy development).  It uses [[Development/Architecture/KDE4/Sonnet|Sonnet]] for OCR spell checking. The dock widget interface ({{bug|71252}} and its many duplicates) has gone.
 There are some discussion threads ([http://lists.kde.org/?t=125570944700004&r=1&w=2 1],
@@ Line 44: / Line 50: @@
 [http://lists.kde.org/?t=125603251000002&r=1&w=2 3]) regarding the KDE4 port and possible future changes.  One of these possibilities is the new KDE scanning library [[libksane]], part of [[Skanlite]], being developed by  Kåre&nbsp;Särs.  libksane has a number of advantages over libkscan, including access to all scanner options and 16-bit scanner support.  In the long run the aim is to convert Kooka to use this new library.
-When ported to KDE4, Kooka may appear in extragear&nbsp;- or even an official KDE release&nbsp;- one day!
+When the port is complete, Kooka may appear in extragear&nbsp;- or even an official KDE release&nbsp;- one day!
 == Running the Development Version ==

@@ Line 10: / Line 10: @@
 Now would be a good time to introduce myself: Jonathan&nbsp;Marten, the current Kooka maintainer.  I was motivated to volunteer for this after having got a new networked scanner (an HP&nbsp;OfficeJet all-in-one) and finding that it didn't work with Kooka, although it did with SANE.  Getting it to work with Kooka was a fairly simple fix, but it was obvious that there was a lot more in the application that could be improved.
-{{note|Don't panic! Although Kooka is no longer present in KDE4, scanning is still available via the [[kolourpaint]] and [[KOffice]] applications among others.  These use the [[libkscan]] library which is still present in kdegraphics.}}
+{{note|Don't panic! Although Kooka is no longer present in KDE4, scanning is still available via the [[kolourpaint]] and [[KOffice]] applications among others.  These use the [[libksane]] library which is included as standard in kdegraphics.
 Any contributions that you can make to Kooka&nbsp;- code, documentation, translation, or artwork&nbsp;-
@@ Line 35: / Line 36: @@
 will list all of the bugs that have been addressed in the development version.
-== Future Plans ==
+== KDE4 Porting ==
-Obviously the Kooka application needs to be ported to KDE4.  The dock widget user interface that it currently uses is not supported in KDE4, as well as being rather unreliable and having usability issues (see {{bug|71252}} and its many duplicates).  I'm currently considering changing the user interface to a task oriented system with a tab for the three main tasks ("Scan", "OCR" and "Gallery").  The panes used for each task will be arranged using splitters.  All of the sizes and arrangements will be fully configurable, of course.
+Porting of Kooka to KDE4 has now started.  At the moment the application runs, scans and saves.  Major areas still to be ported are the image thumbnail view, gallery drag and drop, printing/copying, and OCR spell checking.  New features needed include configurability for the user interface layout.  The dock widget interface ({{bug|71252}} and its many duplicates) has gone.
-In addition to that, a new KDE scanning application [[Skanlite]] is being developed by  Kåre&nbsp;Särs. This includes a new library [[libksane]] which has a number of advantages over libkscan, including access to all scanner options and 16-bit scanner support.  In the long run the aim is to convert Kooka to use this new library.
+There are some discussion threads ([http://lists.kde.org/?t=125570944700004&r=1&w=2 1],
-libksane is for KDE4 only, so the port will have to be done before the library conversion.
+When ported to KDE4, Kooka may appear in extragear&nbsp;- or even an official KDE release&nbsp;- one day!
-−
-Having done all of this and ported to KDE4, Kooka may appear in extragear&nbsp;- or even an official KDE release&nbsp;- one day!
 == Running the Development Version ==
@@ Line 52: / Line 53: @@
 [[Getting_Started/Sources/Using Subversion with KDE|Using Subversion with KDE]] for more information on SVN.
-The development version is at <tt>branches/work/kooka-kde3</tt>, if you just want to browse the files you can do so using the
+The current development version (the KDE4 port) is at <tt>branches/work/kooka-kde4</tt>, if you just want to browse the files you can do so using the
-[http://websvn.kde.org/branches/work/kooka-kde3/ KDE WebSVN].
+[http://websvn.kde.org/branches/work/kooka-kde4/ KDE WebSVN].
 To check out a copy of the current sources, do the following:
    cd [to a suitable place, e.g. your home directory]
-   svn co svn://anonsvn.kde.org/home/kde/branches/work/kooka-kde3
+   svn co svn://anonsvn.kde.org/home/kde/branches/work/kooka-kde4
 This will download the current sources to a subdirectory
-{{path|kooka-kde3}}.
+{{path|kooka-kde4}}.
 To compile and install them, do the following:
-   cd kooka-kde3
+   mkdir kooka-kde4-build
-   make -f Makefile.cvs
+   cd kooka-kde4-build
-   ./configure [with any options needed, you should not need to use any]
+   cmake ../kooka-kde4 [with any options needed, you should not need to use any]
    make
@@ Line 72: / Line 73: @@
    su root -c 'make install'
-This will overwrite your existing Kooka application, its UI file and icons.  However, it will not overwrite the original version of the libkscan library so as not to break any other applications which may use it.  The new libkscan library will get installed with a new version number.  After doing the install, you can run the new Kooka application with the command:
+This will install the new Kooka application and its support files in the KDE4 install location.  There is no Kooka included as standard in KDE4, so nothing will get overwritten.  After doing the install, you can run the new Kooka application with the command:
    kooka
@@ Line 78: / Line 79: @@
 or from the desktop or K-menu in the usual way.
-{{tip|You may need to install some additional software or packages (your distro may call them "development" packages) to obtain SVN, and the autoconf/automake framework that <tt>Makefile.cvs</tt> uses.}}
+{{tip|You may need to install some additional software or packages (your distro may call them "development" packages) to obtain SVN and cmake, or the autotools needed for the KDE3 version.}}
 == Reporting Bugs or Wishes ==
@@ Line 88: / Line 97: @@
 If your problem is a crash, please try to include a meaningful backtrace&nbsp;- this will be displayed by DrKonqi when the application crashes.
-See [[Development/Tutorials/Debugging/How_to_create_useful_crash_reports]] for information on how to create and submit useful crash reports.
+See the TechBase article [[Development/Tutorials/Debugging/How_to_create_useful_crash_reports|How to create useful crash reports]] for information on how to create and submit useful reports.
 Please be aware that a crash may not be a problem with Kooka or anywhere in KDE, it may be caused by the SANE libraries or even the kernel.  Unfortunately, it may not be possible to reproduce the problem for investigation unless a developer has the same scanner hardware as you do&nbsp;- even then it may not be possible.  You should ensure that you are using a reasonably up-to-date kernel (especially if your scanner is connected via USB) and the latest SANE package.  Check the [http://www.sane-project.org/bugs.html SANE bug tracker] if you suspect that the problem may involve SANE.

@@ Line 11: / Line 11: @@
 {{note|Don't panic! Although Kooka is no longer present in KDE4, scanning is still available via the [[kolorpaint]] and [[KOffice]] applications among others.  These use the [[libkscan]] library which is still present in kdegraphics.}}
 == Current Status ==
@@ Line 34: / Line 37: @@
 == Future Plans ==
-A new KDE scanning application [[Glimpse]] is being developed by  Kåre&nbsp;Särs. This includes a new library [[libksane]] which has a number of advantages over libkscan, including access to all scanner options and 16-bit scanner support.  In the long run the aim is to convert Kooka to use this new library.
+Obviously the Kooka application needs to be ported to KDE4.  The dock widget user interface that it currently uses is not supported in KDE4, as well as being rather unreliable and having usability issues (see {{bug|71252}} and its many duplicates).  I'm currently considering changing the user interface to a task oriented system with a tab for the three main tasks ("Scan", "OCR" and "Gallery").  The panes used for each task will be arranged using splitters.  All of the sizes and arrangements will be fully configurable, of course.
-In addition to that, obviously, the application needs to be ported to KDE4.  The dock widget user interface that it currently uses is not supported in KDE4, as well as being rather clumsy and unreliable (see {{bug|71252}} and its many duplicates).  I'm currently considering changing the user interface to a task oriented system for the three main tasks ("Scan", "OCR" and "Gallery"), with a tab for each task.  The panes used for each task will be arranged using splitters.  All of the sizes and arrangements will be fully configurable, of course.
+In addition to that, a new KDE scanning application [[Glimpse]] is being developed by  Kåre&nbsp;Särs. This includes a new library [[libksane]] which has a number of advantages over libkscan, including access to all scanner options and 16-bit scanner support.  In the long run the aim is to convert Kooka to use this new library.
-[[libksane]] is for KDE4 only, so the port will have to be done before the conversion to that library.
+libksane is for KDE4 only, so the port will have to be done before the library conversion.
-Having done all of these changes and ported to KDE4, Kooka may appear in extragear&nbsp;- or even an official KDE release&nbsp;- one day!
+Having done all of this and ported to KDE4, Kooka may appear in extragear&nbsp;- or even an official KDE release&nbsp;- one day!
 == Running the Development Version ==