Re: [bug-gnu-libiconv] Very minor wording change suggestion on iconv_open man page

[Bruno Haible]

Hello,

Perry Rapp wrote:
> This is not exactly a bug report, but I suggest one minor wordiing
> change in the iconv_open man page:
> 
>    libiconv-1.11/man/iconv_open.3
> ...
> I think "similarly looking" sounds awkward and of questionable grammar.

I agree.

> >it can be approximated through one or several similarly looking characters.
> 
> => it can be approximated through one or several similar characters.

This drops the information about what kinds of approximations iconv does.

> If you think the it better to retain the reference to appearance, then
> I suggest this:
> 
> => it can be approximated through one or several characters, similar in
> appearance to the original.

This is better. But I don't like so many noun words in a sentence, when a
verb can be used. I'm applying this. Thanks for the suggestion.

Bruno


--- man/iconv_open.3    31 Mar 2007 23:25:25 -0000      1.28
+++ man/iconv_open.3    24 Apr 2007 06:58:34 -0000
@@ -9,7 +9,7 @@
 .\"   GNU glibc-2 source code and manual
 .\"   OpenGroup's Single Unix specification 
http://www.UNIX-systems.org/online.html
 .\"
-.TH ICONV_OPEN 3  "March 31, 2007" "GNU" "Linux Programmer's Manual"
+.TH ICONV_OPEN 3  "April 24, 2007" "GNU" "Linux Programmer's Manual"
 .SH NAME
 iconv_open \- allocate descriptor for character set conversion
 .SH SYNOPSIS
@@ -172,8 +172,8 @@
 .PP
 When the string "//TRANSLIT" is appended to \fItocode\fP, transliteration
 is activated. This means that when a character cannot be represented in the
-target character set, it can be approximated through one or several
-similarly looking characters.
+target character set, it can be approximated through one or several characters
+that look similar to the original character.
 .PP
 When the string "//IGNORE" is appended to \fItocode\fP, characters that
 cannot be represented in the target character set will be silently discarded.