mirror of
https://github.com/simonmichael/hledger.git
synced 2024-12-26 20:02:27 +03:00
1026 lines
37 KiB
Makefile
1026 lines
37 KiB
Makefile
# One of two project scripts files (Makefile, Shake.hs).
|
||
# This one was a reboot of Makefile.old.
|
||
# It is probably used by hledger developers/contributors but not end-users.
|
||
# It requires GNU Make (https://www.gnu.org/software/make/).
|
||
# Also, some rules may require:
|
||
# - stack (http://haskell-lang.org/get-started, installs libs and runs ghc)
|
||
# - shelltestrunner (hackage, runs functional tests)
|
||
# - quickbench (hackage/stackage, runs benchmarks)
|
||
# - ghcid (hackage/stackage, recompiles and optionally runs tests on file change)
|
||
# - hasktags (hackage, generates tag files for code navigation)
|
||
# - profiterole (hackage/stackage, simplifies profiles)
|
||
# - profiteur (hackage/stackage, renders profiles as html)
|
||
# - hpack (hackage/stackage, generates cabal files from package.yaml files)
|
||
# - site/hakyll-std/hakyll-std (generic site-building hakyll script)
|
||
# - perl
|
||
#
|
||
# Kinds of hledger builds:
|
||
#
|
||
# - stack build: built with stack
|
||
# (hledger/.stack-work/dist/ARCH/CABAL/build/hledger/hledger,
|
||
# .stack-work/install/ARCH/SNAPSHOT/GHC/bin/hledger, installs to ~/.local/bin)
|
||
# - cabal (v1) build: built with cabal (and maybe a sandbox)
|
||
# (hledger/dist/build/hledger/hledger, installs to ~/.cabal/bin)
|
||
# - ghc-only build: built quickly with ghc only, unoptimised, with DEVELOPMENT flag
|
||
# (hledgerdev)
|
||
#
|
||
# This makefile mostly uses stack to get things done (slow but robust).
|
||
# It may sometimes (still ?) use ghc only, or cabal, when easier.
|
||
|
||
# XXX do we need this ?
|
||
#SHELL=/bin/bash
|
||
#.SHELLFLAGS="-O extglob -c" # example
|
||
|
||
###############################################################################
|
||
# MAKEFILE HELP SYSTEM
|
||
|
||
# This defines the def-help* functions for generating makefile help
|
||
# (see the file for more details), and a "help" target (our default).
|
||
# Every useful rule in this makefile should use def-help to describe itself.
|
||
# "make" or "make help" will show these descriptions.
|
||
-include Makefile.helpsys
|
||
|
||
# Some calls and dummy targets to augment the default help output.
|
||
# Also, help-SUBSTR and SUBSTR-help targets to show only matching help.
|
||
$(call def-help-heading,Main rules in the hledger project Makefile:)
|
||
$(call def-help-subheading,HELP:)
|
||
dummy1: $(call def-help,[help], list documented rules in this makefile )
|
||
help-%: $(call def-help,help-SECTION, list documented rules containing some string )
|
||
make help 2>&1 | grep -i $*
|
||
%-help: $(call def-help,SECTION-help, same but easier to type (can append "-help" to any "make RULE") )
|
||
@make help 2>&1 | grep -i $*
|
||
dummy2: $(call def-help,RULE -n, show what RULE would do )
|
||
|
||
###############################################################################
|
||
# VARS
|
||
|
||
# GHC-compiled executables require a locale (and not just C) or they
|
||
# will die on encountering non-ascii data. Set LANG to something if not already set.
|
||
export LANG?=en_US.UTF-8
|
||
|
||
# command to run during profiling (time and heap)
|
||
PROFCMD=stack exec -- hledgerprof balance -f examples/10000x1000x10.journal >/dev/null
|
||
|
||
#PROFRTSFLAGS=-p
|
||
PROFRTSFLAGS=-P
|
||
|
||
# # command to run during "make coverage"
|
||
# COVCMD=test
|
||
# COVCMD=-f test-wf.csv print
|
||
|
||
# misc. system tools
|
||
BROWSE=open
|
||
# VIEWHTML=$(BROWSE)
|
||
VIEWPS=$(BROWSE)
|
||
# VIEWPDF=$(BROWSE)
|
||
# PRINT=lpr
|
||
|
||
#GHC=ghc
|
||
GHCI=ghci #-package ghc-datasize #-package ghc-heap-view
|
||
# GHCPKG=ghc-pkg
|
||
# HADDOCK=haddock
|
||
# CABAL=cabal
|
||
# CABALINSTALL=cabal install -w $(GHC)
|
||
STACK=stack
|
||
# if using an unreleased stack with a newer hpack than the one mentioned in */*.cabal,
|
||
# it will give warnings. To silence these, put the old hpack-X.Y in $PATH and uncomment:
|
||
#STACK=stack --with-hpack=hpack-0.20
|
||
|
||
# -j16 sometimes gives "commitAndReleaseBuffer: resource vanished (Broken pipe)" but seems harmless
|
||
SHELLTESTOPTS=--execdir -j16 --hide-successes --exclude=/_
|
||
|
||
# make sure shelltest is a released version of shelltestrunner
|
||
# run shell tests using the executable specified in tests
|
||
# SHELLTEST=COLUMNS=80 PATH=~/.local/bin:/usr/bin:/bin shelltest $(SHELLTESTOPTS)
|
||
# run shell tests using the stack build of hledger
|
||
#SHELLTESTSTK=shelltest -w `stack exec which hledger` $(SHELLTESTOPTS)
|
||
SHELLTESTSTK=COLUMNS=80 $(STACK) exec -- shelltest $(SHELLTESTOPTS)
|
||
|
||
# # used for make auto, http://joyful.com/repos/searchpath
|
||
# SP=sp
|
||
|
||
PACKAGES=\
|
||
hledger-lib \
|
||
hledger \
|
||
hledger-ui \
|
||
hledger-web \
|
||
hledger-api \
|
||
|
||
INCLUDEPATHS=\
|
||
-ihledger-lib \
|
||
-ihledger-lib/other/ledger-parse \
|
||
-ihledger \
|
||
-ihledger-ui \
|
||
-ihledger-web \
|
||
-ihledger-web/app \
|
||
-ihledger-api \
|
||
|
||
MAIN=hledger/app/hledger-cli.hs
|
||
|
||
# all source files in the project (plus a few strays like Setup.hs & hlint.hs)
|
||
SOURCEFILES:= \
|
||
dev.hs \
|
||
hledger/*hs \
|
||
hledger/bench/*hs \
|
||
hledger/Hledger/*hs \
|
||
hledger/Hledger/*/*hs \
|
||
hledger/Hledger/*/*/*hs \
|
||
hledger-*/*hs \
|
||
hledger-*/Hledger/*hs \
|
||
hledger-*/Hledger/*/*hs \
|
||
hledger-lib/other/ledger-parse/Ledger/Parser/*hs \
|
||
hledger-web/*/*.hs \
|
||
hledger-web/*/*/*.hs \
|
||
hledger-web/*/*/*/*.hs \
|
||
|
||
HPACKFILES:= \
|
||
hledger/*package.yaml \
|
||
hledger-*/*package.yaml \
|
||
|
||
CABALFILES:= \
|
||
hledger/hledger.cabal \
|
||
hledger-*/*.cabal \
|
||
|
||
MANUALSOURCEFILES:= \
|
||
doc/common.m4 \
|
||
*/*.m4.md \
|
||
|
||
MANUALGENFILES:= \
|
||
hledger*/hledger*.{1,5,info,txt} \
|
||
|
||
COMMANDHELPFILES:= \
|
||
hledger/Hledger/Cli/Commands/*.md \
|
||
|
||
# site/*.md includes website source files and generated web manual files
|
||
# WEBDOCFILES:= \
|
||
# site/*.md \
|
||
|
||
WEBCODEFILES:= \
|
||
hledger-web/templates/* \
|
||
hledger-web/static/*.js \
|
||
hledger-web/static/*.css \
|
||
|
||
DOCSOURCEFILES:= \
|
||
README.md \
|
||
CONTRIBUTING.md \
|
||
$(MANUALSOURCEFILES) \
|
||
$(COMMANDHELPFILES) \
|
||
site/*.md \
|
||
wiki/*.md \
|
||
|
||
# # file(s) which require recompilation for a build to have an up-to-date version string
|
||
# VERSIONSOURCEFILE=hledger/Hledger/Cli/Version.hs
|
||
|
||
# Two or three-part version string, set as program version in builds made by this makefile.
|
||
# We use hledger CLI's current version (XXX for all packages, which isn't quite right).
|
||
VERSION=$(shell cat hledger/.version)
|
||
|
||
# the number of commits since the last tag
|
||
PATCHLEVEL=$(shell git describe --tags --match 'hledger-[0-9]*' --long | awk -F- '{print $$3}')
|
||
#PATCHLEVEL:=$(shell git describe --tags --match 'hledger-web-[0-9]*' --long | awk -F- '{print $$4}')
|
||
# the number of commits since the last_release tag
|
||
#PATCHLEVEL:=$(shell git rev-list last_release..HEAD | wc -l)
|
||
|
||
# flags for ghc builds
|
||
|
||
WARNINGS:=\
|
||
-Wall \
|
||
-fno-warn-unused-do-bind \
|
||
-fno-warn-name-shadowing \
|
||
-fno-warn-missing-signatures \
|
||
-fno-warn-orphans \
|
||
-fno-warn-type-defaults \
|
||
|
||
# if you have need to try building in less memory
|
||
# GHCLOWMEMFLAGS= #+RTS -M200m -RTS
|
||
|
||
# ghc-only builds need the macro definitions generated by cabal
|
||
# from cabal's dist or dist-sandbox dir, hopefully there's just one:
|
||
#CABALMACROSFLAGS=-optP-include -optP hledger/dist*/build/autogen/cabal_macros.h
|
||
# or from stack's dist dir:
|
||
#CABALMACROSFLAGS=-optP-include -optP hledger/.stack-work/dist/*/*/build/autogen/cabal_macros.h
|
||
|
||
BUILDFLAGS=\
|
||
-rtsopts \
|
||
$(WARNINGS) \
|
||
$(INCLUDEPATHS) \
|
||
$(GHCLOWMEMFLAGS) $(CABALMACROSFLAGS) \
|
||
-DPATCHLEVEL=$(PATCHLEVEL) \
|
||
-DDEVELOPMENT \
|
||
-DVERSION="\"$(VERSION)\"" \
|
||
# -fhide-source-paths \
|
||
|
||
# PROFBUILDFLAGS:=-prof -fprof-auto -osuf hs_p
|
||
|
||
TIME=$(shell date +"%Y%m%d%H%M")
|
||
MONTHYEAR=$(shell date +'%B %Y')
|
||
|
||
###############################################################################
|
||
$(call def-help-subheading,INSTALLING:)
|
||
|
||
install: \
|
||
$(call def-help,install, download dependencies and install hledger executables to ~/.local/bin or equivalent (with stack))
|
||
$(STACK) install
|
||
|
||
###############################################################################
|
||
$(call def-help-subheading,BUILDING:)
|
||
|
||
# EXTRAINSTALLARGS=
|
||
|
||
build: \
|
||
$(call def-help,build, download dependencies and build hledger executables (with stack))
|
||
$(STACK) build
|
||
|
||
# check-setup: \
|
||
# $(call def-help,check-setup,\
|
||
# run some tests to validate the development environment\
|
||
# )
|
||
# @echo sanity-checking developer environment:
|
||
# @($(SHELLTEST) checks \
|
||
# && echo $@ PASSED) || echo $@ FAILED
|
||
|
||
link-web-dirs: config messages static templates \
|
||
$(call def-help,link-web-dirs,\
|
||
\
|
||
)
|
||
|
||
config: \
|
||
$(call def-help,config,\
|
||
\
|
||
)
|
||
ln -sf hledger-web/$@
|
||
|
||
messages: \
|
||
$(call def-help,messages,\
|
||
\
|
||
)
|
||
ln -sf hledger-web/$@
|
||
|
||
static: \
|
||
$(call def-help,static,\
|
||
\
|
||
)
|
||
ln -sf hledger-web/$@
|
||
|
||
templates: \
|
||
$(call def-help,templates,\
|
||
\
|
||
)
|
||
ln -sf hledger-web/$@
|
||
|
||
# force a compile even if binary exists, since we don't specify dependencies for these
|
||
.PHONY: bin/hledgerprof bin/hledgercov
|
||
|
||
hledgerprof: \
|
||
$(call def-help,hledgerprof, build "hledgerprof" for profiling (with stack) )
|
||
$(STACK) build hledger-lib hledger --library-profiling --executable-profiling --ghc-options=-fprof-auto
|
||
cp `$(STACK) exec which hledger`{,prof}
|
||
@echo to profile, use $(STACK) exec -- hledgerprof ...
|
||
|
||
hledgercov: \
|
||
$(call def-help,hledgercov, build "bin/hledgercov" for coverage reports (with ghc) )
|
||
$(STACK) ghc $(MAIN) -fhpc -o bin/hledgercov -outputdir .hledgercovobjs $(BUILDFLAGS)
|
||
|
||
# hledger-lib/Hledger/Read/TimeclockReaderPP.hs
|
||
dev: dev.hs $(SOURCEFILES) \
|
||
$(call def-help,dev, build the dev.hs script for quick experiments (with ghc) )
|
||
$(STACK) ghc -- $(CABALMACROSFLAGS) -ihledger-lib dev.hs \
|
||
|
||
# to get profiling deps installed, first do something like:
|
||
# stack build --library-profiling hledger-lib timeit criterion
|
||
devprof: dev.hs $(SOURCEFILES) \
|
||
$(call def-help,devprof, build the dev.hs script with profiling support )
|
||
$(STACK) ghc -- $(CABALMACROSFLAGS) -ihledger-lib dev.hs -rtsopts -prof -fprof-auto -osuf p_o -o devprof
|
||
|
||
dev-profile: devprof \
|
||
$(call def-help,dev-profile, get a time & space profile of the dev.hs script )
|
||
time ./devprof +RTS -P \
|
||
&& cp devprof.prof devprof.prof.$(TIME) \
|
||
&& profiterole devprof.prof
|
||
|
||
dev-heap: devprof \
|
||
$(call def-help,dev-heap, get heap profiles of the dev.hs script )
|
||
time ./devprof +RTS -hc -L1000 && cp devprof.hp devprof-hc.hp && hp2ps devprof-hc.hp
|
||
time ./devprof +RTS -hr -L1000 && cp devprof.hp devprof-hr.hp && hp2ps devprof-hr.hp
|
||
|
||
dev-heap-upload:
|
||
curl -F "file=@devprof-hc.hp" -F "title='hledger parser'" http://heap.ezyang.com/upload
|
||
curl -F "file=@devprof-hr.hp" -F "title='hledger parser'" http://heap.ezyang.com/upload
|
||
|
||
|
||
tools/generatejournal: tools/generatejournal.hs \
|
||
$(call def-help,tools/generatejournal, build the generatejournal tool )
|
||
$(STACK) ghc tools/generatejournal.hs
|
||
|
||
ghcid: $(call def-help,ghcid, start ghcid autobuilder on hledger-lib + hledger)
|
||
ghcid -c 'make ghci'
|
||
|
||
ghcid-ui: $(call def-help,ghcid-ui, start ghcid autobuilder on hledger-lib + hledger + hledger-ui)
|
||
ghcid -c 'make ghci-ui'
|
||
|
||
ghcid-web: $(call def-help,ghcid-web, start ghcid autobuilder on hledger-lib + hledger + hledger-web)
|
||
ghcid -c 'make ghci-web'
|
||
|
||
ghcid-api: $(call def-help,ghcid-api, start ghcid autobuilder on hledger-lib + hledger + hledger-api)
|
||
ghcid -c 'make ghci-api'
|
||
|
||
ghcid-test: $(call def-help,ghcid-test, start ghcid autobuilding and running the test command)
|
||
ghcid -c 'make ghci' --test ':main test'
|
||
|
||
ghcid-test-%: $(call def-help,ghcid-test-TESTPATTERN, start ghcid autobuilding and running the test command with the given TESTPATTERN)
|
||
ghcid -c 'make ghci' --test ':main test $*'
|
||
|
||
ghcid-doctest: $(call def-help,ghcid-doctest, start ghcid autobuilding and running hledger-lib doctests)
|
||
ghcid -c 'cd hledger-lib; $(STACK) ghci hledger-lib:test:doctests' --test ':main' --reload hledger-lib
|
||
|
||
# keep synced with Shake.hs header
|
||
SHAKEDEPS= \
|
||
--package base-prelude \
|
||
--package directory \
|
||
--package extra \
|
||
--package process \
|
||
--package safe \
|
||
--package shake \
|
||
--package time \
|
||
|
||
ghcid-shake: $(call def-help,ghcid-shake, start ghcid autobuilder on Shake.hs)
|
||
stack exec $(SHAKEDEPS) -- ghcid Shake.hs
|
||
|
||
# multi-package GHCI prompts
|
||
ghci: $(call def-help,ghci, start ghci REPL on hledger-lib + hledger)
|
||
$(STACK) exec -- $(GHCI) $(BUILDFLAGS) hledger/Hledger/Cli/Main.hs
|
||
|
||
ghci-prof: $(call def-help,ghci-prof, start ghci REPL on hledger-lib + hledger with profiling information)
|
||
stack build --profile hledger --only-dependencies
|
||
$(STACK) exec -- $(GHCI) $(BUILDFLAGS) -fexternal-interpreter -prof -fprof-auto hledger/Hledger/Cli/Main.hs
|
||
|
||
ghci-dev: $(call def-help,ghci-dev, start ghci REPL on hledger-lib + hledger + dev.hs script)
|
||
$(STACK) exec -- $(GHCI) $(BUILDFLAGS) -fno-warn-unused-imports -fno-warn-unused-binds dev.hs
|
||
|
||
ghci-ui: $(call def-help,ghci-ui, start ghci REPL on hledger-lib + hledger + hledger-ui)
|
||
$(STACK) exec -- $(GHCI) $(BUILDFLAGS) hledger-ui/Hledger/UI/Main.hs
|
||
|
||
ghci-web: link-web-dirs $(call def-help,ghci-web, start ghci REPL on hledger-lib + hledger + hledger-web)
|
||
$(STACK) exec -- $(GHCI) $(BUILDFLAGS) hledger-web/app/main.hs
|
||
|
||
ghci-api: $(call def-help,ghci-api, start ghci REPL on hledger-lib + hledger + hledger-api)
|
||
$(STACK) exec -- $(GHCI) $(BUILDFLAGS) hledger-api/hledger-api.hs
|
||
|
||
# ghci-all: $(call def-help,ghci-all, start ghci REPL on all the hledger)
|
||
# $(STACK) exec -- $(GHCI) $(BUILDFLAGS) \
|
||
# hledger-ui/Hledger/UI/Main.hs \
|
||
# hledger-web/app/main.hs \
|
||
# hledger-api/hledger-api.hs \
|
||
|
||
ghci-doctest: $(call def-help,ghci-doctest, start ghci REPL on hledger-lib doctests)
|
||
cd hledger-lib; $(STACK) ghci hledger-lib:test:doctests
|
||
|
||
ghci-shake: $(call def-help,ghci-shake, start ghci REPL on Shake.hs)
|
||
stack exec $(SHAKEDEPS) -- ghci Shake.hs
|
||
|
||
|
||
###############################################################################
|
||
$(call def-help-subheading,TESTING:)
|
||
|
||
test: pkgtest functest \
|
||
$(call def-help,test, run default tests: package tests plus functional tests)
|
||
|
||
# For quieter tests add --silent. It may hide troubleshooting info.
|
||
# For very verbose tests add --verbosity=debug. It seems hard to get something in between.
|
||
STACKTEST=$(STACK) test
|
||
|
||
buildplantest: $(call def-help,buildplantest, stack build --dry-run all hledger packages ensuring an install plan with default snapshot) \
|
||
buildplantest-stack.yaml
|
||
|
||
buildplantest-all: $(call def-help,buildplantest-all, stack build --dry-run all hledger packages ensuring an install plan with each ghc version/stackage snapshot )
|
||
for F in stack-*.yaml stack.yaml; do make --no-print-directory buildplantest-$$F; done
|
||
|
||
buildplantest-%: $(call def-help,buildplantest-STACKFILE, stack build --dry-run all hledger packages ensuring an install plan with the given stack yaml file; eg make buildplantest-stack-ghc8.2.yaml )
|
||
$(STACK) build --dry-run --test --bench --stack-yaml=$*
|
||
|
||
buildtest: $(call def-help,buildtest, force-rebuild all hledger packages/modules quickly ensuring no warnings with default snapshot) \
|
||
buildtest-stack.yaml
|
||
|
||
buildtest-all: $(call def-help,buildtest-all, force-rebuild all hledger packages/modules quickly ensuring no warnings with each ghc version/stackage snapshot )
|
||
for F in stack-*.yaml stack.yaml; do make --no-print-directory buildtest-$$F; done
|
||
|
||
buildtest-%: $(call def-help,buildtest-STACKFILE, force-rebuild all hledger packages/modules quickly ensuring no warnings with the given stack yaml file; eg make buildtest-stack-ghc8.2.yaml )
|
||
$(STACK) build --test --bench --fast --force-dirty --ghc-options=-fforce-recomp --ghc-options=-Werror --stack-yaml=$*
|
||
|
||
incr-buildtest: $(call def-help,incr-buildtest, build any outdated hledger packages/modules quickly ensuring no warnings with default snapshot. Wont detect warnings in up-to-date modules.) \
|
||
incr-buildtest-stack.yaml
|
||
|
||
incr-buildtest-all: $(call def-help,incr-buildtest-all, build any outdated hledger packages/modules quickly ensuring no warnings with each ghc version/stackage snapshot. Wont detect warnings in up-to-date modules. )
|
||
for F in stack-*.yaml stack.yaml; do make --no-print-directory incr-buildtest-$$F; done
|
||
|
||
incr-buildtest-%: $(call def-help,incr-buildtest-STACKFILE, build any outdated hledger packages/modules quickly ensuring no warnings with the stack yaml file; eg make buildtest-stack-ghc8.2.yaml. Wont detect warnings in up-to-date modules. )
|
||
$(STACK) build --test --bench --fast --ghc-options=-Werror --stack-yaml=$*
|
||
|
||
pkgtest: $(call def-help,pkgtest, run the test suites in each package )
|
||
@($(STACKTEST) && echo $@ PASSED) || (echo $@ FAILED; false)
|
||
|
||
# doctest with ghc 8.4 on mac requires a workaround, see hledger-lib/package.yaml.
|
||
# Or, could run it with ghc 8.2:
|
||
# @($(STACKTEST) --stack-yaml stack-ghc8.2.yaml hledger-lib:test:doctests && echo $@ PASSED) || (echo $@ FAILED; false)
|
||
doctest: $(call def-help,doctest, run the doctests in hledger-lib module/function docs )
|
||
@($(STACKTEST) hledger-lib:test:doctests && echo $@ PASSED) || (echo $@ FAILED; false)
|
||
|
||
easytest: $(call def-help,easytest, run the easytest unit tests in hledger-lib )
|
||
@($(STACKTEST) hledger-lib:test:easytests && echo $@ PASSED) || (echo $@ FAILED; false)
|
||
|
||
# assumes an up to date hledger executable is built.
|
||
# I think we don't do it automatically to minimise unnecessary rebuilding.
|
||
builtintest: $(call def-help,builtintest, run hledgers built in test command)
|
||
@($(STACK) exec hledger test && echo $@ PASSED) || (echo $@ FAILED; false)
|
||
|
||
#functest: addons tests/addons/hledger-addon
|
||
functest: tests/addons/hledger-addon \
|
||
$(call def-help,functest, build hledger quickly and run the functional tests (and some unit tests) )
|
||
@stack build --fast hledger
|
||
@($(SHELLTESTSTK) -w `stack exec -- which hledger` tests \
|
||
&& echo $@ PASSED) || (echo $@ FAILED; false)
|
||
|
||
ADDONEXTS=pl py rb sh hs lhs rkt exe com bat
|
||
tests/addons/hledger-addon: \
|
||
$(call def-help,tests/addons/hledger-addon,\
|
||
generate dummy add-ons for testing (hledger-addon the rest)\
|
||
)
|
||
rm -rf tests/addons/hledger-*
|
||
printf '#!/bin/sh\necho add-on: $$0\necho args: $$*\n' >tests/addons/hledger-addon
|
||
for E in '' $(ADDONEXTS); do \
|
||
cp tests/addons/hledger-addon tests/addons/hledger-addon.$$E; done
|
||
for F in addon. addon2 addon2.hs addon3.exe addon3.lhs addon4.exe add reg; do \
|
||
cp tests/addons/hledger-addon tests/addons/hledger-$$F; done
|
||
mkdir tests/addons/hledger-addondir
|
||
chmod +x tests/addons/hledger-*
|
||
|
||
# hlinttest hlint: $(call def-help,hlinttest (or hlint),generate a hlint report)
|
||
# hlint --hint=hlint --report=hlint.html $(SOURCEFILES)
|
||
|
||
haddocktest: $(call def-help,haddocktest, run haddock to make sure it can generate docs without dying )
|
||
@(make --quiet haddock && echo $@ PASSED) || (echo $@ FAILED; false)
|
||
|
||
cabalfiletest: $(call def-help,cabalfiletest, run cabal check to test cabal file syntax )
|
||
@(make --no-print-directory cabalcheck && echo $@ PASSED) || (echo $@ FAILED; false)
|
||
|
||
allghcstest: $(call def-help,allghcstest, build/test/benchmark with all supported GHC versions/stackage snapshots and warning-free) \
|
||
test-stack-ghc7.10.yaml \
|
||
test-stack-ghc8.0.yaml \
|
||
test-stack-ghc8.2.yaml \
|
||
test-stack.yaml \
|
||
|
||
test-stack%yaml:
|
||
$(STACK) --stack-yaml stack$*yaml clean
|
||
$(STACK) --stack-yaml stack$*yaml build --ghc-options="$(WARNINGS) -Werror" --test --bench --haddock --no-haddock-deps
|
||
|
||
travistest: $(call def-help,travistest, run tests similar to our travis CI tests)
|
||
$(STACK) clean
|
||
$(STACK) build --ghc-options=-Werror --test --haddock --no-haddock-deps hledger-lib
|
||
$(STACK) build --ghc-options=-Werror --test --haddock --no-haddock-deps hledger
|
||
$(STACK) build --ghc-options=-Werror --test --haddock --no-haddock-deps hledger-ui
|
||
$(STACK) build --ghc-options=-Werror --test --haddock --no-haddock-deps hledger-web
|
||
$(STACK) build --ghc-options=-Werror --test --haddock --no-haddock-deps hledger-api
|
||
make functest
|
||
|
||
# committest: hlinttest unittest doctest functest haddocktest buildtest quickcabaltest \
|
||
# $(call def-help,committest,more thorough pre-commit/pre-push tests)
|
||
|
||
# releasetest: Clean unittest functest fullcabaltest haddocktest #buildtest doctest \
|
||
# $(call def-help,releasetest,pre-release tests)
|
||
|
||
HLEDGERINSTALLSH=$(PWD)/hledger-install/hledger-install.sh
|
||
installtest: $(call def-help,installtest, run hledger-install.sh from another directory)
|
||
(cd; $(HLEDGERINSTALLSH))
|
||
|
||
###############################################################################
|
||
$(call def-help-subheading,BENCHMARKING:)
|
||
|
||
samplejournals: $(call def-help,samplejournals, regenerate standard sample journals in examples/) \
|
||
examples/sample.journal \
|
||
examples/100x100x10.journal \
|
||
examples/1000x1000x10.journal \
|
||
examples/1000x10000x10.journal \
|
||
examples/2000x1000x10.journal \
|
||
examples/3000x1000x10.journal \
|
||
examples/4000x1000x10.journal \
|
||
examples/5000x1000x10.journal \
|
||
examples/6000x1000x10.journal \
|
||
examples/7000x1000x10.journal \
|
||
examples/8000x1000x10.journal \
|
||
examples/9000x1000x10.journal \
|
||
examples/10000x1000x10.journal \
|
||
examples/10000x10000x10.journal \
|
||
examples/100000x1000x10.journal \
|
||
examples/1000000x1000x10.journal \
|
||
# examples/ascii.journal \
|
||
# examples/chinese.journal \
|
||
# examples/mixed.journal \
|
||
|
||
examples/sample.journal:
|
||
true # XXX should probably regenerate this
|
||
|
||
examples/100x100x10.journal: tools/generatejournal
|
||
tools/generatejournal 100 100 10 >$@
|
||
|
||
examples/1000x1000x10.journal: tools/generatejournal
|
||
tools/generatejournal 1000 1000 10 >$@
|
||
|
||
examples/1000x10000x10.journal: tools/generatejournal
|
||
tools/generatejournal 1000 10000 10 >$@
|
||
|
||
examples/2000x1000x10.journal: tools/generatejournal
|
||
tools/generatejournal 2000 1000 10 >$@
|
||
|
||
examples/3000x1000x10.journal: tools/generatejournal
|
||
tools/generatejournal 3000 1000 10 >$@
|
||
|
||
examples/4000x1000x10.journal: tools/generatejournal
|
||
tools/generatejournal 4000 1000 10 >$@
|
||
|
||
examples/5000x1000x10.journal: tools/generatejournal
|
||
tools/generatejournal 5000 1000 10 >$@
|
||
|
||
examples/6000x1000x10.journal: tools/generatejournal
|
||
tools/generatejournal 6000 1000 10 >$@
|
||
|
||
examples/7000x1000x10.journal: tools/generatejournal
|
||
tools/generatejournal 7000 1000 10 >$@
|
||
|
||
examples/8000x1000x10.journal: tools/generatejournal
|
||
tools/generatejournal 8000 1000 10 >$@
|
||
|
||
examples/9000x1000x10.journal: tools/generatejournal
|
||
tools/generatejournal 9000 1000 10 >$@
|
||
|
||
examples/10000x1000x10.journal: tools/generatejournal
|
||
tools/generatejournal 10000 1000 10 >$@
|
||
|
||
examples/10000x10000x10.journal: tools/generatejournal
|
||
tools/generatejournal 10000 10000 10 >$@
|
||
|
||
examples/100000x1000x10.journal: tools/generatejournal
|
||
tools/generatejournal 100000 1000 10 >$@
|
||
|
||
examples/1000000x1000x10.journal: tools/generatejournal
|
||
tools/generatejournal 1000000 1000 10 >$@
|
||
|
||
examples/ascii.journal: tools/generatejournal
|
||
tools/generatejournal 3 5 5 >$@
|
||
|
||
examples/chinese.journal: tools/generatejournal
|
||
tools/generatejournal 3 5 5 --chinese >$@
|
||
|
||
examples/mixed.journal: tools/generatejournal
|
||
tools/generatejournal 3 5 5 --mixed >$@
|
||
|
||
BENCHEXES=hledger
|
||
# or, eg: BENCHEXES=ledger,hledger-1.4,hledger
|
||
|
||
bench: samplejournals bench.sh $(call def-help,bench, benchmark commands in bench.sh with quickbench and $(BENCHEXES))
|
||
quickbench -v -w $(BENCHEXES)
|
||
|
||
# bench: samplejournals tests/bench.tests tools/simplebench \
|
||
# $(call def-help,bench,\
|
||
# run simple performance benchmarks and archive results\
|
||
# Requires some commands defined in tests/bench.tests and some BENCHEXES defined above.\
|
||
# )
|
||
# tools/simplebench -v -ftests/bench.tests $(BENCHEXES) | tee doc/profs/$(TIME).bench
|
||
# @rm -f benchresults.*
|
||
# @(cd doc/profs; rm -f latest.bench; ln -s $(TIME).bench latest.bench)
|
||
|
||
# criterionbench: samplejournals tools/criterionbench \
|
||
# $(call def-help,criterionbench,\
|
||
# run criterion benchmark tests and save graphical results\
|
||
# )
|
||
# tools/criterionbench -t png -k png
|
||
|
||
# progressionbench: samplejournals tools/progressionbench \
|
||
# $(call def-help,progressionbench,\
|
||
# run progression benchmark tests and save graphical results\
|
||
# )
|
||
# tools/progressionbench -- -t png -k png
|
||
|
||
# prof: samplejournals \
|
||
# $(call def-help,prof,\
|
||
# generate and archive an execution profile\
|
||
# ) #bin/hledgerprof
|
||
# @echo "Profiling: $(PROFCMD)"
|
||
# -$(PROFCMD) +RTS $(PROFRTSFLAGS) -RTS
|
||
# mv hledgerprof.prof doc/profs/$(TIME).prof
|
||
# (cd doc/profs; rm -f latest*.prof; ln -s $(TIME).prof latest.prof)
|
||
|
||
# viewprof: prof \
|
||
# $(call def-help,viewprof,\
|
||
# generate, archive, simplify and display an execution profile\
|
||
# )
|
||
# tools/simplifyprof.hs doc/profs/latest.prof
|
||
|
||
quickprof-%: hledgerprof samplejournals \
|
||
$(call def-help,quickprof-"CMD", run some command against a sample journal and display the execution profile )
|
||
$(STACK) exec -- hledgerprof +RTS $(PROFRTSFLAGS) -RTS $* -f examples/10000x1000x10.journal >/dev/null
|
||
profiterole hledgerprof.prof
|
||
@echo
|
||
@head -20 hledgerprof.prof
|
||
@echo ...
|
||
@echo
|
||
@echo see hledgerprof.prof or hledgerprof.prof.html for the full report
|
||
|
||
# heap: samplejournals \
|
||
# $(call def-help,heap,\
|
||
# generate and archive a graphical heap profile\
|
||
# ) #bin/hledgerprof
|
||
# @echo "Profiling heap with: $(PROFCMD)"
|
||
# $(PROFCMD) +RTS -hc -RTS
|
||
# mv hledgerprof.hp doc/profs/$(TIME).hp
|
||
# (cd doc/profs; rm -f latest.hp; ln -s $(TIME).hp latest.hp; \
|
||
# hp2ps $(TIME).hp; rm -f latest.ps; ln -s $(TIME).ps latest.ps; rm -f *.aux)
|
||
|
||
# viewheap: heap \
|
||
# $(call def-help,viewheap,\
|
||
# \
|
||
# )
|
||
# $(VIEWPS) doc/profs/latest.ps
|
||
|
||
quickheap-%: hledgerprof samplejournals \
|
||
$(call def-help,quickheap-"CMD", run some command against a sample journal and display the heap profile )
|
||
$(STACK) exec -- hledgerprof +RTS -hc -RTS $* -f examples/10000x1000x10.journal >/dev/null
|
||
hp2ps hledgerprof.hp
|
||
@echo generated hledgerprof.ps
|
||
$(VIEWPS) hledgerprof.ps
|
||
|
||
# quickcoverage: hledgercov \
|
||
# $(call def-help,quickcoverage,\
|
||
# display a code coverage text report from running hledger COVCMD\
|
||
# )
|
||
# @echo "Generating code coverage text report for hledger command: $(COVCMD)"
|
||
# tools/runhledgercov "report" $(COVCMD)
|
||
|
||
# coverage: samplejournals hledgercov \
|
||
# $(call def-help,coverage,\
|
||
# generate a code coverage html report from running hledger COVCMD\
|
||
# )
|
||
# @echo "Generating code coverage html report for hledger command: $(COVCMD)"
|
||
# tools/runhledgercov "markup --destdir=doc/profs/coverage" $(COVCMD)
|
||
# cd doc/profs/coverage; rm -f index.html; ln -s hpc_index.html index.html
|
||
|
||
# viewcoverage: \
|
||
# $(call def-help,viewcoverage,\
|
||
# view the last html code coverage report\
|
||
# )
|
||
# $(VIEWHTML) doc/profs/coverage/index.html
|
||
|
||
###############################################################################
|
||
$(call def-help-subheading,DOCUMENTATION: (see also Shake.hs))
|
||
|
||
# cf http://www.haskell.org/haddock/doc/html/invoking.html
|
||
# --ghc-options=-optP-P is a workaround for http://trac.haskell.org/haddock/ticket/284
|
||
HADDOCKFLAGS= \
|
||
--haddock-options='--no-warnings' \
|
||
--ghc-options='-optP-P' \
|
||
|
||
haddock: \
|
||
$(call def-help,haddock, generate haddock docs for the hledger packages )
|
||
$(STACK) haddock --no-haddock-deps --no-keep-going
|
||
# $(STACK) -v haddock --no-haddock-deps --no-keep-going # && echo OK
|
||
|
||
# view-haddock: \
|
||
# $(call def-help,view-haddock-cli,\
|
||
# view the haddock generated for the hledger package\
|
||
# )
|
||
# $(VIEWHTML) hledger/dist/doc/html/hledger/index.html
|
||
|
||
# sourcegraph: \
|
||
# $(call def-help,sourcegraph,\
|
||
# \
|
||
# )
|
||
# for p in $(PACKAGES); do (cd $$p; SourceGraph $$p.cabal); done
|
||
|
||
# #set up the hoogle web interface
|
||
# ## We munge haddock and hoogle into a rough but useful framed layout.
|
||
# ## For this to work the hoogle cgi must be built with base target "main".
|
||
# ## XXX move the framed index building into haddock: ?
|
||
# # sed -i -e 's%^></HEAD%><base target="main"></HEAD%' site/api/modules-index.html ; \
|
||
# # cp site/api-frames.html site/api/index.html ; \
|
||
# # # cp site/hoogle-small.html site/api
|
||
# #
|
||
# #uses a hoogle source tree configured with --datadir=., patched to fix haddock urls/target frame
|
||
# # HOOGLESRC=/usr/local/src/hoogle
|
||
# # HOOGLE=$(HOOGLESRC)/dist/build/hoogle/hoogle
|
||
# # HOOGLEVER=`$(HOOGLE) --version |tail -n 1 | sed -e 's/Version /hoogle-/'`
|
||
# # hoogle: hoogleindex
|
||
# # if test -f $(HOOGLE) ; then \
|
||
# # cd site/api && \
|
||
# # rm -f $(HOOGLEVER) && \
|
||
# # ln -s . $(HOOGLEVER) && \
|
||
# # cp -r $(HOOGLESRC)/src/res/ . && \
|
||
# # cp -p $(HOOGLE) index.cgi && \
|
||
# # touch log.txt && chmod 666 log.txt ; \
|
||
# # else \
|
||
# # echo "Could not find $(HOOGLE) in the hoogle source tree" ; \
|
||
# # fi
|
||
# #
|
||
# #generate a hoogle index
|
||
# # hoogleindex:
|
||
# # $(HADDOCK) $(HADDOCKFLAGS) -o site/api --hoogle $(MAIN) && \
|
||
# # cd site/api && \
|
||
# # hoogle --convert=main.txt --output=default.hoo
|
||
|
||
site-liverender: Shake \
|
||
$(call def-help,site-liverender, update the local website html when source files are saved )
|
||
ls $(DOCSOURCEFILES) | entr ./Shake website
|
||
|
||
LIVERELOAD=livereloadx -p $(LIVERELOADPORT)
|
||
LIVERELOADPORT=8001
|
||
|
||
site-livereload: \
|
||
$(call def-help,site-livereload, open a browser on the local website html and reload the page when it updates )
|
||
(sleep 1; open http://localhost:$(LIVERELOADPORT)) &
|
||
$(LIVERELOAD) -s site/_site
|
||
|
||
site-watch:
|
||
$(call def-help,site-livereload, open a browser on the local website html and rerender & reload the page on file change )
|
||
make site-liverender &
|
||
(sleep 1; $(BROWSE) http://localhost:$(LIVERELOADPORT)/) &
|
||
$(LIVERELOAD) -s site/_site/
|
||
|
||
# This rule, for updating the live hledger.org site, gets called by:
|
||
# 1. github-post-receive (github webhook handler), when something is pushed
|
||
# to the main or wiki repos on Github. Config:
|
||
# /etc/supervisord.conf -> [program:github-post-receive]
|
||
# /etc/github-post-receive.conf
|
||
# 2. cron, nightly. Config: /etc/crontab
|
||
# 3. manually (make site).
|
||
# This must use the existing Shake executable without rebuilding it,
|
||
# as we don't want to immediately execute new code from any collaborator.
|
||
.PHONY: site
|
||
site: \
|
||
$(call def-help,site, update the hledger.org website (run on prod) )
|
||
@[ ! -x Shake ] \
|
||
&& echo 'Please run "make Shake" first (manual compilation of Shake.hs is required)' \
|
||
|| ( \
|
||
echo; \
|
||
./Shake hledgerorg \
|
||
) 2>&1 | tee -a site.log
|
||
|
||
###############################################################################
|
||
$(call def-help-subheading,RELEASING:)
|
||
|
||
# old/desired release process:
|
||
# a normal release: echo 0.7 >.version; make release
|
||
# a bugfix release: echo 0.7.1 >.version; make release
|
||
#release: releasetest bumpversion tagrelease $(call def-help,release, prepare and test a release and tag the repo )
|
||
#publish: hackageupload pushtags $(call def-help,upload, publish latest hackage packages and push tags to github )
|
||
#releaseandpublish: release upload $(call def-help,releaseandpublish, release and upload and publish updated docs )
|
||
|
||
ISCLEAN=git diff-index --quiet HEAD --
|
||
|
||
# stop if the working directory has uncommitted changes
|
||
iscleanwd:
|
||
@$(ISCLEAN) || (echo "please clean the working directory first"; false)
|
||
|
||
# stop if the given file(s) have uncommitted changes
|
||
isclean-%:
|
||
@$(ISCLEAN) $* || (echo "please clean these files first: $*"; false)
|
||
|
||
# (re)generate a cabal files with stack's built-in hpack
|
||
gencabal: $(call def-help,gencabal, regenerate cabal files from package.yaml files with stack )
|
||
$(STACK) build --dry-run --silent
|
||
|
||
# (re)generate cabal files with hpack
|
||
# To avoid warnings, this hpack should be the same version as stack's built-in hpack
|
||
gencabal-with-hpack-%:
|
||
$(STACK) build --with-hpack hpack-$* --dry-run --silent
|
||
|
||
# updatecabal: gencabal $(call def-help,updatecabal, regenerate cabal files and commit )
|
||
# @read -p "please review changes then press enter to commit $(shell ls */*.cabal)"
|
||
# git commit -m "update cabal files" $(shell ls */*.cabal)
|
||
|
||
# we call in shake for this job; so dependencies aren't checked here
|
||
genmanuals: Shake #$(call def-help,genmanuals, regenerate embedded manuals (might need -B) )
|
||
./Shake manuals
|
||
|
||
# we call in shake for this job; so dependencies aren't checked here
|
||
gencommandhelp: Shake
|
||
./Shake commandhelp
|
||
|
||
updateembeddeddocs: genmanuals gencommandhelp $(call def-help,updatemanuals, regenerate embedded docs and commit (might need -B) )
|
||
@read -p "please review changes then press enter to commit $(shell ls hledger*/hledger*.{1,5,info,txt})"
|
||
git commit -m "update embedded docs" hledger*/hledger*.{1,5,info,txt} hledger/Hledger/Cli/Commands/*.txt
|
||
|
||
|
||
# hackageupload-dry: \
|
||
# $(call def-help,hackageupload-dry,\
|
||
# upload all packages to hackage; dry run\
|
||
# )
|
||
# for p in $(PACKAGES); do cabal upload $$p/dist/$$p-$(VERSION).tar.gz -v2 --check; done
|
||
|
||
hackageupload: \
|
||
$(call def-help,hackageupload, upload all packages to hackage )
|
||
for p in $(PACKAGES); do stack upload $$p; done
|
||
|
||
# showreleasestats stats: \
|
||
# showreleasedays \
|
||
# showunreleasedchangecount \
|
||
# showloc \
|
||
# showtestcount \
|
||
# showunittestcoverage \
|
||
# showreleaseauthors \
|
||
# showunreleasedcodechanges \
|
||
# showunpushedchanges \
|
||
# $(call def-help,showreleasestats stats,\
|
||
# show project stats useful for release notes\
|
||
# )
|
||
# # showerrors
|
||
|
||
# FROMTAG=.
|
||
|
||
# showreleasedays: \
|
||
# $(call def-help,showreleasedays,\
|
||
# \
|
||
# )
|
||
# @echo Days since last release:
|
||
# @tools/dayssincetag.hs $(FROMTAG) | head -1 | cut -d' ' -f-1
|
||
# @echo
|
||
|
||
# # XXX
|
||
# showunreleasedchangecount: \
|
||
# $(call def-help,showunreleasedchangecount,\
|
||
# \
|
||
# )
|
||
# @echo Commits since last release:
|
||
# @darcs changes --from-tag $(FROMTAG) --count
|
||
# @echo
|
||
|
||
describe: $(call def-help,describe, show a precise git-describe version string )
|
||
@git describe --tags --match 'hledger-[0-9]*' --dirty
|
||
|
||
# showreleaseauthors: $(call def-help,showreleaseauthors, show author names since last release)
|
||
# @echo Commit authors since last release:
|
||
# @git shortlog -sn $(CHANGELOGSTART).. # TODO undefined
|
||
|
||
cloc: $(call def-help,cloc, count lines of source code )
|
||
@echo Lines of code including tests:
|
||
@cloc --exclude-lang=HTML --exclude-dir=.stack-work,.idea,dist,old,bin,doc,site,.tutorial-data,static,angular .
|
||
|
||
|
||
@echo
|
||
# `ls $(SOURCEFILES)`
|
||
|
||
# sloc: \
|
||
# $(call def-help,sloc,\
|
||
# \
|
||
# )
|
||
# @sloccount hledger-lib hledger hledger-web
|
||
|
||
# cloc: \
|
||
# $(call def-help,cloc,\
|
||
# \
|
||
# )
|
||
# @echo
|
||
# @echo "Lines of code as of `date`:"
|
||
# @echo
|
||
# @echo "hledger-lib, hledger"
|
||
# @cloc -q hledger-lib hledger 2>&1 | grep -v 'defined('
|
||
# @echo
|
||
# @echo "hledger-web"
|
||
# @cloc -q hledger-web 2>&1 | grep -v 'defined('
|
||
# @echo
|
||
# @echo "hledger-lib, hledger, hledger-web"
|
||
# @cloc -q hledger-lib hledger hledger-web 2>&1 | grep -v 'defined('
|
||
|
||
# showtestcount: \
|
||
# $(call def-help,showtestcount,\
|
||
# \
|
||
# )
|
||
# @echo "Unit tests:"
|
||
# @hledger test 2>&1 | cut -d' ' -f2
|
||
# @echo "Functional tests:"
|
||
# @make --no-print functest | egrep '^ Total' | awk '{print $$2}'
|
||
# @echo
|
||
|
||
# showunittestcoverage: \
|
||
# $(call def-help,showunittestcoverage,\
|
||
# \
|
||
# )
|
||
# @echo Unit test coverage:
|
||
# @make --no-print quickcoverage | grep 'expressions'
|
||
# @echo
|
||
|
||
# # showerrors:
|
||
# # @echo Known errors:
|
||
# # @awk '/^** errors/, /^** / && !/^** errors/' NOTES.org | grep '^\*\*\* ' | tail +1
|
||
# # @echo
|
||
|
||
# # XXX
|
||
# showunpushedchanges showunpushed: \
|
||
# $(call def-help,showunpushedchanges showunpushed,\
|
||
# \
|
||
# )
|
||
# @echo "Changes not yet pushed upstream (to `darcs show repo | grep 'Default Remote' | cut -c 17-`):"
|
||
# @-darcs push simon@joyful.com:/repos/hledger --dry-run | grep '*' | tac
|
||
# @echo
|
||
|
||
# # XXX
|
||
# showunreleasedcodechanges showunreleased showchanges: \
|
||
# $(call def-help,showunreleasedcodechanges showunreleased showchanges,\
|
||
# \
|
||
# )
|
||
# @echo "hledger code changes since last release:"
|
||
# @darcs changes --from-tag $(FROMTAG) --matches "not (name docs: or name doc: or name site: or name tools:)" | grep '*'
|
||
# @echo
|
||
|
||
# # XXX
|
||
# showcodechanges: \
|
||
# $(call def-help,showcodechanges,\
|
||
# \
|
||
# )
|
||
# @echo "hledger code changes:"
|
||
# @darcs changes --matches "not (name docs: or name site: or name tools:)" | egrep '^ +(\*|tagged)'
|
||
# @echo
|
||
|
||
###############################################################################
|
||
$(call def-help-subheading,MISCELLANEOUS:)
|
||
|
||
watch-%: $(call def-help,watch-RULE, run make RULE repeatedly when any committed file changes)
|
||
@git ls-files | entr -r make $*
|
||
|
||
Shake: Shake.hs $(call def-help,Shake, ensure the Shake script is compiled )
|
||
./Shake.hs
|
||
|
||
cabal%: \
|
||
$(call def-help,cabalCMD, run cabal CMD inside each hledger package directory )
|
||
for p in $(PACKAGES); do (cd $$p; cabal $*); done
|
||
|
||
usage: cabalusage stackusage \
|
||
$(call def-help,usage, show size of various dirs )
|
||
du -sh .git bin data doc extra
|
||
du -sh .
|
||
|
||
stackusage: \
|
||
$(call def-help,stackusage, show size of stack working dirs if any )
|
||
-du -shc `find . -name '.stack*'`
|
||
|
||
cabalusage: \
|
||
$(call def-help,cabalusage, show size of cabal working dirs if any )
|
||
-du -shc */dist* 2>/dev/null
|
||
|
||
tag: emacstags-ctags \
|
||
$(call def-help,tag, generate tag files for source code navigation (for emacs) )
|
||
|
||
# Tag haskell files with hasktags and just list the other main source files
|
||
# so they will be traversed by tags-search/tags-query-replace.
|
||
# emacstags:
|
||
# rm -f TAGS
|
||
# hasktags -e $(SOURCEFILES)
|
||
# for f in Makefile $(WEBCODEFILES) $(HPACKFILES) $(CABALFILES) $(DOCSOURCEFILES); do \
|
||
# printf " \n$$f,1\n" >> TAGS; \
|
||
# done
|
||
|
||
# Tag:
|
||
# - haskell files, with hasktags
|
||
# - everything else not excluded by .ctags, with (exuberant) ctags
|
||
# - files currently missed by the above, just their names (docs, hpack, cabal..)
|
||
emacstags-ctags:
|
||
hasktags -e $(SOURCEFILES)
|
||
ctags -a -e -R
|
||
for f in \
|
||
$(DOCSOURCEFILES) \
|
||
$(HPACKFILES) \
|
||
$(CABALFILES) \
|
||
Shake.hs \
|
||
; do printf " \n$$f,1\n" >> TAGS; done
|
||
|
||
cleantags: \
|
||
$(call def-help-hide,cleantags, remove tag files )
|
||
rm -f TAGS tags
|
||
|
||
stackclean: \
|
||
$(call def-help-hide,stackclean, remove .stack-work/* in packages (but not in project) )
|
||
$(STACK) clean
|
||
|
||
Stackclean: \
|
||
$(call def-help-hide,Stackclean, remove all stack working dirs )
|
||
$(STACK) clean
|
||
|
||
cleanghco: \
|
||
$(call def-help-hide,cleanghc, remove ghc build leftovers )
|
||
rm -rf `find . -name "*.o" -o -name "*.hi" -o -name "*.dyn_o" -o -name "*.dyn_hi" -o -name "*~" | grep -vE '\.(stack-work|cabal-sandbox|virthualenv)'`
|
||
|
||
clean: cleanghco \
|
||
$(call def-help,clean, default cleanup (ghc build leftovers) )
|
||
|
||
Clean: stackclean cabalclean cleanghc cleantags clean-manpages \
|
||
$(call def-help,Clean, thorough cleanup (stack/cabal/ghc builds and tags) )
|
||
|
||
# reverse = $(if $(wordlist 2,2,$(1)),$(call reverse,$(wordlist 2,$(words $(1)),$(1))) $(firstword $(1)),$(1))
|
||
|
||
###############################################################################
|
||
# END
|
||
|
||
# optional local customisations, not in version control
|
||
-include Makefile.local
|
||
|
||
# show a final message in make help
|
||
$(call def-help-heading,)
|
||
$(call def-help-heading,See also ./Shake help (after make Shake))
|