skribilo/doc/skr, branch lcourtes@laas.fr--2005-libre,skribilo--devo--1.2Document production tool written in Guile Scheme (unofficial mirror)http://git.systemreboot.net/skribilo/atom?h=lcourtes%40laas.fr--2005-libre%2Cskribilo--devo--1.22006-09-01T15:58:59+00:00Turned `doc/skr' into `doc/modules', `skribe-load' into `use-modules'.2006-09-01T15:58:59+00:00Ludovic Court`es2006-09-01T15:58:59+00:00urn:sha1:8e0448d1a0b2590453935e457d9f7de4a6d32502
git-archimport-id: lcourtes@laas.fr--2005-libre/skribilo--devo--1.2--patch-54
Added a GPL header to the documentation files (license confirmed by Manuel Serrano).2006-08-30T08:03:05+00:00Ludovic Court`es2006-08-30T08:03:05+00:00urn:sha1:bb3421760b02a83ec9ae019a690202f579d52f54
git-archimport-id: lcourtes@laas.fr--2005-libre/skribilo--devo--1.2--patch-50
Moved `skribe/api.scm' to `(skribilo package base)'.2006-07-28T13:06:05+00:00Ludovic Court`es2006-07-28T13:06:05+00:00urn:sha1:020b5f2af86a156dce4b4d4f6439e46760c68b62
* doc/skr/api.skr (doc-markup): Updated default value of SOURCE.
* doc/user/bib.skb (bib-sort/authors): Change value of SOURCE (should
have been done earlier!).
* doc/user/sectioning.skb (p): Likewise.
* src/guile/skribilo/evaluator.scm (%evaluate): Updated comment.
* src/guile/skribilo/module.scm (%skribilo-user-imports): Added
`(skribilo package base)'.
(%skribe-core-modules): Removed `api'.
* src/guile/skribilo/package/Makefile.am (dist_guilemodule_DATA): Added
`base.scm'.
* src/guile/skribilo/package/base.scm: No longer use
`define-skribe-module'. Use an appropriate `define-module' instead.
Fixed uses of `gensym' so that they pass a string instead of a symbol
or nothing. Similarly, use Guile's native hash table API instead of
the one in `compat'.
(include): Use `include-document' instead of `skribe-include'.
* src/guile/skribilo/package/eq.scm: Use `package base' instead of
`skribe api'.
* src/guile/skribilo/package/pie.scm: Likewise.
* src/guile/skribilo/skribe/Makefile.am (dist_guilemodule_DATA): Removed
`api.scm'.
* src/guile/skribilo/utils/compat.scm (date): Export it.
(correct-arity?): New.
git-archimport-id: lcourtes@laas.fr--2005-libre/skribilo--devo--1.2--patch-32
Various documentation fixes + completed the doc automake stuff.2006-03-19T20:08:40+00:00Ludovic Courtes2006-03-19T20:08:40+00:00urn:sha1:d43ab320c8c711aef6417d33a33d0b3d2058f690
* doc/user/Makefile.am (%.html): Added `-P ../img'.
(%.lout): Likewise.
(SUBDIRS): New.
* doc/user/char.skb (Some characters): Use the Lout-specific example for
`!' when relevant.
* doc/user/figure.skb (The figure markup): Avoid using `example-produce'.
* doc/user/slide.skb (dummy-slide-set-output): New.
(dummy-slide-output): New.
(dummy-slide-vspace-output): New.
(dummy-slide-embed-output): New.
(Example of Skribilo Slides): Use a processor, as in `document.skb', in
order to use the dummy output functions.
git-archimport-id: lcourtes@laas.fr--2005-mobile/skribilo--devel--1.2--patch-50
Various fixes in the documentation code.2006-03-01T17:25:24+00:00Ludovic Court`es2006-03-01T17:25:24+00:00urn:sha1:b09b035d86267aa363430f5ff8b5900b37c15ea8
* doc/skr/manual.skr: Fixed uses of `format'.
* doc/user/document.skb (dummy-document-output): Fixed handling of
non-list author.
* doc/user/src/api2.skb: Fixed the title. ;-)
* doc/user/src/bib1.sbib (bigloo): Added a year and author as expected by
`bib5.skb'.
* doc/user/user.skb (Introduction): Explicitly added `:file #f'.
git-archimport-id: lcourtes@laas.fr--2004-libre/skribilo--devel--1.2--patch-61
First time the user manual is compiled to HTML.2006-01-31T23:23:15+00:00Ludovic Courtes2006-01-31T23:23:15+00:00urn:sha1:09039355539a79187669b688ff6a03c8a74e2099
* doc/skr/api.skr (make-engine?): Fixed.
(make-engine-custom): Likewise.
* doc/skr/manual.skr (the-index): Don't pass `:&skribe-eval-location'.
* doc/user/emacs.skb: Fixed typo.
* doc/user/htmle.skb: Documented the `file-name-proc' custom.
* doc/user/package.skb: Fixed the `prgm' example there.
* doc/user/skribe-config.skb: Commented out the `OPTIONS' section.
* doc/user/skribec.skb: Likewise.
* doc/user/slide.skb: Don't refer to HTML-ENGINE, use `find-engine'
instead.
* doc/user/src/slides.skb: Don't pass `:slide' to `toc'.
* doc/user/toc.skb: Commented the `:subsubsection' argument.
* doc/user/user.skb (Index): Set `:indent' to "Index".
* src/guile/skribilo.scm (skribilo-options): Added `--image-path'.
(skribilo): Handle it.
* src/guile/skribilo/ast.scm (ast->file-location): Exported.
* src/guile/skribilo/engine/base.scm (the-index): Don't pass
`:&skribe-eval-location'.
* src/guile/skribilo/engine/html.scm: Export `html-width' and
`html-title-authors'.
* src/guile/skribilo/engine/lout.scm (lout-width): Don't use `flonum?'.
* src/guile/skribilo/evaluator.scm (load-document): Added
`:allow-other-keys' so that the optional parameters may contain
keywords, too.
* src/guile/skribilo/package/slide.scm: Use `(skribilo engine html)'.
* src/guile/skribilo/skribe/api.scm (toc): Added `subsubsection'.
git-archimport-id: lcourtes@laas.fr--2005-mobile/skribilo--devel--1.2--patch-31
More progress towards a working user manual.2006-01-25T22:57:34+00:00Ludovic Courtes2006-01-25T22:57:34+00:00urn:sha1:66e42310c0d6518abb39d52553286b5253bba6fd
* doc/skr/api.skr (define-markup?): Support `define*' and
`define*-public'.
* doc/user/bib.skb: Commented out problematic `skribebibtex'-related
things.
* doc/user/lib.skb (skribe-load): Replaced by `load-document'.
(skribe-load-options): Replaced by `*load-options*'.
(skribe-path): Replaced by `*document-path*'.
* src/guile/skribilo/coloring/lisp.scm (definition-search): Removed
debugging statement.
* src/guile/skribilo/engine.scm (find-engine): For documentation
purposes, explicitly list all keyword parameters.
* src/guile/skribilo/source.scm (source-read-lines): Start line numbers
from 0.
* src/guile/skribilo/utils/compat.scm (skribe-path-set!): New.
(skribe-image-path-set!): New.
(skribe-source-path-set!): New.
(skribe-bib-path-set!): New.
git-archimport-id: lcourtes@laas.fr--2005-mobile/skribilo--devel--1.2--patch-30
More fixes in the hope to get the manual compiled.2006-01-18T23:22:29+00:00Ludovic Courtes2006-01-18T23:22:29+00:00urn:sha1:8bdcb386f3ce26a9031ca123b4d43af0b5a3721a
* doc/skr/api.skr (define-markup?): Accept `define-public'.
(define-markup-options): Accept any kind of `define' symbol.
(define-markup-rest): Likewise.
* doc/user/bib.skb (bibliography): Use `src/bib1.sbib'.
(bib-table?): Provide a definition.
(default-bib-table): Likewise.
(make-bib-table): Likewise.
(bibliography): Fixed a `ref'.
(example): Fixed file name. This example does not work yet.
* doc/user/footnote.skb (footnote): Documented `label', removed
`number'.
* doc/user/table.skb (th): Documented `rowspan'.
* src/guile/skribilo.scm (skribilo-options): Added `-S'/`--source-path'.
Honor it.
* src/guile/skribilo/coloring/lisp.scm: Use `(ice-9 match)'. Rewrote all
the `match-case' code into corresponding `match' statements.
(definition-search): Fixed, using `source-property' and `port-line'.
Does not work yet due to a bug in guile-reader's source position
recording (shows 1 line earlier). Added a READ parameter.
* src/guile/skribilo/skribe/api.scm: Mark SYMBOL as replaced instead of
blindly overriding the core binding.
git-archimport-id: lcourtes@laas.fr--2005-mobile/skribilo--devel--1.2--patch-28
Towards a self-hosted user manual.2006-01-17T22:50:23+00:00Ludovic Courtes2006-01-17T22:50:23+00:00urn:sha1:46c709dc1f242fa680d4425da4dfc9314686e9cc
* doc/skr/api.skr: Use `(skribilo reader)' and `(skribilo utils syntax)'.
(api-search-definition): Added a SKRIBE-SOURCE? argument.
Determine the appropriate reader based on its value.
(keyword->symbol): Removed.
(define-markup?): Fixed.
(make-engine?): Fixed (but unverified).
(make-engine-custom): Likewise.
(sym/kw?): New.
(define-markup-formals): Fixed.
(define-markup-options): Likewise.
(define-markup-rest): Likewise.
(doc-markup): Added a SKRIBE-SOURCE? argument.
(doc-engine): Likewise.
* doc/user/*.skb: Updated the `:source' arguments to `doc-markup' and
`doc-engine'.
* src/guile/skribilo/utils/compat.scm (hashtable-update!): Fixed
according to the Bigloo manual.
git-archimport-id: lcourtes@laas.fr--2005-mobile/skribilo--devel--1.2--patch-26
More SRFI-3[45] enhancements; first stab at the user documentation.2006-01-16T22:31:32+00:00Ludovic Courtes2006-01-16T22:31:32+00:00urn:sha1:2d8fa88ef04b3a6141a2b03a9671a7dd0fcc1f60
* src/guile/skribilo/biblio.scm (skribe-open-bib-file): Raise a
`&file-search-error' when needed.
* src/guile/skribilo/runtime.scm (convert-image): Likewise.
* src/guile/skribilo/source.scm (source-read-lines): Likewise.
(source-read-definition): Likewise.
* src/guile/skribilo/utils/compat.scm (skribe-load): Only look up
`%skribe-known-files' when `load-document' failed.
(find-file/path): Use `search-path'.
(find-runtime-type): Implemented.
* doc/skr/api.skr: Use `(ice-9 match)'. Use `match' instead of
`match-case'.
(api-search-definition): Search in `%load-path' and `(skribe-path)'.
(define-markup?): First stab at getting the `match' syntax right.
* doc/user/src/start[3-5].skb: Small fixes.
git-archimport-id: lcourtes@laas.fr--2005-mobile/skribilo--devel--1.2--patch-25