aboutsummaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorArun Isaac2021-06-22 08:12:28 +0530
committerArun Isaac2021-06-22 08:12:28 +0530
commitf99a10235c437899448f2a2cd112e5d9a7c16464 (patch)
tree177f3c463a385996c5eefc5f72584ff69d7ad10a /doc
parentbf506794dc293c8f4e7e8aac6dcd31e95426ecb2 (diff)
downloadccwl-f99a10235c437899448f2a2cd112e5d9a7c16464.tar.gz
ccwl-f99a10235c437899448f2a2cd112e5d9a7c16464.tar.lz
ccwl-f99a10235c437899448f2a2cd112e5d9a7c16464.zip
doc: Fix comma position.
Lispy mode normalizes comma positions incorrectly for Skribilo mode. This needs to be fixed upstream or elsewhere. * doc/ccwl.skb (Tutorial)[Important concepts, Capturing the standard output stream of a command, Capturing output files, Workflow with multiple steps]: Fix comma position.
Diffstat (limited to 'doc')
-rw-r--r--doc/ccwl.skb24
1 files changed, 12 insertions, 12 deletions
diff --git a/doc/ccwl.skb b/doc/ccwl.skb
index 2ffd8f6..57baa94 100644
--- a/doc/ccwl.skb
+++ b/doc/ccwl.skb
@@ -28,19 +28,19 @@ are statically typed programming languages where functions accept
multiple named inputs and return multiple named outputs. Let 's break
down what that means.])
(subsection :title [Static typing]
- (p [In CWL ,the type of arguments accepted by a function and
+ (p [In CWL, the type of arguments accepted by a function and
the type of outputs returned by that function are specified explicitly
-by the programmer ,and are known at compile time even before the code
-has been run. Hence ,we say that it is statically typed.]))
+by the programmer, and are known at compile time even before the code
+has been run. Hence, we say that it is statically typed.]))
(subsection :title [Positional arguments and named arguments]
- (p [In many languages ,the order of arguments passed to a
+ (p [In many languages, the order of arguments passed to a
function is significant. The position of each argument determines
-which formal argument it gets mapped to. For example ,passing
+which formal argument it gets mapped to. For example, passing
positional arguments in Scheme looks like])
(prog :line #f [(foo 1 2)])
- (p [In a language that supports named arguments ,the order of
+ (p [In a language that supports named arguments, the order of
arguments is not significant. Each argument explicitly names the
-formal argument it gets mapped to. For example , in Scheme ,passing
+formal argument it gets mapped to. For example, in Scheme, passing
named arguments may look like]
(prog :line #f [(foo #:bar 1 #:baz 2)])))
(subsection :title [Multiple function arguments and return values]
@@ -89,7 +89,7 @@ as follows. The expected output is also shown.])
(section :title [Capturing the standard output stream of a command]
(p [Let us return to the “Hello World” example in the previous
-section. But now ,let us capture the standard output of the
+section. But now, let us capture the standard output of the
,(code "print") command in an output object. The ccwl code is the same
as earlier with only the addition of an ,(code "stdout") type output
object to the command definition.])
@@ -106,8 +106,8 @@ output of the ,(code "print") command has been captured in the file
(prog :line #f (source :file "doc/capture-stdout.out")))
(section :title [Capturing output files]
- (p [In the previous section ,we captured the standard output
-stream of a command. But ,how do we capture any output files created
+ (p [In the previous section, we captured the standard output
+stream of a command. But, how do we capture any output files created
by a command? Let us see.])
(p [Consider a tar archive ,(file "hello.tar") containing a file
@@ -153,9 +153,9 @@ section, let us write our first multi-step workflow and learn how to
connect steps together in an arbitrary topology.])
(subsection :title [pipe]
- (p [First ,the simplest of topologies---a linear chain
+ (p [First, the simplest of topologies---a linear chain
representing sequential execution of steps. The following workflow
-decompresses a compressed C source file ,compiles and then executes
+decompresses a compressed C source file, compiles and then executes
it.])
(scheme-source "doc/decompress-compile-run.scm")