Wednesday, 18 February 2009

shave: making the autotools output sane

updated: Automake 1.11 has been release with "silent rules" support, a feature that supersedes the hack that shave is. If you can depend on automake 1.11 please consider using its silent rules rather than shave.
updated: add some gtk-doc info
updated: CXX support thanks to Tommi Komulainen


Fed up with endless screens of libtool/automake output? Fed up with having to resort to -Werror to see warnings in your code? Then shave might be for you. shave transforms the messy output of autotools into a pretty Kbuild-like one (Kbuild is the Linux build system). It's composed of a m4 macro and 2 small shell scripts and it's available in a git repository.
git clone git://
Hopefully, in a few minutes, you should be able to see your project compile like this:
$ make
Making all in foo
Making all in internal
CC    internal-file0.o
CC    lib-file0.o
CC    lib-file1.o
Making all in tools
CC    tool0-tool0.o
LINK  tool0
Just like Kbuild, shave supports outputting the underlying commands using:
$ make V=1


  • Put the two shell scripts and in the directory of your choice (it can be at the root of your autotooled project).
  • add shave and shave-libtool to AC_CONFIG_FILES
  • add shave.m4 either in acinclude.m4 or your macro directory
  • add a call to SHAVE_INIT just before AC_CONFIG_FILES/AC_OUTPUT. SHAVE_INIT takes one argument, the directory where shave and shave-libtool are.

Custom rules

Sometimes you have custom Makefile rules, e.g. to generate a small header, run glib-mkenums or glib-genmarshal. It would be nice to output a pretty 'GEN' line. That's quite easy actually, just add few (portable!) lines at the top of your
V         = @
Q         = $(V:1=)
QUIET_GEN = $(Q:@=@echo '  GEN   '$@;)
and then it's just a matter of prepending $(QUIET_GEN) to the rule creating the file:
lib-file2.h: Makefile
$(QUIET_GEN)echo "#define FOO_DEFINE 0xbabe" > lib-file2.h

gtk-doc + shave

gtk-doc + shave + libtool 1.x (2.x is fine) is known to have a small issue, a patch is available. Meanwhile I suggest adding a few lines to your script.
sed -e 's#) --mode=compile#) --tag=CC --mode=compile#' gtk-doc.make > gtk-doc.temp \
&& mv gtk-doc.temp gtk-doc.make
sed -e 's#) --mode=link#) --tag=CC --mode=link#' gtk-doc.make > gtk-doc.temp \
&& mv gtk-doc.temp gtk-doc.make

dolt + shave

It's possible to use dolt in conjunction with shave with a surprisingly small patch to dolt.

Real world example: Clutter

$ make
GEN   stamp-clutter-marshal.h
GEN   clutter-marshal.c
GEN   stamp-clutter-enum-types.h
Making all in cogl
Making all in common
CC    cogl-util.o
CC    cogl-bitmap.o
CC    cogl-bitmap-fallback.o
CC    cogl-primitives.o
CC    cogl-bitmap-pixbuf.o
CC    cogl-clip-stack.o
CC    cogl-fixed.o
CC    cogl-color.o
cogl-color.c: In function ‘cogl_set_source_color4ub’:
cogl-color.c:141: warning: implicit declaration of function ‘cogl_set_source_color’
CC    cogl-vertex-buffer.o
CC    cogl-matrix.o
CC    cogl-material.o

Eh! now we can see a warning there!


This is a first release, shave has not been widely tested aka it may not work for you!
  • test it with a wider range of automake/libtool versions
  • shave won't work without AC_CONFIG_HEADERS due to shell quoting problems
  • see what can be done for make install/dist (they are prettier thanks to make -s, but we probably miss a few actions)
  • there is a '-s' hardcoded in MAKEFLAGS,  I have to find a way to make it more flexible


  1. [...] to Damien, I finally found a way to shut up libtool and get a clean output for the build of a project: [...]

  2. Shame on you. You are setting people up for hours or days of misery when they cannot debug their automated builds.

  3. Unfortunately 'make clean' is not yet actually clean with this. (Oh irony!)

  4. Hmm the problem is this all doesn't really work on libtool 2.2.

  5. Also, it gets confused by libtool convenience libraries.

  6. And preloaded modules don't work either.

  7. You're doing it wrong, this should be added to automake itself so all projects benefit from it instead of just select ones using shave.

    Please make it dependent on a configuration variable in ~/.automake and default it to off.

    Automatic builds should always show all commands and info.

    BTW, you must have missed this:

    Please contact automake upstream about integrating this finally.

  8. I forgott to mention that when warnings/errors occur you *NEED* to output the command too.

  9. Hum, first I just want to say the script is 3 days old. DON'T expect it to work. I know people tend to skip this kind of warnings but I had to try:p Hopefully early adopters will report bugs (or fix them!).

    @Zack, foo: I think you have a point here. You *obviously* need a way to get a verbose build when you get errors and/or when packaging. Now please consider:
    * a workaround could be to export V=1 in your automated build environment; the hardcoded 'make -s' is neither portable nor a good solution, I'm fully aware of that.
    * a distributed package can just disable shave, that's up the to the maintainer,
    * the default behaviour could be set to verbose, and then --enable-shave given to configure would turn shave on.
    This still needs a bit of thinking though.

    @blah: I've tested it with libtool 2.2 and it worked for me (at least at some point), could you point me to the project you are trying to "shave"? (the fix to the unmangling regexp I just pushed could help)

    @foo: I agree with you, the real fix would be to patch automake. However patching automake on your system is just out of the question. You can't require people to patch their own autotools when they want to autoreconf your project. This has to be mainlined. The fact that pretty-am has been around for 2 years and a half tends to prove it's not as easy as it sounds.
    That said the clean/install/... targets have an hardcoded 'echo' and handling those cases requires to patch automake. I might try to revive pretty-am, that's not a promise!

    As a side note, I do know that this problem has been around for years, that people have spend countless hours discussing it and that shave won't solve the problem.

  10. zack's environment and use case is completely flawed (a weird build environment, with weird and proprietary tools).

    the obvious fact that everyone is trying to shut automake and libtool up is that the line noise 9 times out of 10 detracts from the ability to catch an error in the build and in the code. it's as simple as that. solutions to the problem, until the autotools maintainers start integrating stuff like this is using common tools that do not require patching the hell out of automake and/or libtool. once everyone is using the same additions to the build system, with the same ways to restore verbosity level when needed, then the autotools can ship with a centralized solution — possibly using the same syntax.

    that's why shave is a good idea: same syntax, everywhere, to turn on (or off) verbosity, until automake 1.12 is out and everyone has transitioned to it.

  11. I also think shave is a great idea! Thanks for working on this..

  12. Shave looks awesome. That too, gotten without forcing the end user to recompile their Automake. I do have a possilby stupid question (being the autotools n00b I am), how would I apply this to a gnome-autogen-ed project like Anjuta which doesn't have a (only a

  13. @Arun Chaganty is just the old name of, see this page of the autoconf manual.

  14. Works fine for me out of the box, with libtool 2.2.6.

    I even have a couple of custom build rules and it took me about 5 minutes to shut these bastards up too.

    I think this is brilliant. Thanks.

  15. Automake 1.11 has been release with "silent rules" support, a feature that
    supersedes the hack that shave is. If you can depend on automake 1.11 please
    consider using its silent rules rather than shave.

  16. I used shave for some time now and it worked well. It has a blocking issue with GObject introspection though: my build was failing because trying to execute "'/bin/sh", so I switched to silent-rules.

    Not a big deal... just to let you know it and thank you.