jspdf-dynamo 1.0.1 → 1.0.5

package/documentation/3. Variables/SystemMaintained.txt

@@ -3,44 +3,44 @@
 
 .incCurrentY %halfLineGap%
 .SetVar text JsPdfDynamo maintains and updates various variables as each command is processed. These
-.SetVar text %text% variables can not be changed directly by using the SetVar command. They include:
-.DrawTextWrapped 0 %_CurrentY% %_PageWidth% CommandCheckPage %LongText%
+.SetVar text %text% variables can not be changed directly by using the SetVar command. 
+.DrawTextWrapped 0 %_CurrentY% %_PageWidth% CommandCheckPage %text%
+.incCurrentY %halfLineGap%
+.SetVar text Note that unless otherwise stated, all distances and positions are in the unit of measure specified
+.SetVar text %text% when creating the JsPdfDynamo object.
+.DrawTextWrapped 0 %_CurrentY% %_PageWidth% CommandCheckPage %text%
 .incCurrentY %halfLineGap%
 .SetMargin L 20
 
 .SetVar CommandLine1 _CurrentX
-.SetVar CommandLine2 The current horizontal position on the page, relative to the left margin, in
-.Do VariableLine
-.SetVar CommandLine2 millimeters.
+.SetVar CommandLine2 The current horizontal position on the page, relative to the left margin.
 .Do VariableLine
 
 .incCurrentY %halfLineGap%
 .SetVar CommandLine1 _CurrentY
-.SetVar CommandLine2 The current vertical position on the page, relative to the top margin, in
-.Do VariableLine
-.SetVar CommandLine2 millimeters.
+.SetVar CommandLine2 The current vertical position on the page, relative to the top margin.
 .Do VariableLine
 
 .incCurrentY %halfLineGap%
 .SetVar CommandLine1 _CurrentPageSize
-.SetVar CommandLine2 The name of the last page size specified, for example, 'A4', 'Letter'.
+.SetVar CommandLine2 The name of the last page size specified, for example, 'a4', 'letter'.
 .Do VariableLineWide
 
 .incCurrentY %halfLineGap%
 .SetVar CommandLine1 _CurrentPageOrientation
-.SetVar CommandLine2 The last page orientation specified: 
-.Do VariableLineWide
-.SetVar CommandLine2 0=Portrait (default) 1=Landscape 
+.SetVar CommandLine2 The last page orientation specified:  'portrait' or 'landscape'
 .Do VariableLineWide
 
 .incCurrentY %halfLineGap%
 .SetVar CommandLine1 _FontHeight
-.SetVar CommandLine2 The height of the current font, in millimeters. This can be used to create
-.Do VariableLine
-.SetVar CommandLine2 a space between paragraphs when used in conjunction with the
-.Do VariableLine
-.SetVar CommandLine2 incCurrentY command: .incCurrentY %%%%_FontHeight%%%%
-.Do VariableLine
+.SetVar CommandLine2 The height of the current font. This can be used to create a space between
+.SetVar CommandLine2 %CommandLine2% paragraphs when used in conjunction with the incCurrentY command.
+.Do VariableLineWrapped
+
+.incCurrentY %halfLineGap%
+.SetVar CommandLine1 _FontName
+.SetVar CommandLine2 The name of the current font. For example, "helvetica", which is the default font.
+.Do VariableLineWrapped
 
 .incCurrentY %halfLineGap%
 .SetVar CommandLine1 _FontPointSize
@@ -53,15 +53,13 @@
 .Do VariableLine
 
 .incCurrentY %halfLineGap%
-.SetVar CommandLine1 _FontType
-.SetVar CommandLine2 The name of the current font. For example, "Helvetica", which is the
-.Do VariableLine
-.SetVar CommandLine2 default font type.
-.Do VariableLine
+.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 in the current units of measure.
+.SetVar CommandLine2 The height of the last loaded image.
 .Do VariableLine
 
 .incCurrentY %halfLineGap%
