Re: [PATCH] iconv.1: New page for iconv(1)

[Marko Myllynen <myllynen-H+wXaHxf7aLQT0dZR+AlfA@public.gmane.org>]

Hi,

On 2014-06-11 22:15, Michael Kerrisk (man-pages) wrote:
> On 06/11/2014 04:14 PM, Marko Myllynen wrote:
>> On 2014-06-11 17:03, Michael Kerrisk (man-pages) wrote:
>>> On Wed, Jun 11, 2014 at 3:30 PM, Marko Myllynen <myllynen-H+wXaHxf7aJhl2p70BpVqQ@public.gmane.orgm> wrote:
>>>> On 2014-06-11 13:07, Michael Kerrisk (man-pages) wrote:
>>>>> On 06/11/2014 10:09 AM, Marko Myllynen wrote:
>>>>>> On 2014-06-10 22:28, Michael Kerrisk (man-pages) wrote:
>>>>>>> On 06/10/2014 10:38 AM, Marko Myllynen wrote:
> 
> So, how does the following look to you:

it looks very good, thanks for this!

> ENVIRONMENT
>        Internally, the iconv program uses the iconv(3) function  which
>        in   turn   uses   gconv  modules  (dynamically  loaded  shared
>        libraries) to convert to and  from  a  character  set.   Before
>        calling  iconv(3), the iconv program must first allocate a con‐
>        version descriptor using iconv_open(3).  The operation  of  the
>        latter  function is influenced by the setting of the GCONV_PATH
>        environment variable:
> 
>        *  If GCONV_PATH is not set,  iconv_open(3)  loads  the  system
>           gconv  cache  file created by iconvconfig(8) and then, based
>           on the configuration, loads the gconv modules needed to per‐
>           form the conversion.
> 
>        *  If GCONV_PATH is defined (as a colon-separated list of path‐
>           names), the system gconv module configuration cache  is  not
>           used.   Instead,  iconv_open(3) first tries to load the con‐
>           figuration files from one of the directories in  GCONV_PATH,
>           followed  by  the system configuration file.  If a directory
>           does not contain a  gconv  module  configuration  file,  any
>           gconv  modules that it may contain are ignored.  If a direc‐
>           tory contains a gconv module configuration file  and  it  is
>           determined  that  a  module  needed  for  this conversion is
>           available in the directory, then the needed module is loaded
>           from  that  directory,  the  order being such that the first
>           suitable module found in GCONV_PATH is  used.   This  allows
>           users to use custom modules and even replace system-provided
>           modules by providing such modules in GCONV_PATH directories.
> 
>        iconv supports any character  set  for  which  a  corresponding
>        gconv configuration and module are provided.
> 
> I have two doubts about the above text:
> 
> * What is "the system configuration file"?

It is listed in the FILES section, does that clarify enough?

> * The last sentence (left over from your earlier text) seems out
> of place. Is it needed? If it is, I think we need a better place
> for it.

I think the same thing is already said (albeit slightly less explicitly)
above it so I don't think it's needed anymore.

Thanks,

-- 
Marko Myllynen
--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to majordomo-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html