Hi Marko, On Thu, Jun 12, 2014 at 7:40 PM, Marko Myllynen <myllynen@xxxxxxxxxx> wrote: > 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@xxxxxxxxxx> 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? 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. >> * 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. Okay -- I removed the sentence. 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
