* doc/misc/eshell.texi: Fill most of the missing sections.
[emacs.git] / admin / make-emacs
blob03876fff56859539f71dad0bb8ba73664c397f1f
1 #! /usr/bin/perl
2 # Build Emacs with various options for profiling, debugging,
3 # with and without warnings enabled etc.
5 # Copyright (C) 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011, 2012
6 # Free Software Foundation, Inc.
8 # This file is part of GNU Emacs.
10 # GNU Emacs is free software: you can redistribute it and/or modify
11 # it under the terms of the GNU General Public License as published by
12 # the Free Software Foundation, either version 3 of the License, or
13 # (at your option) any later version.
15 # GNU Emacs is distributed in the hope that it will be useful,
16 # but WITHOUT ANY WARRANTY; without even the implied warranty of
17 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
18 # GNU General Public License for more details.
20 # You should have received a copy of the GNU General Public License
21 # along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>.
24 require 5;
25 use Getopt::Long;
26 use File::Basename;
27 use Cwd;
29 # Default CVS sandbox directory. Only used when called from outside
30 # of the sandbox.
32 $root = $ENV{"EMACS_ROOT"};
33 $root = "/gd/gnu/emacs" unless $root;
35 # Default make command.
37 $make = $ENV{"EMACS_MAKE"};
38 $make = "gmake" unless $make;
40 $rc = GetOptions ("help" => \$help,
41 "enable-checking" => \$enable_checking,
42 "no-warn" => \$no_warn,
43 "check-marked" => \$check_marked,
44 "all" => \$all,
45 "no-optim" => \$no_optim,
46 "union-type" => \$union_type,
47 "gprof" => \$profile,
48 "malloc-check" => \$malloc_check,
49 "no-mcheck" => \$no_mcheck,
50 "alias" => \$aliasing,
51 "boot" => \$boot,
52 "wall" => \$wall,
53 "gcc3" => \$gcc3,
54 "trace-selection" => \$trace_selection,
55 "trace-move" => \$trace_move,
56 "stabs" => \$use_stabs,
57 "optim" => \$optim);
59 if ($rc == 0 || $help)
61 print <<USAGE;
62 make-emacs [options] ...
64 Build Emacs.
66 --help show this help
67 --all make clean versionclean first
68 --boot make bootstrap, log to boot.log
69 --enable-checking ENABLE_CHECKING=1
70 --no-warn disable warnings
71 --check-marked GC_CHECK_MARKED_OBJECTS=1
72 --optim no debug defines
73 --gprof make Emacs for profiling
74 --union-type define USE_LISP_UNION_TYPE (bad for GDB)
75 --malloc-check define GC_MALLOC_CHECK
76 --no-mcheck dont define GC_MCHECK
77 --wall compile with -Wall
78 --gcc3 use GCC 3.0 (30% slower compilation, slower code)
79 --trace-selection print traces in xselect.c
80 --trace-move print traces for move_it* functions
81 --stabs use -gstabs instead -g
83 Default is to compile with warnings, with -DGC_MCHECK=1, and
84 with -DGLYPH_DEBUG=1.
86 USAGE
87 exit 1;
90 # Chdir to the top-level directory of the tree. If not in a tree
91 # containing Emacs, use the default.
93 while (! -f "src/emacs.c" && cwd () ne "/")
95 chdir "..";
98 chdir $root if cwd () eq "/";
99 chdir "./src";
100 print "Build in ", cwd (), "\n";
102 # If first arg is `all' or if `--all' specified, ensure a clean
103 # build.
105 if (@ARGV && $ARGV[0] eq "all")
107 $all = 1;
108 shift @ARGV;
111 system ("$make clean versionclean") if $all;
113 if ($wall)
115 $warn = "-Wall";
117 elsif (!$no_warn)
119 $warn = "-Wpointer-arith -Wchar-subscripts -Wformat -Wimplicit-int";
120 $warn = "$warn -Wreturn-type -Wswitch -Wuninitialized";
123 $defs = "-DGLYPH_DEBUG=1" unless $optim;
124 $defs = "$defs -DGC_CHECK_MARKED_OBJECTS=1" if $check_marked;
125 $defs = "$defs -DENABLE_CHECKING=1" if $enable_checking;
127 if ($profile)
129 $opts = "-pg";
130 $defs = "$defs -DPROFILING=1";
132 else
134 if ($use_stabs)
136 $opts = "-gstabs";
138 else
140 $opts = "-g";
144 $defs = "$defs -DUSE_LISP_UNION_TYPE" if $union_type;
145 $defs = "$defs -DGC_MALLOC_CHECK=1 -DGC_PROTECT_MALLOC_STATE=1" if $malloc_check;
146 $defs = "$defs -DGC_MCHECK=1" unless $no_mcheck;
148 $defs = "$defs -DTRACE_SELECTION" if $trace_selection;
149 $defs = "$defs -DDEBUG_TRACE_MOVE" if $trace_move;
151 # arch=pentium leads to slightly faster code than without.
152 $opts = "$opts -march=pentiumpro";
154 if ($optim)
156 $opts = "$opts -pipe -O3";
158 elsif ($no_optim)
160 $opts = "$opts -pipe -fno-inline";
162 else
164 $opts = "$opts -O -pipe -fno-inline";
167 $opts = "$opts -fstrict-aliasing" if $aliasing;
169 $opts = "$opts $defs" if $defs;
170 $opts = "$opts $warn" if $warn;
172 $cc = "/usr/bin/gcc";
173 $cc = "/gd/local/bin/gcc" if $gcc3;
175 if ($boot)
177 chdir "..";
178 system "mv boot.log boot.log.old" if -f "boot.log";
179 exit system "script boot.log $make CC=\"$cc\" CFLAGS=\"$opts\" bootstrap";
182 exit system "$make CC=\"$cc\" CFLAGS=\"$opts\" @ARGV";
184 # Local Variables:
185 # mode: cperl
186 # End:
188 # arch-tag: 5c3f9713-9ece-4a12-b3f8-deaff15974ba