Find/Replace Dialog Box — Find/Replace Tab

Used to locate and change strings of text, searching from the current cursor location to the end of the document. Use this dialog box to enter the search criteria and control the scope of the search.

Areas of generated text are not included in the search.

When one of the following conditions apply, inline tags and processing instructions are ignored when matching text:

If a tag starts or ends a line, it is considered a word boundary and also limits a text match. For example, the search text two words would match two <emphasis>words</emphasis>, but would not match the following:

• Find What — searches the document for the text box contents. If you highlight text in the document before selecting Find/Replace, the content of the selection appears in the Find What text box (tags will be included if the Match Markup option is checked). Otherwise, enter the text that you want to locate.

You can also enter regular expressions, which can contain special characters such as wildcards and character classes as part of the search text. Be sure to check Match Patterns if you enter a regular expression.

The table shows some commonly used characters in regular expressions and how to use them in the Find What text box.

Table 28. Common Regular Expressions
Regular Expressions
Character:	Meaning:	Example:	Finds:
. (period)	Each period equals one character.	s.t	sit, sat, set, …
+ (plus)	One or more characters of those specified in square brackets.	s[aeiou]+n	seen, soon, son, …
* (asterisk)	A character can occur zero or more times.	t[a-z]*y	twenty, try, trusty, …
\| (vertical bar)	"Or," which searches for either word.	icon\|tags	icon, tags

• Find Within — limits the search to text content within the specified tag. Click a markup name from the list. For example, you can limit the search to the content in title tag pairs.

If you have applied an alias map to your document, Arbortext Editor will recognize both real names and aliases of elements in the Find Within field.

Even if you have applied an alias map to your document, Arbortext Editor will only recognize the real names of elements, not aliases, in the Replace With field.

If you are finding/replacing with both the Match Markup and Match Patterns options checked, you must take extra steps to include the ampersand (&) in the Replace With field. This is because the ampersand character instructs Arbortext Editor where to include the found text in the replace string (within a regular expression).

For example, to replace the found text with the copyright symbol, the proper Replace With entry would be \©. To replace the found text with the found text followed by the copyright symbol, the proper Replace With entry would be &\©. To replace the found text with the found text, a copyright symbol, and an ampersand itself (&), you would have to use the ampersand's entity name in the replace string: &\©\&.

Replacing tag names will not work on an unbalanced string, that is, a Replace With entry of <para>Beginning of a paragraph is not legal. Also, replacing tag names is not allowed if the matched selection has unbalanced tags.

◦ Match Markup — when checked, the search will include the text for entities and markup tags. If searching for markup tags, make sure to enclose the tag name in angle brackets (for example, <para> or </para>). If searching for entities, make sure to place an ampersand before the entity name, and a semicolon after the entity name (for example, ©). Once checked, this box remains checked by default for future searches.

If you have applied an alias map to your document and select Match Markup, you can use element aliases in the Find What field. However, Arbortext Editor will not recognize real names of elements in the Find What field when an alias map has been applied.

◦ Match Whole Word Only — when checked, finds only the entire word that matches the Find What text. For example, it finds only the and ignores theatre when searching for the. It does not work with regular expressions used in the Find What text box. Once checked, this box remains checked by default for future searches.

◦ Match Case — when checked, makes the search case-sensitive. For example, use it to find only XML in your document, and ignore xml or Xml. Once checked, this box remains checked by default for future searches.

◦ Match Patterns — when checked, treats the Find What text box contents as a regular expression. Once checked, this box remains checked by default for future searches.

• Direction — determines the direction of the search from the current cursor location. Click the desired option button. The Down option is the default.

• Replace — changes Find What text with Replace With text, and searches for the next occurrence.

If the item to be replaced is inside a DMS object that is writable (not read-only or checked out by another user), then the object will be checked out for edit. You will be prompted to confirm the check out.

• Replace All — changes all occurrences of Find What text with Replace With text without prompting at each occurrence.

Arbortext Editor will provide a summary of the replacements that were successful, and those that failed.

You can set the Prompt Before Wrapping on Find in the Warnings category of the Tools > Preferences dialog box. When the search reaches the end of the document, a message box prompts you to continue the search. Click Yes to continue the search from the beginning of the document, or No to cancel the search. Either button closes this message box but leaves the Find/Replace dialog box open.

You can choose to search the contents of file entities in the Edit category of the Tools > Preferences dialog box. Check the box for Search File Entities on Find. The set entityscan advanced preference setting also controls this setting.