User Guide Version: 2020.
User Guide Version 2020.1 Last Revision: 2021-06-03 Objectif Lune, Inc. 2030 Pie-IX, Suite 500 Montréal, QC, Canada, H1V 2C8 +1 (514) 875-5863 www.objectiflune.com All trademarks displayed are the property of their respective owners. © Objectif Lune, Inc. 1994-2021. All rights reserved. No part of this documentation may be reproduced, transmitted or distributed outside of Objectif Lune Inc. by any means whatsoever without the express written permission of Objectif Lune Inc. Objectif Lune Inc.
Table of Contents Table of Contents 4 Welcome to PrintShop Mail Connect 2020.
Project Wizards preferences Save preferences Scripting preferences Engines preferences Parallel Processing preferences Known Issues Issues running Connect on Hyper-V 9.0 The Update Client OL for Connect 2019.
Email templates Email header settings Email attachments Content elements Element types Editing HTML Attributes Inserting an element Selecting an element Deleting an element Styling and formatting an element Barcode Boxes Business graphics Date Hyperlink and mailto link Images Table Text and special characters Snippets Adding a snippet to the Resources Adding a snippet to a section Creating a snippet Editing a snippet Renaming a snippet Translating a snippet Styling and formatting Local formatting versus sty
Colors Fonts Locale Spacing Personalizing content Variable data Conditional content Dynamic images and Print section backgrounds Snippets Scripts Loading data Variable Data Formatting variable data Showing content conditionally Conditional Print sections Dynamic images Dynamic Print section backgrounds Preferences Clean-up Service preferences Database Connection preferences Editing preferences Email preferences Emmet preferences Engines preferences Hardware for Digital Signing preferences Language preferenc
Managing scripts Testing scripts Optimizing scripts The script flow: when scripts run Selectors in Connect Loading a snippet via a script Loading content using a server's API Using scripts in Dynamic Tables Control Scripts Post Pagination Scripts Translating templates Translating a template Tagging elements for translation Pluralization Exporting and importing translation files Designer User Interface Dialogs Keyboard shortcuts Menus Panes Toolbars Welcome Screen Print options Job Creation Presets Wizard Ou
Print using Advanced Printer Wizard Adding print output Models to the Print Wizard Splitting printing into more than one file Print output variables Generating Email output Before generating Email output Testing Email output Aborting content creation Using an ESP with PrintShop Mail Connect Optimizing a template Scripts Images Print Manager 939 940 941 943 952 952 954 955 956 961 962 962 964 Print Manager Introduction Video Print Manager usage Print Manager Interface Menu options Printers pane Printer Que
Backup before Upgrading Overview OL Connect 2019.2 Enhancements Connect 2019.2 Designer Improvements Connect 2019.2 Output Improvements Print Manager Improvements Known Issues License Update Required for Upgrade to Connect 2019.1 Overview OL Connect 2019.1 Enhancements Connect 2019.1 Designer Updates Connect 2019.1 Output updates Print Wizard and Preset Wizard Improvements Known Issues Overview Connect 2018.2.1 Enhancements/Fixes Connect 2018.2 Enhancements Connect 2018.2 Designer Updates Connect 2018.
Connect 1.8 Designer Enhancements and Fixes Connect 1.8 Output Enhancements and Fixes Connect 1.8 Print Manager Enhancements and Fixes Known Issues Overview Connect 1.7.1 General Enhancements and Fixes Connect 1.7.1 Designer Enhancements and Fixes Connect 1.7.1 Output Enhancements and Fixes Known Issues Overview Connect 1.6.1 General Enhancements and Fixes Connect 1.6.1 Designer Enhancements and Fixes Connect 1.6.1 Output Enhancements and Fixes Known Issues Overview Connect 1.
Welcome to PrintShop Mail Connect 2020.1 Note Since we are always looking for new ways to make your life easier, we welcome your questions and comments about our products and documentation. Use the feedback tool at the bottom of the page or shoot us an email at doc@ca.objectiflune.com. PrintShop Mail Connect is a tool designed to optimize customer communications. It is designed to improve the creation, distribution, interaction and maintenance of your communications.
Setup And Configuration This chapter describes the PrintShop Mail Connect installation and the different considerations that are important in regards to the installation and use of PrintShop Mail Connect. l "System and Hardware Considerations" below l "Installation and Activation" on page 29 l "Known Issues" on page 88 l "Engines preferences" on page 82 System and Hardware Considerations There are a variety of considerations to be aware of.
Directories and folders All Connect applications are installed under an arbitrarily selectable main folder. If the default installation folder options were used, this installation folder would be %PROGRAMFILES%\Objectif Lune\OL Connect. The installation folder will hold all the executable files and other files and folders required for the operation of the whole product suite. All these files and folders remain static after installation.
the whole system at all. However the responsible person for the computer protection has to decide about the monitoring of such temporary folders following the company guidelines. Database 2 Another database instance for Connect will be hold and used under the folder, which is intended to hold data, accessible by and for all users. The path to this folder is stored in the standardized system variable %PROGRAMDATA%. The Connect database instance is located in the subfolder "Connect\MySQL".
Installing / Updating Connect using an existing MySQL instance If MySQL Server is already present and you wish to use it, the following should be taken into consideration: l l l l l The minimum supported MySQL version is MySQL 5.6. The MySQL account must have access to all permissions using the GRANT Command, including creating databases. The database configuration must include the options detailed in the "Using the MySQL Instance from the Installer" on the previous page topic above.
Warning If you chose not to install the supplied MySQL database, and instead opt for using a preexisting (External) database then you yourself must ensure that the External database is accessible to Connect. Objectif Lune Inc. will take no responsibility for setting up database connections to any but the supplied MySQL database. Note Since PrintShop Mail Connect version 1.6 the minimum required version of the MS SQL Server is SQL Server 2012.
MS SQL Server, the user has to switch to "Microsoft SQL Server" type and enter connection details again. When modifying Connect l l If local MySQL is removed from an installation, the Database Configuration page will offer additionally the Microsoft SQL Server database type with respective default values. If local MySQL is added to an installation, the usual MySQL Configuration page with default values will be displayed.
Warning If a Connect 1.5 user wants to use Microsoft SQL instead of MySQL for the Connect Server, there are several points to be taken care of. These are: l l If a MySQL instance exists which could be used intermediately, then this should be selected during the setup. This ensures, that nothing gets installed. Otherwise the supplied MySQL needs to be installed and the switch to Microsoft SQL needs to be done as outlined above.
Environment considerations Terminal Server/Service Support PrintShop Mail Connect does not support Terminal Server (or Terminal Service) environment as possible under Windows 2000, 2003 and 2008. This is to say, if Terminal Service is installed on the server where PrintShop Mail Connect is located, unexpected behaviours may occur and will not be supported by Objectif Lune Inc.. Furthermore, using PrintShop Mail Connect in a Terminal Service environment is an infringement of our End-User License Agreement.
Note While some virtual machine environments (from VMWare and Microsoft) are supported, other virtual environments (such as Parallels, Xen and others) are not supported at this time. Remote Desktop Support Tests have demonstrated that PrintShop Mail Connect can be used through Remote Desktop. It is however possible that certain combination of OS could cause issues. If problems are encountered, please contact OL Support and we will investigate. PrintShop Mail Connect 1.
l Try the installation again. l Once complete, you may re-enable the service and start it. Commandline switches and .ini entries PrintShop Mail Connect is intended to work stably and reliably, based on Java and the Eclipse framework. To ensure this reliability and robustness, many Java and Eclipse parameters have been tested and tuned, which is reflected in the respective .ini entries and the used command line switches.
The default language is English. The PrintShop Mail Connect help system (this document) is currently only available in English. l Encoding: l Issues can sometimes be encountered in menus and templates when running PrintShop Mail Connect on a non-English operating system. These are due to encoding issues and will be addressed in a later release.
Listens on port Destination # port # NodeJS HTTPS Server 8443 25, or 587 SMTP Input when plugin encryption is enabled Email Input plugin Secure Email Input plugin Send Email plugin Secure Email Output plugin LPR LPD 515 Telnet 9100 FTP Input/Output MySQL 3306 Microsoft 1433 SQL Server HyperSQL 9001 Type Comment TCP TCP 110 TCP 993 TCP 25 TCP 587 TCP 515 TCP TCP TCP 21 TCP Default POP3 port Default SMTP port TCP+UDP TCP+UDP TCP l Port numbers in bold type are user configurable.
The ports used by the HTTP Client Input task, Legacy SOAP Client and SOAP Client plugin depend on the configured URL. Performance Considerations This page is a guide to getting the most performance out of PrintShop Mail Connect as well as a rough guideline to indicate when it's best to upgrade. Performance analysis details In PrintShop Mail Connect, after each print job, a message dialog displays a print job summary (see "Print Job Summary dialog" on page 495).
Template optimization When you find that the speed per Merge engine - the Content Creation speed - is low, optimizing a template can make a huge difference. For advice on how to optimize a template see: "Optimizing a template" on page 961. Network and internet connections Use a fast network and internet connection or avoid loading external or internet resources. Using images, JavaScript or CSS resources located on a slow network or on a slow internet connection will obviously lead to a loss of speed.
machine, this is usually easy. When running on a physical machine, it means that you may have to switch hardware. l For both virtual and non-virtual environments, make sure the machine is not busy with all kinds of other processes. System requirements These are the system requirements for PrintShop Mail Connect 2020.
specification is unlikely to produce the performance you expect from the system. It can be used when configuring a trial or a development system, however. l File system: NTFS (FAT32 is not supported) l CPU: multi-core l RAM: 6GB l Disk Space: 4GB for the software modules, 5GB for work files* * This depends on the amount of data you process through OL Connect. For instance, a PostScript file containing several thousands of documents could easily take up several GBs.
module. When installing on multiple PCs, keep the following rules of thumb in mind: l l l l The Connect Workflow module requires less RAM but fast hard drive access. It also benefits from fast multi-core CPUs, in order to run processes in parallel. The Connect Server module requires more RAM and benefits from fast multi-core CPUs. Disk access speed is less of a concern. The Connect Designer module requires more RAM and fast disk access to provide a responsive user-experience.
Note A PDF version of this guide is available for use in offline installations. Click here to download it. Where to obtain the installer The installer for PrintShop Mail Connect 2020.1 can be obtained on DVD or downloaded as follows: l l If you are a Customer, the installer can be downloaded from the Objectif Lune Web Activation Manager (https://www.objectiflune.com/webactivationmanager/) or through the OL Update Client if it is activated.
Activation For information on licensing, please see "Activating a License" on page 47. Installation prerequisites l l l l l Make sure your system meets the System requirements. PrintShop Mail Connect Version 2020.1 can be installed under a regular user account with Administrator privileges., see "User accounts and security" below. PrintShop Mail Connect must be installed on an NTFS file system. PrintShop Mail Connect requires Microsoft .NET Framework 4.5 already be installed on the target system.
Installing PrintShop Mail Connect on Machines without Internet Access Installing PrintShop Mail Connect2020.1 in offline mode requires some extra steps. These are listed below. Updating Connect Updating to Connect 2019.1 from earlier Connect version In order to update PrintShop Mail Connect to 2019.1 it is first necessary to update the Connect License. For details on how to upgrade the Connect License offline see the Upgrading Connect on machines with no internet access section in the Update Client 1.2.
Windows certificate validation - Certificate Revocation List retrieval should be switched off For your security Objectif Lune digitally signs all relevant files with our own name and certificate. The integrity of these files is checked at various times by different, context related, methods. One of these checks, done during the installation process, uses the Windows certificate validation check. .
l If an ISO image, you can choose between the following, depending upon your Operating System and the choices available: 1. Burn the ISO image onto a DVD 2. Un-zip the contents to a folder (keeping the internal folder structure intact) 3.
extracted data, and similar. A pre-existing MySQL or Microsoft SQL server (referred to as an external database, in this documentation) could be used instead, for the same purposes. The external database could reside on the same computer or on a separate server. If you wish to make use of an external database, please make sure the MySQL option is not selected. Warning .
l l l Disk space available on drive: Displays the amount of space available for installation on the drive currently in the Installation Path. Recalculate disk space: Click to re-check available disk space. This is useful if space has been made available for the installation while the installer was open. Source repository location: Displays the path where the installation files are located. This can be a local drive, installation media, or a network path.
If the password is subsequently forgotten, then MySQL must be uninstalled and its database deleted from disk before attempting to reinstall. l l Confirm MySQL user 'root' Password: Re-enter to confirm the password. Both passwords must match for installation to continue. TCP/IP Port Number: The port on which MySQL will expect, and respond to, requests. A check is run to confirm whether the specified TCP\IP Port Number is available on the local machine.
l When ready, click the Finish button to close the installation wizard, and initialize the Product Update Manager, if it was selected. The Product Update Manager If the Configure Update Check option has been selected, a message will be displayed after clicking “Finish” in the setup. The message details the information that needs to be sent back to Objectif Lune Inc. in order to determine when/if the software needs updating.
first necessary to update the Connect License. For details on how to upgrade the Connect License see "Users of Connect prior to 2019.1" on page 56 Required and optional properties PrintShop Mail Connect can be installed in a so called "silent mode" to allow an automated setup during a company wide roll-out or comparable situations. The trigger for the Connect Installer to run in silent mode is a text file with the fixed name install.
# Verbose logging logging.verbose = true # Product selection install.product.0 = Connect Designer install.product.1 = Connect Server # Server settings server.runas.username = Localadmin server.runas.password = admin # Database configuration database.type = mysql database.host = 192.168.116.10 database.port = 3308 database.username = root database.password = admin database.schema = my_ol Verbose logging (optional) By default, the Silent Installer will log the same way as the GUI installer.
Note The values of install.product properties must contain the exact product names. Server configuration (required if Server is selected for install) For Server, the following properties need to be provided: server.runas.username = server.runas.password = Server Extension configuration (required if Server Extension is selected for install) For Server Extension, the following properties need to be provided: server.runas.username = server.runas.password = server.
Note The unlocked option should only be used when the database requires an external access. If the Silent Installer runs with the default product selection, MySQL is included, and hence the database.unlocked = true property may be optionally set if MySQL on this machine is intended to serve as the central database also for remote machines. If the Silent Installer runs with the explicit installation of a stand-alone (install.product.0 = Connect Server), the database.unlocked property is irrelevant.
database.schema = (default value is objectiflune, optional) 2b: Configuring an external Microsoft SQL Server database Note Since PrintShop Mail Connect version 1.6 the minimum required version of the MS SQL Server is SQL Server 2012. To configure an external Microsoft SQL Server database, the following properties should be defined: database.type = Microsoft SQL Server (required) database.host = (default value is localhost, otherwise required) database.
repository. 4. As a last resort, the installer will attempt to install from the default Connect Update Site URL. Examples product.repository = http://192.168.79.73/Connect/Version_ 01/repository product.repository = C:\\iso\\2.0.0.39695_unpacked\\repository Locale definition It is possible to define the Locale which affects the installation language and installed locale for Connect products by using the following properties in the install.properties file: user.language user.
Locale selection by defining user.language and user.country If both user.language and user.country are defined in the install.properties file, the combination must match exactly one of the supported locales, otherwise the Installer will exit with an error. For example, user.language = fr and user.country = CA will cause an error since fr-CA is not in the list of supported Locales. Locale selection by defining only user.language If only user.language is defined in the install.
3. Run this command to unpack the contents of the Connect Setup executable (as a sample, we use the PReS Connect brand): PReS_Connect_Setup_x86_64.exe -nr -gm2 -InstallPath=".\\" 4. In the local folder, the repository subfolder should now be located next to the preinstall.exe, installer.exe and other Installer files. 5. Create the install.properties file for silent installation in the local folder. 6. With a batch file calling preinstall.
:err_preinstall echo "Preinstall error - see preinstall_err.log" goto:eof Activating a License PrintShop Mail Connect comes with a30 day trial license period during which time it is not necessary to have a commercial license to run the application. This allows time for reviewing the applications and for organizing a commercial license.
l l l l l l l Expiration Date: Displays the date when the activation will expire, or the current date if the product is not activated. End-User License Agreement - Appears only when loading a license file: l l Serial Number: Displays the trial license serial number or the activation serial number if the product has been activated in the past. License: This box displays the EULA. Please note that this agreement is legally binding. I agree: Select to accept the EULA.
Activating PrintShop Mail Connect To activate PrintShop Mail Connect, simply save the license file somewhere on your computer where you can easily find it, such as on your desktop. You can then load the license by doubleclicking on it, or through the PrintShop Mail Connect Software Activation tool. Activating the PrintShop Mail Connect license requires the user to have local Windows Administration rights.
l "Network Considerations" on page 23 l "Database Considerations" on page 15 l "Environment considerations" on page 20 l "Installation prerequisites" on page 31 l "Antivirus Exclusions" on page 13 Downloading and installing the software In order to migrate to a new workstation, the software must already be installed on the new workstation. Follow the "Installation and Activation" on page 29 guide to download and install the newest version of PrintShop Mail Connect on the new workstation.
l l l OL Connect Print Manager Configuration files (.OL-ipdsprinter): C:\Users\ [UserName]\Connect\workspace\configurations\PrinterConfig OL Printer Definition Files (.OL-printerdef): C:\Users\ [UserName]\Connect\workspace\configurations\PrinterDefinitionCo nfig OMR Marks Configuration Files (.hcf): C:\Users\[UserName]\Connect\workspace\configurations\HCFFiles Where [username] is replaced by the appropriate Windows user name. Tip Actually, the path may not begin with 'C:\Users', as this is language-dep
Image, Fax and Search Modules l l Reconfigure the Image and Fax outputs with the new host information. Import the Search Profile and rebuild the database in order to generate the database structure required by the Workflow. Capture 1. Download the latest version of the Anoto PenDirector. 2. Before installing the PenDirector, make sure the pen’s docking station isn’t plugged into the server. Then install the PenDirector. 3.
l Re-run the OL Connect Send printer driver setup on client system and select the Repair option to point the clients to the new Server URL. Configuring the Connect Engines Any changes made to the Server preferences require the OLConnect_Server service to be restarted to take effect. 1. Stop the OLConnect_Server service from Control Panel > Administrative Tools > Services > OLConnect_Server > Stop. 2.
1. Stop the OLConnect_ServerExtension service from Control Panel > Administrative Tools > Services > OLConnect_ServerExtension > Stop. 2. Open the Server Extension Configuration from: C:\Program Files\Objectif Lune\OL Connect\Connect Server Extension\ServerExtension.exe 3. Click on Database Connection and configure the JDBC Database connection settings so that the hostname points to the new Master Server. 4. Click on Scheduling and type in the location of the new Master Server. 5.
3. Click on Load License File to import the license.OLConnectLicense. 4. Start the Software Activation module on the Extension servers, where applicable. 5. Click on Load License File to import the above same license.OLConnectLicense. 6. Restart the OLConnect_Server service and restart the OLConnectServer_Extension service on the Extension servers, where applicable. 7. The number of Expected Remote Merge and Weaver engines should now be configurable in the Connect Server Configuration module (C:\Program Fil
Upgrading from previous Connect versions Always backup before upgrading It is recommended that you always backup your existing Connect preferences before upgrading to a new version. This will enable you to revert back to the previous version, in a worst case scenario in which the new version introduces issues with your existing production processes. Whilst the probability of such a worst case scenario is remote, it cannot hurt to take some simple precautions, just in case.
Note If an error occurs during uninstallation or after/when re-installing Connect after uninstalling it, please see: Problems during a Connect installation or version upgrade in Connect's Knowledge Base (https://help.objectiflune.com/en/kbconnect/#KB/FAQ/OL%20Connect/KB2002.htm). Backup existing Connect version It is recommended that you always backup your existing Connect preferences before upgrading to a new version.
l C:\Users\ [UserName]\Connect\workspace\Designer\.metadata\.plugins\org.ec lipse.core.runtime\.settings l C:\Users\ [UserName]\Connect\workspace\Server\.metadata\.plugins\org.ecli pse.core.runtime\.settings Where [username] is replaced by the appropriate Windows user name. Tip Actually, the path may not begin with 'C:\Users', as this is language-dependent. On a French system, for example, it would be 'C:\Utilisateurs'.
The General preferences also provides you with buttons to : l l l Reset all Warning Dialogs: This re-enables all warning dialogs that might have been previously disabled by selecting the "Don't show again" checkbox within the dialog. Restore Defaults. This option restores the preferences to Defaults. This applies to the current Preferences page only, but not other Preferences. Apply: This option applies the settings made within the current Preferences page, but does not close the Preferences dialog.
The values below define when the specified targets are to be set as being ready for deletion, not when they are actually deleted. The actual deletion occurs only as per the cron job scheduling; or when PrintShop Mail Connect is started (if Run at application start up is selected); or when the Run Now button is pressed. l l l Enable clean-up service: Check to enable the Clean-up services. When checked, either or both of the Database clean-up and File clean-up services can be set individually.
Tip The default number of threads is considered the best compromise for running both clean-up and production jobs simultaneously. If experience suggests that the clean-up is not running efficiently, then upping the number of threads here would be recommended. Conversely, if production appears to be suffering courtesy of the clean-up process, then reduce the number of threads here.
of the job. l l l l l Minimum time to retain Job Sets: The minimum time a Job Set (and all the jobs information it contains) is retained within the database before being set for deletion. Minimum time to retain Managed Files: The minimum time file references (to files such as data mapping configurations and templates) are retained within the database before being set for deletion.
l Apply: This option applies the settings made within the current Preferences page, but does not close the Preferences dialog. Database Connection preferences Dialog used to change the PrintShop Mail Connect back-end Database. This dialog supports the swapping of the back-end database between various vendor databases. Note, however, that the alternate vendor database(s) must already be installed and available in order to swap to them. This is not a migration tool.
Connect. This should help in determining and refining the acceptable connection options. l l Hostname: Enter the IP Address or alias of the server where database resides. Database Instance Name: Enter an existing Microsoft SQL Server's instance name. This option only applies to existing Microsoft SQL Server instances, and not for MySQL. l Port: Enter Port number. The defaults are those which the vendors use by default. l Schema: The individual database schema, within the vendor database.
Tip Leaving this value set to the default maximum should be the best option in most circumstances. We recommended this entry be left at the default value. l Custom database parameters table: These are extra parameters which are appended to the database connection URL. The default values are those which have been determined to be useful in connecting to specific vendor databases.
l l l Test Connection: This will run a test on the current Database Connection settings. Restore Defaults. This option restores the preferences to Defaults. This applies to the current Preferences page only, but not other Preferences. Apply: This option applies the settings made within the current Preferences page, but does not close the Preferences dialog. Editing preferences These preferences define different editing options in the Designer module.
separate groups of rules have new lines between them. l l l l Compressed: This output style minifies the output. It has no whitespace except that necessary to separate selectors and a new line at the end of the file. It also includes some other minor compressions, such as choosing the smallest representation for colors. It's not meant to be human-readable. Expanded: This is the default output style. Each property and rule take up one line.
l l l l l l l l Resizable Table: This color highlights tables for which the option Allow resizing has been checked when adding the table; see "Table" on page 272. Forms: This color highlights forms; see Forms. Shared Content: This color highlights shared content, such as shared snippets; see "Snippets" on page 279. Guides: This is the color for rulers that can help position content correctly; see "Guides" on page 302.
l l Restore Defaults. This option restores the preferences to Defaults. This applies to the current Preferences page only, but not other Preferences. Apply: This option applies the settings made within the current Preferences page, but does not close the Preferences dialog. Email preferences Email (General) preferences l Default From Group: l l l Name: Enter the name that is set by default in the "From name" field in the Send Email and Send Test Email dialogs ("Send (Test) Email" on page 510).
l l l l l Use authentication: Check if a user name and password are needed to send emails through the host. Start TLS: Enabled if authentication is checked. Sends emails through Transport Layer Security (TLS), which is sometimes referred to as SSL. User: Enter the user name used to connect to the SMTP server. Restore Defaults: There are three default presets, each for working with a different Email Service Provider (ESP): Mandrilapp.
Common Emmet preferences l l l l Expand abbreviations by Tab key: Check to enable the Expand Abbreviation function. ... in files with extension: Enter a comma-separated list of all file extensions in which expand abbreviation will work. Upgrade web editors: This Emmet option doesn't affect how Emmet works in Connect Designer. Extensions Path: Choose a folder where to put json and js files to extend Emmet. This includes custom snippets, preferences and syntax profiles.
l Preview box: Shows what the selected abbreviation is expanded to. l Restore Defaults: clear all custom abbreviations. l To temporarily disable an abbreviation, uncheck the checkbox next to the name of the abbreviation in the list. Emmet Output preferences The Output Preferences dialog is used to control how the expanded (output) code behaves when expanding abbreviations and snippets.
l To temporarily disable a snippet, uncheck the checkbox next to the name of the snippet in the list. Emmet Variables preferences Variables are placeholders used in Emmet snippets to output predefined data. For example, the html:5 snippet of HTML syntax has the following definition: \n...\n
