2012-01-02 19:07:04 +00:00
|
|
|
.SUFFIXES: # we don't need default suffix rules
|
2011-07-17 12:49:43 +00:00
|
|
|
ifeq ($(MAKELEVEL), 0)
|
|
|
|
$(error This make needs to be started as a sub-make from the toplevel directory.)
|
|
|
|
endif
|
2012-04-21 14:55:57 +00:00
|
|
|
.PHONY: all info html pdf card manual guide install \
|
2012-04-30 19:37:57 +00:00
|
|
|
clean cleanall clean-install
|
2011-07-17 12:49:43 +00:00
|
|
|
|
2012-04-22 06:22:31 +00:00
|
|
|
all: $(ORG_MAKE_DOC)
|
2011-07-17 12:49:43 +00:00
|
|
|
|
2019-03-19 00:57:36 +00:00
|
|
|
info: org orgguide
|
2011-07-17 12:49:43 +00:00
|
|
|
|
2021-09-29 13:06:08 +00:00
|
|
|
html: org.html orgguide.html
|
2011-07-17 12:49:43 +00:00
|
|
|
|
|
|
|
pdf: org.pdf orgguide.pdf
|
|
|
|
|
|
|
|
card: orgcard.pdf orgcard_letter.pdf orgguide.pdf
|
|
|
|
|
2012-08-25 06:35:02 +00:00
|
|
|
ifneq ($(SERVERMK),)
|
2011-07-17 12:49:43 +00:00
|
|
|
manual guide::
|
2012-05-10 18:53:59 +00:00
|
|
|
-$(RMR) $@
|
|
|
|
$(MKDIR) $@
|
|
|
|
manual:: org.texi org-version.inc
|
2011-07-17 12:49:43 +00:00
|
|
|
$(TEXI2HTML) -o $@ $<
|
2012-08-26 12:03:20 +00:00
|
|
|
../mk/mansplit.pl $@/*
|
2012-05-17 06:41:23 +00:00
|
|
|
guide:: orgguide.texi org-version.inc
|
2011-07-17 12:49:43 +00:00
|
|
|
$(TEXI2HTML) -o $@ $<
|
2012-08-26 12:03:20 +00:00
|
|
|
../mk/guidesplit.pl $@/*
|
2012-08-25 06:35:02 +00:00
|
|
|
endif
|
2011-07-17 12:49:43 +00:00
|
|
|
|
2022-06-17 05:18:39 +00:00
|
|
|
# We increase GC threshold when generating documentation. This
|
|
|
|
# imrpoves the performance significantly. See
|
|
|
|
# https://yhetil.org/emacs-devel/9778F176-E724-4E61-B0FB-327BCDD316C0@acm.org
|
|
|
|
# Too high number may cause memory overflow (for example, it has
|
|
|
|
# happened in CI during automated build). We choose 50Mb threshold,
|
|
|
|
# based on the above discussion.
|
2021-12-20 21:27:50 +00:00
|
|
|
org.texi: org-manual.org
|
* lisp/org-agenda.el: Use lexical-binding
- Removed the global (defvar date) and (defvar entry) so as not to
conflict with function arguments of that name. Instead I added such
`defvar`s in the body of each of the functions where it
seemed needed.
- I added some FIXMEs for some issues I found along the way.
- Added an `org-dlet` macro, just like I had done for `calendar-dlet`,
but I also use `defvar` "manually" at some places, when splitting an
existing `let` into a mix of `let`s and `dlet`s seemed too much trouble.
- Removed uses of `org-let and `org-let2` not only because I consider
them offensive to my sense of aesthetics but also because they're
basically incompatible with lexical scoping.
I replaced them with uses of `cl-progv` which are a bit more verbose.
Maybe we should define some `org-progv` macro on top of `cl-progv` to
make the code less verbose, but I didn't do that because I like the
fact that the current code makes uses of `eval` a bit more obvious
(since these behave differently with lexical scoping than with
lexical binding, it seemed worthwhile).
- Removed the use of `eval` in `org-store-agenda-views` which was only
placed there in order to use a macro before it's defined (it would
have been simpler/cleaner to just move that functions *after* the
macro, but with the new code the problem doesn't occur any more anyway).
- Replaced a few `(lambda...) with actual closures.
Detailed changes follow:
(date, entry): Don't declare as being globally dynbound.
(org-agenda-format-date-aligned): Remove unused var `weekyear`.
(org-agenda-mode): `run-mode-hooks` is always available nowadays.
(org-agenda-undo): Remove unused var `last-undo-buffer`.
(org-agenda): Rename arg to `keys` and then dyn-bind it as `org-keys`.
Remove unused vars `buf` and `key`.
(org-agenda): Use `pcase` and `cl-progv` instead of `org-let`.
(org-let, org-let2): Mark as obsolete.
(org-agenda-run-series): Use `cl-progv` instead of `org-let` and `org-let2`.
(org-agenda-run-series): New function.
(org--batch-agenda): New function extracted from `org-batch-agenda`.
(org-batch-agenda): Use it.
(org--batch-agenda-csv): New function extracted from `org-batch-agenda-csv`.
(org-batch-agenda-csv): Use it.
(org--batch-store-agenda-views): New function, extracted from
`org-batch-store-agenda-views`.
(org-store-agenda-views, org-batch-store-agenda-views): Use it.
(org--batch-store-agenda-views): Use `cl-progv` instead of
`org-eval-in-environment`.
(org-agenda-write): Use `cl-progv` instead of `org-let`.
Use `with-current-buffer`.
(org-agenda-filter-any): Use `cl-some` instead of `eval`.
(org-agenda-list): Remove unused var `e`.
(org-search-view): η-reduce.
(crm-separator): Declare var.
(org-agenda-skip-if): Remove unused var `beg`.
(org-agenda-list-stuck-projects): Use a closure rather than `(lambda..).
(diary-modify-entry-list-string-function, diary-file-name-prefix)
(diary-display-function): Declare vars.
(org-diary): Declare `date` and `entry` as dynbound.
(org-agenda-get-day-entries): Use `org-dlet`.
(org-agenda-get-timestamps, org-agenda-get-progress)
(org-agenda-get-deadlines, org-agenda-get-scheduled, org-agenda-get-blocks):
Declare `date` as dynbound.
(org-agenda-get-sexps, org-class): Declare `date` and `entry` as dynbound.
(org-agenda-format-item): Declare the vars mentioned in
`org-compile-prefix-format` as dyn-bound.
Also binding `extra`, suggested by Kyle Meyer <kyle@kyleam.com>.
(org-compile-prefix-format): Remove unused var `e`.
Use `member` rather than or+equal.
(org-set-sorting-strategy): Minor simplification.
(org-entries-lessp): Use `org-dlet`.
(org-agenda-redo): Declare var `org-agenda-tag-filter-while-redo`.
(org-agenda-redo): Use `cl-progv` rather than `org-let`.
(org-agenda-filter): Remove unused var `rpl-fn`.
Use `org-pushnew-to-end` to replace `add-to-list` on lexical var.
(org-agenda-filter-by-tag): Remove unused var `n`.
(org-agenda-filter-apply): Use `org-dlet`.
(org-agenda-compute-starting-span): Remove unused var `dg`.
(org-agenda-forward-block): Remove unused var `pos`.
(org-archive-from-agenda): Declare var.
(org-agenda-refile): Remove unused var `pos`.
(org-agenda-headline-snapshot-before-repeat): Declare var.
(org-agenda-todo): Remove redundant use of `bound-and-true-p`.
(org-agenda-add-note): Remove unused var `hdmarker` and unused `arg`.
(org-agenda-change-all-lines): Remove unused var `pl`.
(org-agenda-priority): Remove unused var `marker`.
(org-agenda-set-effort): Remove unused var `newhead`.
(org-agenda-schedule): Remove unused var `type`.
(org-agenda-clock-cancel): Remove unused `arg`.
(org-agenda-execute-calendar-command): Use `org-dlet`.
(org-agenda-bulk-action): Use closures instead of `(lambda ...).
(org-agenda-show-the-flagging-note): Remove unused vars `heading` and
`newhead`.
(org-agenda-remove-flag): Avoid `setq`.
* testing/org-test.el (org--compile-when): New macro.
(org-test-jump): Use it so compilation doesn't fail or generate broken
code when `jump` is not available.
* testing/lisp/test-org-src.el:
* testing/lisp/test-org-attach.el:
* testing/lisp/test-org-agenda.el:
* testing/lisp/test-ob-java.el: Pass explicit filename to `require`
so as not to rely on ".../testing" being in `load-path` during compilation.
* lisp/org-num.el: Require` org`.
* lisp/org-macs.el (org-eval-in-environment): Declare obsolete.
(org-dlet, org-pushnew-to-end): New macros.
* doc/Makefile (org.texi, orgguide.texi, %_letter.tex): Simplify quoting.
* contrib/lisp/ob-sclang.el: Don't crash compilation when `sclang`
is not available.
* contrib/lisp/ob-clojure-literate.el: Don't crash compilation when `cider`
is not available.
* contrib/lisp/ob-arduino.el: Don't crash compilation when `arduino-mode`
is not available.
* .gitignore: Add files generated during `make packages/org`.
2021-02-23 20:47:29 +00:00
|
|
|
$(BATCH) \
|
|
|
|
--eval '(add-to-list `load-path "../lisp")' \
|
|
|
|
--eval '(load "../mk/org-fixup.el")' \
|
2022-06-17 05:18:39 +00:00
|
|
|
--eval '(setq gc-cons-threshold (* 50 1000 1000))' \
|
2021-12-20 21:27:50 +00:00
|
|
|
--eval '(org-make-manual)'
|
|
|
|
|
|
|
|
orgguide.texi: org-guide.org
|
|
|
|
$(BATCH) \
|
|
|
|
--eval '(add-to-list `load-path "../lisp")' \
|
|
|
|
--eval '(load "../mk/org-fixup.el")' \
|
2022-06-17 05:18:39 +00:00
|
|
|
--eval '(setq gc-cons-threshold (* 50 1000 1000))' \
|
2021-12-20 21:27:50 +00:00
|
|
|
--eval '(org-make-guide)'
|
2018-05-09 00:23:10 +00:00
|
|
|
|
2012-04-30 19:37:57 +00:00
|
|
|
org-version.inc: org.texi
|
2012-04-21 13:10:30 +00:00
|
|
|
@echo "org-version: $(ORGVERSION) ($(GITVERSION))"
|
2012-04-16 17:35:55 +00:00
|
|
|
@echo "@c automatically generated, do not edit" > org-version.inc
|
|
|
|
@echo "@set VERSION $(ORGVERSION) ($(GITVERSION))" >> org-version.inc
|
|
|
|
@echo "@set DATE $(DATE)" >> org-version.inc
|
2011-10-28 08:33:15 +00:00
|
|
|
|
2017-06-23 18:54:02 +00:00
|
|
|
org-version.tex: orgcard.tex
|
2017-06-30 17:06:18 +00:00
|
|
|
@printf "org-version: $(ORGVERSION) ($(GITVERSION))\n"
|
|
|
|
@printf "%% automatically generated, do not edit\n" > org-version.tex
|
|
|
|
@printf "\def\orgversionnumber{$(ORGVERSION)}\n" >> org-version.tex
|
|
|
|
@printf "\def\\\\versionyear{$(YEAR)}\n" >> org-version.tex
|
|
|
|
@printf "\def\year{$(YEAR)}\n" >> org-version.tex
|
2017-06-23 18:54:02 +00:00
|
|
|
|
2019-03-19 00:57:36 +00:00
|
|
|
install: org orgguide
|
2012-01-02 19:07:04 +00:00
|
|
|
if [ ! -d $(DESTDIR)$(infodir) ]; then $(MKDIR) $(DESTDIR)$(infodir); else true; fi ;
|
2021-05-16 08:35:32 +00:00
|
|
|
$(CP) org.info $(DESTDIR)$(infodir)
|
|
|
|
$(CP) orgguide.info $(DESTDIR)$(infodir)
|
|
|
|
$(INSTALL_INFO) --infodir=$(DESTDIR)$(infodir) org.info
|
|
|
|
$(INSTALL_INFO) --infodir=$(DESTDIR)$(infodir) orgguide.info
|
2011-07-17 12:49:43 +00:00
|
|
|
|
2011-07-18 19:05:52 +00:00
|
|
|
clean:
|
2021-09-12 16:05:37 +00:00
|
|
|
$(RM) *.pdf *.html *.info *_letter.tex org-version.inc org-version.tex \
|
|
|
|
*.aux *.cp *.cps *.dvi *.fn *.fns *.ky *.kys *.pg *.pgs *.toc \
|
|
|
|
*.tp *.tps *.vr *.vrs *.log *.ps
|
2011-07-18 19:05:52 +00:00
|
|
|
cleanall: clean
|
2021-05-21 15:42:35 +00:00
|
|
|
$(RM) org.texi orgguide.texi
|
2011-07-18 19:05:52 +00:00
|
|
|
$(RMR) guide manual
|
2011-07-17 12:49:43 +00:00
|
|
|
|
2011-07-18 15:55:23 +00:00
|
|
|
clean-install:
|
2012-01-02 19:07:04 +00:00
|
|
|
$(RM) $(DESTDIR)$(infodir)/org*
|
|
|
|
$(INSTALL_INFO) --infodir=$(DESTDIR)$(infodir) --remove org
|
2019-03-19 00:57:36 +00:00
|
|
|
$(INSTALL_INFO) --infodir=$(DESTDIR)$(infodir) --remove orgguide
|
2011-07-18 15:55:23 +00:00
|
|
|
|
2012-05-26 20:32:21 +00:00
|
|
|
.SUFFIXES: .texi .tex .txt _letter.tex
|
2011-07-17 12:49:43 +00:00
|
|
|
|
2012-04-21 13:10:30 +00:00
|
|
|
%: %.texi org-version.inc
|
2021-05-16 08:35:32 +00:00
|
|
|
$(MAKEINFO) --no-split $< -o $@.info
|
2011-07-17 12:49:43 +00:00
|
|
|
|
2014-01-07 20:23:45 +00:00
|
|
|
# the following two lines work around a bug in some versions of texi2dvi
|
|
|
|
%.pdf: LC_ALL=C
|
|
|
|
%.pdf: LANG=C
|
2012-04-21 13:10:30 +00:00
|
|
|
%.pdf: %.texi org-version.inc
|
2011-07-17 12:49:43 +00:00
|
|
|
$(TEXI2PDF) $<
|
2017-06-23 18:54:02 +00:00
|
|
|
%.pdf: %.tex org-version.tex
|
2011-07-17 12:49:43 +00:00
|
|
|
PDFLATEX=$(PDFTEX) $(TEXI2PDF) $<
|
|
|
|
|
2012-04-21 13:10:30 +00:00
|
|
|
%.html: %.texi org-version.inc
|
2011-07-17 12:49:43 +00:00
|
|
|
$(TEXI2HTML) --no-split -o $@ $<
|
2012-08-25 06:35:02 +00:00
|
|
|
ifneq ($(SERVERMK),)
|
2012-08-26 12:03:20 +00:00
|
|
|
../mk/manfull.pl $@
|
2011-07-17 12:49:43 +00:00
|
|
|
|
|
|
|
%.txt: %.tex
|
2012-08-26 12:03:20 +00:00
|
|
|
perl ../mk/orgcard2txt.pl $< > $@
|
2012-08-25 06:35:02 +00:00
|
|
|
endif
|
2011-07-17 12:49:43 +00:00
|
|
|
|
|
|
|
%_letter.tex: %.tex
|
* lisp/org-agenda.el: Use lexical-binding
- Removed the global (defvar date) and (defvar entry) so as not to
conflict with function arguments of that name. Instead I added such
`defvar`s in the body of each of the functions where it
seemed needed.
- I added some FIXMEs for some issues I found along the way.
- Added an `org-dlet` macro, just like I had done for `calendar-dlet`,
but I also use `defvar` "manually" at some places, when splitting an
existing `let` into a mix of `let`s and `dlet`s seemed too much trouble.
- Removed uses of `org-let and `org-let2` not only because I consider
them offensive to my sense of aesthetics but also because they're
basically incompatible with lexical scoping.
I replaced them with uses of `cl-progv` which are a bit more verbose.
Maybe we should define some `org-progv` macro on top of `cl-progv` to
make the code less verbose, but I didn't do that because I like the
fact that the current code makes uses of `eval` a bit more obvious
(since these behave differently with lexical scoping than with
lexical binding, it seemed worthwhile).
- Removed the use of `eval` in `org-store-agenda-views` which was only
placed there in order to use a macro before it's defined (it would
have been simpler/cleaner to just move that functions *after* the
macro, but with the new code the problem doesn't occur any more anyway).
- Replaced a few `(lambda...) with actual closures.
Detailed changes follow:
(date, entry): Don't declare as being globally dynbound.
(org-agenda-format-date-aligned): Remove unused var `weekyear`.
(org-agenda-mode): `run-mode-hooks` is always available nowadays.
(org-agenda-undo): Remove unused var `last-undo-buffer`.
(org-agenda): Rename arg to `keys` and then dyn-bind it as `org-keys`.
Remove unused vars `buf` and `key`.
(org-agenda): Use `pcase` and `cl-progv` instead of `org-let`.
(org-let, org-let2): Mark as obsolete.
(org-agenda-run-series): Use `cl-progv` instead of `org-let` and `org-let2`.
(org-agenda-run-series): New function.
(org--batch-agenda): New function extracted from `org-batch-agenda`.
(org-batch-agenda): Use it.
(org--batch-agenda-csv): New function extracted from `org-batch-agenda-csv`.
(org-batch-agenda-csv): Use it.
(org--batch-store-agenda-views): New function, extracted from
`org-batch-store-agenda-views`.
(org-store-agenda-views, org-batch-store-agenda-views): Use it.
(org--batch-store-agenda-views): Use `cl-progv` instead of
`org-eval-in-environment`.
(org-agenda-write): Use `cl-progv` instead of `org-let`.
Use `with-current-buffer`.
(org-agenda-filter-any): Use `cl-some` instead of `eval`.
(org-agenda-list): Remove unused var `e`.
(org-search-view): η-reduce.
(crm-separator): Declare var.
(org-agenda-skip-if): Remove unused var `beg`.
(org-agenda-list-stuck-projects): Use a closure rather than `(lambda..).
(diary-modify-entry-list-string-function, diary-file-name-prefix)
(diary-display-function): Declare vars.
(org-diary): Declare `date` and `entry` as dynbound.
(org-agenda-get-day-entries): Use `org-dlet`.
(org-agenda-get-timestamps, org-agenda-get-progress)
(org-agenda-get-deadlines, org-agenda-get-scheduled, org-agenda-get-blocks):
Declare `date` as dynbound.
(org-agenda-get-sexps, org-class): Declare `date` and `entry` as dynbound.
(org-agenda-format-item): Declare the vars mentioned in
`org-compile-prefix-format` as dyn-bound.
Also binding `extra`, suggested by Kyle Meyer <kyle@kyleam.com>.
(org-compile-prefix-format): Remove unused var `e`.
Use `member` rather than or+equal.
(org-set-sorting-strategy): Minor simplification.
(org-entries-lessp): Use `org-dlet`.
(org-agenda-redo): Declare var `org-agenda-tag-filter-while-redo`.
(org-agenda-redo): Use `cl-progv` rather than `org-let`.
(org-agenda-filter): Remove unused var `rpl-fn`.
Use `org-pushnew-to-end` to replace `add-to-list` on lexical var.
(org-agenda-filter-by-tag): Remove unused var `n`.
(org-agenda-filter-apply): Use `org-dlet`.
(org-agenda-compute-starting-span): Remove unused var `dg`.
(org-agenda-forward-block): Remove unused var `pos`.
(org-archive-from-agenda): Declare var.
(org-agenda-refile): Remove unused var `pos`.
(org-agenda-headline-snapshot-before-repeat): Declare var.
(org-agenda-todo): Remove redundant use of `bound-and-true-p`.
(org-agenda-add-note): Remove unused var `hdmarker` and unused `arg`.
(org-agenda-change-all-lines): Remove unused var `pl`.
(org-agenda-priority): Remove unused var `marker`.
(org-agenda-set-effort): Remove unused var `newhead`.
(org-agenda-schedule): Remove unused var `type`.
(org-agenda-clock-cancel): Remove unused `arg`.
(org-agenda-execute-calendar-command): Use `org-dlet`.
(org-agenda-bulk-action): Use closures instead of `(lambda ...).
(org-agenda-show-the-flagging-note): Remove unused vars `heading` and
`newhead`.
(org-agenda-remove-flag): Avoid `setq`.
* testing/org-test.el (org--compile-when): New macro.
(org-test-jump): Use it so compilation doesn't fail or generate broken
code when `jump` is not available.
* testing/lisp/test-org-src.el:
* testing/lisp/test-org-attach.el:
* testing/lisp/test-org-agenda.el:
* testing/lisp/test-ob-java.el: Pass explicit filename to `require`
so as not to rely on ".../testing" being in `load-path` during compilation.
* lisp/org-num.el: Require` org`.
* lisp/org-macs.el (org-eval-in-environment): Declare obsolete.
(org-dlet, org-pushnew-to-end): New macros.
* doc/Makefile (org.texi, orgguide.texi, %_letter.tex): Simplify quoting.
* contrib/lisp/ob-sclang.el: Don't crash compilation when `sclang`
is not available.
* contrib/lisp/ob-clojure-literate.el: Don't crash compilation when `cider`
is not available.
* contrib/lisp/ob-arduino.el: Don't crash compilation when `arduino-mode`
is not available.
* .gitignore: Add files generated during `make packages/org`.
2021-02-23 20:47:29 +00:00
|
|
|
$(BATCH) \
|
|
|
|
--eval '(add-to-list `load-path "../lisp")' \
|
|
|
|
--eval '(load "org-compat.el")' \
|
|
|
|
--eval '(load "../mk/org-fixup.el")' \
|
2012-05-26 20:32:21 +00:00
|
|
|
--eval '(org-make-letterformat "$(<F)" "$(@F)")'
|