jspdf-dynamo 1.0.4 → 1.0.6

package/dist/index.js

@@ -46,19 +46,19 @@ var AppLogger = class {
       this._logger = console;
     }
   }
-  trace(message, ...args) {
+  trace(message, args) {
     this.canLog(0) ? this._logger.trace(message, args) : null;
   }
-  debug(message, ...args) {
+  debug(message, args) {
     this.canLog(1) ? this._logger.debug(message, args) : null;
   }
-  info(message, ...args) {
+  info(message, args) {
     this.canLog(2) ? this._logger.info(message, args) : null;
   }
-  warn(message, ...args) {
+  warn(message, args) {
     this.canLog(3) ? this._logger.warn(message, args) : null;
   }
-  error(message, ...args) {
+  error(message, args) {
     this.canLog(4) ? this._logger.error(message, args) : null;
   }
   logLevel(newLevel) {
@@ -235,6 +235,8 @@ function isValidFontStyle(fontStyle) {
 // src/models/jsPdfOptions.ts
 var JsPdfOptions = class {
   constructor(options = {}) {
+    this.compress = true;
+    this.putOnlyUsedFonts = true;
     var _a, _b, _c;
     this.pageSize = ((_a = options.pageSize) == null ? void 0 : _a.toLocaleLowerCase()) || "a4";
     this.orientation = ((_b = options.orientation) == null ? void 0 : _b.toLocaleLowerCase()) || "portrait";
@@ -314,15 +316,37 @@ var JsPdfProcessor = class {
     this.pageOrientation = optn.orientation;
     this.currentUom = optn.unit;
     this._pdfDocument.setLineHeightFactor(1);
+    const now = /* @__PURE__ */ new Date();
     this._variables.set(
       "_TIMEHM",
-      (/* @__PURE__ */ new Date()).toLocaleTimeString("en-US", {
+      now.toLocaleTimeString(void 0, {
         hour12: false,
         hour: "2-digit",
         minute: "2-digit"
       })
     );
-    this._variables.set("_DATEDMY", (/* @__PURE__ */ new Date()).toLocaleDateString("en-GB"));
+    this._variables.set(
+      "_DATEDDMMYYYY",
+      now.toLocaleDateString("en-GB", {
+        day: "2-digit",
+        month: "2-digit",
+        year: "numeric"
+      })
+    );
+    this._variables.set(
+      "_DATEMMDDYYYY",
+      now.toLocaleDateString("en-US", {
+        day: "2-digit",
+        month: "2-digit",
+        year: "numeric"
+      })
+    );
+    this._variables.set("_DATEISO", now.toISOString().substring(0, 10));
+    this._variables.set("_IMAGEASPECT", "1");
+    this._variables.set("_IMAGEHEIGHT", "0");
+    this._variables.set("_IMAGEHEIGHTPX", "0");
+    this._variables.set("_IMAGEWIDTH", "0");
+    this._variables.set("_IMAGEWIDTHPX", "0");
     this._variables.set("_PAGENO", "1");
     this._variables.set("_PAGES", "1");
     this.posnX = 0;
@@ -687,8 +711,8 @@ var JsPdfProcessor = class {
       this.pageWidth = document.internal.pageSize.width - this._marginLeft - this._marginRight;
     }
   }
-  addImageFromFile(input) {
-    const subs = this.logAndParseCommand(".addImageFromFile", input);
+  LoadImageFromFile(input) {
+    const subs = this.logAndParseCommand(".LoadImageFromFile", input);
     let fileName = subs;
     if (!fileName) {
       this.lastError = "A file name is required.";
@@ -709,9 +733,9 @@ var JsPdfProcessor = class {
       this.lastResult = "0";
     }
   }
-  addImageFromUrl(input) {
+  LoadImageFromUrl(input) {
     return __async(this, null, function* () {
-      const subs = this.logAndParseCommand(".addImageFromUrl", input);
+      const subs = this.logAndParseCommand(".LoadImageFromUrl", input);
       let url = subs;
       if (!url) {
         this.lastError = "A URL is required.";
@@ -754,6 +778,10 @@ var JsPdfProcessor = class {
       this.setFixedDec(this.pixelsToUom(info.height), 3)
     );
     this._variables.set("_IMAGEHEIGHTPX", info.height.toString());
+    this._variables.set(
+      "_IMAGEASPECT",
+      info.height > 0 ? this.setFixedDec(info.width / info.height, 3) : "1"
+    );
   }
   getContentType(fileName) {
     const mediaType = fileName.split(".").pop();
@@ -817,6 +845,8 @@ var JsPdfProcessor = class {
     const subs = this.logAndParseCommand(".drawDebugGrid", input);
     const savedLineColour = this.lineColour;
     const savedLineWidth = this.lineWidth;
+    const savedX = this.posnX;
+    const savedY = this.posnY;
     const mm = 0.1;
     const pts = mmToPoints(mm);
     const lineWidth = this.pointsToUom(pts);
@@ -873,6 +903,8 @@ var JsPdfProcessor = class {
     }
     this.lineColour = savedLineColour;
     this.lineWidth = savedLineWidth;
+    this.posnX = savedX;
+    this.posnY = savedY;
   }
   drawLine(input) {
     const subs = this.logAndParseCommand(".drawLine", input);
@@ -912,7 +944,7 @@ var JsPdfProcessor = class {
       return;
     }
     if (isNaN(imageNo) || imageNo < 0 || imageNo > this._images.length - 1) {
-      this.lastError = this._images.length ? "The image number must be in the range of 0 to " + (this._images.length - 1).toString() : "Only one image has been loaded, the image number can only be 0";
+      this.lastError = this._images.length > 1 ? `The image number ${imageNo} must be in the range of 0 to ${(this._images.length - 1).toString()}` : "Only one image has been loaded, the image number can only be 0";
       this.lastResult = "0";
       return;
     }
@@ -963,7 +995,6 @@ var JsPdfProcessor = class {
     this.lastResult = "1";
   }
   drawText(input) {
-    var _a;
     const subs = this.logAndParseCommand(".drawText", input);
     const { first: left, rest: rest1 } = getNextNumber(subs);
     const { first: top, rest: rest2 } = getNextNumber(rest1);
@@ -975,7 +1006,7 @@ var JsPdfProcessor = class {
     this.lastObjectWidth = 0;
     this.lastResult = "1";
     if (lines.length > 1) {
-      this.lastError = `Text was truncated to fit within the available width (${(_a = lines[0]) == null ? void 0 : _a.substring(0, 20)}...)`;
+      this.lastError = `Text was truncated to fit within the available width (${rest2.substring(0, 20)}...) on page ${this._currentPageNumber}.`;
       this.lastResult = "0";
       if (lines[0]) {
         if (this._pdfDocument.getTextWidth(lines[0]) < maxWidth) {
@@ -1281,10 +1312,11 @@ var JsPdfProcessor = class {
   }
   ifNotBlank(jsPdfDynamo, input) {
     return __async(this, null, function* () {
-      let { first: variable, rest } = getNextString(input);
+      let { first: value1, rest } = getNextString(input);
       const subs = this.substitute(rest.trim());
-      this._logger.debug(".ifNotBlank " + variable + " " + subs);
-      let value = this._variables.get(variable.toLocaleUpperCase()) || "";
+      this._logger.debug(".ifNotBlank " + value1 + " " + subs);
+      const variable1 = this.substitute(value1);
+      let value = this._variables.get(variable1.toLocaleUpperCase()) || "";
       this.lastResult = "-1";
       if (value.trim() !== "") {
         yield jsPdfDynamo.processDot(this, rest);
@@ -1367,6 +1399,51 @@ var JsPdfProcessor = class {
       "Variable " + varName + " incremented to " + this._variables.get(varName)
     );
   }
+  divVar(input) {
+    let subs = this.substitute(input.trim());
+    this._logger.debug(".divVar " + subs);
+    let { first: varName, rest } = getNextString(subs.toLocaleUpperCase());
+    if (varName === "") {
+      this.lastResult = "0";
+      this.lastError = "DivVar must reference a variable";
+      return;
+    }
+    if (varName.startsWith("_")) {
+      this.lastResult = "0";
+      this.lastError = "DivVar can not be used to update system maintained variables";
+      return;
+    }
+    let varValue = this._variables.get(varName);
+    if (!varValue) {
+      this.lastResult = "0";
+      this.lastError = "Variable '" + varName + "' is not defined";
+      return;
+    }
+    if (isNaN(Number(varValue))) {
+      this._variables.set(varName, "0");
+    }
+    while (rest.length > 0) {
+      const { first: nextOp, rest: remainder } = getNextNumber(rest, 4);
+      rest = remainder;
+      let varValue2 = this._variables.get(varName);
+      if (!isNaN(Number(nextOp)) && Number(nextOp) === 0) {
+        this.lastResult = "0";
+        this.lastError = "Divide by zero error";
+        return;
+      }
+      if (!isNaN(Number(varValue2)) && !isNaN(Number(nextOp))) {
+        this._variables.set(
+          varName,
+          removeTrailingZeros((Number(varValue2) / Number(nextOp)).toFixed(4))
+        );
+      }
+      varValue2 = this._variables.get(varName);
+    }
+    this.lastResult = "1";
+    this._logger.trace(
+      "Variable " + varName + " incremented to " + this._variables.get(varName)
+    );
+  }
   multVar(input) {
     let subs = this.substitute(input.trim());
     this._logger.debug(".multVar " + subs);
@@ -1493,9 +1570,14 @@ var JsPdfProcessor = class {
     }
   }
   setFillColour(input) {
-    let subs = this.substitute(input);
-    this._logger.debug(".setFillColour " + subs);
-    this.fillColour = subs;
+    const subs = this.logAndParseCommand(".setFillColour", input);
+    const { first: fillColour } = getNextString(subs);
+    if (fillColour === "") {
+      this.lastResult = "0";
+      this.lastError = "A fill colour must be specified";
+      return;
+    }
+    this.fillColour = fillColour;
     this.lastResult = "1";
   }
   setFontName(input) {
@@ -1511,14 +1593,25 @@ var JsPdfProcessor = class {
   }
   setFontSize(input) {
     const subs = this.logAndParseCommand(".setFontSize", input);
-    let { first: size } = getNextNumber(subs);
-    if (size > 0) {
-      this.fontPointSize = size;
-      this.lastResult = "1";
-    } else {
+    if (subs === "") {
+      this.lastResult = "0";
+      this.lastError = "A font size must be specified";
+      return;
+    }
+    let { first: sizeAlpha } = getNextNumber(subs);
+    const size = Number(sizeAlpha);
+    if (Number.isNaN(size)) {
+      this.lastResult = "0";
+      this.lastError = `A font size must be a number. '${sizeAlpha}' is not a number.`;
+      return;
+    }
+    if (size <= 0) {
       this.lastResult = "0";
-      this.lastError = "Invalid font size " + size;
+      this.lastError = "A font size must be greater than 0";
+      return;
     }
+    this.fontPointSize = size;
+    this.lastResult = "1";
   }
   setFontStyle(input) {
     const subs = this.logAndParseCommand(".setFontStyle", input);
@@ -1537,9 +1630,14 @@ var JsPdfProcessor = class {
     this.lastResult = "1";
   }
   setLineColour(input) {
-    let subs = this.substitute(input);
-    this._logger.debug(".setLineColour " + subs);
-    this.lineColour = subs;
+    const subs = this.logAndParseCommand(".setFontStyle", input);
+    const { first: lineColour } = getNextString(subs);
+    if (lineColour === "") {
+      this.lastResult = "0";
+      this.lastError = "A line colour must be specified";
+      return;
+    }
+    this.lineColour = lineColour;
     this.lastResult = "1";
   }
   setLineWidth(input) {
@@ -1645,7 +1743,13 @@ var JsPdfProcessor = class {
   }
   setTextColour(input) {
     const subs = this.logAndParseCommand(".setTextColour", input);
-    this.textColour = subs;
+    const { first: textColour } = getNextString(subs);
+    if (textColour === "") {
+      this.lastResult = "0";
+      this.lastError = "A text colour must be specified";
+      return;
+    }
+    this.textColour = textColour;
     this.lastResult = "1";
   }
   copyVar(input) {
@@ -1815,11 +1919,9 @@ var JsPdfDynamo = class {
       return null;
     }
   }
-  toBlobUrl(fileName) {
+  toBlobUrl() {
     try {
-      const result = this._processor.PdfDocument.output("bloburi", {
-        filename: fileName
-      });
+      const result = this._processor.PdfDocument.output("bloburi");
       return result;
     } catch (e) {
       __privateGet(this, _appLogger).warn(
@@ -1850,7 +1952,7 @@ var JsPdfDynamo = class {
   }
   processTemplate(processor, input) {
     return __async(this, null, function* () {
-      let inGroupProcessing = false;
+      let inGroupLoading = false;
       let grpName = "";
       let currGroup = [];
       for (let ix = 0; ix < input.length; ix++) {
@@ -1859,12 +1961,8 @@ var JsPdfDynamo = class {
           continue;
         }
         if (currLine.startsWith("[")) {
-          if (inGroupProcessing) {
-            inGroupProcessing = false;
-            __privateGet(this, _appLogger).debug(
-              `Finished loading group ${grpName}   (${currLine})
-`
-            );
+          if (inGroupLoading) {
+            inGroupLoading = false;
           } else {
             if (currLine.length === 1) continue;
             grpName = currLine.substring(1);
@@ -1873,15 +1971,14 @@ var JsPdfDynamo = class {
               grpName = grpName.substring(0, iy);
             }
             grpName = grpName.trim().toLocaleUpperCase();
-            inGroupProcessing = true;
-            __privateGet(this, _appLogger).debug(`Loading group ${grpName}   (${currLine})
-`);
+            inGroupLoading = true;
+            __privateGet(this, _appLogger).debug(`Loading group ${grpName}`);
             currGroup = [];
             __privateGet(this, _groups)[grpName] = currGroup;
           }
           continue;
         }
-        if (inGroupProcessing) {
+        if (inGroupLoading) {
           currGroup.push(currLine);
           __privateGet(this, _appLogger).trace(`  ${currLine}`);
           continue;
@@ -1905,12 +2002,6 @@ var JsPdfDynamo = class {
         case "AddBookmark".toLowerCase():
           processor.addBookmark(parameters);
           return;
-        case "AddImageFromFile".toLowerCase():
-          processor.addImageFromFile(parameters);
-          return;
-        case "AddImageFromUrl".toLowerCase():
-          yield processor.addImageFromUrl(parameters);
-          return;
         case "AddPage".toLowerCase():
           processor.addPage(parameters);
           return;
@@ -1920,6 +2011,9 @@ var JsPdfDynamo = class {
         case "CopyVar".toLowerCase():
           processor.copyVar(parameters);
           return;
+        case "DivVar".toLowerCase():
+          processor.divVar(parameters);
+          return;
         case "Do".toLowerCase():
           yield this.processGroups(processor, parameters);
           return;
@@ -1980,6 +2074,12 @@ var JsPdfDynamo = class {
         case "IncVar".toLowerCase():
           processor.incVar(parameters);
           return;
+        case "LoadImageFromFile".toLowerCase():
+          processor.LoadImageFromFile(parameters);
+          return;
+        case "LoadImageFromUrl".toLowerCase():
+          yield processor.LoadImageFromUrl(parameters);
+          return;
         case "MultVar".toLowerCase():
           processor.multVar(parameters);
           return;
@@ -2056,9 +2156,11 @@ var JsPdfDynamo = class {
         let { first: group, rest } = getNextString(subs);
         subs = rest;
         __privateGet(this, _appLogger).debug(`
-[${group}]`);
+[${group} - Enter]`);
         if (__privateGet(this, _groups)[group]) {
           yield this.processTemplate(processor, __privateGet(this, _groups)[group]);
+          __privateGet(this, _appLogger).debug(`[${group} - Exit]
+`);
         } else {
           __privateGet(this, _appLogger).warn(`Group ${group} was not found.`);
           processor.lastResult = "0";

package/documentation/1. Introduction/Introduction.txt

@@ -42,7 +42,7 @@
 
 .SetVar top %_CurrentY%
 .DrawText 5 %top% -
-.SetVar text The initial page size, orientation and units of measure are set when the
+.SetVar text The initial page size, orientation and unit of measure are set when the
 .SetVar text %text% JsPdfDynamo instance is instantiated.
 .DrawTextWrapped 10 %top% %width% *None %text%
 

package/documentation/3. Variables/Introduction.txt

@@ -10,30 +10,31 @@
 .incCurrentY %halfLineGap%
 .DrawText 0 %_CurrentY% Commands are described in a following chapter.
 
-.incCurrentY %_FontHeight%
+.incCurrentY %halfLineGap%
 .SetVar CommandLine1 Variables are referenced by enclosing them in percentage symbols. For example, to write some
 .SetVar CommandLine1 %CommandLine1% text at the current position on the page the following DrawText command can be used:
-.Do CommandLine1
-.incCurrentY %_FontHeight%
+.Do CommandLine
+.incCurrentY %halfLineGap%
 .SetVar CommandLine1 .DrawText %%%%_CurrentX%%%% %%%%_CurrentY%%%% Hello World!
 .Do CommandLine2
-.incCurrentY %_FontHeight%
+.incCurrentY %halfLineGap%
 .SetVar CommandLine1 Variables (and commands) are not case sensitive and the above command could also be given as:
-.Do CommandLine1 
-.incCurrentY %_FontHeight%
+.Do CommandLine
+.incCurrentY %halfLineGap%
 .SetVar CommandLine1 .drawTEXT %%%%_currentX%%%% %%%%_CURRENTy%%%% Hello World!
 .Do CommandLine2 
-.incCurrentY %_FontHeight%
+.incCurrentY %halfLineGap%
 
 .SetVar CommandLine1 Variables are stored as strings though there is a limited capability to perform arithmetic on
 .SetVar CommandLine1 %CommandLine1% variables. For example, the .IncVar command can be used to add or subtract a number from
 .SetVar CommandLine1 %CommandLine1% a variable.
-.Do CommandLine1
-.incCurrentY %_FontHeight%
+.Do CommandLine
+.incCurrentY %halfLineGap%
 
-.DrawText 0 %_CurrentY% Variables do not have to be assigned a value before being used. 
+.DrawText 0 %_CurrentY% Variables do not have to be assigned a value before being used.
+.incCurrentY %halfLineGap%
 .DrawText 0 %_CurrentY% The value of a variable referenced before being assigned a value is an empty string.
-.incCurrentY %_FontHeight%
+.incCurrentY %halfLineGap%
 .SetVar CommandLine1 All variables are global, there is no scoping of variables within a group. A variable
 .SetVar CommandLine1 %CommandLine1% defined within a group is available to commands run after that group.
-.Do CommandLine1
+.Do CommandLine

package/documentation/3. Variables/SystemMaintained.txt

@@ -31,6 +31,26 @@
 .SetVar CommandLine2 The last page orientation specified:  'portrait' or 'landscape'
 .Do VariableLineWide
 
+.incCurrentY %halfLineGap%
+.SetVar CommandLine1 _DateDdMmYyyy
+.SetVar CommandLine2 The current date, formatted as DD/MM/YYYY.
+.Do VariableLineWrapped
+
+.incCurrentY %halfLineGap%
+.SetVar CommandLine1 _DateMmDdYyyy
+.SetVar CommandLine2 The current date, formatted as MM/DD/YYYY.
+.Do VariableLineWrapped
+
+.incCurrentY %halfLineGap%
+.SetVar CommandLine1 _DateISO
+.SetVar CommandLine2 The current date, formatted as YYYY-MM-DD.
+.Do VariableLineWrapped
+
+.incCurrentY %halfLineGap%
+.SetVar CommandLine1 _FillColour
+.SetVar CommandLine2 The colour that will be used when rendering any following filled boxes.
+.Do VariableLineWide
+
 .incCurrentY %halfLineGap%
 .SetVar CommandLine1 _FontHeight
 .SetVar CommandLine2 The height of the current font. This can be used to create a space between
@@ -52,6 +72,11 @@
 .SetVar CommandLine2 The current font style. For example, "normal" or "italic".
 .Do VariableLine
 
+.incCurrentY %halfLineGap%
+.SetVar CommandLine1 _ImageAspect
+.SetVar CommandLine2 The aspect ratio of the last loaded image, calculated as width divided by height.
+.Do VariableLineWrapped
+
 .incCurrentY %halfLineGap%
 .SetVar CommandLine1 _ImageHeight
 .SetVar CommandLine2 The height of the last loaded image.
@@ -110,6 +135,16 @@
 .SetVar CommandLine2 %CommandLine2% will contain the number of the added page.
 .Do VariableLineWrapped
 
+.incCurrentY %halfLineGap%
+.SetVar CommandLine1 _LineColour
+.SetVar CommandLine2 The colour that will be used to render any following lines.
+.Do VariableLineWide
+
+.incCurrentY %halfLineGap%
+.SetVar CommandLine1 _LineWidth
+.SetVar CommandLine2 The width that any following lines will be drawn.
+.Do VariableLine
+
 .incCurrentY %halfLineGap%
 .SetVar CommandLine1 _MarginBottom
 .SetVar CommandLine2 The current margin from the bottom edge of the page.
@@ -165,5 +200,15 @@
 .SetVar CommandLine2 %CommandLine2% from the height of the object plus the current vertical spacing, which can 
 .SetVar CommandLine2 %CommandLine2% be set with the SetSpaceVert command. 
 .Do VariableLineWrapped
+
+.incCurrentY %halfLineGap%
+.SetVar CommandLine1 _TextColour
+.SetVar CommandLine2 The colour that will be used when rendering any following text.
+.Do VariableLineWrapped
+
+.incCurrentY %halfLineGap%
+.SetVar CommandLine1 _TimeHhMm
+.SetVar CommandLine2 The current time, formatted as HH:MM.
+.Do VariableLineWrapped
 .incCurrentY %_SPACEVERT%
 .Do SetMargins 

package/documentation/4. Commands/AddBookmark.txt

@@ -6,7 +6,7 @@
 
 .SetVar CommandSubHeading Syntax
 .Do CommandSubHeading
-.SetVar CommandLine1 .AddBookmark ParentId PageNo Text
+.SetVar CommandLine1 .AddBookmark  ParentId  PageNo  Text
 .Do CommandLine2
 
 .SetVar CommandSubHeading Parameters

package/documentation/4. Commands/AddPage.txt

@@ -4,15 +4,17 @@
 
 .SetVar CommandSubHeading Syntax
 .Do CommandSubHeading
-.SetVar CommandLine1 .AddPage {PageSize}
+.SetVar CommandLine1 .AddPage  PageSize  Orientation
 .Do CommandLine2
 
 .SetVar CommandSubHeading Parameters
 .Do CommandSubHeading
 .SetVar CommandLine1 PageSize
-.SetVar CommandLine2 The page size: A3, A4, Letter, etc. Optional and if not supplied the
+.SetVar CommandLine2 The size of the page to be added: A3, A4, Letter, etc. Optional and if not supplied, the current page size is used.
 .Do CommandLine2
-.SetVar CommandLine2 current page size is used
+.SetVar CommandLine1 Orientation
+.SetVar CommandLine2 The orientation of the page to be added: 'portrait' or 'landscape'. Optional and if not supplied, the
+.SetVar CommandLine2 %CommandLine2% current orientation is used. The orientation can be abbreviated to the first letter, 'p' or 'l'.
 .Do CommandLine2
 
 .SetVar CommandSubHeading Other

package/documentation/4. Commands/CheckPage.txt

@@ -12,7 +12,7 @@
 
 .SetVar CommandSubHeading Syntax
 .Do CommandSubHeading
-.SetVar CommandLine1 .CheckPage Distance {Group1, Group2 ...}
+.SetVar CommandLine1 .CheckPage  Distance  {Group1,  Group2 ...}
 .Do CommandLine2
 
 .SetVar CommandSubHeading Parameters

package/documentation/4. Commands/CopyVar.txt

@@ -6,7 +6,7 @@
 
 .SetVar CommandSubHeading Syntax
 .Do CommandSubHeading
-.SetVar CommandLine1 .CopyVar CopyTo CopyFrom
+.SetVar CommandLine1 .CopyVar  CopyTo  CopyFrom
 .Do CommandLine2
 
 .SetVar CommandSubHeading Parameters
@@ -47,6 +47,6 @@
 
 .SetVar CommandSubHeading See Also
 .Do CommandSubHeading
-.SetVar CommandLine1 IncVar, MultVar, SetVar
+.SetVar CommandLine1 DivVar, IncVar, MultVar, SetVar
 .Do CommandLine2
 .incCurrentY %_FontHeight%

package/documentation/4. Commands/DivVar.txt

@@ -0,0 +1,67 @@
+.SetVar CommandName DivVar
+.Do CommandHeading
+.DrawText 0 %_CurrentY% Divide the value of a variable by one or more factors.
+
+.SetVar CommandSubHeading Syntax
+.Do CommandSubHeading
+.SetVar CommandLine1 .DivVar  Variable  Value  Value (etc)
+.Do CommandLine2
+
+.SetVar CommandSubHeading Parameters
+.Do CommandSubHeading
+.SetVar CommandLine1 Variable
+.SetVar CommandLine2 The name of the variable to update. This is not usually a substitution variable,
+.SetVar CommandLine2 %CommandLine2% but it can be, or contain substitution variables. The variable must exist.
+.Do CommandLine2
+.SetVar CommandLine1 Value
+.SetVar CommandLine2 One or more values to multiple the variable by. These can be constants or substitution variables.
+.Do CommandLine2
+
+.SetVar CommandSubHeading Other
+.Do CommandSubHeading
+.SetVar CommandLine1 Variable _LastResult is set to '1' if a valid variable name is provided, otherwise it is set to '0'.
+.Do CommandLine
+.SetVar CommandLine1 The JsPdfDynamo maintained variables (those whose name starts with an underscore) can not 
+.Do CommandLine
+.SetVar CommandLine1 be changed by this command.
+.Do CommandLine
+.incCurrentY %halfLineGap%
+.SetVar CommandLine1 The variable name may itself be, or contain a variable.
+.Do CommandLine 
+
+.SetVar CommandSubHeading Examples
+.Do CommandSubHeading
+.SetVar CommandLine1 Divide the value of the variable 'Total' by '4':
+.Do CommandLine
+.incCurrentY %halfLineGap%
+.SetVar CommandLine1 .SetVar  Total  12
+.Do CommandLine2
+.SetVar CommandLine1 .DivVar  Total  4
+.Do CommandLine2
+.incCurrentY %_FontHeight%
+
+.SetVar CommandLine1 Decrease the value of 'Weight6' by half from '78.6' to '39.3':
+.Do CommandLine
+.incCurrentY %halfLineGap%
+.SetVar CommandLine1 .SetVar  index  6
+.Do CommandLine2
+.SetVar CommandLine1 .SetVar  Weight%%%%index%%%%  78.6
+.Do CommandLine2
+.SetVar CommandLine1 .DivVar  Weight%%%%index%%%%  2
+.Do CommandLine2
+.incCurrentY %_FontHeight%
+
+.SetVar CommandLine1 Multiple values can be used to increase value of 'total' from 100 to 5
+.Do CommandLine
+.incCurrentY %halfLineGap%
+.SetVar CommandLine1 .SetVar  Total  10
+.Do CommandLine2
+.SetVar CommandLine1 .DivVar  Total  10  2
+.Do CommandLine2
+.incCurrentY %_FontHeight%
+
+.SetVar CommandSubHeading See Also
+.Do CommandSubHeading
+.SetVar CommandLine1 CopyVar, IncVar, MultVar, SetVar
+.Do CommandLine2
+.incCurrentY %_FontHeight%

package/documentation/4. Commands/Do.txt

@@ -3,7 +3,7 @@
 .DrawText 0 %_CurrentY% 'Do' (ie process) one or more groups of commands that have already been defined.
 .SetVar CommandSubHeading Syntax
 .Do CommandSubHeading
-.SetVar CommandLine1 .Do Group1, Group2...etc
+.SetVar CommandLine1 .Do  Group1,  Group2...etc
 .Do CommandLine2
 
 .SetVar CommandSubHeading Parameters

package/documentation/4. Commands/DoRepeat.txt

@@ -6,7 +6,7 @@
 
 .SetVar CommandSubHeading Syntax
 .Do CommandSubHeading
-.SetVar CommandLine1 .DoRepeat Number Group1, Group2...etc
+.SetVar CommandLine1 .DoRepeat  Number  Group1,  Group2...etc
 .Do CommandLine2
 
 .SetVar CommandSubHeading Parameters