[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: [PATCH] DOC: Elaborate on the description and nature of scripts.
From: |
Jose E. Marchesi |
Subject: |
Re: [PATCH] DOC: Elaborate on the description and nature of scripts. |
Date: |
Wed, 11 Dec 2019 14:31:06 +0100 |
User-agent: |
Gnus/5.13 (Gnus v5.13) Emacs/26.1 (gnu/linux) |
Hi John.
+# The following line is a Poke expression without any side effect.
+# Consequently it is valid, but rather useless.
+4 == 4;
Actually the example above is a statement ("expression statement") not
an expression. IMO it would be better to have it written as:
4 == 4
without the trailing ;.
+@end example
+
+A script file contains commands, not Poke code. This means
+it gets read line by line and commands cannot occupy
+more than one line. Hence the following is a valid script:
+
+@example
+deftype struct = @{int this; int that;@};
+@end example
I would avoid including the trailing ; above as well.
Other than that, this looks great for master.
Thanks! :)