-*- mode: text; coding: utf-8 -*- Time-stamp: "07/06/28 16:04:08 jemarch"

README for gv
=============

This is version 3.6.5 of gv, an X11 ghostscript frontend based on
Tim Theisen's ghostview 1.5.

The most recent version may be obtained from gv's homepage at

   http://www.gnu.org/software/gv/

or via anonymous ftp from

   ftp://ftp.gnu.org/gnu/gv/

Please send suggestions or bug reports to bug-gv@gnu.org

--
José E. Marchesi (jemarch@gnu.org)

GV I18N Fontset Patch
			Keio University in Japan
			1998 Yasuyuki Furukawa <yasu@on.cs.keio.ac.jp>

This patch make gv to support UTF8.

Note that Xaw3d version 1.5E or 1.6.1 or newer is required for UTF8-Support.

Note that UTF8-Mode is currently turned off by default.
To enable it, you have two possibilities:

1. include the resource

      GV*international:		True

   e. g. in ~/.gv

2. The configure parameter --enable-international will turn on
   international by default.




NEED:
	Xaw3d 1.4, 1.5 and 1.6.0 and 1.6.1 has a fatal bug in MultiSrc.c line 735-740.
	This GV's patch need Xaw3d library patched follow:

*** xc/lib/Xaw3d/MultiSrc.c	Fri May 15 04:03:23 1998
--- xc-fix/lib/Xaw3d/MultiSrc.c	Fri Dec 18 09:59:52 1998
@@ -736,6 +736,7 @@

   if ( string_set || (old_src->multi_src.type != src->multi_src.type) ) {
     RemoveOldStringOrFile(old_src, string_set);
+    src->multi_src.allocated_string = old_src->multi_src.allocated_string;
     file = InitStringOrFile(src, string_set);

     /* Load pieces does this logic for us, but it shouldn't.  Its messy.*/



Another bug in Xaw3d will segfault in closing the application. The following
patch will fix it:

--- XawIm.c
+++ XawIm.c
@@ -331,12 +331,12 @@ static void DestroyAllIM( ve )
     /*
      * Close Input Method
      */
-    CloseIM(ve);
     if (!XFindContext(XDisplayOfIM(ve->im.xim), (Window)ve->im.xim, errContext,
 		      (XPointer*)&contextErrData)) {
 	if (contextErrData) XtFree((char *)contextErrData);
     }
     XDeleteContext(XDisplayOfIM(ve->im.xim), (Window)ve->im.xim, errContext);
+    CloseIM(ve);
     ve->im.xim = NULL;

     /*

A collection of Xaw3D 1.5E and 1.6.x bug fixing patches can be found on
git://gitorious.org/xaw3d/xaw3d.git.
For Xaw3d 1.5E take the master branch, for libXaw3d 1.6.x take the
"v1.6-branch", "v1.6.1-branch" and so on.

(1) Prerequisites

Make sure that GNU gv has been installed if you want to test the translation.
In this case also make sure you have turned on international mode for GNU gv
(see README.I18N for details).

Otherwise compiling GNU gv and taking the generated file
"src/gv-update-userconfig" will be enough.
Also make sure that perl 5.8 or newer is working.



(2) File names of the translation file

The file has to be named "$LOCLAE.dat", where $LOCALE may be e. g. "de_AT.utf8"
for the austrian locale. See appendix "(B) Naming locales" for details.

If you do not have a translation file, start with an empty one, that is,
create one with "touch $LOCALE.dat".




(3) Getting the file to translate / Updating it

simply run "gv-update-userconfig -i $LOCALE.dat"

This command will add all strings that are not in the translation file to the
end of that file.



(4) Translating the strings

After (3) you will find in your $LOCALE.dat many lines like the followings:

GV*copyright.Label:                     Copyright
GV*miscmenuLabel.label:                 Misc Menu Entries
GV*optionsgv.Label:                     gv Options ...
GV*mark.Label:                          Mark
GV*dismiss.Label:                       Dismiss

Just overwrite the right hand side with your translation.



Important: Do not change the "GV.version" resource which may look like the
following:

GV.version:             gv 3.6.7.90


(5) Testing your translation (optional)

Create a symlink "~/.gv-$LOCALE" to the rranslation file $LOCALE.dat unless you have already done so.

Just run gv, your symlink "~/.gv-$LOCALE" will ensure that your translation is
used instead of GNU gv's own strings.



(6) Submitting the translated files

See my job discription on http://sv.gnu.org/projects/gv for details.

I'll check if they are syntactically correct and copy them to "src/nls" in the
distribution tarball of GNU gv and update the src/nls/LANGUAGES file.









(A) What to do of more locales share the same translation strings?

src/nls/LANGUAGES can contain aliases for languages.
Assume "de_CH.utf8" uses the same translation strings as "de_AT.utf8".
"echo 'de_AT.utf8 -> de_CH.utf8' >> LANGUAGES" tells GNU gv to use the
strings from the locale "de_AT.utf8" for the locale "de_CH.utf8".




(B) Naming locales

A locale is named "language[_territory][.codeset][@modifier]".

If the complete locale does not match to one of the translations, the modifier
is removed. If this still does not match, the territory is removed.


IMPORTANT NOTE:
If international mode is turned off, the locale is prefixed with "noint:", e. g.
"noint:en_US". So locales are named "noint:language[_territory]".

Note that multibyte characters are not available in non-international mode.
For that reason it is wise not to use the translation from the international mode
for the non-international mode and codeset and modifier are not used to identify a
translation.
It's ok not to provide a translation for the non-international mode. But you can
provide one if you think that this is a good idea.





TODO: Which charset to use in non-international mode?  7-bit-ASCII might be a
good choice.