1 ;;; ede-pmake.el --- EDE Generic Project Makefile code generator.
3 ;;; Copyright (C) 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005,
4 ;;; 2007, 2008, 2009 Free Software Foundation, Inc.
6 ;; Author: Eric M. Ludlam <zappo@gnu.org>
7 ;; Keywords: project, make
9 ;; This file is part of GNU Emacs.
11 ;; GNU Emacs is free software: you can redistribute it and/or modify
12 ;; it under the terms of the GNU General Public License as published by
13 ;; the Free Software Foundation, either version 3 of the License, or
14 ;; (at your option) any later version.
16 ;; GNU Emacs is distributed in the hope that it will be useful,
17 ;; but WITHOUT ANY WARRANTY; without even the implied warranty of
18 ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
19 ;; GNU General Public License for more details.
21 ;; You should have received a copy of the GNU General Public License
22 ;; along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>.
26 ;; Code generator for Makefiles.
28 ;; Here is how it should work:
29 ;; 1) Collect information about the project and targets
30 ;; 2) Insert header into the Makefile
31 ;; 3) Insert basic variables (target/source)
34 ;; 1) Insert support variables (compiler variables, etc)
35 ;; 2) Insert VERSION and DISTDIR
36 ;; 3) Specify top build dir if necessary
37 ;; 4) Specify compile/link commands (c, etc)
38 ;; 5) Specify dependency files
39 ;; 6) Specify all: target
40 ;; 7) Include dependency files
41 ;; 8) Insert commonized target specify rules
42 ;; 9) Insert clean: and dist: rules
44 ;; 1) Insert distribution source variables for targets
45 ;; 2) Insert user requested rules
48 (require 'ede
/proj-obj
)
49 (require 'ede
/proj-comp
)
51 (declare-function ede-srecode-setup
"ede/srecode")
52 (declare-function ede-srecode-insert
"ede/srecode")
55 (defmethod ede-proj-makefile-create ((this ede-proj-project
) mfilename
)
56 "Create a Makefile for all Makefile targets in THIS.
57 MFILENAME is the makefile to generate."
58 (require 'ede
/srecode
)
60 (isdist (string= mfilename
(ede-proj-dist-makefile this
)))
65 ;; Find out how deep this project is.
67 (while (setq tmp
(ede-parent-project tmp
))
68 (setq depth
(1+ depth
))))
69 ;; Collect the targets that belong in a makefile.
72 (if (and (obj-of-class-p obj
'ede-proj-target-makefile
)
73 (string= (oref obj makefile
) mfilename
))
74 (setq mt
(cons obj mt
))))
76 ;; Fix the order so things compile in the right direction.
77 (setq mt
(nreverse mt
))
78 ;; Add in the header part of the Makefile*
80 (setq orig-buffer
(get-file-buffer mfilename
))
81 (set-buffer (setq buff-to-kill
(find-file-noselect mfilename
)))
82 (goto-char (point-min))
85 (not (looking-at "# Automatically Generated \\w+ by EDE.")))
86 (if (not (y-or-n-p (format "Really replace %s? " mfilename
)))
87 (error "Not replacing Makefile"))
88 (message "Replace EDE Makefile"))
91 ;; Insert a giant pile of stuff that is common between
92 ;; one of our Makefiles, and a Makefile.in
96 (with-slots (makefile-type) this
97 (cond ((eq makefile-type
'Makefile
) "make")
98 ((eq makefile-type
'Makefile.in
) "autoconf")
99 ((eq makefile-type
'Makefile.am
) "automake")
100 (t (error ":makefile-type in project invalid")))))
102 ;; Just this project's variables
103 (ede-proj-makefile-insert-variables this
)
109 ((eq (oref this makefile-type
) 'Makefile
)
110 ;; Make sure the user has the right kind of make
111 (ede-make-check-version)
113 (let* ((targ (if isdist
(oref this targets
) mt
))
114 (sp (oref this subproj
))
117 (ede-proj-makefile-dependency-files tg
))
119 ;; Distribution variables
120 (ede-compiler-begin-unique
121 (mapc 'ede-proj-makefile-insert-variables targ
))
122 ;; Only add the distribution stuff in when depth != 0
123 (let ((top (ede-toplevel this
))
126 (insert "VERSION=" (oref top version
) "\n"
127 "DISTDIR=$(top)" (oref top name
) "-$(VERSION)")
128 (while (ede-parent-project tmp
)
132 (file-name-nondirectory
134 (file-name-directory (oref tmp file
))))
136 tmp
(ede-parent-project tmp
)))
137 (insert subdir
"\n"))
138 ;; Some built in variables for C code
141 (insert "top_builddir = ")
145 (if (/= tc
0) (insert "/")))
148 ;; Create a variable with all the dependency files to include
149 ;; These methods borrowed from automake.
150 (if (and (oref this automatic-dependencies
) df
)
153 (mapconcat (lambda (f)
155 (file-name-nondirectory
156 (file-name-sans-extension
164 (if (and (slot-exists-p c
'partofall
) (oref c partofall
))
165 ;; Only insert this rule if it is a part of ALL.
166 (insert " " (ede-proj-makefile-target-name c
))))
169 (insert " " (ede-name c
))
174 ;; Add in the include files
177 (insert "include " c
"\n\n"))
178 (oref this include-file
))
179 ;; Some C inference rules
180 ;; Dependency rules borrowed from automake.
182 ;; NOTE: This is GNU Make specific.
183 (if (and (oref this automatic-dependencies
) df
)
184 (insert "DEPS_MAGIC := $(shell mkdir .deps > /dev/null "
186 "-include $(DEP_FILES)\n\n"))
188 ;; General makefile rules stored in the individual targets
190 (ede-compiler-begin-unique
191 (ede-proj-makefile-insert-rules this
)
192 (mapc 'ede-proj-makefile-insert-rules targ
))
194 ;; phony targets for sub projects
196 (mapc 'ede-proj-makefile-insert-subproj-rules sp
)
198 ;; Distribution rules such as CLEAN and DIST
201 (ede-proj-makefile-tags this mt
)
202 (ede-proj-makefile-insert-dist-rules this
)))
204 ((eq (oref this makefile-type
) 'Makefile.in
)
205 (error "Makefile.in is not supported"))
206 ((eq (oref this makefile-type
) 'Makefile.am
)
208 ;; Distribution variables
209 (let ((targ (if isdist
(oref this targets
) mt
)))
210 (ede-compiler-begin-unique
211 (mapc 'ede-proj-makefile-insert-automake-pre-variables targ
))
212 (ede-compiler-begin-unique
213 (mapc 'ede-proj-makefile-insert-source-variables targ
))
214 (ede-compiler-begin-unique
215 (mapc 'ede-proj-makefile-insert-automake-post-variables targ
))
216 (ede-compiler-begin-unique
217 (ede-proj-makefile-insert-user-rules this
))
218 (insert "\n# End of Makefile.am\n")
221 (t (error "Unknown makefile type when generating Makefile")))
222 ;; Put the cursor in a nice place
223 (goto-char (point-min)))
224 ;; If we have an original buffer, then don't kill it.
225 (when (not orig-buffer
)
226 (kill-buffer buff-to-kill
))
229 ;;; VARIABLE insertion
231 (defun ede-pmake-end-of-variable ()
232 "Move to the end of the variable declaration under point."
234 (while (= (preceding-char) ?
\\)
239 (defmacro ede-pmake-insert-variable-shared
(varname &rest body
)
240 "Add VARNAME into the current Makefile.
241 Execute BODY in a location where a value can be placed."
242 `(let ((addcr t
) (v ,varname
))
243 (if (re-search-backward (concat "^" v
"\\s-*=") nil t
)
245 (ede-pmake-end-of-variable)
246 (if (< (current-column) 40)
247 (if (and (/= (preceding-char) ?
=)
248 (/= (preceding-char) ?
))
254 (if addcr
(insert "\n"))
255 (goto-char (point-max))))
256 (put 'ede-pmake-insert-variable-shared
'lisp-indent-function
1)
258 (defmacro ede-pmake-insert-variable-once
(varname &rest body
)
259 "Add VARNAME into the current Makefile if it doesn't exist.
260 Execute BODY in a location where a value can be placed."
261 `(let ((addcr t
) (v ,varname
))
262 (unless (re-search-backward (concat "^" v
"\\s-*=") nil t
)
265 (if addcr
(insert "\n"))
266 (goto-char (point-max)))
268 (put 'ede-pmake-insert-variable-once
'lisp-indent-function
1)
270 ;;; SOURCE VARIABLE NAME CONSTRUCTION
272 (defsubst ede-pmake-varname
(obj)
273 "Convert OBJ into a variable name name.
274 Change . to _ in the variable name."
275 (let ((name (oref obj name
)))
276 (while (string-match "\\." name
)
277 (setq name
(replace-match "_" nil t name
)))
280 (defmethod ede-proj-makefile-sourcevar ((this ede-proj-target
))
281 "Return the variable name for THIS's sources."
282 (concat (ede-pmake-varname this
) "_YOU_FOUND_A_BUG"))
284 ;;; DEPENDENCY FILE GENERATOR LISTS
286 (defmethod ede-proj-makefile-dependency-files ((this ede-proj-target
))
287 "Return a list of source files to convert to dependencies.
288 Argument THIS is the target to get sources from."
291 ;;; GENERIC VARIABLES
293 (defmethod ede-proj-makefile-configuration-variables ((this ede-proj-project
)
295 "Return a list of configuration variables from THIS.
296 Use CONFIGURATION as the current configuration to query."
297 (cdr (assoc configuration
(oref this configuration-variables
))))
299 (defmethod ede-proj-makefile-insert-variables-new ((this ede-proj-project
))
300 "Insert variables needed by target THIS.
302 NOTE: Not yet in use! This is part of an SRecode conversion of
303 EDE that is in progress."
304 ; (let ((conf-table (ede-proj-makefile-configuration-variables
305 ; this (oref this configuration-default)))
308 ; (ede-srecode-insert-with-dictionary
309 ; "declaration:ede-vars"
311 ; ;; Insert all variables, and augment them with details from
312 ; ;; the current configuration.
315 ; (let ((ldict (srecode-dictionary-add-section-dictionary
318 ; (srecode-dictionary-set-value ldict "NAME" (car c))
319 ; (if (assoc (car c) conf-table)
320 ; (let ((vdict (srecode-dictionary-add-section-dictionary
322 ; (srecode-dictionary-set-value
323 ; vdict "VAL" (cdr (assoc (car c) conf-table)))
324 ; (setq conf-done (cons (car c) conf-done))))
325 ; (let ((vdict (srecode-dictionary-add-section-dictionary
327 ; (srecode-dictionary-set-value vdict "VAL" (cdr c))))
330 ; (oref this variables))
332 ; ;; Add in all variables from the configuration not allready covered.
335 ; (if (member (car c) conf-done)
337 ; (let* ((ldict (srecode-dictionary-add-section-dictionary
339 ; (vdict (srecode-dictionary-add-section-dictionary
342 ; (srecode-dictionary-set-value ldict "NAME" (car c))
343 ; (srecode-dictionary-set-value vdict "VAL" (cdr c))))
349 ;; @TODO - finish off this function, and replace the below fcn
354 (defmethod ede-proj-makefile-insert-variables ((this ede-proj-project
))
355 "Insert variables needed by target THIS."
356 (let ((conf-table (ede-proj-makefile-configuration-variables
357 this
(oref this configuration-default
)))
359 ;; Insert all variables, and augment them with details from
360 ;; the current configuration.
363 (if (assoc (car c
) conf-table
)
365 (insert (cdr (assoc (car c
) conf-table
)) " ")
366 (setq conf-done
(cons (car c
) conf-done
))))
367 (insert (cdr c
) "\n"))
368 (oref this variables
))
369 ;; Add in all variables from the configuration not allready covered.
371 (if (member (car c
) conf-done
)
373 (insert (car c
) "=" (cdr c
) "\n")))
377 (while (ede-parent-project tmp
)
378 (setq tmp
(ede-parent-project tmp
)
379 top
(concat "../" top
)))
380 (insert "\ntop=" top
))
381 (insert "\nede_FILES=" (file-name-nondirectory (oref this file
)) " "
382 (file-name-nondirectory (ede-proj-dist-makefile this
)) "\n"))
384 (defmethod ede-proj-makefile-insert-source-variables ((this ede-proj-target
)
387 "Insert the source variables needed by THIS.
388 Optional argument MORESOURCE is a list of additional sources to add to the
390 (let ((sv (ede-proj-makefile-sourcevar this
)))
391 ;; This variable may be shared between targets
392 (ede-pmake-insert-variable-shared (cond ((listp sv
) (car sv
))
394 (insert (mapconcat (lambda (a) a
) (oref this source
) " "))
396 (insert " \\\n " (mapconcat (lambda (a) a
) moresource
" ") "")))))
398 (defmethod ede-proj-makefile-insert-variables ((this ede-proj-target
) &optional
400 "Insert variables needed by target THIS.
401 Optional argument MORESOURCE is a list of additional sources to add to the
403 (ede-proj-makefile-insert-source-variables this moresource
)
406 (defmethod ede-proj-makefile-configuration-variables ((this ede-proj-target-makefile
)
408 "Return a list of configuration variables from THIS.
409 Use CONFIGURATION as the current configuration to query."
410 (cdr (assoc configuration
(oref this configuration-variables
))))
412 (defmethod ede-proj-makefile-insert-variables ((this ede-proj-target-makefile
)
413 &optional moresource
)
414 "Insert variables needed by target THIS.
415 Optional argument MORESOURCE is a list of additional sources to add to the
418 (let* ((proj (ede-target-parent this
))
419 (conf-table (ede-proj-makefile-configuration-variables
420 this
(oref proj configuration-default
)))
423 ;; Add in all variables from the configuration not allready covered.
425 (if (member (car c
) conf-done
)
427 (insert (car c
) "=" (cdr c
) "\n")))
429 (let ((comp (ede-proj-compilers this
))
430 (link (ede-proj-linkers this
))
431 (name (ede-proj-makefile-target-name this
))
432 (src (oref this source
)))
434 (ede-compiler-only-once (car comp
)
435 (ede-proj-makefile-insert-object-variables (car comp
) name src
)
436 (ede-proj-makefile-insert-variables (car comp
)))
437 (setq comp
(cdr comp
)))
439 (ede-linker-only-once (car link
)
440 (ede-proj-makefile-insert-variables (car link
)))
441 (setq link
(cdr link
)))))
443 (defmethod ede-proj-makefile-insert-automake-pre-variables
444 ((this ede-proj-target
))
445 "Insert variables needed by target THIS in Makefile.am before SOURCES."
448 (defmethod ede-proj-makefile-insert-automake-post-variables
449 ((this ede-proj-target
))
450 "Insert variables needed by target THIS in Makefile.am after SOURCES."
455 (defmethod ede-proj-makefile-garbage-patterns ((this ede-proj-project
))
456 "Return a list of patterns that are considered garbage to THIS.
457 These are removed with make clean."
458 (let ((mc (ede-map-targets
459 this
(lambda (c) (ede-proj-makefile-garbage-patterns c
))))
461 (setq mc
(sort (apply 'append mc
) 'string
<))
462 ;; Filter out duplicates from the targets.
464 (if (and (car uniq
) (string= (car uniq
) (car mc
)))
466 (setq uniq
(cons (car mc
) uniq
)))
470 (defmethod ede-proj-makefile-garbage-patterns ((this ede-proj-target
))
471 "Return a list of patterns that are considered garbage to THIS.
472 These are removed with make clean."
473 ;; Get the the source object from THIS, and use the specified garbage.
474 (let ((src (ede-target-sourcecode this
))
477 (setq garb
(append (oref (car src
) garbagepattern
) garb
)
484 (defmethod ede-proj-makefile-insert-subproj-rules ((this ede-proj-project
))
485 "Insert a rule for the project THIS which should be a subproject."
486 (insert ".PHONY:" (ede-name this
))
488 (insert (ede-name this
) ":")
490 (insert "\t$(MAKE) -C " (directory-file-name (ede-subproject-relative-path this
)))
495 (defmethod ede-proj-makefile-insert-rules ((this ede-proj-project
))
496 "Insert rules needed by THIS target."
497 (mapc 'ede-proj-makefile-insert-rules
(oref this inference-rules
))
500 (defmethod ede-proj-makefile-insert-dist-dependencies ((this ede-proj-project
))
501 "Insert any symbols that the DIST rule should depend on.
502 Argument THIS is the project that should insert stuff."
503 (mapc 'ede-proj-makefile-insert-dist-dependencies
(oref this targets
))
506 (defmethod ede-proj-makefile-insert-dist-dependencies ((this ede-proj-target
))
507 "Insert any symbols that the DIST rule should depend on.
508 Argument THIS is the target that should insert stuff."
511 (defmethod ede-proj-makefile-insert-dist-filepatterns ((this ede-proj-target
))
512 "Insert any symbols that the DIST rule should depend on.
513 Argument THIS is the target that should insert stuff."
514 (ede-proj-makefile-insert-dist-dependencies this
)
517 (defmethod ede-proj-makefile-insert-dist-rules ((this ede-proj-project
))
518 "Insert distribution rules for THIS in a Makefile, such as CLEAN and DIST."
519 (let ((junk (ede-proj-makefile-garbage-patterns this
))
521 ;; Build CLEAN, DIST, TAG, and other rules here.
525 (mapconcat (lambda (c) c
) junk
" ")
527 ;; @TODO: ^^^ Clean should also recurse. ^^^
529 (insert ".PHONY: dist\n")
531 (ede-proj-makefile-insert-dist-dependencies this
)
533 (unless (or (ede-subproject-p this
)
534 (oref this metasubproject
))
535 ;; Only delete if we are the toplevel project.
536 (insert "\trm -rf $(DISTDIR)\n"))
537 (insert "\tmkdir $(DISTDIR)\n") ;We may need a -p, but I think not.
538 (setq tmp
(oref this targets
))
541 (let ((sv (ede-proj-makefile-sourcevar (car tmp
))))
543 ;; Handle special case variables.
544 (cond ((eq (cdr sv
) 'share
)
545 ;; This variable may be shared between multiple targets.
546 (if (re-search-backward (concat "\\$(" (car sv
) ")")
551 ;; If its already in the dist target, then skip it.
554 (t (setq sv
(car sv
)))))
556 (insert " $(" sv
")"))
557 (ede-proj-makefile-insert-dist-filepatterns (car tmp
))
558 (setq tmp
(cdr tmp
))))
559 (insert " $(ede_FILES) $(DISTDIR)\n")
561 ;; Call our sub projects.
564 (let ((rp (directory-file-name (ede-subproject-relative-path sproj
))))
565 (insert "\t$(MAKE) -C " rp
" $(MFLAGS) DISTDIR=$(DISTDIR)/" rp
570 (unless (or (ede-subproject-p this
)
571 (oref this metasubproject
))
572 (insert "\ttar -cvzf $(DISTDIR).tar.gz $(DISTDIR)\n"
573 "\trm -rf $(DISTDIR)\n"))
575 ;; Make sure the Makefile is ok.
577 (file-name-nondirectory (buffer-file-name)) ": "
578 (file-name-nondirectory (oref this file
)) "\n"
579 ;; "$(EMACS) -batch Project.ede -l ede -f ede-proj-regenerate"
580 "\t@echo Makefile is out of date! "
581 "It needs to be regenerated by EDE.\n"
582 "\t@echo If you have not modified Project.ede, you can"
583 " use 'touch' to update the Makefile time stamp.\n"
585 "\n\n# End of Makefile\n")))
587 (defmethod ede-proj-makefile-insert-rules ((this ede-proj-target
))
588 "Insert rules needed by THIS target."
591 (defmethod ede-proj-makefile-insert-rules ((this ede-proj-target-makefile
))
592 "Insert rules needed by THIS target."
593 (mapc 'ede-proj-makefile-insert-rules
(oref this rules
))
594 (let ((c (ede-proj-compilers this
)))
596 (mapc 'ede-proj-makefile-insert-rules c
)
597 (if (oref this phony
)
598 (insert ".PHONY: " (ede-proj-makefile-target-name this
) "\n"))
599 (insert (ede-proj-makefile-target-name this
) ": "
600 (ede-proj-makefile-dependencies this
) "\n")
601 (ede-proj-makefile-insert-commands this
)
604 (defmethod ede-proj-makefile-insert-commands ((this ede-proj-target-makefile
))
605 "Insert the commands needed by target THIS.
606 For targets, insert the commands needed by the chosen compiler."
607 (mapc 'ede-proj-makefile-insert-commands
(ede-proj-compilers this
))
608 (when (object-assoc t
:uselinker
(ede-proj-compilers this
))
609 (mapc 'ede-proj-makefile-insert-commands
(ede-proj-linkers this
))))
612 (defmethod ede-proj-makefile-insert-user-rules ((this ede-proj-project
))
613 "Insert user specified rules needed by THIS target.
614 This is different from `ede-proj-makefile-insert-rules' in that this
615 function won't create the building rules which are auto created with
617 (mapc 'ede-proj-makefile-insert-user-rules
(oref this inference-rules
)))
619 (defmethod ede-proj-makefile-insert-user-rules ((this ede-proj-target
))
620 "Insert user specified rules needed by THIS target."
621 (mapc 'ede-proj-makefile-insert-rules
(oref this rules
)))
623 (defmethod ede-proj-makefile-dependencies ((this ede-proj-target-makefile
))
624 "Return a string representing the dependencies for THIS.
625 Some compilers only use the first element in the dependencies, others
626 have a list of intermediates (object files), and others don't care.
627 This allows customization of how these elements appear."
628 (let* ((c (ede-proj-compilers this
))
629 (io (eval (cons 'or
(mapcar 'ede-compiler-intermediate-objects-p c
))))
635 (concat out
"$(" (ede-compiler-intermediate-object-variable
637 (ede-proj-makefile-target-name this
)) ")")
640 (let ((sv (ede-proj-makefile-sourcevar this
))
641 (aux (oref this auxsource
)))
643 (if (and (stringp sv
) (not (string= sv
"")))
647 (setq out
(concat out
" " (car aux
)))
648 (setq aux
(cdr aux
)))
652 (defmethod ede-proj-makefile-tags ((this ede-proj-project
) targets
)
653 "Insert into the current location rules to make recursive TAGS files.
654 Argument THIS is the project to create tags for.
655 Argument TARGETS are the targets we should depend on for TAGS."
658 ;; Loop over all source variables and insert them
660 (insert "$(" (ede-proj-makefile-sourcevar (car tg
)) ") ")
664 (insert "\tetags $^\n"))
665 ;; Now recurse into all subprojects
666 (setq tg
(oref this subproj
))
668 (insert "\t$(MAKE) -C " (ede-subproject-relative-path (car tg
)) " $(MFLAGS) $@\n")
675 ;; arch-tag: 7ad8e19f-cdee-484c-8caf-f15cb0fc4df2
676 ;;; ede/pmake.el ends here