Documentation: add manpage about workflows
[git/trast.git] / git-gui / Makefile
blob55765c8a3aa6b3702b230e8efe3c2ab47a6e73e5
1 all::
3 # Define V=1 to have a more verbose compile.
5 # Define NO_MSGFMT if you do not have msgfmt from the GNU gettext
6 # package and want to use our rough pure Tcl po->msg translator.
7 # TCL_PATH must be vaild for this to work.
10 GIT-VERSION-FILE: .FORCE-GIT-VERSION-FILE
11 @$(SHELL_PATH) ./GIT-VERSION-GEN
12 -include GIT-VERSION-FILE
14 uname_S := $(shell sh -c 'uname -s 2>/dev/null || echo not')
15 uname_O := $(shell sh -c 'uname -o 2>/dev/null || echo not')
16 uname_R := $(shell sh -c 'uname -r 2>/dev/null || echo not')
18 SCRIPT_SH = git-gui.sh
19 GITGUI_MAIN := git-gui
20 GITGUI_BUILT_INS = git-citool
21 ALL_LIBFILES = $(wildcard lib/*.tcl)
22 PRELOAD_FILES = lib/class.tcl
23 NONTCL_LIBFILES = \
24 lib/git-gui.ico \
25 $(wildcard lib/win32_*.js) \
26 #end NONTCL_LIBFILES
28 ifndef SHELL_PATH
29 SHELL_PATH = /bin/sh
30 endif
32 ifndef gitexecdir
33 gitexecdir := $(shell git --exec-path)
34 endif
36 ifndef sharedir
37 ifeq (git-core,$(notdir $(gitexecdir)))
38 sharedir := $(dir $(patsubst %/,%,$(dir $(gitexecdir))))share
39 else
40 sharedir := $(dir $(gitexecdir))share
41 endif
42 endif
44 ifndef INSTALL
45 INSTALL = install
46 endif
48 RM_RF ?= rm -rf
49 RMDIR ?= rmdir
51 INSTALL_D0 = $(INSTALL) -d -m 755 # space is required here
52 INSTALL_D1 =
53 INSTALL_R0 = $(INSTALL) -m 644 # space is required here
54 INSTALL_R1 =
55 INSTALL_X0 = $(INSTALL) -m 755 # space is required here
56 INSTALL_X1 =
57 INSTALL_A0 = find # space is required here
58 INSTALL_A1 = | cpio -pud
59 INSTALL_L0 = rm -f # space is required here
60 INSTALL_L1 = && ln # space is required here
61 INSTALL_L2 =
62 INSTALL_L3 =
64 REMOVE_D0 = $(RMDIR) # space is required here
65 REMOVE_D1 = || true
66 REMOVE_F0 = $(RM_RF) # space is required here
67 REMOVE_F1 =
68 CLEAN_DST = true
70 ifndef V
71 QUIET = @
72 QUIET_GEN = $(QUIET)echo ' ' GEN '$@' &&
73 QUIET_INDEX = $(QUIET)echo ' ' INDEX $(dir $@) &&
74 QUIET_MSGFMT0 = $(QUIET)printf ' MSGFMT %12s ' $@ && v=`
75 QUIET_MSGFMT1 = 2>&1` && echo "$$v" | sed -e 's/fuzzy translations/fuzzy/' | sed -e 's/ messages*//g'
76 QUIET_2DEVNULL = 2>/dev/null
78 INSTALL_D0 = dir=
79 INSTALL_D1 = && echo ' ' DEST $$dir && $(INSTALL) -d -m 755 "$$dir"
80 INSTALL_R0 = src=
81 INSTALL_R1 = && echo ' ' INSTALL 644 `basename $$src` && $(INSTALL) -m 644 $$src
82 INSTALL_X0 = src=
83 INSTALL_X1 = && echo ' ' INSTALL 755 `basename $$src` && $(INSTALL) -m 755 $$src
84 INSTALL_A0 = src=
85 INSTALL_A1 = && echo ' ' INSTALL ' ' `basename "$$src"` && find "$$src" | cpio -pud
87 INSTALL_L0 = dst=
88 INSTALL_L1 = && src=
89 INSTALL_L2 = && dst=
90 INSTALL_L3 = && echo ' ' 'LINK ' `basename "$$dst"` '->' `basename "$$src"` && rm -f "$$dst" && ln "$$src" "$$dst"
92 CLEAN_DST = echo ' ' UNINSTALL
93 REMOVE_D0 = dir=
94 REMOVE_D1 = && echo ' ' REMOVE $$dir && test -d "$$dir" && $(RMDIR) "$$dir" || true
95 REMOVE_F0 = dst=
96 REMOVE_F1 = && echo ' ' REMOVE `basename "$$dst"` && $(RM_RF) "$$dst"
97 endif
99 TCLTK_PATH ?= wish
100 ifeq (./,$(dir $(TCLTK_PATH)))
101 TCL_PATH ?= $(subst wish,tclsh,$(TCLTK_PATH))
102 else
103 TCL_PATH ?= $(dir $(TCLTK_PATH))$(notdir $(subst wish,tclsh,$(TCLTK_PATH)))
104 endif
106 ifeq ($(uname_S),Darwin)
107 TKFRAMEWORK = /Library/Frameworks/Tk.framework/Resources/Wish.app
108 ifeq ($(shell expr "$(uname_R)" : '9\.'),2)
109 TKFRAMEWORK = /System/Library/Frameworks/Tk.framework/Resources/Wish\ Shell.app
110 endif
111 TKEXECUTABLE = $(shell basename "$(TKFRAMEWORK)" .app)
112 endif
114 ifeq ($(findstring $(MAKEFLAGS),s),s)
115 QUIET_GEN =
116 endif
118 -include config.mak
120 DESTDIR_SQ = $(subst ','\'',$(DESTDIR))
121 gitexecdir_SQ = $(subst ','\'',$(gitexecdir))
122 SHELL_PATH_SQ = $(subst ','\'',$(SHELL_PATH))
123 TCL_PATH_SQ = $(subst ','\'',$(TCL_PATH))
124 TCLTK_PATH_SQ = $(subst ','\'',$(TCLTK_PATH))
125 TCLTK_PATH_SED = $(subst ','\'',$(subst \,\\,$(TCLTK_PATH)))
127 gg_libdir ?= $(sharedir)/git-gui/lib
128 libdir_SQ = $(subst ','\'',$(gg_libdir))
129 libdir_SED = $(subst ','\'',$(subst \,\\,$(gg_libdir_sed_in)))
130 exedir = $(dir $(gitexecdir))share/git-gui/lib
132 GITGUI_SCRIPT := $$0
133 GITGUI_RELATIVE :=
134 GITGUI_MACOSXAPP :=
136 ifeq ($(uname_O),Cygwin)
137 GITGUI_SCRIPT := `cygpath --windows --absolute "$(GITGUI_SCRIPT)"`
139 # Is this a Cygwin Tcl/Tk binary? If so it knows how to do
140 # POSIX path translation just like cygpath does and we must
141 # keep libdir in POSIX format so Cygwin packages of git-gui
142 # work no matter where the user installs them.
144 ifeq ($(shell echo 'puts [file normalize /]' | '$(TCL_PATH_SQ)'),$(shell cygpath --mixed --absolute /))
145 gg_libdir_sed_in := $(gg_libdir)
146 else
147 gg_libdir_sed_in := $(shell cygpath --windows --absolute "$(gg_libdir)")
148 endif
149 else
150 ifeq ($(exedir),$(gg_libdir))
151 GITGUI_RELATIVE := 1
152 endif
153 gg_libdir_sed_in := $(gg_libdir)
154 endif
155 ifeq ($(uname_S),Darwin)
156 ifeq ($(shell test -d $(TKFRAMEWORK) && echo y),y)
157 GITGUI_MACOSXAPP := YesPlease
158 endif
159 endif
160 ifneq (,$(findstring MINGW,$(uname_S)))
161 NO_MSGFMT=1
162 GITGUI_WINDOWS_WRAPPER := YesPlease
163 GITGUI_RELATIVE := 1
164 endif
166 ifdef GITGUI_MACOSXAPP
167 GITGUI_MAIN := git-gui.tcl
169 git-gui: GIT-VERSION-FILE GIT-GUI-VARS
170 $(QUIET_GEN)rm -f $@ $@+ && \
171 echo '#!$(SHELL_PATH_SQ)' >$@+ && \
172 echo 'if test "z$$*" = zversion ||' >>$@+ && \
173 echo ' test "z$$*" = z--version' >>$@+ && \
174 echo then >>$@+ && \
175 echo ' 'echo \'git-gui version '$(GITGUI_VERSION)'\' >>$@+ && \
176 echo else >>$@+ && \
177 echo ' 'exec \''$(libdir_SQ)/Git Gui.app/Contents/MacOS/$(subst \,,$(TKEXECUTABLE))'\' \
178 '"$$0" "$$@"' >>$@+ && \
179 echo fi >>$@+ && \
180 chmod +x $@+ && \
181 mv $@+ $@
183 Git\ Gui.app: GIT-VERSION-FILE GIT-GUI-VARS \
184 macosx/Info.plist \
185 macosx/git-gui.icns \
186 macosx/AppMain.tcl \
187 $(TKFRAMEWORK)/Contents/MacOS/$(TKEXECUTABLE)
188 $(QUIET_GEN)rm -rf '$@' '$@'+ && \
189 mkdir -p '$@'+/Contents/MacOS && \
190 mkdir -p '$@'+/Contents/Resources/Scripts && \
191 cp '$(subst ','\'',$(subst \,,$(TKFRAMEWORK)/Contents/MacOS/$(TKEXECUTABLE)))' \
192 '$@'+/Contents/MacOS && \
193 cp macosx/git-gui.icns '$@'+/Contents/Resources && \
194 sed -e 's/@@GITGUI_VERSION@@/$(GITGUI_VERSION)/g' \
195 -e 's/@@GITGUI_TKEXECUTABLE@@/$(TKEXECUTABLE)/g' \
196 macosx/Info.plist \
197 >'$@'+/Contents/Info.plist && \
198 sed -e 's|@@gitexecdir@@|$(gitexecdir_SQ)|' \
199 -e 's|@@GITGUI_LIBDIR@@|$(libdir_SED)|' \
200 macosx/AppMain.tcl \
201 >'$@'+/Contents/Resources/Scripts/AppMain.tcl && \
202 mv '$@'+ '$@'
203 endif
205 ifdef GITGUI_WINDOWS_WRAPPER
206 GITGUI_MAIN := git-gui.tcl
208 git-gui: windows/git-gui.sh
209 cp $< $@
210 endif
212 $(GITGUI_MAIN): git-gui.sh GIT-VERSION-FILE GIT-GUI-VARS
213 $(QUIET_GEN)rm -f $@ $@+ && \
214 sed -e '1s|#!.*/sh|#!$(SHELL_PATH_SQ)|' \
215 -e '1,30s|^ argv0=$$0| argv0=$(GITGUI_SCRIPT)|' \
216 -e '1,30s|^ exec wish | exec '\''$(TCLTK_PATH_SED)'\'' |' \
217 -e 's/@@GITGUI_VERSION@@/$(GITGUI_VERSION)/g' \
218 -e 's|@@GITGUI_RELATIVE@@|$(GITGUI_RELATIVE)|' \
219 -e '$(GITGUI_RELATIVE)s|@@GITGUI_LIBDIR@@|$(libdir_SED)|' \
220 git-gui.sh >$@+ && \
221 chmod +x $@+ && \
222 mv $@+ $@
224 XGETTEXT ?= xgettext
225 ifdef NO_MSGFMT
226 MSGFMT ?= $(TCL_PATH) po/po2msg.sh
227 else
228 MSGFMT ?= msgfmt
229 ifneq ($(shell $(MSGFMT) --tcl -l C -d . /dev/null 2>/dev/null; echo $$?),0)
230 MSGFMT := $(TCL_PATH) po/po2msg.sh
231 endif
232 endif
234 msgsdir = $(gg_libdir)/msgs
235 msgsdir_SQ = $(subst ','\'',$(msgsdir))
236 PO_TEMPLATE = po/git-gui.pot
237 ALL_POFILES = $(wildcard po/*.po)
238 ALL_MSGFILES = $(subst .po,.msg,$(ALL_POFILES))
240 $(PO_TEMPLATE): $(SCRIPT_SH) $(ALL_LIBFILES)
241 $(XGETTEXT) -kmc -LTcl -o $@ $(SCRIPT_SH) $(ALL_LIBFILES)
242 update-po:: $(PO_TEMPLATE)
243 $(foreach p, $(ALL_POFILES), echo Updating $p ; msgmerge -U $p $(PO_TEMPLATE) ; )
244 $(ALL_MSGFILES): %.msg : %.po
245 $(QUIET_MSGFMT0)$(MSGFMT) --statistics --tcl -l $(basename $(notdir $<)) -d $(dir $@) $< $(QUIET_MSGFMT1)
247 lib/tclIndex: $(ALL_LIBFILES) GIT-GUI-VARS
248 $(QUIET_INDEX)if echo \
249 $(foreach p,$(PRELOAD_FILES),source $p\;) \
250 auto_mkindex lib '*.tcl' \
251 | $(TCL_PATH) $(QUIET_2DEVNULL); then : ok; \
252 else \
253 echo 1>&2 " * $(TCL_PATH) failed; using unoptimized loading"; \
254 rm -f $@ ; \
255 echo '# Autogenerated by git-gui Makefile' >$@ && \
256 echo >>$@ && \
257 $(foreach p,$(PRELOAD_FILES) $(ALL_LIBFILES),echo '$(subst lib/,,$p)' >>$@ &&) \
258 echo >>$@ ; \
261 TRACK_VARS = \
262 $(subst ','\'',SHELL_PATH='$(SHELL_PATH_SQ)') \
263 $(subst ','\'',TCL_PATH='$(TCL_PATH_SQ)') \
264 $(subst ','\'',TCLTK_PATH='$(TCLTK_PATH_SQ)') \
265 $(subst ','\'',gitexecdir='$(gitexecdir_SQ)') \
266 $(subst ','\'',gg_libdir='$(libdir_SQ)') \
267 GITGUI_MACOSXAPP=$(GITGUI_MACOSXAPP) \
268 #end TRACK_VARS
270 GIT-GUI-VARS: .FORCE-GIT-GUI-VARS
271 @VARS='$(TRACK_VARS)'; \
272 if test x"$$VARS" != x"`cat $@ 2>/dev/null`" ; then \
273 echo 1>&2 " * new locations or Tcl/Tk interpreter"; \
274 echo 1>$@ "$$VARS"; \
277 ifdef GITGUI_MACOSXAPP
278 all:: git-gui Git\ Gui.app
279 endif
280 ifdef GITGUI_WINDOWS_WRAPPER
281 all:: git-gui
282 endif
283 all:: $(GITGUI_MAIN) lib/tclIndex $(ALL_MSGFILES)
285 install: all
286 $(QUIET)$(INSTALL_D0)'$(DESTDIR_SQ)$(gitexecdir_SQ)' $(INSTALL_D1)
287 $(QUIET)$(INSTALL_X0)git-gui $(INSTALL_X1) '$(DESTDIR_SQ)$(gitexecdir_SQ)'
288 $(QUIET)$(foreach p,$(GITGUI_BUILT_INS), $(INSTALL_L0)'$(DESTDIR_SQ)$(gitexecdir_SQ)/$p' $(INSTALL_L1)'$(DESTDIR_SQ)$(gitexecdir_SQ)/git-gui' $(INSTALL_L2)'$(DESTDIR_SQ)$(gitexecdir_SQ)/$p' $(INSTALL_L3) &&) true
289 ifdef GITGUI_WINDOWS_WRAPPER
290 $(QUIET)$(INSTALL_R0)git-gui.tcl $(INSTALL_R1) '$(DESTDIR_SQ)$(gitexecdir_SQ)'
291 endif
292 $(QUIET)$(INSTALL_D0)'$(DESTDIR_SQ)$(libdir_SQ)' $(INSTALL_D1)
293 $(QUIET)$(INSTALL_R0)lib/tclIndex $(INSTALL_R1) '$(DESTDIR_SQ)$(libdir_SQ)'
294 ifdef GITGUI_MACOSXAPP
295 $(QUIET)$(INSTALL_A0)'Git Gui.app' $(INSTALL_A1) '$(DESTDIR_SQ)$(libdir_SQ)'
296 $(QUIET)$(INSTALL_X0)git-gui.tcl $(INSTALL_X1) '$(DESTDIR_SQ)$(libdir_SQ)'
297 endif
298 $(QUIET)$(foreach p,$(ALL_LIBFILES) $(NONTCL_LIBFILES), $(INSTALL_R0)$p $(INSTALL_R1) '$(DESTDIR_SQ)$(libdir_SQ)' &&) true
299 $(QUIET)$(INSTALL_D0)'$(DESTDIR_SQ)$(msgsdir_SQ)' $(INSTALL_D1)
300 $(QUIET)$(foreach p,$(ALL_MSGFILES), $(INSTALL_R0)$p $(INSTALL_R1) '$(DESTDIR_SQ)$(msgsdir_SQ)' &&) true
302 uninstall:
303 $(QUIET)$(CLEAN_DST) '$(DESTDIR_SQ)$(gitexecdir_SQ)'
304 $(QUIET)$(REMOVE_F0)'$(DESTDIR_SQ)$(gitexecdir_SQ)'/git-gui $(REMOVE_F1)
305 $(QUIET)$(foreach p,$(GITGUI_BUILT_INS), $(REMOVE_F0)'$(DESTDIR_SQ)$(gitexecdir_SQ)'/$p $(REMOVE_F1) &&) true
306 ifdef GITGUI_WINDOWS_WRAPPER
307 $(QUIET)$(REMOVE_F0)'$(DESTDIR_SQ)$(gitexecdir_SQ)'/git-gui.tcl $(REMOVE_F1)
308 endif
309 $(QUIET)$(CLEAN_DST) '$(DESTDIR_SQ)$(libdir_SQ)'
310 $(QUIET)$(REMOVE_F0)'$(DESTDIR_SQ)$(libdir_SQ)'/tclIndex $(REMOVE_F1)
311 ifdef GITGUI_MACOSXAPP
312 $(QUIET)$(REMOVE_F0)'$(DESTDIR_SQ)$(libdir_SQ)/Git Gui.app' $(REMOVE_F1)
313 $(QUIET)$(REMOVE_F0)'$(DESTDIR_SQ)$(libdir_SQ)'/git-gui.tcl $(REMOVE_F1)
314 endif
315 $(QUIET)$(foreach p,$(ALL_LIBFILES) $(NONTCL_LIBFILES), $(REMOVE_F0)'$(DESTDIR_SQ)$(libdir_SQ)'/$(notdir $p) $(REMOVE_F1) &&) true
316 $(QUIET)$(CLEAN_DST) '$(DESTDIR_SQ)$(msgsdir_SQ)'
317 $(QUIET)$(foreach p,$(ALL_MSGFILES), $(REMOVE_F0)'$(DESTDIR_SQ)$(msgsdir_SQ)'/$(notdir $p) $(REMOVE_F1) &&) true
318 $(QUIET)$(REMOVE_D0)'$(DESTDIR_SQ)$(gitexecdir_SQ)' $(REMOVE_D1)
319 $(QUIET)$(REMOVE_D0)'$(DESTDIR_SQ)$(msgsdir_SQ)' $(REMOVE_D1)
320 $(QUIET)$(REMOVE_D0)'$(DESTDIR_SQ)$(libdir_SQ)' $(REMOVE_D1)
321 $(QUIET)$(REMOVE_D0)`dirname '$(DESTDIR_SQ)$(libdir_SQ)'` $(REMOVE_D1)
323 dist-version:
324 @mkdir -p $(TARDIR)
325 @echo $(GITGUI_VERSION) > $(TARDIR)/version
327 clean::
328 $(RM_RF) $(GITGUI_MAIN) lib/tclIndex po/*.msg
329 $(RM_RF) GIT-VERSION-FILE GIT-GUI-VARS
330 ifdef GITGUI_MACOSXAPP
331 $(RM_RF) 'Git Gui.app'* git-gui
332 endif
333 ifdef GITGUI_WINDOWS_WRAPPER
334 $(RM_RF) git-gui
335 endif
337 .PHONY: all install uninstall dist-version clean
338 .PHONY: .FORCE-GIT-VERSION-FILE
339 .PHONY: .FORCE-GIT-GUI-VARS