Ide/IDE Dialogs - Revision history

GalinaTchekmareva at 08:52, 24 May 2013

2013-05-24T08:52:19Z

← Older revision		Revision as of 10:52, 24 May 2013
Line 174:		Line 174:
	:Some regular expressions can match only one substring. That is, a set of strings such regular expression describes has only one member. For example, the regular expression '''foo''' matches only the substring '''foo''' and no others. Other regular expressions can match more than one substring. That is, a set of strings such regular expression describes has more than one member. For example, the regular expression <vp>f</vp> matches the set of strings made up of any number (including zero) of '''f''' characters. Some characters in regular expressions match themselves (such as '''f''') and some do not match to any concrete character (such as <vp></vp>). Characters that do not match themselves are used to specify patterns, which describe sets of different strings.		:Some regular expressions can match only one substring. That is, a set of strings such regular expression describes has only one member. For example, the regular expression '''foo''' matches only the substring '''foo''' and no others. Other regular expressions can match more than one substring. That is, a set of strings such regular expression describes has more than one member. For example, the regular expression <vp>f</vp> matches the set of strings made up of any number (including zero) of '''f''' characters. Some characters in regular expressions match themselves (such as '''f''') and some do not match to any concrete character (such as <vp></vp>). Characters that do not match themselves are used to specify patterns, which describe sets of different strings.
	'''Regular Expression Syntax'''		'''Regular Expression Syntax'''
	See the [pfc\regEx\packRegEx~~.htm regEx]~~ package for more details of regular expression syntax.		:See the pfc\regEx\packRegEx package for more details of regular expression syntax.

	'''Find'''		'''Find'''
	:Press the '''Find''' button to invoke searching of the specified string (regular expression) with the specified options.		:Press the '''Find''' button to invoke searching of the specified string (regular expression) with the specified options.

GalinaTchekmareva at 12:59, 17 May 2013

2013-05-17T12:59:04Z

