| # XMLmind XML Editor - Online Help |

### 5.2. Open options

Use the native file chooser in preference to the multi-platform file chooser

  If this toggle is checked, the native file chooser will be used in preference to Java's multi-platform file chooser.

  Note that automatically appending the proper extension to the selected save filename (see option "Ensure that a save filename has an extension") is not possible when this option has been turned on.

  Default: checked on the Mac, not checked on Windows, disabled (grayed out) on the other platforms.

When no DTD or schema, guess ignorable white space

  If this toggle is checked, when opening a document not constrained by a DTD or a schema, white space characters are stripped from elements containing child elements separated by white space.

  This heuristic is generally a good one for XML data.

  Default: checked.

When no DTD or schema, simulate a DTD

  If this toggle is checked, a dynamic, non constraining, pseudo DTD is used for documents not conforming to a DTD or schema.

  The pseudo DTD simply remembers all attributes and child elements added to each element during the editing session. Thanks to this pseudo DTD, the pick lists of the Edit and Attributes tools are always filled with sensible values.

  Default: checked.

Ignore <?xml-stylesheet?>

  If this toggle is checked, xml-stylesheet processing instructions specifying which style sheets to use for the newly loaded document are ignored. If the XXE configuration associated to the newly loaded document specifies CSS style sheets, these style sheets are used instead.

  Using this option is useful if `<?xml-stylesheet?>` specifies a style sheet for use by a Web browser such as Mozilla and not a style sheet for use by XXE.

  Default: not checked.

Inform about non-editable document parts

  If this toggle is checked and if the document being opened is modular (that is, contains references to nodes coming from other documents), XXE display a dialog box informing the user that included nodes have been marked as non-editable.

  Default: checked.

Lock documents stored on the local filesystem

  If this toggle is checked, the file containing the document being opened in the editor is automatically locked using an advisory, application-level, lock.

  In practice, this means that:

  - Applications other XXE can open and modify the document being edited in an instance of XXE.

  - If you try to open in XXE a document being edited in another instance of XXE (run by you or by one of your coworkers), XXE will inform you that the file is locked and will tell you who is locking it. After that you'll be able to open the document but, if you modify it, you'll have to save it to another location.

  Caveat: In order to use this facility, you and all your coworkers possibly editing the same files, need to turn this option on. If one of your coworkers forgets to do it, XXE will not be able to detect that the file being opened is locked, and in such case, your coworker may overwrite a document being edited by another person.

  ### How to forcibly remove a lock

  A lock is implemented by the means of a hidden text file containing information about who has locked the corresponding document.

  On Windows, the lock file corresponding to document `C:\doc\doc.xml` is `C:\doc\doc.xml.LOCK` (with the hidden attribute set on this file).

  On the other platforms, the lock file corresponding to document `/home/john/doc/doc.xml` is `/home/john/doc/.doc.xml.LOCK`.

  Manually deleting the lock file forcibly removes the lock set on the corresponding document. Note that it is harmless to delete such lock files and this, at any time.

  Default: not checked.

When possible, lock documents stored on remote filesystems

  Unlike the above toggle, this form applies only to files stored on filesystems other than the local one (WebDAV, FTP, Zip, etc).

  Preferred lock mode

    Specifies the type of lock used for the document being edited, when the underlying document store supports locking. Currently, only WebDAV supports document locking.

    Note that the mode specified here is just a wish. XXE will adapt the lock mode to what is actually supported by the underlying document store. For example, if the Shared mode has been chosen by the user and the underlying document store only supports Exclusive locking, the document being edited will be locked using an Exclusive lock.

    Default: Exclusive

  Identifier as a lock owner

    Specifies a free form string identifying you as the person locking a document. This string is presented to other users wishing to know who is locking a document. It is recommended to specify your email address (example: `jdoe@acme.com`).

    Default: empty string which implies `user_name`@`host_name` (example: `jdoe`@fast.acme.com)

    Table 9.1. Lock Types

    Lock type | Description
    --- | ---
    None | The document being edited in not locked.
    Shared | The document being edited is locked using a shared lock. A shared lock does not prevent you from overwriting a document shared-locked by another author but a least, you are informed that the document is being ``used'' by this other author. (In such case, you'll generally want to contact him to decide what to do.)
    Exclusive | The document being edited is locked using an exclusive lock. An exclusive lock prevents you from overwriting a document exclusively-locked by another author.

#### 5.2.1. Document Set options

You may need to enable this group of options by checking "Enable the 'File|Document Set' Submenu" in Options → Preferences, General|Features section.

The following options specify which actions are to be automatically performed by XXE after a document set is opened using File → Document Set → Open Document Set and/or after a document set is explicitly refreshed using Refresh.

Automatically update all inclusions in member documents

  Turning on this option is useful only if your DITA topics make use of attribute `conkeyref`.

  Default: not checked.

Automatically redraw member documents

  Turning on this option is useful only if your DITA topics make use of attribute `keyref` and when some of the `keyref`s point to image files.

  Default: not checked.

Automatically validate member documents

  Turning on this option is generally recommended.

  Default: checked.