← Back to branch summary

~win-cross-dev/win-cross/gettext

« back to all changes in this revision

Viewing changes to PACKAGING

  • Committer: Nathan Osman
  • Date: 2012-08-11 05:06:52 UTC
  • Revision ID: admin@quickmediasolutions.com-20120811050652-ochkxjtonbw6kkve
Initial commit.

Show diffs side-by-side

added added

removed removed

Lines of Context:
PACKAGING
 
1
Packaging hints for binary package distributors
 
2
===============================================
 
3
 
 
4
Although the source of the gettext package comes as a single package,
 
5
I recommend that in distributions of binary packages the installed files
 
6
be split into two packages:
 
7
 
 
8
   gettext-runtime
 
9
        Contents: Runtime libraries and programs.
 
10
        Audience: Anyone who wants to run internationalized programs.
 
11
 
 
12
   gettext-tools
 
13
        Contents: Tools and documentation for developers and translators.
 
14
        Audience: Anyone who wants to develop or localize internationalized
 
15
                  programs, i.e. developers and translators.
 
16
        Dependencies: requires gettext-runtime.
 
17
 
 
18
The 'gettext-runtime' binary package is much smaller than the 'gettext-tools'
 
19
binary package (420 KB versus 5.5 MB). I recommend to include it in the default
 
20
installation list, like GNU 'coreutils'; in fact, the runtime programs are
 
21
utilities for sh programs.
 
22
 
 
23
The 'gettext-runtime' binary package can be installed by doing
 
24
 
 
25
      cd gettext-runtime
 
26
      ./configure
 
27
      make
 
28
      make install
 
29
 
 
30
The 'gettext-tools' binary package can be installed by doing
 
31
 
 
32
      cd gettext-tools
 
33
      ./configure
 
34
      make
 
35
      make install
 
36
 
 
37
If you want to install both at the same time, you simply do at the toplevel
 
38
directory:
 
39
 
 
40
      ./configure
 
41
      make
 
42
      make install
 
43
 
 
44
The precise split between gettext and gettext-tools is according to the
 
45
following file list.
 
46
 
 
47
   gettext-runtime
 
48
 
 
49
      $prefix/share/gettext/ABOUT-NLS
 
50
 
 
51
      $prefix/bin/gettext
 
52
      $prefix/bin/ngettext
 
53
      $prefix/bin/envsubst
 
54
      $prefix/bin/gettext.sh
 
55
      $prefix/share/man/man1/gettext.1
 
56
      $prefix/share/man/man1/ngettext.1
 
57
      $prefix/share/man/man1/envsubst.1
 
58
      $prefix/share/doc/gettext/gettext.1.html
 
59
      $prefix/share/doc/gettext/ngettext.1.html
 
60
      $prefix/share/doc/gettext/envsubst.1.html
 
61
      $prefix/share/locale/*/LC_MESSAGES/gettext-runtime.mo
 
62
 
 
63
      $prefix/lib/libintl.*               (not installed on glibc systems)
 
64
      $prefix/lib/charset.alias           (not installed on glibc systems)
 
65
      $prefix/share/locale/locale.alias   (not installed on glibc systems)
 
66
      $prefix/include/libintl.h           (not installed on glibc systems)
 
67
      $prefix/share/man/man3/*
 
68
      $prefix/share/doc/gettext/*.3.html
 
69
 
 
70
      $prefix/share/gettext/libintl.jar
 
71
      $prefix/share/doc/gettext/javadoc2/*
 
72
 
 
73
      $prefix/lib/GNU.Gettext.dll
 
74
      $prefix/share/doc/gettext/csharpdoc/*
 
75
 
 
76
      $prefix/lib/libasprintf.*
 
77
      $prefix/include/autosprintf.h
 
78
      $prefix/share/doc/libasprintf/autosprintf.html
 
79
      $prefix/info/autosprintf.info
 
80
 
 
81
   gettext-tools
 
82
 
 
83
      Everything else, i.e. currently:
 
84
 
 
85
      $prefix/bin/msg*
 
86
      $prefix/bin/xgettext
 
87
      $prefix/bin/gettextize
 
88
      $prefix/bin/autopoint
 
89
      $prefix/bin/recode*
 
90
      $prefix/share/man/man1/msg*.1
 
91
      $prefix/share/man/man1/xgettext.1
 
92
      $prefix/share/man/man1/gettextize.1
 
93
      $prefix/share/man/man1/autopoint.1
 
94
      $prefix/share/doc/gettext/msg*.1.html
 
95
      $prefix/share/doc/gettext/xgettext.1.html
 
96
      $prefix/share/doc/gettext/gettextize.1.html
 
97
      $prefix/share/doc/gettext/autopoint.1.html
 
98
      $prefix/share/doc/gettext/gettext_*.html
 
99
      $prefix/share/doc/gettext/FAQ.html
 
100
      $prefix/share/doc/gettext/examples/*
 
101
      $prefix/info/gettext.info*
 
102
      $prefix/include/gettext-po.h
 
103
      $prefix/lib/libgettextlib*
 
104
      $prefix/lib/libgettextsrc*
 
105
      $prefix/lib/libgettextpo*
 
106
      $prefix/lib/preloadable_libintl.so  (only installed on glibc systems)
 
107
      $prefix/lib/gettext/*
 
108
      $prefix/share/locale/*/LC_MESSAGES/gettext-tools.mo
 