← Older revision		Revision as of 14:59, 17 May 2013
Line 118:		Line 118:
	:*:Find occurrences of the string as whole words. It only displays instances of the Find what string that are matched in complete words. For example, a search for "my::List" will return "my::List" but not "cmy::List" or "my::Listtt".		:*:Find occurrences of the string as whole words. It only displays instances of the Find what string that are matched in complete words. For example, a search for "my::List" will return "my::List" but not "cmy::List" or "my::Listtt".
	:*'''Use Regular Expressions'''		:*'''Use Regular Expressions'''
	:*:See ~~[Find_Text_in_Files.htm~~ #~~Regular_Expressions2~~ Regular Expressions] for details.		:*:See {{ide\|IDE Dialogs#Regular Expressions\|Regular Expressions}} for details.
	'''Replace'''		'''Replace'''
	:Press the '''Replace''' button to replace the current selection or to invoke searching of the specified string (regular expression) with the specified options if there are no selection.		:Press the '''Replace''' button to replace the current selection or to invoke searching of the specified string (regular expression) with the specified options if there are no selection.

GalinaTchekmareva at 12:52, 17 May 2013

2013-05-17T12:52:17Z

← Older revision		Revision as of 14:52, 17 May 2013
Line 218:		Line 218:
	::Find occurrences of the string as whole words.		::Find occurrences of the string as whole words.
	:'''Use Regular Expressions'''		:'''Use Regular Expressions'''
	::See ~~[Find_Text_in_Files.htm~~ #~~Regular_Expressions2~~ Regular Expressions] for details.		::See {{ide\|IDE Dialogs#Regular Expressions\|Regular Expressions}} for details.
	'''Find'''		'''Find'''
	:Press the '''Find''' button to invoke searching of the specified string (regular expression) with the specified options.		:Press the '''Find''' button to invoke searching of the specified string (regular expression) with the specified options.

SergeMukhin: /* Window Navigation Dialog */

2013-04-26T08:26:27Z

Window Navigation Dialog

← Older revision		Revision as of 10:26, 26 April 2013
Line 239:		Line 239:

	'''Ctrl-Alt''' switches on/off showing only read-write files.		'''Ctrl-Alt''' switches on/off showing only read-write files.

			'''Ctrl-*''' switches on/off alternate filter by letter.

Gukalov: /* Find Text in Files */

2013-04-17T14:21:33Z

Find Text in Files

← Older revision		Revision as of 16:21, 17 April 2013
Line 182:		Line 182:
	'''Help'''		'''Help'''
	:Displays this help topic.		:Displays this help topic.
	~~'''~~Search results~~'''~~
			==== Search results ====

	[[Image:Ide_FindInFilesResults.png]]		[[Image:Ide_FindInFilesResults.png]]

GalinaTchekmareva at 08:33, 17 April 2013

2013-04-17T08:33:28Z

← Older revision		Revision as of 10:33, 17 April 2013
Line 162:		Line 162:
	'''Case Sensitive'''		'''Case Sensitive'''
	:The selected item specifies whether the search should match case of the whole search string ('''Case Sensitive'''), ignore the case ('''Case Insensitive''') or match the case of the first character of the search string ('''Prolog Sensitive'''). The last option is unavailable, when '''Regular Expressions''' option is checked ON.		:The selected item specifies whether the search should match case of the whole search string ('''Case Sensitive'''), ignore the case ('''Case Insensitive''') or match the case of the first character of the search string ('''Prolog Sensitive'''). The last option is unavailable, when '''Regular Expressions''' option is checked ON.
	~~'''~~Regular Expressions~~'''~~
	:Provides possibility to perform advanced string searching operations (searching, matching and replacing) using regular expressions.		==== Regular Expressions ====
	:'''Regular Expressions '''
	::A ''regular expression'' (or pattern) is a text string that describes some (mathematical) group of strings. A string <vp>S</vp> "matches" a regular expression <vp>R</vp> if <vp>S</vp> belongs to the set of strings described by <vp>R</vp>. Using regular expression, you can:		Provides possibility to perform advanced string searching operations (searching, matching and replacing) using regular expressions.
	::* check whether the specified string matches the specified pattern;
	::* search within a string for a substring matching the specified pattern;		'''Regular Expressions '''
	::* perform replacing within matched substrings.		:A ''regular expression'' (or pattern) is a text string that describes some (mathematical) group of strings. A string <vp>S</vp> "matches" a regular expression <vp>R</vp> if <vp>S</vp> belongs to the set of strings described by <vp>R</vp>. Using regular expression, you can:
	::Some regular expressions can match only one substring. That is, a set of strings such regular expression describes has only one member. For example, the regular expression '''foo''' matches only the substring '''foo''' and no others. Other regular expressions can match more than one substring. That is, a set of strings such regular expression describes has more than one member. For example, the regular expression <vp>f</vp> matches the set of strings made up of any number (including zero) of '''f''' characters. Some characters in regular expressions match themselves (such as '''f''') and some do not match to any concrete character (such as <vp></vp>). Characters that do not match themselves are used to specify patterns, which describe sets of different strings.		:* check whether the specified string matches the specified pattern;
	:'''Regular Expression Syntax'''		:* search within a string for a substring matching the specified pattern;
	:See the [pfc\regEx\packRegEx.htm regEx] package for more details of regular expression syntax.		:* perform replacing within matched substrings.
			:Some regular expressions can match only one substring. That is, a set of strings such regular expression describes has only one member. For example, the regular expression '''foo''' matches only the substring '''foo''' and no others. Other regular expressions can match more than one substring. That is, a set of strings such regular expression describes has more than one member. For example, the regular expression <vp>f</vp> matches the set of strings made up of any number (including zero) of '''f''' characters. Some characters in regular expressions match themselves (such as '''f''') and some do not match to any concrete character (such as <vp></vp>). Characters that do not match themselves are used to specify patterns, which describe sets of different strings.
			'''Regular Expression Syntax'''
			See the [pfc\regEx\packRegEx.htm regEx] package for more details of regular expression syntax.

	'''Find'''		'''Find'''

GalinaTchekmareva at 10:22, 8 April 2013

2013-04-08T10:22:24Z

@@ Line 170: / Line 170: @@
 ::* perform replacing within matched substrings.
 ::Some regular expressions can match only one substring. That is, a set of strings such regular expression describes has only one member. For example, the regular expression '''foo''' matches only the substring '''foo''' and no others. Other regular expressions can match more than one substring. That is, a set of strings such regular expression describes has more than one member. For example, the regular expression <vp>f*</vp> matches the set of strings made up of any number (including zero) of '''f''' characters. Some characters in regular expressions match themselves (such as '''f''') and some do not match to any concrete character (such as <vp>*</vp>). Characters that do not match themselves are used to specify patterns, which describe sets of different strings.
-:'''Regular Expression Syntax '''
+:'''Regular Expression Syntax'''
 :See the [pfc\regEx\packRegEx.htm regEx] package for more details of regular expression syntax.
@@ Line 186: / Line 186: @@
 If you double-click any filename, then this file will be opened in the text editor.

GalinaTchekmareva: New page: {{ideNavbar|IDE Dialogs}} === Warning: These files will be overwritten === When you create a new project with the IDE {{ide|Project Settings#General Tab|Project Settings}} facility, you ...

2013-04-04T12:52:03Z

New page: {{ideNavbar|IDE Dialogs}} === Warning: These files will be overwritten === When you create a new project with the IDE {{ide|Project Settings#General Tab|Project Settings}} facility, you ...

New page

{{ideNavbar|IDE Dialogs}}

=== Warning: These files will be overwritten ===

When you create a new project with the IDE {{ide|Project Settings#General Tab|Project Settings}} facility, you can specify the '''Subdirectory''' in which the project will be placed (notice that usually this name is generated automatically from the specified project name). Notice that each project contains several standard files (always automatically generated by the IDE) with standard names. Therefore, if the specified subdirectory name coincides with one in which a previously created project already exists, then these 2 projects should have several standard files with the same names. Because the old versions of these files can be incompatible with the new project, the {{ide|Project Settings#General Tab|Project Settings}} generates the warning dialog with the title:

'''These files will be overwritten:'''

In the central pane of this dialog you see a list of files which should be overwritten.

You can select the following actions:

'''Continue'''

If you select this button, then the old versions of files specified in the list will be overwritten with the new versions.

'''Cancel'''

If you select this button, then no files will be overwritten, the IDE returns into the {{ide|Project Settings#General Tab|Project Settings}} dialog where you can the specify other name in the '''Subdirectory''' control.

=== Resolve Ambiguity ===

This dialog appears when you execute the:

* '''Go to Declaration''' ('''Ctrl+Shift+D'''),
* '''Go to Definition''' ('''Ctrl+Shift+C'''), or
* '''Show Visual Prolog Help''' ('''F1''')

commands and the cursor points onto a "'''''name'''''", which has several versions of the "'''''name'''''" references in the generated {{ide|Code Experts#Source Browser|browse information}} and cannot resolve this ambiguity using all additional information about the "'''''name'''''", which The IDE can gather in the edited file.

Correspondently it have titles:

* '''Resolve Ambiguity of "''name''" Declaration'''
* '''Resolve Ambiguity of "''name''" Definition'''
* '''Choose "''name''" to Show Help Topic'''

These dialogs display lists of references to the "'''''name'''''" with additional information (gathered in the generated by the compiler {{ide|Code Experts#Source Browser|browse information}}, which helps you to resolve ambiguity of the "'''''name'''''".

Names are prefixed with the same {{ide|Project Tree#Icons Used in the Project Window|icons}}, which are used in the Project window.

To continue an initiated command execution you need to select (click) one of displayed lines containing unique references to the "'''''name'''''".

=== Send Bug Report to Support ===

Normally you should use '''Help | Send Bug Report...''' IDE command to send a bug report or feedback. You can also send a mail directly to the '''Visual Prolog Support Service'''.

'''About Visual Prolog Support Service'''

'''Visual Prolog Support''' is responsible for answering questions only about bugs and problems with using of Visual Prolog language, the IDE, and other tools and packages supplied in '''Commercial''' editions of Visual Prolog.

'''Guidelines for preparing Bug Reports to Visual Prolog Support'''
----

'''1. Please check the following information sources before submitting your E-mail:'''

* [http://www.visual-prolog.com/vip6/support/faq.htm Frequently Asked Questions]
* [http://kb.visual-prolog.com Visual Prolog Knowledge Base]

'''2. Please do not ask Visual Prolog Support about general problems like: "Visual Prolog and Fuzzy Logic?"'''

For things please use [http://discuss.visual-prolog.com/ Visual Prolog Discussion Forum], where you are free to discuss any question deals with Visual Prolog. Anybody can read the debate, but you need to register if you want to make postings.

Prolog Development Center will follow and participate as much as possible in the debates. But we cannot make any "answer guarantee"; this is mainly your forum.

This forum will receive all major announcements from Prolog Development Center.

'''3. Your message MUST contain information generated by "Help | Send Bug Report | Show Details" IDE command.'''

This information contains some parameters about your computer and your project that are useful for correct understanding of the problem. It should be copied to the mail.

'''4. How to write a message:'''

*'''To:'''
*:The address of Visual Prolog International Support Group is: '''support@visual-prolog.com'''
*'''Subject:'''
*:Use a short, precise, and relevant Subject (title line). Please, do not use subjects like: '''My 1st problem with Prolog'''
*'''Message Text:'''
*:One problem per message, please.
*:Here you should describe your problem as detailed and precise, as it is possible.
*:Please supply examples of code illustrating your problem.
*:The information supplied in your message should be sufficient to reproduce your problem on our computers.

Please follow the above guidelines when you E-mail Bug Reports to Visual Prolog Support.

Regards

The Visual Prolog International Support Group

support@visual-prolog.com

=== Replace Text ===

Using this dialog you can find and replace each or every occurrence of a text pattern (a string or a regular expression) in the edited file.

'''Text to Find'''
:In the '''Text to Find''' box, type in the search string, or ''regular expression'', or choose a previous string from the drop-down list.
'''New Text'''
:Type the replacement string, or ''regular replacement expression'' in the '''New Text''' box, or choose a previous string from the drop-down list. Notice that ''regular replacement expressions'' have limited syntax regarding to ''regular expressions'' used in the '''Text to Find''' patterns.
'''Origin'''
:Options in the '''Origin''' group box defines the file scope in which the string should be searched.
:*'''Entire Scope'''
:*:Defines that the string should be searched in all file.
:*'''From Cursor'''
:*:Defines that the string should be searched beginning from the current cursor position.
:*'''Selected Text'''
:*:Defines that the string should be searched only in the selected piece of the edited text.
'''Direction'''
:Options in the '''Direction''' group box defines the direction in which the string should be searched.
:*'''Forward'''
:*:Search the document below the insertion point.
:*'''Backward'''
:*:Search the document above the insertion point.
'''Options'''
:In this group box you defines the search options.
:*'''Case Sensitive'''
:*:Find strings having the given pattern of uppercase and lowercase letters.
:*'''Whole Words Only'''
:*:Find occurrences of the string as whole words. It only displays instances of the Find what string that are matched in complete words. For example, a search for "my::List" will return "my::List" but not "cmy::List" or "my::Listtt".
:*'''Use Regular Expressions'''
:*:See [Find_Text_in_Files.htm #Regular_Expressions2 Regular Expressions] for details.
'''Replace'''
:Press the '''Replace''' button to replace the current selection or to invoke searching of the specified string (regular expression) with the specified options if there are no selection.
'''Find Next'''
:Press the '''Find''' button to invoke searching of the next occurrence of the specified string (regular expression) with the specified options.
'''Change All'''
:Press the '''Change All''' button to replace all occurrences of the search text, in the specified scope.
'''Close'''
:Close this dialog.
'''Help'''
:Displays this help topic.

=== Find Text in Files ===

Using this dialog you can find each occurrence of a combination of any characters, including uppercase and lowercase characters, whole words, or parts of words, or regular expressions in the specified group of files.

[[Image:Ide_FindInFiles.png]]

'''Text to Find'''
:In the '''Text to Find''' box, type in the search string, or ''regular expression'', or choose a previous string from the drop-down list.
'''Find in All Opened Editors'''
:Check this option if you wish that the IDE search the specified string only in that text files, which are currently opened in the IDE text editors.
'''Find in Project Files Only'''
:Check this option if you wish that the IDE search the specified string only in text files, which are parts of the project currently loaded into the IDE.
:This button is disabled when the project is not loaded.
'''Show Search Results in New Window'''
:If this option is checked ON, then the IDE will open new '''Search results''' window each time the search is completed, otherwise it will display search results in the same window.
'''In Files:'''
:In this list editor you can specify (or select from the list of previously used) the file mask which will be used to restrict files in which the IDE will search for the string. For example, you can use <vp>*</vp> operator to specify that any sub-string can be used instead of this operator.
:This option is disabled when the '''Find in All Opened Editors''' option is checked ON.
'''In Folder:'''
:In this list editor you can specify (or select from the list of previously used) the folder, which will be used to restrict files in which the IDE will search for the string.
:This option is disabled when the '''Find in All Opened Editors''' option is checked ON.
'''Browse'''
:Press this button to open the '''Set New Directory''' dialog in which you can select the folder, which name will be inserted into the '''In Folder''' field.
:<br/>Notice that when '''Find in Project Files Only''' is checked ON, then this dialog will gives you access only to the folders known to the project.
:This button is disabled when the '''Find in All Opened Editors''' option is checked ON.
'''Search Subfolders'''
:When this option is checked ON (the default), then the IDE will search in all subfolders of the folder specified in the '''In Folder''' field.
:Otherwise, search will be only in the files directly in the folder specified in the '''In Folder''' field.
'''Whole Words Only'''
:Find occurrences of the string as whole words. It only displays instances of the Find what string that are matched in complete words. For example, a search for "my::List" will return "my::List" but not "cmy::List" or "my::Listtt".
'''Case Sensitive'''
:The selected item specifies whether the search should match case of the whole search string ('''Case Sensitive'''), ignore the case ('''Case Insensitive''') or match the case of the first character of the search string ('''Prolog Sensitive'''). The last option is unavailable, when '''Regular Expressions''' option is checked ON.
'''Regular Expressions'''
:Provides possibility to perform advanced string searching operations (searching, matching and replacing) using regular expressions.
:'''Regular Expressions '''
::A ''regular expression'' (or pattern) is a text string that describes some (mathematical) group of strings. A string <vp>S</vp> "matches" a regular expression <vp>R</vp> if <vp>S</vp> belongs to the set of strings described by <vp>R</vp>. Using regular expression, you can:
::* check whether the specified string matches the specified pattern;
::* search within a string for a substring matching the specified pattern;
::* perform replacing within matched substrings.
::Some regular expressions can match only one substring. That is, a set of strings such regular expression describes has only one member. For example, the regular expression '''foo''' matches only the substring '''foo''' and no others. Other regular expressions can match more than one substring. That is, a set of strings such regular expression describes has more than one member. For example, the regular expression <vp>f*</vp> matches the set of strings made up of any number (including zero) of '''f''' characters. Some characters in regular expressions match themselves (such as '''f''') and some do not match to any concrete character (such as <vp>*</vp>). Characters that do not match themselves are used to specify patterns, which describe sets of different strings.
:'''Regular Expression Syntax '''
:See the [pfc\regEx\packRegEx.htm regEx] package for more details of regular expression syntax.

'''Find'''
:Press the '''Find''' button to invoke searching of the specified string (regular expression) with the specified options.
'''Stop'''
:Press the '''Stop''' button to stop searching.
'''Help'''
:Displays this help topic.
'''Search results'''

[[Image:Ide_FindInFilesResults.png]]

This window displays the table which contains the names of files in which the specified string is found, the line number and the position, where the specified text is located and the content of the whole line.

If you double-click any filename, then this file will be opened in the text editor.