guix.git/doc.am, branch master

build: Move 'Makefile' fragments to subdirectories.

2016-04-21T16:47:50Z

This follows a convention used by some other GNU packages like Autoconf, Bison, Coreutils, and Gnulib. * doc.am: Rename to ... * doc/local.mk: ... this. * emacs.am: Rename to ... * emacs/local.mk: ... this. * gnu-system.am: Rename to ... * gnu/local.mk: ... this. * daemon.am: Rename to ... * nix/local.mk: ... this. * Makefile.am: Adapt to them. * doc/guix.texi (Porting to a New Platform): Adapt documentation. * guix/config.scm.in (%state-directory, %config-directory): Adapt comments. * emacs/guix-config.el.in (guix-config-state-directory): Likewise.

doc: Add "lightweight desktop" OS config example.

2016-03-22T23:23:12Z

* gnu/system/examples/desktop.tmpl (packages): Remove XFCE and RATPOISON. (services): Add 'gnome-desktop-service' and 'xfce-desktop-service'. * gnu/system/examples/lightweight-desktop.tmpl: New file. * Makefile.am (EXAMPLES): Add it. * doc.am (OS_CONFIG_EXAMPLES_TEXI): Add doc/os-config-lightweight-desktop.texi. * gnu/system/install.scm (/etc/configuration-files)[directory]: Add lightweight-desktop.tmpl.

build: Rewrite comments for man pages.

2016-03-20T22:47:59Z

* doc.am : Rewrite comments to describe the build process and the meaning of the noticeable idiosyncrasies in a more general way.

build: Build man pages in $(srcdir).

2016-03-20T22:47:59Z

Before that the doc/guix.1 rule was always triggered when doing a VPATH build from a tarball. * doc.am (sub_commands_mans, dist_man1_MANS): man pages are now generated in $(srcdir) like the info manual. (doc/guix.1, doc/guix-%.1): Prepend $(srcdir) to target name. [BUILD_DAEMON] (doc/guix-daemon.1): Likewise.

build: Make 'guix' man page depend on scripts/guix.in.

2016-03-20T22:47:59Z

* doc.am (doc/guix.1): Add scripts/guix.in prerequisite.

Revert "build: Do not remake doc/guix.1."

2016-03-20T22:47:59Z

This reverts commit 97966e6d65bd3d450f12c7bb41af5f9eafd35a60.

build: Do not remake doc/guix.1.

2016-03-16T23:32:25Z

* doc.am (doc/guix.1): Do not depend on $(sub_commands_mans) which will always appear out-of-date.

doc: Add Texinfo HTML cross-reference file.

2016-02-21T21:28:20Z

Fixes . * doc/htmlxref.cnf: New file. * doc.am (EXTRA_DIST): Add it.

build: Use the right section and source for man pages.

2016-02-01T07:59:13Z

* doc.am (HELP2MANFLAGS): New variable. (gen_man): Use it.

build: Generate man pages after compiling Guile objects.

2016-01-29T22:45:34Z

This reduces compilation time since scripts are not compiled twice. When building with 'make -j4' from a clean repository on an Intel i5-2540M, compilation time gets from: real 4m48.708s user 17m29.892s sys 0m9.596s down to: real 2m23.399s user 6m48.604s sys 0m6.420s * doc.am (subcommand-manual-target): Delete function. (SUBCOMMANDS): Delete variable. (sub_command_mans, gen_man): New variables. (dist_man1_MANS): Add $(sub_commands_mans). (doc/guix-%.1): New target for sub-commands man pages. It ensures that man pages are built only after compiling Guile objects. (doc/guix-daemon.1): Use $(gen_man). Build only if BUILD_DAEMON. (doc/guix.1): Use $(gen_man). Add $(sub_command_mans) prerequisite. Co-authored-by: Mathieu Lirzin