Bug 3701 - There is no documentation available for kdiff3
Summary: There is no documentation available for kdiff3
Status: RESOLVED FIXED
Alias: None
Product: Mageia
Classification: Unclassified
Component: RPM Packages (show other bugs)
Version: 1
Hardware: x86_64 Linux
Priority: Normal normal
Target Milestone: ---
Assignee: QA Team
QA Contact:
URL: http://kdiff3.sourceforge.net/
Whiteboard:
Keywords: validated_update
Depends on:
Blocks:
 
Reported: 2011-12-11 06:31 CET by Dimitrios Glentadakis
Modified: 2012-04-11 20:30 CEST (History)
7 users (show)

See Also:
Source RPM: kdiff3-0.9.95-4.mga1.src.rpm
CVE:
Status comment:


Attachments

Description Dimitrios Glentadakis 2011-12-11 06:31:50 CET
With the kdiff3 there are some documentation files:

[dglent@localhost HTML]$ pwd
/home/dglent/kdiff3-0.9.95-4.mga1.x86_64/usr/share/doc/HTML
[dglent@localhost HTML]$ ls
et/  pt/  sv/


but there is no english version, so in my system the documentation is nt present.

The available doc tanslations in the tarball of kdiff3 are:
da/  en/  et/  it/  pt/  sv/   de/  es/  fr/  nl/
Comment 1 Manuel Hiebel 2011-12-11 11:33:25 CET
Hi, thanks for reporting this bug.
As there is no maintainer for this package I added the committers in CC.

CC: (none) => shlomif

