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

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

Hi,

On 2014-06-12 21:44, Michael Kerrisk (man-pages) wrote:
>>
>>> 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?
> 
> I wondered about that. But the term "system configuration file" does
> not appear in FILES. Is it "Usual default gconv module configuration"?
> If so, that's not so obvious because the terms differ.

you're right, using "system default gconv module configuration" in both
places should make it obvious.

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