@@ -71,7 +69,7 @@
 
 .incCurrentY %halfLineGap%
 .SetVar CommandLine1 _ImageWidth
-.SetVar CommandLine2 The width of the last loaded image in the current units of measure.
+.SetVar CommandLine2 The width of the last loaded image.
 .Do VariableLine
 
 .incCurrentY %halfLineGap%
@@ -81,7 +79,7 @@
 
 .incCurrentY %halfLineGap%
 .SetVar CommandLine1 _LastError
-.SetVar CommandLine2 A description of the last error encountered. 
+.SetVar CommandLine2 A description of the last error encountered.
 .Do VariableLine
 
 .incCurrentY %halfLineGap%
@@ -95,50 +93,46 @@
 
 .incCurrentY %halfLineGap%
 .SetVar CommandLine1 _LastObjectHeight
-.SetVar CommandLine2 The height of the last object that has been output, in millimeters.
+.SetVar CommandLine2 The height of the last object that has been drawn.
 .Do VariableLine
 
 .incCurrentY %halfLineGap%
 .SetVar CommandLine1 _LastObjectWidth
-.SetVar CommandLine2 The width of the last object that has been output, in millimeters.
+.SetVar CommandLine2 The width of the last object that has been drawn.
 .Do VariableLine
 
 .incCurrentY %halfLineGap%
 .SetVar CommandLine1 _LastOutline
 .SetVar CommandLine2 This contains the number assigned to each outline entry when it is
-.Do VariableLine
-.SetVar CommandLine2 created. This number is used when creating child outline entries. 
-.Do VariableLine
+.SetVar CommandLine2 %CommandLine2% created. This is used when creating child outline entries. 
+.Do VariableLineWrapped
 
 .incCurrentY %halfLineGap%
 .SetVar CommandLine1 _LastResult
 .SetVar CommandLine2 Most commands update this variable. If the command fails, this will be
-.Do VariableLine
-.SetVar CommandLine2 set to '0'. A successful command wil set this to '1' or to some other
-.Do VariableLine
-.SetVar CommandLine2 useful value. For example, when a new page is created the page number
-.Do VariableLine
-.SetVar CommandLine2 is returned in this variable.
-.Do VariableLine
+.SetVar CommandLine2 %CommandLine2% set to '0'. A successful command will set this to '1' or to some other
+.SetVar CommandLine2 %CommandLine2% useful value. For example, when a new page is added, _LastResult 
+.SetVar CommandLine2 %CommandLine2% will contain the number of the added page.
+.Do VariableLineWrapped
 
 .incCurrentY %halfLineGap%
 .SetVar CommandLine1 _MarginBottom
-.SetVar CommandLine2 The current margin, in millimeters, from the page bottom edge.
+.SetVar CommandLine2 The current margin from the bottom edge of the page.
 .Do VariableLine
 
 .incCurrentY %halfLineGap%
 .SetVar CommandLine1 _MarginLeft
-.SetVar CommandLine2 The current margin, in millimeters, from the page left edge.
+.SetVar CommandLine2 The current margin from the left edge of the page.
 .Do VariableLine
 
 .incCurrentY %halfLineGap%
 .SetVar CommandLine1 _MarginRight
-.SetVar CommandLine2 The current margin, in millimeters, from the page right edge.
+.SetVar CommandLine2 The current margin from the right edge of the page.
 .Do VariableLine
 
 .incCurrentY %halfLineGap%
 .SetVar CommandLine1 _MarginTop
-.SetVar CommandLine2 The current margin, in millimeters, from the page top edge.
+.SetVar CommandLine2 The current margin from the top edge of the page.
 .Do VariableLine
 
 .incCurrentY %halfLineGap%
@@ -148,9 +142,7 @@
 
 .incCurrentY %halfLineGap%
 .SetVar CommandLine1 _PageHeight
-.SetVar CommandLine2 The height of the page, less the current top and bottom margins,
-.Do VariableLine
-.SetVar CommandLine2 expressed in millimeters.
+.SetVar CommandLine2 The height of the page, less the current top and bottom margins.
 .Do VariableLine
 
 .incCurrentY %halfLineGap%
