summaryrefslogtreecommitdiff
path: root/doc/user/prgm.skb
diff options
context:
space:
mode:
authorLudovic Courtès2008-01-22 19:17:15 +0100
committerLudovic Courtès2008-01-22 19:17:15 +0100
commit1c48e83c54179144b82f8e1323101baf0c6b1a8d (patch)
tree94a5ceb3a8d140111890c0b1cf290b35184c86b9 /doc/user/prgm.skb
parentffd3ed37343917e87d27acb38a377686e866d741 (diff)
downloadskribilo-1c48e83c54179144b82f8e1323101baf0c6b1a8d.tar.gz
skribilo-1c48e83c54179144b82f8e1323101baf0c6b1a8d.tar.lz
skribilo-1c48e83c54179144b82f8e1323101baf0c6b1a8d.zip
doc: Document all the `*xxx-path*' parameters.
* 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.
Diffstat (limited to 'doc/user/prgm.skb')
-rw-r--r--doc/user/prgm.skb23
1 files changed, 19 insertions, 4 deletions
diff --git a/doc/user/prgm.skb b/doc/user/prgm.skb
index 1007268..95a69bf 100644
--- a/doc/user/prgm.skb
+++ b/doc/user/prgm.skb
@@ -1,5 +1,6 @@
;;; prgm.skb -- Computer programs
;;;
+;;; Copyright 2008 Ludovic Courtès <ludo@gnu.org>
;;; Copyright 2001, 2002, 2003, 2004 Manuel Serrano
;;;
;;;
@@ -74,7 +75,7 @@ program. It may automatically introduce line numbers.])
;*---------------------------------------------------------------------*/
;* Source code ... @label source@ */
;*---------------------------------------------------------------------*/
-(section :title "Source code"
+(section :title "Source Code"
(p [The ,(code "source") function extracts part of the source code and
enables ,(emph "fontification"). That is, some words of the program
@@ -84,19 +85,28 @@ can be rendered using different colors or faces.])
(doc-markup 'source
`((:language ,[The ,(markup-ref "language") of the source code.])
(:file ,[The file containing the actual source code. The file
- is searched in the ,(markup-ref "skribe-source-path") path.])
+ is searched in the ,(markup-ref "*source-path*") path.])
(:start [A start line number or a start marker.])
(:stop [A stop line number or a stop marker.])
(:definition [The identifier of the definition to extract.])
(:tab [The tabulation width.]))
:common-args '()
:force-engines *api-engines*
- :see-also '(prog language ref skribe-source-path))
+ :see-also '(prog language ref *source-path*))
;!source-stop
(example-produce
(example :legend "The source markup" (prgm :file "src/prgm2.skb"))
- (disp (include "src/prgm2.skb"))))
+ (disp (include "src/prgm2.skb")))
+
+(mark "*source-path*")
+(p [Files passed as the ,(tt [:file]) argument of ,(markup-ref "source")
+are searched in the current ,(emph [source path]), which is defined by the
+,(tt [*source-path*]) ,(srfi-ref 39) parameter. This parameter contains
+a list of directories and its value can be obtained using ,(code
+[(*source-path*)]). Its value can be altered using the ,(tt [-S])
+command-line option of the ,(tt [skribilo]) compiler (see ,(numref :text
+[Chapter] :ident "compiler") for details).]))
;*---------------------------------------------------------------------*/
;* Language ... @label language@ */
@@ -128,3 +138,8 @@ in ,(markup-ref "source") function call.])
(disp (include "src/prgm3.skb"))))
(else
'()))))
+
+;;; Local Variables:
+;;; coding: latin-1
+;;; ispell-local-dictionary: "american"
+;;; End: