IronPort-PHdr: =?us-ascii?q?9a23=3Asn7wOh3u0m8gZ7EusmDT+zVfTzU7u7jyIg8e44?=
               =?us-ascii?q?YmjLQLSKm44pD+JxWBvqd3gVvATN+d9vRFzurbsqztXWYN+5nHvH1ROIdUWU?=
               =?us-ascii?q?ojjsMb1xclHNbDEVfyeffodyUgB8BFWXdq+ni6NQ5eH8OtL0bKrCiK5CUJUg?=
               =?us-ascii?q?76KRIzI+30HoDIiMHi3uKq8ofIZwJFrDW4aLJ2ah6xqFaZrdEY1K1lLKt50R?=
               =?us-ascii?q?7Vuj1IduBRkHtvPk6Wlg3g692Y+Zdi92FItatk+ZcfDeP1eKM3SbEeBzMjaj?=
               =?us-ascii?q?pn3sDguBjdQAfK3UMyCT1PwDxPBQWNrAv3Wp7g6G3nsOs42CSbMcDyR70uVn?=
               =?us-ascii?q?Ku4vUjThigkyoBOzMjlQOfwsVtkKJWpg6grB1j0sbVZo+SLv93YqLae5sTW2?=
               =?us-ascii?q?NAWs9bUyEJDJm7asMDCO8IPOAQqIeYxRNGpBmmDBO3AOTi4jBNj37ym6Y91q?=
               =?us-ascii?q?VpEA3L2hAhA8NbqG7d/53+MKYfV/zwzbGdl22SKaMLn22ksM6RLUxyxJPEFa?=
               =?us-ascii?q?h9esfQ10Q1QhnIilyB88r4OTLQ1ukMv2Wf5ed6WqSjhj1CyUk5rz6xy8Mrko?=
               =?us-ascii?q?SMiJgSzwWO/CdhyZwuIdq1YEF+aN+gVpBXsmvJUuk+CtNnWGxutCsgn/cPu4?=
               =?us-ascii?q?ayZjMOz5kPyBvWavjBeI+NqEGrRKOaJjF2g2hgcbS0ikOp8ESu/eb7U9G9zF?=
               =?us-ascii?q?dAqiccyIv2u3sA1gLe5o28ctUgrhrz4T+UzEiT8OxAKFFu07fdKtshz788m5?=
               =?us-ascii?q?4ZvF7MWCP7yg36i6qfd0Ns/ebNiayva7f+r4WHM4h5og77O6Uq3Me4BKw0Px?=
               =?us-ascii?q?MPUG6S5emnnOe7rAupHfMQ16Vwy/aF+JnBbdwWvKu4HxNY3uNBo16kAjGq3c?=
               =?us-ascii?q?5Z1XgLIVRZeQ6W2o3gOlXAOvf9Xr+0h1WhlisuxuiTZOWwRMWQaCKayPG4Iu?=
               =?us-ascii?q?oujiwUgBA+xt1e+Z9OX6sMJPviAAnsst2dDhI4PwGwyev9B5Nx29B7OyrHD6?=
               =?us-ascii?q?mHPafVqVLN6PgoJrzGbY0NsSzmL/8oz/HrhH4931QaeOP6uPlfIGD9BflgL0?=
               =?us-ascii?q?iDNDDlgM8IC3wOuQcWQ+njiVnEWjlWLSXXPep09nQwD4SoCp3GT4amjema3S?=
               =?us-ascii?q?u1KZZRY3hPFlGGFXq7P5XBQfoHbzieZ9NwijFRH6b0UJcvjFv90W2yg6oiNO?=
               =?us-ascii?q?ff/TcU8I7uxMQgrfOGjgk8rHR1F5jPiDzLFjAs2DlUGHlum/oj6U1llgXdje?=
               =?us-ascii?q?4i2KceTIILoasOC1ZfV9aUzvQmWY6sHFuZJJHRDg7hGI3uACltHIxvhYVSMg?=
               =?us-ascii?q?AtQ5P6yUqblyuyX+1KzfrSWNpto/iahz+od6Mfgz7HzPVz0AVgG5ESczXg3u?=
               =?us-ascii?q?kmqUDSH9Kbyh3J0f/1KuJMmnaKrj7LzHLS7hgHC0gpAPmDBTZHIRKIyLaxrk?=
               =?us-ascii?q?LaE+30UeVhYlYHkJTSbPMNM4KhjE0aFq26ZpKDMyToyj32XVHRl/uNdNa4IT?=
               =?us-ascii?q?xDmn+GWQ5fyUZLui/XUGp2TjGop2aUVWY8L1/kbkLy/OU7k0uVFRRrnSeNaU?=
               =?us-ascii?q?Apl6C4/hcE37qBTfJW3r8FtColoThuExCx0oCeDd3IvAdncKhGBLF1qF5ayW?=
               =?us-ascii?q?LUsRB8NZ28PuhjgFAZaQF+o0Lp0V1+FIxBlcEgqH5iwhB1LOqU11ZIdjXQ2p?=
               =?us-ascii?q?6VWPWfMm7p4BWmcLLbwHnb2deSv78BsbE28gq/+g6uEUUm/jNs1NwUm3qQ65?=
               =?us-ascii?q?PWDRYDBJL8VkFkknoy77reYyQ7+8bVzSg2afjy4mKEgYtxQrJ6lkXoZdpUPa?=
               =?us-ascii?q?KaGRWnCcAeDtn0bvEsmh2pYxMIMeRY+bQ7ec+rJJ7kkOamOvhtmDW+gCFJ+o?=
               =?us-ascii?q?d4hwiF9TJ1UPXM2JstzPSR3w/BXDD5xgTE0Ii/icVfaDceE3DqgzDjH5JUb7?=
               =?us-ascii?q?ZucJwjDG6vJ4ivyIw7iceyBzhX81msA15A08isM0n3DRS1zUhb0kIZpmaikC?=
               =?us-ascii?q?2zwmlvkj0nmaGY2TTH3+XocBdeazx7AVJ6hFKpGrCaytUTXUymdQ8szUL36k?=
               =?us-ascii?q?Pzxqwdr6N6fTCKHRV4OhPuJmQnaZOe86KYapcWupwtuCRTFu+7ZALCE+Ovk1?=
               =?us-ascii?q?4hyyrmWlBm6nU7ejWt4MurmhV7jCeFIi82oiOGJYd/whDQ4NGaTvlUjGIL?=