@@ -160,31 +152,23 @@
 
 .incCurrentY %halfLineGap%
 .SetVar CommandLine1 _PageWidth
-.SetVar CommandLine2 The width of the page, less the current left and right margins, expressed
-.Do VariableLine
-.SetVar CommandLine2 in millimeters.
+.SetVar CommandLine2 The width of the page, less the current left and right margins.
 .Do VariableLine
 
 .incCurrentY %halfLineGap%
 .SetVar CommandLine1 _SpaceHoz
 .SetVar CommandLine2 JsPdfDynamo keeps track of the current position, relative to the left
-.Do VariableLine
-.SetVar CommandLine2 margin, after each object is output. This position is calculated in
-.Do VariableLine
-.SetVar CommandLine2 millimeters from the width of the object plus the current horizontal spacing, 
-.Do VariableLine
-.SetVar CommandLine2 which can be set with the SetSpaceHoz command. 
-.Do VariableLine
+.SetVar CommandLine2 %CommandLine2% margin, after each object is output. This position is calculated
+.SetVar CommandLine2 %CommandLine2% from the width of the object plus the current horizontal spacing, 
+.SetVar CommandLine2 %CommandLine2% which can be set with the SetSpaceHoz command. 
+.Do VariableLineWrapped
 
 .incCurrentY %halfLineGap%
 .SetVar CommandLine1 _SpaceVert
-.SetVar CommandLine2 JsPdfDynamo keeps track of the current position, in millimeters, relative
-.Do VariableLine
-.SetVar CommandLine2 to the top margin, after each object is output. This position is calculated
-.Do VariableLine
-.SetVar CommandLine2 from the height of the object plus the current vertical spacing, which can 
-.Do VariableLine
-.SetVar CommandLine2 be set with the SetSpaceVert command. 
-.Do VariableLine
+.SetVar CommandLine2 %CommandLine2% JsPdfDynamo keeps track of the current position, relative
+.SetVar CommandLine2 %CommandLine2% to the top margin, after each object is output. This position is calculated
+.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 %_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
@@ -34,14 +34,14 @@
 .SetVar CommandLine1 Create a top level bookmark entry for the current page:
 .Do CommandLine
 .incCurrentY %halfLineGap%
-.SetVar CommandLine1 .AddBookmark 0 %%%%_PAGENO%%%% Chapter one of the document 
+.SetVar CommandLine1 .AddBookmark  0  %%%%_PAGENO%%%%  Chapter one of the document 
 .Do CommandLine2
-.SetVar CommandLine1 .SetVar Chapter1 %%%%_LastResult%%%% 
+.SetVar CommandLine1 .SetVar  Chapter1  %%%%_LastResult%%%% 
 .Do CommandLine2
 .incCurrentY %_FontHeight%
 .SetVar CommandLine1 Create a child bookmark entry for the chapter 1:
 .Do CommandLine
 .incCurrentY %halfLineGap%
-.SetVar CommandLine1 .AddBookmark %%%%Chapter1%%%% %%%%_PAGENO%%%% Chapter one, Paragraph 1 
+.SetVar CommandLine1 .AddBookmark  %%%%Chapter1%%%%  %%%%_PAGENO%%%%  Chapter one, Paragraph 1 
 .Do CommandLine2
 .incCurrentY %_FontHeight%

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
@@ -35,6 +37,6 @@
 .SetVar CommandLine1 Create a new page with a page size of 'A4':
 .Do CommandLine
 .incCurrentY %halfLineGap%
-.SetVar CommandLine1 .AddPage A4
+.SetVar CommandLine1 .AddPage  a4
 .Do CommandLine2
 .incCurrentY %_FontHeight%

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
@@ -38,7 +38,7 @@
 .SetVar CommandLine1 %CommandLine1% is within 10mm of the bottom margin and create a new page if so:
 .Do CommandLine
 .incCurrentY %halfLineGap%