109
      $prefix/share/gettext/config.rpath
 
110
      $prefix/share/gettext/intl/*
 
111
      $prefix/share/gettext/po/*
 
112
      $prefix/share/gettext/projects/*
 
113
      $prefix/share/gettext/gettext.h
 
114
      $prefix/share/gettext/gettext.jar   (only installed if gcj is not present)
 
115
      $prefix/share/gettext/msgunfmt.tcl
 
116
      $prefix/share/gettext/archive.cvs.tar.gz
 
117
      $prefix/share/gettext/archive.git.tar.gz   (only installed if --with-git specified)
 
118
      $prefix/share/gettext/archive.dir.tar.gz   (only installed if --without-cvs specified)
 
119
      $prefix/share/aclocal/codeset.m4
 
120
      $prefix/share/aclocal/fcntl-o.m4
 
121
      $prefix/share/aclocal/gettext.m4
 
122
      $prefix/share/aclocal/glibc2.m4
 
123
      $prefix/share/aclocal/glibc21.m4
 
124
      $prefix/share/aclocal/iconv.m4
 
125
      $prefix/share/aclocal/intdiv0.m4
 
126
      $prefix/share/aclocal/intl.m4
 
127
      $prefix/share/aclocal/intldir.m4
 
128
      $prefix/share/aclocal/intlmacosx.m4
 
129
      $prefix/share/aclocal/intmax.m4
 
130
      $prefix/share/aclocal/inttypes_h.m4
 
131
      $prefix/share/aclocal/inttypes-pri.m4
 
132
      $prefix/share/aclocal/lcmessage.m4
 
133
      $prefix/share/aclocal/lib-ld.m4
 
134
      $prefix/share/aclocal/lib-link.m4
 
135
      $prefix/share/aclocal/lib-prefix.m4
 
136
      $prefix/share/aclocal/lock.m4
 
137
      $prefix/share/aclocal/longlong.m4
 
138
      $prefix/share/aclocal/nls.m4
 
139
      $prefix/share/aclocal/po.m4
 
140
      $prefix/share/aclocal/printf-posix.m4
 
141
      $prefix/share/aclocal/progtest.m4
 
142
      $prefix/share/aclocal/size_max.m4
 
143
      $prefix/share/aclocal/stdint_h.m4
 
144
      $prefix/share/aclocal/uintmax_t.m4
 
145
      $prefix/share/aclocal/visibility.m4
 
146
      $prefix/share/aclocal/wchar_t.m4
 
147
      $prefix/share/aclocal/wint_t.m4
 
148
      $prefix/share/aclocal/xsize.m4
 
149
      $prefix/share/emacs/site-lisp/po-compat.el
 
150
      $prefix/share/emacs/site-lisp/po-compat.elc
 
151
      $prefix/share/emacs/site-lisp/po-mode.el
 
152
      $prefix/share/emacs/site-lisp/po-mode.elc
 
153
      $prefix/share/emacs/site-lisp/start-po.el
 
154
      $prefix/share/emacs/site-lisp/start-po.elc
 
155
 
 
156
 
 
157
Java support:
 
158
-------------
 
159
 
 
160
If GNU gcj is available at build time, two programs will be built as native
 
161
executables:
 
162
      $prefix/lib/gettext/gnu.gettext.*
 
163
and the gettext-tools package will therefore have a runtime dependency to
 
164
libgcj.so.
 
165
 
 
166
If GNU gcj is not available at build time but another Java implementation is
 
167
available instead, the two programs will be compiled to Java bytecode only:
 
168
      $prefix/share/gettext/gettext.jar
 
169
and the gettext-tools package will therefore have a runtime dependency to
 
170
the Java virtual machine (Sun Java2, IBM Java2, GNU libgcj.jar, or other).
 
171
 
 
172
 
 
173
C# support:
 
174
-----------
 
175
 
 
176
For C# support, one of pnet or mono must be available at build time; it must
 
177
also be available at run time. If you have both available, choose the desired
 
178
one through the configure option. Note there is no interoperability currently
 
179
between pnet and mono: Programs compiled with pnet don't run with mono, and
 
180
vice versa.