User-Agent: Mozilla/5.0 (Windows NT 6.1; WOW64; rv:60.0) Gecko/20100101
            Thunderbird/60.4.0
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8; format=flowed
Content-Transfer-Encoding: 8bit
Content-Language: en-US
Message-ID:  <536afa93-d39e-8ade-e940-102755737d15@gmail.com>
Date:         Fri, 25 Jan 2019 11:12:06 +1300
Reply-To:     Mailing list for the LaTeX3 project
              <LATEX-L@LISTSERV.UNI-HEIDELBERG.DE>
Sender:       Mailing list for the LaTeX3 project <LATEX-L@LISTSERV.UNI-HEIDELBERG.DE>
From:         Andrew Parsloe <ajparsloe@GMAIL.COM>
Subject: l3draw transformations
To:           LATEX-L@LISTSERV.UNI-HEIDELBERG.DE
Precedence: list
Envelope-To: <rainer.schoepf@gmx.net>
Status: R

Reading through the l3draw documentation various matters came to mind:

Section 1.9 of l3draw.pdf
Typos
Text: \draw_transform_matrix:nnnnn
       has a fifth "n"
Margin: \draw_transform_xscale:n
       the second occurrence should be \draw_transform_yscale:n and not 
greyed out.
Text: \draw_transform_shift:n
       \draw_transform_xshift:n
      delete \draw_transform_shift:n
Margin: \draw_transform_matrix_reset
       needs a concluding colon

Clarification
Perhaps there should be a mention under 
\draw_transform_matrix_concat:nnnn that concatenating means matrix 
multiplication from the left.

Naming
There is \draw_transform_matrix_concat:nnnn and 
\draw_transform_shift_concat:n. The rotate, scale, shift and slant 
transforms are also concatenations but not so named (lack the _concat). 
I wonder if a better naming scheme might be to drop the _concat from 
\draw_transform_matrix_concat:nnnn and \draw_transform_shift_concat:n, 
thus treating all the concatenating transforms similarly, and rename the 
functions currently called \draw_transform_matrix:nnnn and 
\draw_transform_shift:n to something else, perhaps 
\draw_transform_matrix_set:nnnn and \draw_transform_shift_set:n?

Comma lists?
Was consideration given to using a comma list instead of four separate 
braced arguments for \draw_transform_matrix:nnnn? {a}{b}{c}{d} needs 
four brace pairs, {a,b,c,d} needs only one. I have a standard US 
keyboard (at least I think it is). The { and } characters require the 
shift key and a (small) stretch of the little finger to type; commas on 
the other hand are easy, no stretch, no shift key. Comma lists are 
widely used elsewhere in l3draw for specifying coordinate pairs, e.g. 
\draw_path_moveto:n { 1cm , 0cm }. Even {a,b}{c,d} would be better -- 
and helpful in separating the rows of the matrix.

Andrew


---
This email has been checked for viruses by Avast antivirus software.
https://www.avast.com/antivirus