Re: [PATCH] Fix documentation for hcache's MD5 generation
Hi,
* Ralf Wildenhues [06-07-05 13:32:09 +0200] wrote:
'echo -n' is not portable. I'd suggest
printf '%s' $folder
instead, which should work on all but some ancient hosts.
Fixed and revised patch attached, thanks for clarification.
bye, Rocco
--
:wq!
diff --git a/doc/manual.xml.head b/doc/manual.xml.head
index 206960c..713b80e 100644
--- a/doc/manual.xml.head
+++ b/doc/manual.xml.head
@@ -4520,10 +4520,25 @@ to a directory.
</para>
<para>
-For the one-file-per-folder case, database files will be named by
-MD5 sums and can be removed if a system is short on space. However,
-there currently is no easy to find out which database file is used
-for which folder.
+For the one-file-per-folder case, database files will be named by MD5
+sums and can be removed if a system is short on space. By issuing a
+command like in the following examples, one can find out the MD5-based
+database file name for a folder (<emphasis role="bold">note</emphasis>
+the <literal>-n</literal> option to <literal>echo</literal> command
+as the trailing newline isn't taken into account by mutt when generating
+the checksum):
+</para>
+
+<para>
+<screen>
+$ printf '%s' '/path/to/folder' | md5sum
+$ printf '%s' 'imaps://user@host/path/to/folder' | md5sum
+</screen>
+</para>
+
+<para>
+Depending on the system used, the <literal>md5sum</literal> command may
+be named just <literal>md5</literal> (such as FreeBSD, for example).
</para>
</sect2>