git@vger.kernel.org mailing list mirror (one of many)
 help / color / mirror / code / Atom feed
From: Johannes Schindelin <Johannes.Schindelin@gmx.de>
To: "Ævar Arnfjörð Bjarmason" <avarab@gmail.com>
Cc: Karsten Blees via GitGitGadget <gitgitgadget@gmail.com>,
	git@vger.kernel.org, Junio C Hamano <gitster@pobox.com>,
	Karsten Blees <blees@dcon.de>
Subject: Re: [PATCH v2 1/1] gettext: always use UTF-8 on native Windows
Date: Mon, 8 Jul 2019 14:57:56 +0200 (CEST)	[thread overview]
Message-ID: <nycvar.QRO.7.76.6.1907081446030.44@tvgsbejvaqbjf.bet> (raw)
In-Reply-To: <87o92976nz.fsf@evledraar.gmail.com>

[-- Attachment #1: Type: text/plain, Size: 6329 bytes --]

Hi Ævar,

On Fri, 5 Jul 2019, Ævar Arnfjörð Bjarmason wrote:

> On Wed, Jul 03 2019, Karsten Blees via GitGitGadget wrote:
>
> > From: Karsten Blees <blees@dcon.de>
> >
> > On native Windows, Git exclusively uses UTF-8 for console output (both
> > with MinTTY and native Win32 Console). Gettext uses `setlocale()` to
> > determine the output encoding for translated text, however, MSVCRT's
> > `setlocale()` does not support UTF-8. As a result, translated text is
> > encoded in system encoding (as per `GetAPC()`), and non-ASCII chars are
> > mangled in console output.
> >
> > Side note: There is actually a code page for UTF-8: 65001. In practice,
> > it does not work as expected at least on Windows 7, though, so we cannot
> > use it in Git. Besides, if we overrode the code page, any process
> > spawned from Git would inherit that code page (as opposed to the code
> > page configured for the current user), which would quite possibly break
> > e.g. diff or merge helpers. So we really cannot override the code page.
> >
> > In `init_gettext_charset()`, Git calls gettext's
> > `bind_textdomain_codeset()` with the character set obtained via
> > `locale_charset()`; Let's override that latter function to force the
> > encoding to UTF-8 on native Windows.
> >
> > In Git for Windows' SDK, there is a `libcharset.h` and therefore we
> > define `HAVE_LIBCHARSET_H` in the MINGW-specific section in
> > `config.mak.uname`, therefore we need to add the override before that
> > conditionally-compiled code block.
> >
> > Rather than simply defining `locale_charset()` to return the string
> > `"UTF-8"`, though, we are careful not to break `LC_ALL=C`: the
> > `ab/no-kwset` patch series, for example, needs to have a way to prevent
> > Git from expecting UTF-8-encoded input.
>
> It's not just the ab/no-kwset I have cooking (but happy to have this
> take that into account), but also anything grep-like is usually must
> faster with LC_ALL=C. Isn't that also the case on Windows?

Probably. I have never tested this.

> Setting locales affects a large variety of libc functions and third
> party libraries (e.g. PCRE via us setting "use UTF-8" under locale).

Yes, but as I mentioned in the commit message, setting locales in MINGW
programs is murky at best. There is the idea of gettext, and there is the
idea of Windows, and they are likely a bit different from one another.

> > Signed-off-by: Karsten Blees <blees@dcon.de>
> > Signed-off-by: Johannes Schindelin <johannes.schindelin@gmx.de>
> > ---
> >  gettext.c | 20 +++++++++++++++++++-
> >  1 file changed, 19 insertions(+), 1 deletion(-)
> >
> > diff --git a/gettext.c b/gettext.c
> > index d4021d690c..3f2aca5c3b 100644
> > --- a/gettext.c
> > +++ b/gettext.c
> > @@ -12,7 +12,25 @@
> >  #ifndef NO_GETTEXT
> >  #	include <locale.h>
> >  #	include <libintl.h>
> > -#	ifdef HAVE_LIBCHARSET_H
> > +#	ifdef GIT_WINDOWS_NATIVE
> > +
> > +static const char *locale_charset(void)
> > +{
> > +	const char *env = getenv("LC_ALL"), *dot;
> > +
> > +	if (!env || !*env)
> > +		env = getenv("LC_CTYPE");
> > +	if (!env || !*env)
> > +		env = getenv("LANG");
> > +
> > +	if (!env)
> > +		return "UTF-8";
> > +
> > +	dot = strchr(env, '.');
> > +	return !dot ? env : dot + 1;
> > +}
> > +
> > +#	elif defined HAVE_LIBCHARSET_H
> >  #		include <libcharset.h>
> >  #	else
> >  #		include <langinfo.h>
>
> I'll take it on faith that this is what the locale_charset() should look
> like.

I copy/edited that code from a later code block in `is_utf8_locale()` that
is also conditional (under `NO_GETTEXT`, hence no attempt to refactor it,
as that would make the code even less readable).

So I am fairly confident that the code is _correct_.

Whether it is elegant, I cannot really say. It strikes me as ugly, in
those indented `#ifdef..#endif` guards, yet I did not find a way to make
it less ugly.

> I wonder if it wouldn't be better to always compile this function, and
> just have init_gettext_charset() switch between the two.

Based on what? If the switch is a compile time switch, then this function
must be under the same compile time guard, otherwise GCC will complain
about an unused static function.

> We've moved more towards that sort of thing (e.g. with pthreads). I.e.
> prefer redundant compilation to ifdefing platform-only code (which then
> only gets compiled there). See "HAVE_THREADS" in the code.

How does that even avoid complaints by GCC about dead code.

> It looks to me that with this patch the HAVE_LIBCHARSET_H docs in
> "Makefile" become wrong. Shouldn't those be updated too?

That comment says:

# Define HAVE_LIBCHARSET_H if you haven't set NO_GETTEXT and you can't
# trust the langinfo.h's nl_langinfo(CODESET) function to return the
# current character set. [...]

I think it still applies.

> We also still pass -DHAVE_LIBCHARSET_H to every file we compile, only to
> never use it under GIT_WINDOWS_NATIVE, but perhaps fixing that isn't
> possible with GIT_WINDOWS_NATIVE being a macro, and perhaps I've again
> gotten the "native" v.s. "mingw" etc. relationship wrong in my head and
> the HAVE_LIBCHARSET_H docs are fine.

MinGW is a really old, outdated thing. These days, mingw-w64 is the rage
(it even supports building 64-bit binaries, would you believe that?
</sarcasm>). And neither is "native", strictly, although it is as native
as you can get with GCC.

And as you say, the macro thing makes it hard/impossible to decide in
Makefile whether we want to pass HAVE_LIBCHARSET_H or not. So we should do
it independently of whether we're on Windows or not.

> It just seems wrong that we have both the configure script &
> config.mak.uname look for / declare that we have libcharset.h, only to
> at this late point not use libcharset.h at all. Couldn't we just know if
> GIT_WINDOWS_NATIVE will be true earlier & move that check up, so it &
> HAVE_LIBCHARSET_H can be mutually exclusive (with accompanying #error if
> we have both)?

I don't think that this is wrong, as it is correct in pretty much all
circumstances except Git for Windows. And even in Git for Windows it is
correct: we do have a `libcharset.h`. We just can't use it to determine
the current locale.

Ciao,
Dscho

  reply	other threads:[~2019-07-08 12:57 UTC|newest]

Thread overview: 9+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2019-06-27  8:44 [PATCH 0/1] gettext(windows): always use UTF-8 Johannes Schindelin via GitGitGadget
2019-06-27  8:44 ` [PATCH 1/1] gettext: always use UTF-8 on native Windows Karsten Blees via GitGitGadget
2019-07-03 11:26   ` Johannes Schindelin
2019-07-03 18:31     ` Junio C Hamano
2019-07-03 20:46 ` [PATCH v2 0/1] gettext(windows): always use UTF-8 Johannes Schindelin via GitGitGadget
2019-07-03 20:46   ` [PATCH v2 1/1] gettext: always use UTF-8 on native Windows Karsten Blees via GitGitGadget
2019-07-04 22:53     ` Ævar Arnfjörð Bjarmason
2019-07-08 12:57       ` Johannes Schindelin [this message]
2019-07-08 18:30       ` Junio C Hamano

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

  List information: http://vger.kernel.org/majordomo-info.html

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=nycvar.QRO.7.76.6.1907081446030.44@tvgsbejvaqbjf.bet \
    --to=johannes.schindelin@gmx.de \
    --cc=avarab@gmail.com \
    --cc=blees@dcon.de \
    --cc=git@vger.kernel.org \
    --cc=gitgitgadget@gmail.com \
    --cc=gitster@pobox.com \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
Code repositories for project(s) associated with this public inbox

	https://80x24.org/mirrors/git.git

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).