-.SetVar CommandLine1 .CheckPage 10
+.SetVar CommandLine1 .CheckPage  10
 .Do CommandLine2
 .incCurrentY %_FontHeight%
 
@@ -47,6 +47,6 @@
 .SetVar CommandLine1 %CommandLine1% process the groups PageFooter, AddPage and GroupHeadingContinued:
 .Do CommandLine
 .incCurrentY %halfLineGap%
-.SetVar CommandLine1 .CHECKPAGE 1.25 PageFooter AddPage GroupHeadingContinued
+.SetVar CommandLine1 .CHECKPAGE  1.25  PageFooter  AddPage  GroupHeadingContinued
 .Do CommandLine2
 .incCurrentY %_FontHeight%

package/documentation/4. Commands/Commands.txt

@@ -0,0 +1,7 @@
+.SetVar ChapterName Commands
+.do ChapterHeading
+
+.SetVar text Note that unless otherwise stated, all distances and positions are in the unit of measure specified
+.SetVar text %text% when creating the JsPdfDynamo object.
+.DrawTextWrapped 0 %_CurrentY% %_PageWidth% CommandCheckPage %text%
+.incCurrentY %_FontHeight%

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
@@ -33,7 +33,7 @@
 .SetVar CommandLine1 Set the variable 'SaveCurrentTop' to the system maintained variable '_CurrentY':
 .Do CommandLine
 .incCurrentY %halfLineGap%
-.SetVar CommandLine1 .CopyVar SaveCurrentTop  _CurrentY
+.SetVar CommandLine1 .CopyVar  SaveCurrentTop  _CurrentY
 .Do CommandLine2
 .incCurrentY %_FontHeight%
 
@@ -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
@@ -23,13 +23,13 @@
 .SetVar CommandLine1 Process the groups 'NewChapter' and 'NewSection':
 .Do CommandLine
 .incCurrentY %halfLineGap%
-.SetVar CommandLine1 .Do NewChapter NewSection
+.SetVar CommandLine1 .Do  NewChapter  NewSection
 .Do CommandLine2
 .incCurrentY %_FontHeight%
 .SetVar CommandLine1 Process the group whose name is stored in the variable 'NextGroup':
 .Do CommandLine
 .incCurrentY %halfLineGap%
-.SetVar CommandLine1 .Do %%%%NextGroup%%%%
+.SetVar CommandLine1 .Do  %%%%NextGroup%%%%
 .Do CommandLine2
 .incCurrentY %_FontHeight%
 

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
@@ -34,13 +34,13 @@
 .SetVar CommandLine1 %CommandLine1% 'Detail', 'Footer', 'Heading', 'Detail', 'Footer', 'Heading', 'Detail, 'Footer'):
 .Do CommandLine
 .incCurrentY %halfLineGap%
-.SetVar CommandLine1 .DoRepeat 3 Heading Detail Footer
+.SetVar CommandLine1 .DoRepeat  3  Heading Detail Footer
 .Do CommandLine2
 .incCurrentY %_FontHeight%
 .SetVar CommandLine1 Process the group PrintAddress the number of times stored in the variable 'AddressCount':
 .Do CommandLine
 .incCurrentY %halfLineGap%
-.SetVar CommandLine1 .DoRepeat %%%%AddressCount%%%% PrintAddress
+.SetVar CommandLine1 .DoRepeat  %%%%AddressCount%%%%  PrintAddress
 .Do CommandLine2
 .incCurrentY %_FontHeight%
 

package/documentation/4. Commands/DrawBox.txt

@@ -4,7 +4,7 @@
 
 .SetVar CommandSubHeading Syntax
 .Do CommandSubHeading
-.SetVar CommandLine1 .DrawBox Left Top Width Height Option
+.SetVar CommandLine1 .DrawBox  Left  Top  Width  Height  Option
 .Do CommandLine2
 
 .SetVar CommandSubHeading Parameters
