# <Messages>

The Messages element specifies textual messages for aspects of the document that are not part of the document content itself. Some example messages include messages that provide information about the document such as the author and publisher or messages that provide additional information to the reader of a document when the reader enters an invalid registration code for a document that requires a registration code.

## Full element example

        <Messages>
          <Title>My Document's Full Title Is Written Here</Title>
          <Version>v. 2.1</Version>
          <Copyright>(C) 2003 ACME, Inc.</Copyright>
          <Notes>This document is protected by copyright law.</Notes>
          <AuthorName>Yar Givin</AuthorName>
          <AuthorContact>yar@givin.com</AuthorContact>
          <AuthorNotes>Email me with your comments.</AuthorNotes>
          <PublisherName>Tasteful Publishers, Inc.</PublisherName>
          <PublisherContact>contact@tastefulpublishers.com</PublisherContact>
          <PublisherNotes>Publishers of anything.</PublisherNotes>
          <RegCodePreMsg>This document requires that you enter a registration code.  If you do not have one, please visit http://www.acme.com for more information.</RegCodePreMsg>
          <RegCodeFailedMsg>To purchase this document, please visit:\nhttp://www.acme.com</RegCodeFailedMsg>
          <RegCodeCancelMsg>To purchase this document, please visit:\nhttp://www.acme.com</RegCodeCancelMsg>
          <PasswordPreMsg>This document requires a password.</PasswordPreMsg>
          <PasswordFailedMsg>Note that it is a felony to attempt to access this document without authorization.</PasswordFailedMsg>
          <PasswordCancelMsg>Consult your administrator for more information.</PasswordCancelMsg>
          <ExpiredMsg>This document has expired, please visit http://www.acme.org for an updated version.</ExpiredMsg>
        </Messages>

To specify a line break within a message, use the two character sequence "\n" (e.g., backslash and the letter 'n'). To include the backslash character, use the two character sequence "\\" (e.g., two backslash characters).

## Sub-element summary

Tag | Type | Default | Description
--- | --- | --- | ---
`<Title>` | string | n/a | Formal full title of the document
`<Version>` | string | n/a | Version description of the document
`<Copyright>` | string | n/a | Basic copyright information
`<Notes>` | string | n/a | Additional informational notes about the document
`<AuthorName>` | string | n/a | The document author's name
`<AuthorContact>` | string | n/a | Contact information for the author
`<AuthorNotes>` | string | n/a | Additional notes from or about the author
`<PublisherName>` | string | n/a | The publisher of the document
`<PublisherContact>` | string | n/a | Publisher contact information
`<PublisherNotes>` | string | n/a | Additional notes from or about the publisher
`<RegCodePreMsg>` | string | n/a | Message to display before asking for the registration code
`<RegCodeFailedMsg>` | string | n/a | Message to display when user enters an invalid registration code
`<RegCodeCancelMsg>` | string | n/a | Message to display when user cancels entering of the registration code
`<PasswordPreMsg>` | string | n/a | Message to display before asking for the password
`<PasswordFailedMsg>` | string | n/a | Message to display when user enters an incorrect password
`<PasswordCancelMsg>` | string | n/a | Message to display when user cancels entering of the password
`<ExpiredMsg>` | string | n/a | Message to display for an expired document

## Sub-element descriptions

### <Title>

Description
Use the Title element to provide the formal full title of the document. For documents with long titles, the Title element of the Destination element may not provide enough space, allowing for only 31 characters, enough for a concise title. In such cases, you can provide the formal full title of the document using the Title element of the Messages element. This title displays in the Title section of iSilo™'s Document Information dialog.
Example
This example specifies the title message to be "An Authoritative Guide to the Universe: Galaxies, Solar Systems, and Planets".

      <Title>An Authoritative Guide to the Universe: Galaxies, Solar Systems, and Planets</Title>

### <Version>

Description
Use the Version element to provide a version or revision description for the document. The text is free form, but some possible suggestions are given in the examples. The version message displays in the Title section of iSilo™'s Document Information dialog.
Examples
This example specifies the version message to be "Version 1.1".

      <Version>Version 1.1</Version>

This example specifies the version message to be "3.0 revision B".

      <Version>3.0 revision B</Version>

### <Copyright>

Description
Use the Copyright element to provide a basic copyright message for the document. The copyright message displays in the Title section of iSilo™'s Document Information dialog.
Example
This example specifies the copyright message to be "(C) 1999-2006 Acme Co.".

      <Copyright>(C) 1999-2006 Acme Co.</Copyright>

### <Notes>

Description
Use the Notes element to provide additional simple informational notes for the document. The notes message displays in the Title section of iSilo™'s Document Information dialog.
Example
This example specifies the notes to be "Do not distribute this document.".

      <Notes>Do not distribute this document.</Notes>

### <AuthorName>

