Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!
Bug 480416 - installation handbook - change recommended application for checksum verification on MS Windows
Summary: installation handbook - change recommended application for checksum verificat...
Status: RESOLVED FIXED
Alias: None
Product: [OLD] Docs on www.gentoo.org
Classification: Unclassified
Component: Installation Handbook (show other bugs)
Hardware: All Linux
: Normal normal (vote)
Assignee: Sven Vermeulen (RETIRED)
URL: http://www.gentoo.org/doc/en/handbook...
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2013-08-09 18:37 UTC by Ben Kohler
Modified: 2013-08-10 13:25 UTC (History)
2 users (show)

See Also:
Package list:
Runtime testing required: ---


Attachments
first adware offering (hb-checksum-tool-bug1.png,19.37 KB, image/png)
2013-08-09 18:37 UTC, Ben Kohler
Details
second adware offering (hb-checksum-tool-bug2.png,20.78 KB, image/png)
2013-08-09 18:38 UTC, Ben Kohler
Details
screenshot of old vs new gui (hb-checksum-tool-bug3.png,27.49 KB, image/png)
2013-08-09 18:39 UTC, Ben Kohler
Details
handbook patch (hb-checksum-tool-bug.diff,615 bytes, patch)
2013-08-09 18:45 UTC, Ben Kohler
Details | Diff

Note You need to log in before you can comment on or make changes to this bug.
Description Ben Kohler gentoo-dev 2013-08-09 18:37:38 UTC
Created attachment 355522 [details]
first adware offering

From the handbook:

"In case you wonder if your downloaded file is corrupted or not, you can check its SHA-2 checksum and compare it with the SHA-2 checksum we provide (such as install-amd64-minimal-<release>.iso.DIGESTS). You can check the SHA-2 checksum with the sha512sum tool under Linux/Unix or File Checksum Tool for Windows."

This currently-recommended tool (http://www.krylack.com/file-checksum-tool/) is non-F/OSS and now bundles ("optionally") 2 pieces of adware.  There are comparable F/OSS tools available without the adware encumbrance.

Ubuntu mentions/recommends a few tools here: https://help.ubuntu.com/community/HowToMD5SUM#MD5SUM_on_Windows .  I like the second one, "Checksums calculator"-- it's simple, free & open, and localized in 19 languages.  We aren't providing any usage instructions for the currently linked tool, so the doc change would be minimal.
Comment 1 Ben Kohler gentoo-dev 2013-08-09 18:38:05 UTC
Created attachment 355524 [details]
second adware offering
Comment 2 Ben Kohler gentoo-dev 2013-08-09 18:39:54 UTC
Created attachment 355526 [details]
screenshot of old vs new gui

Old (current, adware-encumbered) tool on the left, new suggested tool on the right.  I don't think the difference is enough to make any further changes in the doc besides the tool name & link.
Comment 3 Ben Kohler gentoo-dev 2013-08-09 18:45:37 UTC
Created attachment 355528 [details, diff]
handbook patch

I forgot to mention the direct link to the new tool I'm suggesting: http://www.sinf.gr/en/hashcalc.html

Attached is a patch with the proposed HB fix.
Comment 4 Sven Vermeulen (RETIRED) gentoo-dev 2013-08-10 13:25:45 UTC
Thanks! Great bugreport & fix. I've applied it to the CVS (also to the other architectural handbooks that referred to the krylack one) so it should show up on the site in an hour or so.