#LyX 1.5.0svn created this file. For more info see http://www.lyx.org/ \lyxformat 276 \begin_document \begin_header \textclass article \language english \inputencoding auto \font_roman default \font_sans default \font_typewriter default \font_default_family default \font_sc false \font_osf false \font_sf_scale 100 \font_tt_scale 100 \graphics default \paperfontsize default \papersize default \use_geometry false \use_amsmath 1 \use_esint 1 \cite_engine basic \use_bibtopic false \paperorientation portrait \secnumdepth 3 \tocdepth 3 \paragraph_separation indent \defskip medskip \quotes_language english \papercolumns 1 \papersides 1 \paperpagestyle default \tracking_changes false \output_changes false \author "" \author "" \end_header \begin_body \begin_layout Section Introduction to the find advanced feature \end_layout \begin_layout Standard This is an introduction to the find advanced feature of LyX, that is activated through the [C-S-f] sequence (Ctrl+Shift+f). \end_layout \begin_layout Standard First, leave the ignore format option \series bold checked \series default . \end_layout \begin_layout Enumerate Search for the word \series bold about \series default and see how it is found both in text mode and in math mode, and both in emphasized, bold or normal face, and both in section titles and in standard text. When finished typing the text to find in the \noun on Find... \noun default box, pressing repeatidly \noun on [Enter] \noun default will search for it forward, while pressing \noun on [Shift+Enter] \noun default will search backwards. \end_layout \begin_layout Enumerate Search for some math by typing in the \noun on Find... \noun default box a \begin_inset Formula $x^{2}$ \end_inset in simple math (C-m) mode (you can directly copy it from this text and paste into the \noun on Find... \noun default box), or also something more elaborate like \begin_inset Formula $\frac{gh}{ij}$ \end_inset . See how it is found both when alone and when in subformulas and nested parts of subformulas. \end_layout \begin_layout Standard Now, uncheck the ignore format option. \end_layout \begin_layout Enumerate Search for a plain 'about' word and see how emphasized and boldface instances, as well as the ones in non-standard style, are not found anymore. \end_layout \begin_layout Enumerate Search for \emph on emphasized about \emph default or \series bold boldface about \series default and see how you can find the respective instances with same face only, and within same text style only (e.g. in order to find the words in this paragraph, you need to also add an enumerate style). Note that e.g. emphasized text is found not only when alone, but also when it is in a longer emphasized sentence. \end_layout \begin_layout Enumerate Search for the word 'about' (again plain face) giving it a Section style from the style selection dropdown menu, and see how it is found only within Section titles. Repeat with the word ' \emph on advanced \emph default ' in emphasized face, with \noun on Section \noun default style, and see how its corresponding instance is found. \end_layout \begin_layout Enumerate Search for some math in centered line math (C-S-m) mode, like this \begin_inset Formula \[ x^{2}\] \end_inset and see how only instances of the text within the same kind of environment are found. \end_layout \begin_layout Subsection About using regular expressions in the Find... box \end_layout \begin_layout Standard Now you can try the regular expression based searching facility. Users may arbitrarily insert, within text or math material, regexp-mode insets that allow to enter regular subexpressions. This is done either through \noun on [Insert]->[Regexp] \noun default or by typing [C-S-r]. Characters entered in the \noun on [Find...] \noun default box within regexp insets are matched according to the regular expression matching rules \begin_inset Foot status collapsed \begin_layout Standard but under the constraint that any subexpression must match a well-formed LyX text segment, i.e. when matching LaTeX code, no segments with unbalanced {} braces are allowed to match subexpressions entered by the user. \end_layout \end_inset , while text entered outside regexp insets is matched exactly against the same text in the document. Note that it is allowed to cut and paste regexp-mode insets as usual. In order to try the feature, first leave the ignore format option checked. \end_layout \begin_layout Enumerate Search for the fraction \begin_inset Formula $\frac{\regexp{.*}}{mn}$ \end_inset , where the '.*' on the numerator is the match-everything regular expression that may be added by pressing the \noun on [Match...]->[Anything] \noun default button, or entering the regexp-mode through C-S-r and by typing '.*'. See how all fractions with the specified denominator are found. \end_layout \begin_layout Enumerate Now uncheck the Ignore Format option and search for ' \series bold .* \series default ' in boldface, or ' \emph on .* \emph default ' in emphasized face. See how, respectively, all boldface and all emphasized text is found. \end_layout \begin_layout Enumerate Search for a plain '.*' giving it a Section style, and navigate across section titles (similarly, navigate across enumerated or bulletted lists). \end_layout \begin_layout Enumerate You can use references to subexpressions as usual, enclosing parts of the regex expression within round braces '()', and referring back to them through \backslash 1, \backslash 2, etc... (within either the same or another regexp-mode inset, where a ' \backslash ' symbol is entered by pressing twice the ' \backslash ' key). For example, try searching for ' \begin_inset Formula \regexp{[\^a-z]([a-z]+)} \end_inset \begin_inset Formula \regexp{\backslash1} \end_inset ' in order to find word repetitions, if any. \end_layout \begin_layout Standard What follows is just a set of meaningless formulas and sentences useful for for testing purposes. \end_layout \begin_layout Standard \begin_inset Formula $y+x+X^{2}+\frac{gh}{ij}-1+x_{j}^{i}+y_{jk}^{ip}+i$ \end_inset and \begin_inset Formula $z+x_{j}^{i}.$ \end_inset \end_layout \begin_layout Standard Hi, world ! \emph on what \emph default about your \begin_inset Formula $X+y^{2}+\frac{x+x^{2}+\frac{gh}{ij}}{y^{x+x^{2}}+\frac{kl}{mn}}-about$ \end_inset ? \end_layout \begin_layout Standard \begin_inset Formula \[ X+y^{2}+\frac{x+x^{2}+\frac{gh}{ij}}{y^{x+x^{2}}+\frac{kl}{mn}}-about\] \end_inset Hi, universe ! what \emph on about \emph default my \begin_inset Formula $c+\frac{kl}{mn}+\frac{\sqrt{\frac{gh}{ij}}}{mn}-\frac{1+\sqrt{\frac{about}{mn}}}{mn}+\textrm{about}$ \end_inset ? \end_layout \begin_layout Section Conclusion and future work about the find \emph on advanced \emph default feature \end_layout \begin_layout Standard This feature seems very useful to me. Hope others will find it useful as well. Currently, I'm not really happy with the implementation, because it has at least quadratic complexity (document size multiplied by maximum paragraph size, plus regexp matching complexity, if enabled, and infact it is quite slow), but hopefully that will be fixable by changing the TeXOnePar() function and simpleTeXOnePar() method, and possibly other TeX related methods. \end_layout \begin_layout Standard Infact, a DocIterator could be used to keep track of the current position, and an externally supplied functor could be called at each position providing the DocIterator and LaTeX string translated so far to the external code. This would allow to couple each DocIterator state with the position in the output LaTeX string, allowing to recover the DocIterator positions after a regexp-based find operation made (only once this time) on translated LaTeX. \end_layout \begin_layout Standard Again, a few meaningless sentences useful for testing purposes on about. \end_layout \begin_layout Standard But \emph on what about your \emph default health ? \end_layout \begin_layout Standard But \series bold what about your health \series default ? \end_layout \begin_layout Itemize search for plain 'about' \end_layout \begin_layout Itemize search for \emph on emphasized about \emph default or \series bold boldface about \end_layout \begin_layout Standard \begin_inset Formula $y+x-x^{2}\cdot2$ \end_inset \end_layout \end_body \end_document