diff --git a/doc/ChangeLog b/doc/ChangeLog index 180b948ef..6b36ebf49 100644 --- a/doc/ChangeLog +++ b/doc/ChangeLog @@ -1,5 +1,9 @@ 2001-02-15 Neil Jerram + * README: Explain retirement of `data-rep.texi'. + + * Makefile.am (info_TEXINFOS, data_rep_TEXINFOS): Removed. + * data-rep.texi: Replace this copy of data-rep.texi with a notice indicating that it has been retired. The master copy of data-rep.texi is at guile-doc/ref/data-rep.texi. diff --git a/doc/Makefile.am b/doc/Makefile.am index e98fae083..aecb266f2 100644 --- a/doc/Makefile.am +++ b/doc/Makefile.am @@ -18,8 +18,6 @@ ## License along with GUILE; see the file COPYING. If not, write ## to the Free Software Foundation, Inc., 59 Temple Place, Suite ## 330, Boston, MA 02111-1307 USA -info_TEXINFOS = data-rep.texi -data_rep_TEXINFOS = data-rep.texi version.texi # This rule overrides automake's rule for version.texi. It causes # version.texi to be created even in non-maintainer-mode. diff --git a/doc/README b/doc/README index 141b29876..47f120c4e 100644 --- a/doc/README +++ b/doc/README @@ -1,15 +1,18 @@ This directory contains documentation on the Guile core. At the moment, we don't have a full manual on Guile; that's at the -head of our task list. - -The file `data-rep.texi' is an essay on how to write C code that uses -Guile values. If you're interested in writing a application which is -extensible via Guile, this is a good place to start. Make builds the -`info' manual by default, designed to be read on-line; if you want to -print it out, go to the `doc' subdirectory of the tree you're building -in, and run `make data-rep.ps'. +head of our task list. You can see a snapshot of the new Guile +reference manual by checking out the `guile-doc' CVS module. The file `oldfmt.c' contains a function which can be used by application writers to support both old-style and new-style error format strings. + +The file `data-rep.texi', which used to be in this directory, is now +integrated into the Guile reference manual: the integrated version of +this essay is the `Data Representation' chapter. (This chapter is an +essay on how to write C code that uses Guile values. If you're +interested in writing a application which is extensible via Guile, +this is a good place to start.) To update the Texinfo source for this +essay - for example, when the smob interface changes - please update +the file `guile-doc/ref/data-rep.texi' in the guile-doc module.