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? > * 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@xxxxxxxxxxxxxxx More majordomo info at http://vger.kernel.org/majordomo-info.html
