[kde-doc-english] Fwd: Find/Replace dialog documentation

[Brad Hards]

This appears to be blocked - I've dropped the images.

Do you want me to mark it up?

Brad

----------  Forwarded Message  ----------

Subject: Find/Replace dialog documentation
Date: Mon, 25 Oct 2004 17:57 pm
From: Anders Lund <anders at alweb.dk>
To: "KDE Documentation Team" <kde-doc-english at kde.org>
Cc: Brad Hards <bradh at frogmouth.net>

Hi,
I was asked to send you a brief documentation of the Find and Replace dialogs
in KDE. I hope the attached is sufficeent.

-anders

On Sunday 24 October 2004 23:11, Brad Hards wrote:
> On Mon, 25 Oct 2004 07:01 am, Anders Lund wrote:
> > Yes, I'd like to do that. A Section, or chapter? or...?
>
> Just write the text (and a screenshot or two if required) in plain ASCII,
> and send it to the documentation team (kde-doc-english at kde.org). No need to
> do markup or anything like that.
>
> Brad

--
Hjælp verden -- tænk, tal og stem IMOD Bush ved det amerikanske valg
Help the world -- think, speak and vote AGAINST Bush at the american election

-------------------------------------------------------
-------------- next part --------------
The KDE Find and Replace Dialogs

The KDE Find and Replace dialogs are shared by many applications in KDE and utilizes searching and replacing text in a document.

The Find Dialog

To use the Find dialog, enter a phrase to search for in the "Text to find" entry, or select aprevious phrase from the dropdown list.
If you check the "Regular Expression", checkbox the phrase is used as a regular expression pattern, and regular expression search performed.
You can edit the expression in a graphical editor by pressing the "Edit" button next to the checkbox.

Search Options

Case Sensitive: Perform a case sensitive search. This means that the phrase 'Free' will match 'Free' but not 'FREE', 'free' or 'fREe'.
Find Backwards: Searchin the opposite direction, for example from the end of the text towards the beginning.
Whole Words Only: Both ends of the match must be at word boundaries. For example the phrase 'chair' will not match against 'armchair' or 'chairman', only 'chair'.
Selected Text: Search only within the current selection of your document.
From Cursor: Start the search at the insertion cursor, as opposed to the start/end of the document.

The Replace Dialog

The Replace dialog adds a entry for a replacement string. You can enter a string, or select a previous one from the dropdown list.
When using Regular Expression search, you get the option to "Use Placeholders". This allows you to use pieces of the text matching the regular expression in the replacement string. To capture a piece of the match, put parentheses around the part of the regular expression. To use a captured text, enter '\N' where N is the index of the capture, ie. the text captured by the first set of parentheses is '\1' and so on. Example: the Regular expression 'Firstname: (\w+)' when matched against the text "Firstname: Anders" will capture 'Anders' in the first capture.
When "Use Placeholders" is enabled, pressing the "Insert Placeholder" button will bring up a list of captures currently in the expression, identified by index.

Replace Options

Prompt on replace: Ask wether to replace for each match found.
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 189 bytes
Desc: not available
Url : http://mail.kde.org/pipermail/kde-doc-english/attachments/20041027/a673073b/attachment.sig