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

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



On Fri, Jun 13, 2014 at 11:15 AM, Marko Myllynen <myllynen@xxxxxxxxxx> wrote:
> 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.


Done. And I made a similar change in the FILES section of iconvconfig.8.

Cheers,

Michael

-- 
Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
Linux/UNIX System Programming Training: http://man7.org/training/
--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to majordomo@xxxxxxxxxxxxxxx
More majordomo info at  http://vger.kernel.org/majordomo-info.html




[Index of Archives]     [Kernel Documentation]     [Netdev]     [Linux Ethernet Bridging]     [Linux Wireless]     [Kernel Newbies]     [Security]     [Linux for Hams]     [Netfilter]     [Bugtraq]     [Yosemite News]     [MIPS Linux]     [ARM Linux]     [Linux RAID]     [Linux Admin]     [Samba]

  Powered by Linux