guile

mirror of https://git.savannah.gnu.org/git/guile.git synced 2025-04-29 19:30:36 +02:00

History

Neil Jerram 53befeb700 Change Guile license to LGPLv3+ (Not quite finished, the following will be done tomorrow. module/srfi/.scm module/rnrs/.scm module/scripts/.scm testsuite/.scm guile-readline/* )		2009-06-17 00:22:09 +01:00
..
ChangeLog-2008	Rename `ChangeLog' files to` ChangeLog-2008'.	2008-09-12 21:49:58 +02:00
docstring.el	Change Guile license to LGPLv3+	2009-06-17 00:22:09 +01:00
guile.texi	Fix `explicitely' typos, should be` explicitly'	2009-05-20 18:51:03 +01:00
README	* docstring.el: optional 2nd environment variable to locate	2002-07-10 17:18:41 +00:00

README

README for guile-core/doc/maint                      -*- text -*-

The files in this directory are used by the maintainers to automate
the process of updating the Guile reference manual when the docstrings
in the libguile C source change.

- ChangeLog is the change log for files in this directory.

- README is this file.

- docstring.el is a helpful Emacs Lisp library (see source for
  customization).  The two key entry points are:
    `docstring-process-module' and
    `docstring-ediff-this-line'.

- guile.texi is a snapshot of the built file libguile/guile.texi,
  copied last time the reference manual was determined to be in sync
  with the libguile source.

docstring.el requires the setting of an environment variable, e.g.,

export GUILE_MAINTAINER_GUILE_CORE_DIR=$HOME/guile/guile-core

If the build directory differs from the source directory, an additional
variable is required:

export GUILE_MAINTAINER_BUILD_CORE_DIR=$HOME/guile/guile-core-build

If you've just fixed a docstring in, say, ../libguile/strop.c, do in emacs:

    M-x load-file RET .../doc/maint/docstring.el RET
    M-x docstring-process-module RET (guile) RET

Save all modified .texi files and copy the current ../libguile/guile.texi
to ./guile.texi, then commit.  See elisp var `docstring-snarfed-roots'.