[Kde-pim] Kleopatra Documentation

[Burkhard Lück]

Am Donnerstag, 29. Juli 2010, um 08:44:05 schrieb Thomas McGuire:
> Hi Burkhard,
> 
> On Thursday 29 July 2010 07:59:40 Burkhard Lück wrote:
> > the kleopatra documentation in trunk has a lot of
> > correction/improvement/additions compared to branch.
> > 
> > Is this documentation in trunk also valid for kleopatra in branch?
> > 
> > In that case I'd like to backport the documentation the next days.
> 
> To be honest, I have no idea what features of Kleopatra made it to the 4.5
> branch, and in what branches the features mentioned in the documentation
> are.
> 
> I only merged the Kleopatra commits from the enterprise4 branch to trunk,
> without much knowledge about the program itself, so I mostly didn't
> backport commits, and I have no overview of the features.
> 
> Therefore, I suggest not backporting the documentation, as I don't know if
> it is still valid for the branch.
> 

Hmm...

The last content change of the handbook in trunk is r11441621, branch was 
tagged from 1143967

Comparing branch and trunk docs, I see that a lot of my comments in the branch 
docbook like "not in 4.x", "changed in 4.x", "gui option missing" and the like 
are replaced by content. 

Reading the trunk docbook against the gui of kleopatra from 4.5 the Chapters 
"Introduction", "Main Functions" and "Menu Reference" are also valid for 4.5, 
But there are some errors, fixed and diff attached.

Only a small diff in output of kleopatra --help in trunk + 4.5, so the Chapter 
"Command Line Options Reference" is mostly valid, one option has to be removed 
for 4.5.

Chapter Configuration has only three string changes:
Certificate Categories -> Certificate Filters
Show technical details -> Show certificate details
File Operations -> Checksum Operations

I have removed the </guilabel> markup in titles in my patch, that looks really 
ugly with the current style sheet.

Of course I can't judge about the chapter "Administrator's Guide". You have to 
decide, if it is valid for backporting.

From my PoV I'd say besides the chapter "Administrator's Guide" everything 
should be backported.

Thanks.

-- 
Burkhard Lück
-------------- next part --------------
A non-text attachment was scrubbed...
Name: kleopatra-doc.diff
Type: text/x-patch
Size: 4880 bytes
Desc: not available
URL: <http://mail.kde.org/pipermail/kde-pim/attachments/20100729/cf9064cd/attachment.bin>
-------------- next part --------------
_______________________________________________
KDE PIM mailing list kde-pim at kde.org
https://mail.kde.org/mailman/listinfo/kde-pim
KDE PIM home page at http://pim.kde.org/