Initial support for HTML Help. All the ad-hoc help-file finding code
[u/mdw/putty] / Recipe
1 # -*- makefile -*-
2 #
3 # This file describes which PuTTY programs are made up from which
4 # object and resource files. It is processed into the various
5 # Makefiles by means of a Perl script. Makefile changes should
6 # really be made by editing this file and/or the Perl script, not
7 # by editing the actual Makefiles.
8
9 # ------------------------------------------------------------
10 # Top-level configuration.
11
12 # Overall project name.
13 !name putty
14 # Locations and types of output Makefiles.
15 !makefile vc windows/Makefile.vc
16 !makefile vcproj windows/MSVC
17 !makefile cygwin windows/Makefile.cyg
18 !makefile borland windows/Makefile.bor
19 !makefile lcc windows/Makefile.lcc
20 !makefile gtk unix/Makefile.gtk
21 !makefile ac unix/Makefile.in
22 !makefile mpw mac/Makefile.mpw
23 !makefile osx macosx/Makefile
24 !makefile devcppproj windows/DEVCPP
25 # Source directories.
26 !srcdir charset/
27 !srcdir windows/
28 !srcdir unix/
29 !srcdir mac/
30 !srcdir macosx/
31
32 # Help text added to the top of each Makefile, with /D converted
33 # into -D as appropriate for the particular Makefile.
34
35 !begin help
36 #
37 # Extra options you can set:
38 #
39 # - VER="/DSNAPSHOT=1999-01-25 /DSVN_REV=1234"
40 # Generates executables whose About box report them as being a
41 # development snapshot. SVN_REV is a Subversion revision number.
42 #
43 # - VER=/DRELEASE=0.43
44 # Generates executables whose About box report them as being a
45 # release version.
46 #
47 # - COMPAT=/DAUTO_WINSOCK (Windows only)
48 # Causes PuTTY to assume that <windows.h> includes its own WinSock
49 # header file, so that it won't try to include <winsock.h>.
50 #
51 # - COMPAT=/DWINSOCK_TWO (Windows only)
52 # Causes the PuTTY utilities to include <winsock2.h> instead of
53 # <winsock.h>, except Plink which _needs_ WinSock 2 so it already
54 # does this.
55 #
56 # - COMPAT=/DNO_SECURITY (Windows only)
57 # Disables Pageant's use of <aclapi.h>, which is not available
58 # with some development environments (such as older versions of
59 # the Cygwin/mingw GNU toolchain). This means that Pageant
60 # won't care about the local user ID of processes accessing it; a
61 # version of Pageant built with this option will therefore refuse
62 # to run under NT-series OSes on security grounds (although it
63 # will run fine on Win95-series OSes where there is no access
64 # control anyway).
65 #
66 # - COMPAT=/DNO_MULTIMON (Windows only)
67 # Disables PuTTY's use of <multimon.h>, which is not available
68 # with some development environments. This means that PuTTY's
69 # full-screen mode (configurable to work on Alt-Enter) will
70 # not behave usefully in a multi-monitor environment.
71 #
72 # Note that this definition is always enabled in the Cygwin
73 # build, since at the time of writing this <multimon.h> is
74 # known not to be available in Cygwin.
75 #
76 # - RCFL=/DNO_MANIFESTS (Windows only)
77 # Disables inclusion of XML application manifests in the PuTTY
78 # binaries. This may be necessary to build for 64-bit Windows;
79 # the manifests are only included to use the XP GUI style on
80 # Windows XP, and the architecture tags are a lie on 64-bit.
81 #
82 # - COMPAT=/DNO_IPV6
83 # Disables PuTTY's ability to make IPv6 connections, enabling
84 # it to compile under development environments which do not
85 # support IPv6 in their header files.
86 #
87 # - COMPAT=/DMSVC4 (Windows only)
88 # - RCFL=/DMSVC4
89 # Makes a couple of minor changes so that PuTTY compiles using
90 # MSVC 4. You will also need /DNO_SECURITY and /DNO_MULTIMON.
91 #
92 # - RCFL=/DASCIICTLS (Windows only)
93 # Uses ASCII rather than Unicode to specify the tab control in
94 # the resource file. Probably most useful when compiling with
95 # Cygnus/mingw32, whose resource compiler may have less of a
96 # problem with it.
97 #
98 # - XFLAGS=/DTELNET_DEFAULT
99 # Causes PuTTY to default to the Telnet protocol (in the absence
100 # of Default Settings and so on to the contrary). Normally PuTTY
101 # will default to SSH.
102 #
103 # - XFLAGS=/DDEBUG
104 # Causes PuTTY to enable internal debugging.
105 #
106 # - XFLAGS=/DMALLOC_LOG
107 # Causes PuTTY to emit a file called putty_mem.log, logging every
108 # memory allocation and free, so you can track memory leaks.
109 #
110 # - XFLAGS=/DMINEFIELD (Windows only)
111 # Causes PuTTY to use a custom memory allocator, similar in
112 # concept to Electric Fence, in place of regular malloc(). Wastes
113 # huge amounts of RAM, but should cause heap-corruption bugs to
114 # show up as GPFs at the point of failure rather than appearing
115 # later on as second-level damage.
116 #
117 !end
118
119 # ------------------------------------------------------------
120 # Additional text added verbatim to each individual Makefile.
121
122 # Hack to force version.o to be rebuilt always.
123 !begin vc
124 version.obj: *.c *.h *.rc
125 cl $(VER) $(CFLAGS) /c ..\version.c
126 !end
127 !specialobj vc version
128 !begin cygwin
129 version.o: FORCE
130 $(CC) $(COMPAT) $(XFLAGS) $(CFLAGS) $(VER) -c ../version.c
131 !end
132 !specialobj cygwin version
133 !begin borland
134 version.obj: FORCE
135 bcc32 $(VER) $(CFLAGS) /c ..\version.c
136 !end
137 !specialobj borland version
138 !begin lcc
139 version.obj: FORCE
140 lcc $(VER) $(CFLAGS) /c ..\version.c
141 !end
142 !specialobj lcc version
143 # For Unix, we also need the gross MD5 hack that causes automatic
144 # version number selection in release source archives.
145 !begin gtk
146 version.o: FORCE
147 if test -z "$(VER)" && (cd ..; md5sum -c manifest); then \
148 $(CC) $(COMPAT) $(XFLAGS) $(CFLAGS) `cat ../version.def` -c ../version.c; \
149 else \
150 $(CC) $(COMPAT) $(XFLAGS) $(CFLAGS) $(VER) -c ../version.c; \
151 fi
152 !end
153 !specialobj gtk version
154
155 # Add VER to Windows resource targets, and force them to be rebuilt every
156 # time, on the assumption that they will contain version information.
157 !begin vc vars
158 RCFLAGS = $(RCFLAGS) $(VER)
159 !end
160 !begin cygwin vars
161 # XXX GNU-ism, but it's probably all right for a Cygwin/MinGW Makfile.
162 RCFLAGS += $(patsubst -D%,--define %,$(VER))
163 !end
164 !begin borland vars
165 # Borland doesn't support +=. This probably shouldn't work, but seems to.
166 RCFLAGS = $(RCFLAGS) $(VER)
167 !end
168 !begin lcc vars
169 RCFLAGS += $(VER)
170 !end
171 !forceobj putty.res
172 !forceobj puttytel.res
173 !forceobj plink.res
174 !forceobj pscp.res
175 !forceobj psftp.res
176 !forceobj pageant.res
177 !forceobj puttygen.res
178
179 # `make install' target for Unix.
180 !begin gtk
181 install:
182 $(INSTALL_PROGRAM) -m 755 plink $(DESTDIR)$(bindir)/plink
183 $(INSTALL_PROGRAM) -m 755 pscp $(DESTDIR)$(bindir)/pscp
184 $(INSTALL_PROGRAM) -m 755 psftp $(DESTDIR)$(bindir)/psftp
185 $(INSTALL_PROGRAM) -m 755 pterm $(DESTDIR)$(bindir)/pterm
186 if test -n "$(UTMP_GROUP)"; then \
187 chgrp $(UTMP_GROUP) $(DESTDIR)$(bindir)/pterm && \
188 chmod 2755 $(DESTDIR)$(bindir)/pterm; \
189 elif test -n "$(UTMP_USER)"; then \
190 chown $(UTMP_USER) $(DESTDIR)$(bindir)/pterm && \
191 chmod 4755 $(DESTDIR)$(bindir)/pterm; \
192 fi
193 $(INSTALL_PROGRAM) -m 755 putty $(DESTDIR)$(bindir)/putty
194 $(INSTALL_PROGRAM) -m 755 puttygen $(DESTDIR)$(bindir)/puttygen
195 $(INSTALL_PROGRAM) -m 755 puttytel $(DESTDIR)$(bindir)/puttytel
196 $(INSTALL_DATA) -m 644 ../doc/plink.1 $(DESTDIR)$(man1dir)/plink.1
197 $(INSTALL_DATA) -m 644 ../doc/pscp.1 $(DESTDIR)$(man1dir)/pscp.1
198 $(INSTALL_DATA) -m 644 ../doc/psftp.1 $(DESTDIR)$(man1dir)/psftp.1
199 $(INSTALL_DATA) -m 644 ../doc/pterm.1 $(DESTDIR)$(man1dir)/pterm.1
200 $(INSTALL_DATA) -m 644 ../doc/putty.1 $(DESTDIR)$(man1dir)/putty.1
201 $(INSTALL_DATA) -m 644 ../doc/puttygen.1 $(DESTDIR)$(man1dir)/puttygen.1
202 $(INSTALL_DATA) -m 644 ../doc/puttytel.1 $(DESTDIR)$(man1dir)/puttytel.1
203
204 install-strip:
205 $(MAKE) install INSTALL_PROGRAM="$(INSTALL_PROGRAM) -s"
206 !end
207 !begin osx vars
208 CFLAGS += -DMACOSX
209 !end
210
211 # ------------------------------------------------------------
212 # Definitions of object groups. A group name, followed by an =,
213 # followed by any number of objects or other already-defined group
214 # names. A line beginning `+' is assumed to continue the previous
215 # line.
216
217 # Terminal emulator and its (platform-independent) dependencies.
218 TERMINAL = terminal wcwidth ldiscucs logging tree234 minibidi
219 + config dialog
220
221 # GUI front end and terminal emulator (putty, puttytel).
222 GUITERM = TERMINAL window windlg winctrls sizetip winucs winprint
223 + winutils wincfg sercfg winhelp
224
225 # Same thing on Unix.
226 UXTERM = TERMINAL uxcfg sercfg uxucs uxprint timing
227 GTKTERM = UXTERM gtkwin gtkcfg gtkdlg gtkcols gtkpanel xkeysym
228 OSXTERM = UXTERM osxwin osxdlg osxctrls
229
230 # Non-SSH back ends (putty, puttytel, plink).
231 NONSSH = telnet raw rlogin ldisc pinger
232
233 # SSH back end (putty, plink, pscp, psftp).
234 SSH = ssh sshcrc sshdes sshmd5 sshrsa sshrand sshsha sshblowf
235 + sshdh sshcrcda sshpubk sshzlib sshdss x11fwd portfwd
236 + sshaes sshsh256 sshsh512 sshbn wildcard pinger ssharcf
237 WINSSH = SSH winnoise winpgntc
238 UXSSH = SSH uxnoise uxagentc
239 MACSSH = SSH macnoise
240
241 # SFTP implementation (pscp, psftp).
242 SFTP = sftp int64 logging
243
244 # Miscellaneous objects appearing in all the network utilities (not
245 # Pageant or PuTTYgen).
246 MISC = timing misc version settings tree234 proxy
247 WINMISC = MISC winstore winnet winhandl cmdline windefs winmisc winproxy
248 + wintime
249 UXMISC = MISC uxstore uxsel uxnet cmdline uxmisc uxproxy time
250 OSXMISC = MISC uxstore uxsel osxsel uxnet uxmisc uxproxy time
251 MACMISC = MISC macstore macnet mtcpnet otnet macmisc macabout pproxy
252
253 # Character set library, for use in pterm.
254 CHARSET = sbcsdat slookup sbcs utf8 toucs fromucs xenc mimeenc macenc localenc
255
256 # Standard libraries.
257 LIBS = advapi32.lib user32.lib gdi32.lib comctl32.lib comdlg32.lib
258 + shell32.lib winmm.lib imm32.lib winspool.lib htmlhelp.lib
259
260 # Network backend sets. This also brings in the relevant attachment
261 # to proxy.c depending on whether we're crypto-avoidant or not.
262 BE_ALL = be_all cproxy
263 BE_NOSSH = be_nossh nocproxy
264 BE_SSH = be_none cproxy
265 BE_NONE = be_none nocproxy
266 # More backend sets, with the additional Windows serial-port module.
267 W_BE_ALL = be_all_s winser cproxy
268 W_BE_NOSSH = be_nos_s winser nocproxy
269 # And with the Unix serial-port module.
270 U_BE_ALL = be_all_s uxser cproxy
271 U_BE_NOSSH = be_nos_s uxser nocproxy
272
273 # ------------------------------------------------------------
274 # Definitions of actual programs. The program name, followed by a
275 # colon, followed by a list of objects. Also in the list may be the
276 # keywords [G] for Windows GUI app, [C] for Console app, [X] for
277 # X/GTK Unix app, [U] for command-line Unix app, [M] for Macintosh app.
278
279 putty : [G] GUITERM NONSSH WINSSH W_BE_ALL WINMISC putty.res LIBS
280 puttytel : [G] GUITERM NONSSH W_BE_NOSSH WINMISC puttytel.res LIBS
281 plink : [C] winplink wincons NONSSH WINSSH W_BE_ALL logging WINMISC
282 + plink.res LIBS
283 pscp : [C] pscp winsftp wincons WINSSH BE_SSH SFTP wildcard WINMISC
284 + pscp.res LIBS
285 psftp : [C] psftp winsftp wincons WINSSH BE_SSH SFTP wildcard WINMISC
286 + psftp.res LIBS
287
288 pageant : [G] winpgnt sshrsa sshpubk sshdes sshbn sshmd5 version tree234
289 + misc sshaes sshsha winpgntc sshdss sshsh512 winutils winmisc
290 + winhelp pageant.res LIBS
291
292 puttygen : [G] winpgen sshrsag sshdssg sshprime sshdes sshbn sshmd5 version
293 + sshrand winnoise sshsha winstore misc winctrls sshrsa sshdss winmisc
294 + sshpubk sshaes sshsh512 import winutils puttygen.res tree234
295 + notiming winhelp LIBS wintime
296
297 pterm : [X] GTKTERM uxmisc misc ldisc settings uxpty uxsel BE_NONE uxstore
298 + uxsignal CHARSET cmdline uxpterm version time
299 putty : [X] GTKTERM uxmisc misc ldisc settings uxsel U_BE_ALL uxstore
300 + uxsignal CHARSET uxputty NONSSH UXSSH UXMISC ux_x11
301 puttytel : [X] GTKTERM uxmisc misc ldisc settings uxsel U_BE_NOSSH
302 + uxstore uxsignal CHARSET uxputty NONSSH UXMISC
303
304 plink : [U] uxplink uxcons NONSSH UXSSH U_BE_ALL logging UXMISC uxsignal
305 + ux_x11
306
307 puttygen : [U] cmdgen sshrsag sshdssg sshprime sshdes sshbn sshmd5 version
308 + sshrand uxnoise sshsha misc sshrsa sshdss uxcons uxstore uxmisc
309 + sshpubk sshaes sshsh512 import puttygen.res time tree234 uxgen
310 + notiming
311
312 pscp : [U] pscp uxsftp uxcons UXSSH BE_SSH SFTP wildcard UXMISC
313 psftp : [U] psftp uxsftp uxcons UXSSH BE_SSH SFTP wildcard UXMISC
314
315 PuTTY : [M] terminal wcwidth ldiscucs logging BE_ALL mac macdlg macevlog
316 + macterm macucs mac_res.rsrc testback NONSSH MACSSH MACMISC CHARSET
317 + stricmp vsnprint dialog config macctrls minibidi
318 PuTTYtel : [M] terminal wcwidth ldiscucs logging BE_NOSSH mac macdlg
319 + macevlog macterm macucs mac_res.rsrc testback NONSSH MACMISC
320 + CHARSET stricmp vsnprint dialog config macctrls minibidi
321 PuTTYgen : [M] macpgen sshrsag sshdssg sshprime sshdes sshbn sshmd5 version
322 + sshrand macnoise sshsha macstore misc sshrsa sshdss macmisc sshpubk
323 + sshaes sshsh512 import macpgen.rsrc macpgkey macabout
324
325 PuTTY : [MX] osxmain OSXTERM OSXMISC CHARSET U_BE_ALL NONSSH UXSSH
326 + ux_x11 uxpty uxsignal testback putty.icns info.plist