Makefile build-order comments

This commit is contained in:
John Kerl 2021-03-31 17:40:51 -04:00
parent ce2468c989
commit b6f3be69a1
4 changed files with 9 additions and 4 deletions

View file

@ -1,5 +1,8 @@
# Minimal makefile for Sphinx documentation
#
# Note: run this after make in the ../c directory and make in the ../man directory
# since ../c/mlr is used to autogenerate ../man/manpage.txt which is used in this directory.
# See also https://miller.readthedocs.io/en/latest/build.html#creating-a-new-release-for-developers
# You can set these variables from the command line, and also
# from the environment for the first two.

View file

@ -148,6 +148,7 @@ In this example I am using version 3.4.0; of course that will change for subsequ
* Edit ``configure.ac``, ``c/mlrvers.h``, ``miller.spec``, and ``docs/conf.py`` from ``3.3.2-dev`` to ``3.4.0``.
* Do a fresh ``autoreconf -fiv`` and commit the output. (Preferably on a Linux host, rather than MacOS, to reduce needless diffs in autogen build files.)
* ``make -C c -f Makefile.no-autoconfig installhome && make -C man -f Makefile.no-autoconfig installhome && make -C docs -f Makefile.no-autoconfig html``
* The ordering is important: the first build creates ``mlr``; the second runs ``mlr`` to create ``manpage.txt``; the third includes ``manpage.txt`` into one of its outputs.
* Commit and push.
* Create the release tarball and SRPM:

View file

@ -2,12 +2,10 @@
TOP OF LIST:
* manpage.txt fu w/ comments & automake
* #455 -- doc-neatens re ordering
! substr operate on runes
* #455 -- doc-neatens re ordering
d windows mrpl colors -- ? checking isatty also -- ?
* more doclinks:
https://www.ict4g.net/adolfo/notes/data-analysis/tools-to-manipulate-csv.html
https://www.ict4g.net/adolfo/notes/data-analysis/miller-quick-tutorial.html
* more about HTTP logs in miller -- doc and encapsulate:
mlr --icsv --implicit-csv-header --ifs space --oxtab --from elb-log put -q 'print $27'

View file

@ -1,4 +1,7 @@
# Respective MANPATH entries would include /usr/local/share/man or $HOME/man.
# This should be run after make in the ../c directory but before make in the ../docs directory,
# since ../c/mlr is used to autogenerate ./manpage.txt which is used in ../docs.
# See also https://miller.readthedocs.io/en/latest/build.html#creating-a-new-release-for-developers
INSTALLDIR=/usr/local/share/man/man1
INSTALLHOME=$(HOME)/man/man1