Bug 140182 - Minor correction/enhancement to Kmail documentation (chapter 7)
Summary: Minor correction/enhancement to Kmail documentation (chapter 7)
Status: RESOLVED FIXED
Alias: None
Product: docs.kde.org
Classification: Websites
Component: Corrections (show other bugs)
Version: unspecified
Platform: Gentoo Packages Linux
: NOR wishlist
Target Milestone: ---
Assignee: Documentation Editorial Team
URL:
Keywords:
Depends on:
Blocks:
 
Reported: 2007-01-17 06:54 UTC by dave0x01
Modified: 2007-09-03 00:30 UTC (History)
0 users

See Also:
Latest Commit:
Version Fixed In:


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description dave0x01 2007-01-17 06:54:42 UTC
Version:           1.9.5 (using KDE KDE 3.5.5)
Installed from:    Gentoo Packages
OS:                Linux

In chapter 7, accessible from <help:/kmail/importing.html>:

Under the heading "Mailsmith", the command given to covert newline format from Mac to Unix can be more efficiently written as:

perl -pe 's/\r/\n/g' mail-mac.txt > mail-unix.txt
or:
perl -i -pe 's/\r/\n/g' mail-mac.txt

The latter edits the file in-place, and should not be used if the original file is to be retained.

The command given in the present documentation is as follows:

cat mail-mac.txt | perl -e 'while (<STDIN>) { s/\r/\n/gi; print $_ ;}' > mail-unix.txt

Which, while equivalent, is more cumbersome to type and less efficient.  In addition, the "i" flag (for case-insensitive matching) is meaningless, since control characters have no case.  People notice these things.
Comment 1 Frederik Schwarzer 2007-09-03 00:28:03 UTC
Fixed in trunk (and forgot to close with commit):

Index: importing.docbook
===================================================================
--- importing.docbook   (revision 707781)
+++ importing.docbook   (working copy)
@@ -91,8 +91,7 @@
 the &Mac; line breaks to &UNIX; line breaks using your favorite editor, or using the following
 command under &Linux;:</para>

-<para><userinput><command>cat</command> <option>mail-mac.txt</option>
-| perl -e 'while (&lt;STDIN&gt;) { s/\r/\n/gi; print $_ ;}'  &gt; mail-unix.txt</userinput></para>
+<para><userinput><command>perl</command> <option>-pe 's/\r/\n/g'</option> mail-mac.txt > mail-unix.txt</userinput></para>

 <para>&kmail; will only recognize mboxes placed directly in the <filename class="directory">~/Mail/</filename>
 folder. This means that  a folder hierarchy cannot be preserved by simply moving files into the


thanks for the report
Comment 2 Frederik Schwarzer 2007-09-03 00:30:18 UTC
Forgot to say:
Fixed with revision 707784
(it's late...)