1
0
Fork 0
doc/main/editing/man-search-and-replace.en.tm

64 lines
3.1 KiB
Tcl

<TeXmacs|1.0.5.3>
<style|tmdoc>
<\body>
<tmdoc-title|Search and replace>
You can start searching text by pressing <key|C-s> or <menu|Edit|Search>.
During a search, the ``search string'' is displayed at the left hand side
of the footer. Each character you type is appended to this search string
and the next occurrence of it is surrounded by a red box. When pressing
<key|C-s> a second time during a search, the next occurrence is being
searched. A beep indicates that no more occurrences were found in the
document; pressing <key|C-s> will continue the search at the beginning of
your document. You may press <key|backspace> in order to undo key
presses during a search.
Usually, text is being searched for in a forward manner, starting from the
current cursor position. You may also search backwards, using <key|C-r>.
During a search, only text in the same mode and the same language will be
found, as those which are active at the position where you started your
search. In other words, when searching an <with|mode|math|x> in math-mode,
you will not find any x's in the ordinary text. As a current limitation,
the search string can only contain ordinary text and no math-symbols or
more complicated structured text.
A query replace is started by pressing <key|C-=> or <menu|Edit|Replace>.
You are prompted for a string which is to be replaced and the string by
which to replace. At each occurrence of the string to be replaced you are
prompted and you have to choose between replacing the string (y), not
replacing it (n) and replace this and all further occurrences (a). Like in
the case of searching, the query-replace command is mode and language
sensitive.
The current search and replace system is still quite rudimentary in the
sense that it only deals with plain text in a simple way. In the future, we
plan to implement a more powerful search and replace mechanism for
structured text.
For the time being, you may nevertheless search and replace arbitrary
document fragments as follows: somewhere inside your document or another
window, select the fragment you want to search using <menu|Edit|Copy
to|Search>. Next hit <key|C-s> twice or more in order to search all
occurences of this fragment inside your document. Similarly, using
<menu|Edit|Copy to|Replace>, you may select a second fragment by which you
want to replace the first one. In order to start the replacement,
hit<nbsp><key|C-=> and specify the empty string as the arguments for
``<localize|Replace>'' and ``<localize|Replace by>''.
<tmdoc-copyright|1998--2002|Joris van der Hoeven>
<tmdoc-license|Permission is granted to copy, distribute and/or modify this
document under the terms of the GNU Free Documentation License, Version 1.1
or any later version published by the Free Software Foundation; with no
Invariant Sections, with no Front-Cover Texts, and with no Back-Cover
Texts. A copy of the license is included in the section entitled "GNU Free
Documentation License".>
</body>
<\initial>
<\collection>
<associate|language|english>
</collection>
</initial>