@@ -48,7 +48,7 @@
 .SetVar CommandLine1 %CommandLine1% spans the width of the page and is 14.5 millimeters high.
 .Do CommandLine
 .incCurrentY %halfLineGap%
-.SetVar CommandLine1 .DrawBox 0 %%%%_CurrentY%%%% %%%%_PageWidth%%%% 14.5 0
+.SetVar CommandLine1 .DrawBox  0  %%%%_CurrentY%%%%  %%%%_PageWidth%%%%  14.5  0
 .Do CommandLine2
 
 .incCurrentY %_FontHeight%
@@ -57,7 +57,7 @@
 .SetVar CommandLine1 %CommandLine1% of the page and is ½ inch high.
 .Do CommandLine
 .incCurrentY %halfLineGap%
-.SetVar CommandLine1 .DrawBox 0 0 %%%%_PageWidth%%%% 0.5 2
+.SetVar CommandLine1 .DrawBox  0  0  %%%%_PageWidth%%%%  0.5  2
 .Do CommandLine2
 
 .SetVar CommandSubHeading See Also

package/documentation/4. Commands/DrawDebugGrid.txt

@@ -7,7 +7,7 @@
 
 .SetVar CommandSubHeading Syntax
 .Do CommandSubHeading
-.SetVar CommandLine1 .DrawDebugGrid Option
+.SetVar CommandLine1 .DrawDebugGrid  Option
 .Do CommandLine2
 
 .SetVar CommandSubHeading Parameters
@@ -24,14 +24,14 @@
 .SetVar CommandLine1 %CommandLine1% down to the bottom right.
 .Do CommandLine
 .incCurrentY %halfLineGap%
-.SetVar CommandLine1 .DrawDebugGrid Page
+.SetVar CommandLine1 .DrawDebugGrid  Page
 .Do CommandLine2
 .incCurrentY %_FontHeight%
 
 .SetVar CommandLine1 Draws a debug grid on all pages of the document, within the current margin settings.
 .Do CommandLine
 .incCurrentY %halfLineGap%
-.SetVar CommandLine1 .ForEachPage .DrawDebugGrid
+.SetVar CommandLine1 .ForEachPage  .DrawDebugGrid
 .Do CommandLine2
 
 .SetVar CommandSubHeading See Also

package/documentation/4. Commands/DrawImage.txt

@@ -5,7 +5,7 @@
 
 .SetVar CommandSubHeading Syntax
 .Do CommandSubHeading
-.SetVar CommandLine1 .DrawImage ImageNo Left Top Width Height Scale
+.SetVar CommandLine1 .DrawImage  ImageNo  Left  Top  Width  Height  Scale
 .Do CommandLine2
 
 .SetVar CommandSubHeading Parameters
@@ -73,7 +73,7 @@
 .SetVar CommandLine1 %CommandLine1% location on the page.
 .Do CommandLine
 .incCurrentY %halfLineGap%
-.SetVar CommandLine1 .DrawImage %%%%ImageId%%%% %%%%_CurrentX%%%% %%%%_CurrentY%%%%
+.SetVar CommandLine1 .DrawImage  %%%%ImageId%%%%  %%%%_CurrentX%%%%  %%%%_CurrentY%%%%
 .Do CommandLine2
 .incCurrentY %_FontHeight%
 .SetVar CommandLine1 Assuming that the unit of measure is millimeters, 
@@ -81,12 +81,12 @@
 .SetVar CommandLine1 %CommandLine1% the page and scaled proportionally to be 10mm high.
 .Do CommandLine
 .incCurrentY %halfLineGap%
-.SetVar CommandLine1 .DrawImage %%%%LogoId%%%% 0 0 0 10
+.SetVar CommandLine1 .DrawImage  %%%%LogoId%%%%  0  0  0  10
 .Do CommandLine2
 .incCurrentY %_FontHeight%
 
 .SetVar CommandSubHeading See Also
 .Do CommandSubHeading