Comment 2 Shlomi Fish 2011-12-23 16:19:47 CET
This should be fixed in Cauldron as we package kdiff3-0.9.96. Should I backport the package to Mageia 1?
Comment 3 Marja Van Waes 2012-02-14 06:45:35 CET
(In reply to comment #2)
> This should be fixed in Cauldron as we package kdiff3-0.9.96. Should I backport
> the package to Mageia 1?

@ dglent

is this issue fixed for you in cauldron?

CC: (none) => marja11

Comment 4 Dimitrios Glentadakis 2012-02-14 06:51:16 CET
i dont have cauldron, i use Mageia 1
Comment 5 Marja Van Waes 2012-02-14 11:04:32 CET
Just checked, in cauldron the english KDiff3 Handbook is accessible from within the KDE help centre


btw, I didn't manage to open the .docbook index file by right clicking and choosing an application. The only way that worked for me was to go use the kickoff Application launcher and go to documentation - help (that started KDE help centre) - development - KDiff3 

cc'ing Oliver Burger

@ Oliver

WDYT about Shlomi's suggestion in comment 2 (not for backports, but for updates)?

CC: (none) => oliver.bgr

Comment 6 Remco Rijnders 2012-03-19 07:25:53 CET
@Shlomi,

Is it possible to release this as an update for kdiff3-0.9.95, that is, to release the package with only this fix in?

CC: (none) => remco

Comment 7 Shlomi Fish 2012-04-05 12:53:46 CEST
(In reply to comment #6)
> @Shlomi,
> 
> Is it possible to release this as an update for kdiff3-0.9.95, that is, to
> release the package with only this fix in?

It is possible, but I'm not sure if such a bug warrants an update. I guess it's up to the higher levels to decide on that.

Regards,

-- Shlomi Fish
Comment 8 Marja Van Waes 2012-04-08 16:37:44 CEST
(In reply to comment #7)
> (In reply to comment #6)
> > @Shlomi,
> > 
> > Is it possible to release this as an update for kdiff3-0.9.95, that is, to
> > release the package with only this fix in?
> 
> It is possible, but I'm not sure if such a bug warrants an update. I guess it's
> up to the higher levels to decide on that.
> 
> Regards,
> 
> -- Shlomi Fish

Documentation bugs are real bugs and should get fixed.  The way Remco proposed (by not updating to a newer version of kdiff, but by just dropping the fix in the kdiff version that is in Mageia 1 now), is perfectly in line with our updates policy https://wiki.mageia.org/en/Updates_policy
Comment 9 Shlomi Fish 2012-04-08 17:38:34 CEST
(In reply to comment #8)
> (In reply to comment #7)
> > (In reply to comment #6)
> > > @Shlomi,
> > > 
> > > Is it possible to release this as an update for kdiff3-0.9.95, that is, to
> > > release the package with only this fix in?
> > 
> > It is possible, but I'm not sure if such a bug warrants an update. I guess it's
> > up to the higher levels to decide on that.
> > 
> > Regards,
> > 
> > -- Shlomi Fish
> 
> Documentation bugs are real bugs and should get fixed.  The way Remco proposed
> (by not updating to a newer version of kdiff, but by just dropping the fix in
> the kdiff version that is in Mageia 1 now), is perfectly in line with our
> updates policy https://wiki.mageia.org/en/Updates_policy

OK, I've uploaded the up-to-date version now:

<<<
6 seconds ago 	shlomif 	kdiff3-0.9.96-1.mga1 	1 	core/updates_testing 		todo
>>>

Regards,

-- Shlomi Fish
Comment 10 Marja Van Waes 2012-04-08 19:12:20 CEST
(In reply to comment #9)
> (In reply to comment #8)

> > 
> > Documentation bugs are real bugs and should get fixed.  The way Remco proposed
> > (by not updating to a newer version of kdiff, but by just dropping the fix in
> > the kdiff version that is in Mageia 1 now), is perfectly in line with our
> > updates policy https://wiki.mageia.org/en/Updates_policy
> 
> OK, I've uploaded the up-to-date version now:
> 
> <<<
> 6 seconds ago     shlomif     kdiff3-0.9.96-1.mga1     1    
> core/updates_testing         todo
> >>>
> 

Thanks a lot :)

Shouldn't the version number be 0.9.95-5.mga1 if this is version 0.9.95-4 with the fix added?

Assignee: bugsquad => shlomif

Comment 11 Shlomi Fish 2012-04-08 23:07:12 CEST
Hi,

(In reply to comment #10)
> (In reply to comment #9)
> > (In reply to comment #8)
> 
> > > 
> > > Documentation bugs are real bugs and should get fixed.  The way Remco proposed
> > > (by not updating to a newer version of kdiff, but by just dropping the fix in
> > > the kdiff version that is in Mageia 1 now), is perfectly in line with our
> > > updates policy https://wiki.mageia.org/en/Updates_policy
> > 
> > OK, I've uploaded the up-to-date version now:
> > 
> > <<<
> > 6 seconds ago     shlomif     kdiff3-0.9.96-1.mga1     1    
> > core/updates_testing         todo
> > >>>
> > 
> 
> Thanks a lot :)
> 
> Shouldn't the version number be 0.9.95-5.mga1 if this is version 0.9.95-4 with
> the fix added?

Well, I didn't backport the fix, because I didn't know what in the diff to the SPEC file changed it, and it's possible the fix was in the source tarball itself (not sure). So what I did was submit the new and upgraded package instead. I hope it's still OK.

Regards,

-- Shlomi Fish
Comment 12 Marja Van Waes 2012-04-09 10:34:07 CEST
(In reply to comment #11)
> Hi,
> 
> (In reply to comment #10)

> 
> Well, I didn't backport the fix, because I didn't know what in the diff to the
> SPEC file changed it, and it's possible the fix was in the source tarball
> itself (not sure). So what I did was submit the new and upgraded package
> instead. I hope it's still OK.
> 

Well, I just looked at the release notes and the changelog of kdiff3-0.9.96
http://kdiff3.sourceforge.net/ChangeLog
http://sourceforge.net/mailarchive/message.php?msg_id=28037303


The only new "feature" in kdiff3-0.9.96 mentioned, is that more languages are supported, but to me that is a bug fix, too. I understand all the rest of the quite long list are ordinary bug fixes and maintenance bug fixes.
So in my eyes, this is a bug fix only release, which can be pushed according to https://wiki.mageia.org/en/Updates_policy#Version_Policy 

@ Oliver
@ Remco

Do you agree that this is a bugfix only release?
Remco Rijnders 2012-04-09 12:03:06 CEST

Assignee: shlomif => qa-bugs

Comment 13 Marja Van Waes 2012-04-09 18:12:22 CEST
@ Shlomif

I hadn't read https://wiki.mageia.org/en/Example_update_advisory_announcement yet, so I'll do it better here than in bug 1488:

There is now kdiff3-0.9.96-1.mga1 in core/updates_testing to validate
-------------------------------------------------------


Suggested advisory:
-------------------
This update fixes the following bug

[1] https://bugs.mageia.org/show_bug.cgi?id=3701

Other fixes in this bug fix only release:
http://sourceforge.net/mailarchive/message.php?msg_id=28037303

-------------------------------------------------------
Steps to reproduce:

- install/update to update candidate
- check that at least the English documentation is available
Comment 14 Dave Hodgins 2012-04-09 20:59:52 CEST
Testing complete on i586 for the srpm
kdiff3-0.9.96-1.mga1.src.rpm

The handbook is now accessible, and comparing files works.

CC: (none) => davidwhodgins

Comment 15 Manuel Hiebel 2012-04-11 01:00:38 CEST
The handbook in french is here and the soft works. Testing complete.


Suggested Advisory:
-------------
This update add more supported languages and fix some bugs:
http://sourceforge.net/mailarchive/message.php?msg_id=28037303

https://bugs.mageia.org/show_bug.cgi?id=3701#c14
-------------

SRPM: kdiff3-0.9.96-1.mga1.src.rpm

Could sysadmin please push from core/updates_testing to core/updates

Thankyou!

Keywords: (none) => validated_update
CC: (none) => sysadmin-bugs

Comment 16 Thomas Backlund 2012-04-11 20:30:49 CEST
Update pushed

Status: NEW => RESOLVED
CC: (none) => tmb
Resolution: (none) => FIXED


Note You need to log in before you can comment on or make changes to this bug.