aboutsummaryrefslogtreecommitdiff
path: root/doc
AgeCommit message (Collapse)Author
2008-01-30doc: Improve engine introduction.Ludovic Courtès
2008-01-30doc: Add nice rendering of `doc-engine' in Lout.Ludovic Courtès
* doc/modules/skribilo/documentation/api.scm (doc-engine): New `lout' writer. (doc-engine): Check for Lout.
2008-01-29doc: Tiny improvements of the `manual' module.Ludovic Courtès
* doc/modules/skribilo/documentation/manual.scm (disp): Use `resolve' and test that engine, rather than raw `(engine-format? "xxx")'. (compiler-options): Issue a warning if an option is not documented.
2008-01-29doc: Add section about "documents in Scheme programs".Ludovic Courtès
* doc/user/Makefile.am (EXTRA_DIST): Add `src/scheme.scm'. * doc/user/syntax.skb (Documents in Scheme Programs): New.
2008-01-29doc: Document the `outline' reader.Ludovic Courtès
* doc/user/Makefile.am (EXTRA_DIST): Add `src/outline.txt' and `loute.skb'. * doc/user/compiler.skb: Add ref to `outline-syntax'. * doc/user/syntax.skb: Re-structure, add `outline-syntax' section. * doc/user/user.skb: Use `(skribilo reader)' and `(ice-9 pretty-print)'.
2008-01-29CSS: Force `pre' to the left.Ludovic Courtès
2008-01-29doc: Tiny bibliography-related fixes.Ludovic Courtès
2008-01-28doc: Improve rendering of `prgm' and `disp' in Lout.Ludovic Courtès
* doc/modules/skribilo/documentation/manual.scm (prgm): Specialize Lout output. (disp): Likewise.
2008-01-28doc: Provide nicer `doc-markup' output for `lout'.Ludovic Courtès
* doc/modules/skribilo/documentation/api.scm: New lout customization. (punctuate): New. (doc-markup)[doc-markup.lout]: New. Use it.
2008-01-25doc: Document the Lout engine.Ludovic Courtès
* doc/modules/skribilo/documentation/env.scm (*api-engines*): Add `lout'. * doc/user/engine.skb: Include `loute.skb'. * doc/user/slide.skb (Slide Package): Add `:ident'.
2008-01-24doc: Document the "compiler".Ludovic Courtès
* doc/modules/skribilo/documentation/manual.scm (compiler-options): Rewritten to suit our needs. * doc/user/Makefile.am (EXTRA_DIST): `skribec.skb' renamed to `compiler.skb'. * doc/user/bib.skb: Fix xref. * doc/user/lib.skb: Likewise. * doc/user/links.skb: Likewise. * doc/user/syntax.skb: Add `:ident'.
2008-01-23doc: Update `slide' package documentation.Ludovic Courtès
2008-01-23doc: Update & improve engine documentation.Ludovic Courtès
* doc/user/engine.skb (Engines): Rewrote intro, fixed `resolve'. (Functions dealing with engines): Renamed to... (Manipulating Engines): New. [Writing New Engines]: New. * doc/user/{htmle,xmle,latexe}.skb: Add intro.
2008-01-22doc: Tiny CSS fix.Ludovic Courtès
2008-01-22doc: Document all the `*xxx-path*' parameters.Ludovic Courtès
* doc/modules/skribilo/documentation/manual.scm (srfi-ref): New. * doc/user/bib.skb: Add `*bib-path*'. * doc/user/image.skb: Add `*image-path*'. * doc/user/lib.skb: Mention `-I' command-line option for `*document-path*'. * doc/user/prgm.skb: Add `*source-path*'. * doc/user/skribec.skb: Add `:ident' for chapter.
2008-01-22doc: Remove need to `doc-config.scm'.Ludovic Courtès
* doc/user/Makefile.am (BUILT_SOURCES): Remove. (skrflags): Define `%have-ploticus?' and `%ploticus-path' using `-e'. (doc-config.scm): Remove. * doc/user/user.skb: Don't load `doc-config.scm'.
2008-01-22doc: Use CSS style sheet in HTML output.Ludovic Courtès
* doc/modules/skribilo/documentation/manual.scm: Set `css' custom of the HTML engine. Explicitly initialize the `chapter-file', etc., customs. * doc/user/Makefile.am (dist_html_DATA): New. * doc/user/skribilo.css: New file.
2008-01-21doc: Use `web-book2' instead of `web-book'.Ludovic Courtès
2008-01-21doc: Fix typos in the HTML engine section.Ludovic Courtès
2008-01-19Document `web-book2'.Ludovic Courtès
* doc/user/package.skb (Web)[web-book]: Improve documentation. [web-book2]: New.
2008-01-04doc: Update "Standard Packages" section.Ludovic Courtès
* TODO: Add new item. * doc/user/package.skb (Standard Packages): Remove references to `skribe-load', mention `use-modules'. [Web](web-article): Commented out since it sucks. * src/guile/skribilo/package/web-article.scm: Add FIXMEs.
2007-12-14doc: Update "Standard Library" and chapter about `skribilo-config'.Ludovic Courtès
* doc/user/Makefile.am (EXTRA_DIST): Rename `skribe-config.skb' to `skribilo-config.skb'. (skrflags): Add `-e' flags defining `%top-srcdir' and `%top-builddir'. * doc/user/lib.skb: Update stuff, removing references to `skribe-*' functions. Remove doc for `load-document' and `skribe-configure', both of which have become essentially useless. * doc/user/skribilo-config.skb: Updated. Actually run `skribilo-config' and get options from there. * doc/user/user.skb: Use `(ice-9 popen)' and `(ice-9 rdelim)'. Update includes.
2007-12-14Correctly install/uninstall/clean documentation.Ludovic Courtès
* doc/user/Makefile.am (install-data-hook, uninstall-local, clean-local): New. This makes `distcheck' happy and installs all the documentation files.
2007-12-14Fix documentation build glitches.Ludovic Courtès
* doc/user/Makefile.am (EXTRA_DIST): Add `spacing.skb' and `src/bib1.sbib'. (skrflags): Fix include paths. (load_path): Shrink.
2007-12-11Overhaul `(skribilo)' using SRFI-37.Ludovic Courtès
* README: Update dependency description. * configure.ac: Check for SRFI-37. * doc/user/Makefile.am (skrflags): Add the relevant `-S' flag, now that `%load-path' is no longer part of `*source-path*' by default. (.skb.html, .skb.lout): Add an `=' sign after `--target'. * src/guile/skribilo.scm: Overhauled. Use SRFI-37 for command-line argument parsing. Remove legacy (unused) code.
2007-12-11doc/lout: Use the Van de Graaf canon for page construction.Ludovic Courtès
* doc/user/lout/book-style.lout (@*Margin): Adjust.
2007-12-11Improve `(skribilo config)'.Ludovic Courtès
* configure.ac: Don't generate `src/guile/skribilo/config.scm'; don't substitute `SKRIBILO_DOC_DIR', `SKRIBILO_EXT_DIR' and `SKRIBILO_SKR_PATH'. * doc/modules/skribilo/documentation/env.scm (*courtes-mail*): Update. (*skribe-user-doc-url*, *skribe-dir-doc-url*): Update. * src/guile/skribilo/Makefile.am (CLEANFILES, .in): New. Include `substitute.am'. * src/guile/skribilo/config.scm.in: Overhauled. * src/guile/skribilo/engine/context.scm: Use `skribilo-version' instead of `skribilo-release'. * src/guile/skribilo/engine/lout.scm: Likewise. * src/guile/skribilo/utils/compat.scm: Use `(skribilo config)'. (skribe-release, skribe-url, skribe-doc-dir, skribe-ext-dir, skribe-default-path, skribe-scheme): New.
2007-12-01Make "distcheck" happy.Ludovic Courtès
* Makefile.am (EXTRA_DIST): Remove `config.rpath'. * doc/user/Makefile.am (CLEANFILES): New. * src/Makefile.am (EXTRA_DIST): Add `pre-inst-skribilo.in'. (CLEANFILES): Likewise.
2007-12-01Remove `doc/user/src/Makefile.am'.Ludovic Courtès
2007-12-01doc: Fix rendering of keywords.Ludovic Courtès
* doc/modules/skribilo/documentation/manual.scm (write <keyword>): New method.
2007-12-01doc: Remove broken `section' example.Ludovic Courtès
* doc/user/sectioning.skb (Sections): Remove broken example. It produced a real section, which confused Lout.
2007-12-01doc: Improve "Getting Started" and "Introduction".Ludovic Courtès
* doc/user/{start,user}.skb: Slightly improve stuff. Use paragraphs.
2007-12-01doc: Slightly improve Lout rendering of `prgm'.Ludovic Courtès
* doc/modules/skribilo/documentation/manual.scm (prgm): Better Lout output.
2007-12-01doc: Improve `.gitignore'.Ludovic Courtès
2007-12-01doc: Improved rendering of `example' in Lout.Ludovic Courtès
* doc/modules/skribilo/documentation/manual.scm: Add `lout' writer for `example'. (example-produce): Remove `(it "Example:")'.
2007-12-01doc: Use native API in `(skribilo documentation manual)'.Ludovic Courtès
* doc/modules/skribilo/documentation/manual.scm: Switch to native API.
2007-12-01doc: Makefile...Ludovic Courtès
* doc/user/Makefile.am (config.scm): Remove leading `-'.
2007-12-01doc: Add support for `ps2pdf'.Ludovic Courtès
* configure.ac: Look for `ps2pdf'. * doc/user/Makefile.am (pdf_DATA): New. (.ps.pdf): New rule.
2007-12-01Don't use GNU Make specific idioms.Ludovic Courtès
* doc/user/Makefile.am: Use old-fashioned ".input.output" targets.
2007-12-01doc: Improve building using the Lout engine, with a `book' style.Ludovic Courtès
* doc/modules/skribilo/documentation/api.scm (doc-engine): Use `ctrtable' instead of `table'. * doc/modules/skribilo/documentation/manual.scm: Add customs for the `lout' engine. (ctrtable): New. (prgm): Don't center frames in Lout. * doc/user/Makefile.am (EXTRA_DIST): Add `lout/book-style.lout'. (%.ps): Add "-r4 -I$(srcdir)/lout". * doc/user/char.skb: Use `ctrtable' instead of `(center (table...' for the list of chars. * doc/user/markup.skb: Add emacsology. * doc/user/package.skb: Don't show the sample code with non-HTML engines. * doc/user/src/html-navtabs.skb: Fix typo. * doc/user/user.skb: Don't produce out-of-chapter text in Lout.
2007-11-28Update `.gitignore'.Ludovic Courtès
2007-11-28Add run-time module with fewer bindings; add `--compat' command-line option.Ludovic Courtès
* doc/user/Makefile.am (skrflags): New. Use `--compat=skribe' for now. * src/guile/Makefile.am (moduledir): New. (dist_guilemodule_DATA): Renamed to... (dist_module_DATA): This, for consistency. * src/guile/skribilo.scm (skribilo-options): Add `--compat'. (doskribe): New COMPAT argument. (skribilo): Honor `--compat'. * src/guile/skribilo/module.scm (%skribilo-user-imports): New. (make-run-time-module): Renamed to `make-skribe-user-module'. (make-skribilo-user-module): New. (make-user-module, user-module-flavor): New. (*skribilo-user-module*): Default to a `skribilo' module flavor. * src/guile/skribilo/package/diff.scm (make-diff-document-from-files): Use "(make-user-module 'skribilo)".
2007-11-28Use modules from the source dir when building the doc.Ludovic Courtès
* doc/user/Makefile.am (skribilo): Use `pre-inst-skribilo'. * src/Makefile.am (noinst_SCRIPTS): New. (substitute): Substitute `abs_top_srcdir' and `abs_top_builddir'. * src/pre-inst-skribilo.in: New.
2007-11-15slide: Add `:unfold?' option to `slide-topic'.Ludovic Courtès
* doc/user/slide.skb: Update. * src/guile/skribilo/package/slide.scm (slide-topic, slide-subtopic)[:unfold?]: New argument. * src/guile/skribilo/package/slide/base.scm (make-outline-slide): Honor `:unfold?'. (slide-topic, slide-subtopic): Mark `:unfold?' as supported.
2007-08-29doc: Improved bibliography doc, documented `noabbrev'.Ludovic Court`es
* doc/user/bib.skb (Bibliography): Better explain the constraints with `name+year'. Document `noabbrev'. (Sorting Bibliography Entries): Document `bib-sort/first-author-last-name'. * doc/user/src/bib1.sbib: Use proper `author' fields, including `noabbrev'. git-archimport-id: lcourtes@laas.fr--2006-libre/skribilo--devo--1.2--patch-99
2007-08-20Merge from skribilo@sv.gnu.org--2006Ludovic Court`es
Patches applied: * lcourtes@laas.fr--2005-mobile/skribilo--devel--1.2 (patch 122-127) * skribilo@sv.gnu.org--2006/skribilo--devo--1.2 (patch 138-143) - sui: Small autoload fix. - `outline' reader: Fixed `append-trees'. - Added `html-navtabs' by Manuel Serrano. - html-navtabs: Permit disabling of CSS output. - Allow arbitrary keyword arguments in `define-markup'. - Documented `html-navtabs'. git-archimport-id: lcourtes@laas.fr--2006-libre/skribilo--devo--1.2--patch-88
2007-08-20doc: Updated documentation of `:number' for sections.Ludovic Court`es
* doc/user/sectioning.skb (Chapter): Mention new behavior with non-boolean `:number'. (Sections): Likewise. git-archimport-id: lcourtes@laas.fr--2006-libre/skribilo--devo--1.2--patch-87
2007-07-29Documented `html-navtabs'.Ludovic Courtes
* doc/user/package.skb (HTML Navigation Tabs): New subsection. Borrowed from Manuel Serrano's doc for `html-navtabs'. git-archimport-id: skribilo@sv.gnu.org--2006/skribilo--devo--1.2--patch-143
2007-07-04Linted documentation modules.Ludovic Courtes
* doc/modules/skribilo/documentation/*.scm: Use the `%skribilo-module-reader' and corresponding syntax, no longer use `compat'. git-archimport-id: skribilo@sv.gnu.org--2006/skribilo--devo--1.2--patch-137
2007-07-04Renamed the `coloring' module tree to `source' for consistency.Ludovic Courtes
git-archimport-id: skribilo@sv.gnu.org--2006/skribilo--devo--1.2--patch-134