Review Request 128645: Update Ark documentation to 16.08

[Ragnar Thomsen]

-----------------------------------------------------------
This is an automatically generated e-mail. To reply, visit:
https://git.reviewboard.kde.org/r/128645/#review98296
-----------------------------------------------------------



Thanks for updating the docs :)


doc/index.docbook (line 76)
<https://git.reviewboard.kde.org/r/128645/#comment66218>

    I think you meant "xar".



doc/index.docbook (line 294)
<https://git.reviewboard.kde.org/r/128645/#comment66215>

    bootom -> bottom



doc/index.docbook (lines 300 - 302)
<https://git.reviewboard.kde.org/r/128645/#comment66216>

    Correct: Higher compression level -> smaller size, but slower (de)compression.
    
    We follow the default compression level for the various archive formats. For bzip2 the max level is the default, while for others it is somewhere in the middle. There is a trade-off, since for some formats using the max level increases the (de)compression time alot with little reduction in size.
    
    For most formats the minimum compression level is equivalent to just storing the files, i.e. no compression.



doc/index.docbook (lines 342 - 347)
<https://git.reviewboard.kde.org/r/128645/#comment66217>

    For zip and 7z multi-vol archives have the suffix .zip.001, zip.002, etc and .7z.001, 7z.002, etc.
    
    For rar the volumes get the name .part1.rar, part2.rar, etc.
    
    .r00, .r01 is the old rar naming scheme, but is no longer used by rar by default (it can be specified with switch, however). We use the new naming scheme for rars.
    
    The volume size can be chosen for various reasons. Previously, it was used for splitting large files onto several floppy disks. Nowadays, it is probably most used for attaching large files to emails (usually there is a limit of 5MB).
    
    We set a min limit for volume size of 100 KB and a max limit of 1000 MB in the GUI in Ark.


- Ragnar Thomsen


On Aug. 10, 2016, 4:33 p.m., Burkhard Lück wrote:
> 
> -----------------------------------------------------------
> This is an automatically generated e-mail. To reply, visit:
> https://git.reviewboard.kde.org/r/128645/
> -----------------------------------------------------------
> 
> (Updated Aug. 10, 2016, 4:33 p.m.)
> 
> 
> Review request for Documentation, KDE Utils, Elvis Angelaccio, and Ragnar Thomsen.
> 
> 
> Repository: ark
> 
> 
> Description
> -------
> 
> man page
>   proofread, bump date + releaseinfo, add "See Also" with info about more qt + kf5 options
> 
> handbook
>   proofread, bump date + releaseinfo
>   add features integrity test, compression and multi-volume
>   update / add screenshot
> 
> content + pngs from https://rthomsen6.wordpress.com/2016/08/01/ark-improvements-in-16-08/
> 
> @ Elvis + Ragnar:
> for sections compression + multi volume please provide some input, answer my questions in the FIXME's, thanks.
> 
> 
> Diffs
> -----
> 
>   doc/create-protected-archive.png 686d701 
>   doc/index.docbook da20381 
>   doc/man-ark.1.docbook 9786bca 
> 
> Diff: https://git.reviewboard.kde.org/r/128645/diff/
> 
> 
> Testing
> -------
> 
> passes checkXML5
> 
> 
> File Attachments
> ----------------
> 
> create-archive.png
>   https://git.reviewboard.kde.org/media/uploaded/files/2016/08/10/a19f3256-6af7-411b-a6bd-efb41bd501d6__create-archive.png
> create-protected-archive.png
>   https://git.reviewboard.kde.org/media/uploaded/files/2016/08/10/f525f6ee-ca03-4264-a9ed-d25b902c28e7__create-protected-archive.png
> 
> 
> Thanks,
> 
> Burkhard Lück
> 
>

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.kde.org/pipermail/kde-utils-devel/attachments/20160810/fea3c45c/attachment.html>