1
Fork 0
mirror of https://git.savannah.gnu.org/git/guile.git synced 2025-05-07 08:20:15 +02:00
Commit graph

39 commits

Author SHA1 Message Date
Neil Jerram
0a864beb31 Improvements to Introduction chapter
* doc/ref/intro.texi (Introduction): Change "some" to "the".
  (Guile and Scheme): "multithreading" -> "multithreaded".
  (Combining with C): Mention "libguile" as library name.
  (Guile and the GNU Project): New text.
  (Interactive Programming): New text.
  (Supporting Multiple Languages): New text, reflecting currently
  supported languages.
  (Obtaining and Installing Guile): Use @var for version placeholder.
  Remove mention of separate tutorial.
2010-04-11 01:25:12 +01:00
Neil Jerram
26b9f90900 Merge branch 'master' into wip-manual-2
Conflicts:

	doc/ref/api-procedures.texi
	doc/ref/misc-modules.texi

(Caused by me removing `@page' from a couple of sections that have been modified
by others.)
2010-04-10 13:32:42 +01:00
Andy Wingo
1ea8aa7d8e Update manual examples of how to link with Guile
* doc/ref/intro.texi (Linking Guile into Programs):
* doc/ref/libguile-linking.texi (A Sample Guile Main Program): Update
  examples of how to link with guile.
2010-03-22 22:13:35 +01:00
Neil Jerram
3ce5e1304b Placeholders for expected remaining Intro sections
* doc/ref/intro.texi (Introduction): Add menu entries and sections for
  `Guile and the GNU Project', `Interactive Programming' and
  `Supporting Multiple Languages'.
2009-12-21 01:09:43 +00:00
Neil Jerram
c6c8e7e06d More intro text on combining with C code
* doc/ref/intro.texi (Combining with C): New paragraph.
2009-12-21 01:02:56 +00:00
Neil Jerram
84d86e7453 Typo and formatting
* doc/ref/intro.texi (Introduction): "onScheme" -> "on Scheme".  Add
  blank lines around @itemize block - looks better in Info.
2009-12-19 23:49:23 +00:00
Neil Jerram
ebb6158f23 More about Guile's relationship to Scheme standards
Also continue adding a bit more structure to the introductory "what is
Guile" material.

* doc/ref/intro.texi (Introduction): Split `What is Guile?' (which is
  a bad heading, since we've already answered that...) into `Guile and
  Scheme' and `Combining with C'.  Further splits will follow, to
  cover the other toplevel bullet points.

  (Guile and Scheme): Remove `packaged for use in a wide variety of
  environments', as I don't see what this can mean to the reader at
  this point.  Add text about R6RS and SRFIs.
2009-12-19 23:32:22 +00:00
Neil Jerram
95c2df5c60 Format `Revised^n' more nicely in TeX
* doc/ref/intro.texi (Introduction): Format Revised^n differently for
  TeX.
2009-12-19 23:26:29 +00:00
Neil Jerram
3d9af0c966 New introductory text about Guile
* doc/ref/guile.texi (Top): Rename `Introduction to Guile' as just
  `Introduction'.

* doc/ref/intro.texi: Add new introductory text.  [Not yet complete]

* doc/ref/preface.texi (Preface): Update for chapter renaming.
2009-12-19 01:31:03 +00:00
Neil Jerram
65de749477 Move Conventions section to after `Reporting Bugs'
(Reporting Bugs fits better immediately after the tour of how to use
Guile)

* doc/ref/intro.texi: Move `Manual Conventions' to after `Reporting
  Bugs', and rename to `Typographical Conventions'.
2009-12-19 01:28:27 +00:00
Neil Jerram
029fa8965d Move "Discouraged and Deprecated" from Introduction to API chapter
* doc/ref/intro.texi (Discouraged and Deprecated): Move from here...

* doc/ref/api-discdepr.texi: ...to new file here.

* doc/ref/guile.texi: Include api-discdepr.texi, and include
 `Discouraged and Deprecated' in API chapter menu.

* doc/ref/Makefile.am (guile_TEXINFOS): Add api-discdepr.texi.
2009-12-19 01:20:33 +00:00
Neil Jerram
064f84ae56 Streamline the manual's Preface material
(The principle here is that Preface should only contain
meta-information about the manual, such as how to use it and who wrote
it; plus any political points that we want to draw attention to.)

* doc/ref/preface.texi (Preface): Make unnumbered, for consistency
  with other GNU manuals (e.g. Emacs, GSL).  Merge layout text into
  top level.  Simplify first sentence.  Move section on conventions
  away...

* doc/ref/intro.texi (Introduction to Guile): ...to here.
2009-12-19 00:06:42 +00:00
Brian Gough
d746e18ef5 use correct url to ftp.gnu.org 2009-12-17 23:17:41 +00:00
Neil Jerram
45867c2ace Fix overfull hboxes 2009-08-04 12:10:16 +01:00
Neil Jerram
31c73458db Miscellaneous small updates
- Typos
- Minor changes to texinfo markup
- Minor wording changes
2009-08-03 11:27:51 +01:00
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
Neil Jerram
9dfa64ca7f Revert "(Reporting Bugs): Note need for subscription to"
This reverts commit e563095988, which is
appropriate because subscription is not now required for someone to
send a message to bug-guile@gnu.org.

Conflicts:
2008-12-10 19:02:50 +00:00
Neil Jerram
e563095988 (Reporting Bugs): Note need for subscription to
bug-guile@gnu.org.
2006-11-17 15:52:23 +00:00
Kevin Ryde
23f2b9a3de merge from 1.8 branch 2006-06-17 23:15:59 +00:00
Kevin Ryde
1b09b607dd merge from 1.8 branch 2006-04-16 23:18:55 +00:00
Kevin Ryde
5f30c653d9 pxref libtool manual. 2006-02-03 23:59:59 +00:00
Marius Vollmer
5aa76027f5 Typos and a small addition. 2004-08-03 14:54:17 +00:00
Marius Vollmer
235da338fa * api-deprecated.texi: Removed.
* intro.texi (Discouraged and Deprecated): General information
about deprecation, etc.
2004-08-02 15:15:31 +00:00
Marius Vollmer
3229f68b5a Big reorganization of the whole manual to give it a simpler structure. 2004-04-21 14:33:05 +00:00
Marius Vollmer
2da09c3fde Added Copyright notice. 2004-01-21 22:40:39 +00:00
Marius Vollmer
01b30204b5 (What is Guile?): Add @acronym for POSIX, R5RS, GUI,
and HTTP.  Conclude linking libguile.
2003-11-19 18:12:11 +00:00
Marius Vollmer
cc772cf8ef (Whirlwind Tour): Added pointer to examples directory. 2002-10-14 21:47:40 +00:00
Marius Vollmer
6e63303d39 Updated GNu ftp server name. Use "-lguile" instead of "libguile.a".
Some small fixes/improvements.
2002-09-09 21:32:29 +00:00
Marius Vollmer
4310df3688 Added (use-modules (ice-9 rdelim)) to an example that uses read-line.
Thanks to Ralf Mattes!
2002-08-05 18:52:27 +00:00
Neil Jerram
801892e788 Various manual updates, including syncing with stable branch. 2002-03-27 21:55:31 +00:00
Neil Jerram
c16da59f61 Manual updates. 2002-03-16 13:51:03 +00:00
Thien-Thi Nguyen
85a9b4ed19 Spell check. 2002-01-08 08:29:00 +00:00
Neil Jerram
4902ea64db * Fix doc typo. 2002-01-07 20:48:02 +00:00
Thien-Thi Nguyen
7bb16613f4 Spell check. 2002-01-06 07:45:06 +00:00
Neil Jerram
a7a7bb95eb * Various small manual improvements. 2001-12-07 17:08:19 +00:00
Neil Jerram
8f85c0c6c3 * Adding C function declarations from the SCM interface to the
reference manual documentation.
2001-11-16 15:04:17 +00:00
Neil Jerram
9401323e63 * Documentation work. 2001-11-11 15:01:52 +00:00
Neil Jerram
b45898cae3 * Fix doc snapshot build problems by avoiding use of ../AUTHORS file.
* Use TEXINFO_TEX to avoid shipping multiple copies of texinfo.tex.
2001-08-27 21:25:44 +00:00
Neil Jerram
a0e07ba4ec * Organize documentation into per-manual directories (halfway point commit). 2001-08-24 09:40:29 +00:00
Renamed from doc/intro.texi (Browse further)