Description
Use the AuthorName element to specify the name of the document's author. The author name message displays in the Author section of iSilo™'s Document Information dialog.
Examples
This example specifies the author's name to be "John Doe".

      <AuthorName>John Doe</AuthorName>

### <AuthorContact>

Description
Use the AuthorContact element to provide contact information for the author. The author contact message displays in the Author section of iSilo™'s Document Information dialog.
Example
This example specifies the author's contact information to be "johndoe@acme.org".

      <AuthorContact>johndoe@acme.org</AuthorContact>

### <AuthorNotes>

Description
Use the AuthorNotes element to provide additional notes from or about the author. The author notes message displays in the Author section of iSilo™'s Document Information dialog.
Example
This example specifies the author notes to be "If you would like to provide feedback about this document, please email John Doe.".

      <AuthorNotes>If you would like to provide feedback about this document, please email John Doe.</AuthorNotes>

### <PublisherName>

Description
Use the PublisherName element to specify the name of the document's publisher. The publisher name message displays in the Publisher section of iSilo™'s Document Information dialog.
Example
This example specifies the publisher name for the document to be "Acme Publishing Company".

      <PublisherName>Acme Publishing Company</PublisherName>

### <PublisherContact>

Description
Use the PublisherContact element to provide contact information for the publisher. The publisher contact message displays in the Publisher section of iSilo™'s Document Information dialog.
Example
This example specifies the publisher contact information to be "publishme@acme.org".

      <PublisherContact>publishme@acme.org</PublisherContact>

### <PublisherNotes>

Description
Use the PublisherNotes element to provide additional notes from or about the publisher. The publisher notes message displays in the Publisher section of iSilo™'s Document Information dialog.
Example
This example specifies the publisher notes message to be "Feel feel to distribute this document to anyone and everyone at no charge.".

      <PublisherNotes>Feel feel to distribute this document to anyone and everyone at no charge.</PublisherNotes>

### <RegCodePreMsg>

Description
Use the RegCodePreMsg element to provide the message to display before prompting the user to enter the document registration code. One possible use is to notify the user about the protected status of the document.
Examples
This example specifies the registration code message to be "This document requires that you enter a registration code. If you do not have one, please visit http://www.acme.com for more information.".

      <RegCodePreMsg>This document requires that you enter a registration code.  If you do not have one, please visit http://www.acme.com for more information.</RegCodePreMsg>

### <RegCodeFailedMsg>

Description
Use the RegCodeFailedMsg element to provide the message to display if the user enters an invalid document registration code. One possible use is to inform the user of how and where the user may obtain a registration code.
Examples
This example specifies the registration code failed message to be "To purchase this document, please visit:\nhttp://www.acme.com<".

      <RegCodeFailedMsg>To purchase this document, please visit:\nhttp://www.acme.com</RegCodeFailedMsg>

### <RegCodeCancelMsg>

Description
Use the RegCodeCancelMsg element to provide the message to display if the user cancels entering of the document registration code. One possible use is to inform the user of how and where the user may obtain a registration code.
Examples
This example specifies the registration code cancel message to be "To purchase this document, please visit:\nhttp://www.acme.com".

      <RegCodeCancelMsg>To purchase this document, please visit:\nhttp://www.acme.com</RegCodeCancelMsg>

### <PasswordPreMsg>

Description
Use the PasswordPreMsg element to provide the message to display before prompting the user to enter the document password. One possible use is to notify the user about the protected status of the document.
Examples
This example specifies the password message to be "This document requires a password.".

      <PasswordPreMsg>This document requires a password.</PasswordPreMsg>

### <PasswordFailedMsg>

Description
Use the PasswordFailedMsg element to provide the message to display if the user enters an invalid document password. One possible use is to inform the user of how and where the user may obtain the password.
Examples
This example specifies the password failed title message to be "Note that it is a felony to attempt to access this document without authorization.".

      <PasswordFailedMsg>Note that it is a felony to attempt to access this document without authorization.</PasswordFailedMsg>

### <PasswordCancelMsg>

Description
Use the PasswordCancelMsg element to provide the message to display if the user cancels entering of the document password. One possible use is to inform the user of how and where the user may obtain the password.
Examples
This example specifies the password cancel message to be "Consult your administrator for more information.".

      <PasswordCancelMsg>Consult your administrator for more information.</PasswordCancelMsg>

### <ExpiredMsg>

Description
Use the ExpiredMsg element to provide the message to display when the user attempts to open a document that has expired. If the document is a publication with a renewable subscription, one possible use is to notify the user about how to renew the subscription.
Examples
This example specifies the document expiration message to be "This document has expired, please visit http://www.acme.org for an updated version.".

      <ExpiredMsg>This document has expired, please visit http://www.acme.org for an updated version.</ExpiredMsg>

©1999-2017 DC & Co. All rights reserved.