-.SetVar CommandLine1 AddImageFromFile, AddImageFromUrl
+.SetVar CommandLine1 LoadImageFromFile, LoadImageFromUrl
 .Do CommandLine2
 .incCurrentY %_FontHeight%

package/documentation/4. Commands/DrawLine.txt

@@ -7,7 +7,7 @@
 
 .SetVar CommandSubHeading Syntax
 .Do CommandSubHeading
-.SetVar CommandLine1 .DrawLine Left Top Right Bottom
+.SetVar CommandLine1 .DrawLine  Left  Top  Right  Bottom
 .Do CommandLine2
 
 .SetVar CommandSubHeading Parameters
@@ -45,14 +45,14 @@
 .SetVar CommandLine1 %CommandLine1% output a vertical line 15cm from the left margin:
 .Do CommandLine
 .incCurrentY %halfLineGap%
-.SetVar CommandLine1 .DrawLine 150 0 150 %%%%_PageHeight%%%%
+.SetVar CommandLine1 .DrawLine  150  0  150  %%%%_PageHeight%%%%
 .Do CommandLine2
 
 .incCurrentY %_FontHeight%
 .SetVar CommandLine1 Output a horizontal line at the current vertical position on the page:
 .Do CommandLine
 .incCurrentY %halfLineGap%
-.SetVar CommandLine1 .DrawLine 0 %%%%_CurrentY%%%% %%%%_PageWidth%%%% %%%%_CurrentY%%%% 
+.SetVar CommandLine1 .DrawLine  0  %%%%_CurrentY%%%%  %%%%_PageWidth%%%%  %%%%_CurrentY%%%% 
 .Do CommandLine2
 
 .SetVar CommandSubHeading See Also

package/documentation/4. Commands/DrawTextBox.txt

@@ -6,7 +6,7 @@
 
 .SetVar CommandSubHeading Syntax
 .Do CommandSubHeading
-.SetVar CommandLine1 .DrawTextBox Left Top Width Height Horizontal-alignment Vertical-alignment Text
+.SetVar CommandLine1 .DrawTextBox  Left  Top  Width  Height  Horizontal-alignment  Vertical-alignment  Text
 .Do CommandLine2
 
 .SetVar CommandSubHeading Parameters

package/documentation/4. Commands/DrawTextWrapped.txt

@@ -1,6 +1,8 @@
 .SetVar CommandName DrawTextWrapped
 .Do CommandHeading
-.DrawTextWrapped 0 %_CurrentY% %_PageWidth% CommandCheckPage Draw text at the given point on the page, relative to the page margins, wrapping to one or more new lines as required. 
+.SetVar CommandLine1 Draw text at the given point on the page, relative to the page margins, wrapping to one or more new lines
+.SetVar CommandLine1 %CommandLine1% as required, and handling overflowing of pages.
+.Do CommandLine1
 
 .SetVar CommandSubHeading Syntax
 .Do CommandSubHeading
@@ -10,15 +12,13 @@
 .SetVar CommandSubHeading Parameters
 .Do CommandSubHeading
 .SetVar CommandLine1 Left
-.SetVar CommandLine2 The position of the text, measured from the left margin, in millimeters.
+.SetVar CommandLine2 The position of the text, measured from the left margin.
 .Do CommandLine2
 .SetVar CommandLine1 Top
-.SetVar CommandLine2 The position of the text, measured from the top margin, in millimeters.
+.SetVar CommandLine2 The position of the text, measured from the top margin.
 .Do CommandLine2
 .SetVar CommandLine1 MaxWidth
-.SetVar CommandLine2 The maximum width of text to be output on each line before wrapping to
-.Do CommandLine2
-.SetVar CommandLine2 a new line.
+.SetVar CommandLine2 The maximum width of text to be output on each line before wrapping to a new line.
 .Do CommandLine2
 .SetVar CommandLine1 CmdGroup
 .SetVar CommandLine2 The name of a command group (macro) to be run prior to the output of 
@@ -34,19 +34,42 @@
 .SetVar CommandSubHeading Other
 .Do CommandSubHeading
 
