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