-.SetVar LongText The variable _LastResult is always set to '1'. \n\nThe variable _CurrentX is set to the starting left position
-.SetVar LongText %LongText% of the text plus the maximum width of the text plus the value of the current horizontal spacing variable, _SpaceHoz.
-.SetVar LongText %LongText% \n\nThe variable _CurrentY is incremented by the height plus the value of the current vertical
-.SetVar LongText %LongText% spacing variable, _SpaceVert, for each line written. \n\nThe variable _LastObjectHeight is
-.SetVar LongText %LongText% updated to reflect the height of the text just output. \n\nThe variable _LastObjectWidth is set
-.SetVar LongText %LongText% to the value of the MaxWidth parameter.
-.DrawTextWrapped 0 %_CurrentY% %_PageWidth% CommandCheckPage %LongText%
+.SetVar text Variable _LastResult is set to '0' if the position falls outside of the 
+.SetVar text %text% page margins, or the box area would not fit within the 
+.SetVar text %text% page margins, otherwise it is set to '1'.
+.DrawTextWrapped 0 %_CurrentY% %_PageWidth% CommandCheckPage %text%
+.incCurrentY %halfLineGap%
+.SetVar text The variable _CurrentX is set to the starting left position of the text plus
+.SetVar text %text% the maximum width of the text plus the value of the current horizontal spacing variable, _SpaceHoz.
+.DrawTextWrapped 0 %_CurrentY% %_PageWidth% CommandCheckPage %text%
+.incCurrentY %halfLineGap%
+.SetVar text The variable _CurrentY is incremented by the height plus the value of the current vertical
+.SetVar text %text% spacing variable, _SpaceVert, for each line written.
+.DrawTextWrapped 0 %_CurrentY% %_PageWidth% CommandCheckPage %text%
+.incCurrentY %halfLineGap%
+.SetVar text The variable _LastObjectHeight is updated to reflect the height of the text just output.
+.DrawTextWrapped 0 %_CurrentY% %_PageWidth% CommandCheckPage %text%
+
+.incCurrentY %halfLineGap%
+.SetVar text The variable _LastObjectWidth is set to the value of the MaxWidth parameter.
+.DrawTextWrapped 0 %_CurrentY% %_PageWidth% CommandCheckPage %text%
+
+.incCurrentY %halfLineGap%
+.SetVar text If a command group is specified it should check that there is sufficient space to draw each line of text,
+.SetVar text %text% otherwise any text that would extend beyond the bottom page margin will not be drawn.
+.DrawTextWrapped 0 %_CurrentY% %_PageWidth% CommandCheckPage %text%
 
-.SetVar CommandSubHeading Example
+.incCurrentY %halfLineGap%
+.SetVar text If '*None' is provided for the command group, a check is made before drawing each line of text
+.SetVar text %text% that there is sufficient space on the page. If there is not space, a new page is added to the
+.SetVar text %text% document before drawing the line of text.
+.DrawTextWrapped 0 %_CurrentY% %_PageWidth% CommandCheckPage %text%
+
+.SetVar CommandSubHeading Examples
 .Do CommandSubHeading
-.SetVar LongText Output some text contained in the variable 'myLongText', over one or more lines starting from the left margin
-.SetVar LongText %LongText% at the current vertical position on the page. Command group 'CheckPage' is run to check for page overflow.
-.DrawTextWrapped 0 %_CurrentY% %_PageWidth% CommandCheckPage %LongText%
+.SetVar text Output some text contained in the variable 'myLongText', over one or more lines starting from the left margin
+.SetVar text %text% at the current vertical position on the page. Command group 'CheckPage' is run to check for page overflow.
+.DrawTextWrapped 0 %_CurrentY% %_PageWidth% CommandCheckPage %text%
 .incCurrentY %halfLineGap%
 .SetVar CommandLine1 .DrawTextWrapped  0  %%%%_CurrentY%%%%  %%%%_PageWidth%%%%  CheckPage  %%%%myLongText%%%%
 .Do CommandLine2