Recent changes to HowToSearchHeader

HowToSearchHeader modified by Benoit St-Pierre

Benoit St-Pierre — Tue, 17 Jun 2014 14:42:39 -0000

SearchHeader modified by Benoit St-Pierre

Benoit St-Pierre — Wed, 11 Jun 2014 21:31:43 -0000

--- v3
+++ v4
@@ -28,7 +28,7 @@

 Finally, the Header search can be used to find any text (case-sensitive and without wildcards) in the PGN representation of each game. You may enter up to three text phrases, and they must all appear in a game for it to be a match. 

-This search is very useful for searching in the comments or extra tags of a game (such as lost on time or Annotator), or for a move sequence like Bxh7+ and Kxh7 for a bishop sacrifice on h7 that was accepted. However, this type of search can be very slow since all the games that match other criteria must be decoded and scanned for the text phrases. So it is a good idea to limit these searches as much as possible. Here are some examples. To find games with under-promotions to a rook, search for =R and also set the Promotions flag to Yes. When searching for text that would appear in comments, set the Comments flag to Yes. If you are searching for the moves Bxh7+ and Kxh7, you may want to restrict the search to games with a 1-0 result and at least 40 half-moves, for example, or do a material/pattern search first to find games where a white bishop moves to h7. 
+This search is very useful for searching in the comments or extra tags of a game (such as lost on time or Annotator), or for a move sequence like Bxh7+ and Kxh7 for a bishop sacrifice on h7 that was accepted. However, this type of search can be very slow since all the games that match other criteria must be decoded and scanned for the text phrases. So it is a good idea to limit these searches as much as possible. 

 ##### What about

SearchHeader modified by Benoit St-Pierre

Benoit St-Pierre — Wed, 11 Jun 2014 20:43:11 -0000

--- v2
+++ v3
@@ -1,18 +1,35 @@
-Search: Header
+Clicking on **Search Header** in [TheSearchMenu] invokes [TheSearchHeaderDialog].
+
+This search can be used to find games according to the information contained in the fields of [TheGameHeader] 
+
+The name fields (White, Black, Event, Site and Round)
+
+(such as date, result, names, flags and ratings).
+
+This search does not require any moves to be decoded.

- This search can be used to find aspects of the game that are stored in the header (such as date, result, names, flags and ratings), so it does not require any moves to be decoded. 
+For a game to match a Header search, all fields that you specify must match. 
+
+The name fields (White, Black, Event, Site and Round)
+
+##### Is Search Case Sensitive?

- For a game to match a Header search, all fields that you specify must match. 
+The name fields match on any text inside the name, case-insensitive and ignoring spaces. 
+
+Additionally, an Annotator may be searched case insensitively. Note that this function requires the Annotator header field to be set properly. The checkbox [annotated games only] acts as a logical OR filter for the flags Comments, Variations, Anotations, that is can be used to select only those games that got any type of annotations. 
+
+##### Can I Use Wildcards?

- The name fields (White, Black, Event, Site and Round) match on any text inside the name, case-insensitive and ignoring spaces. 
+You can do case-sensitive wildcard searches for the White, Black, Event, Site and Round fields (with ? representing one character and * representing zero or more characters) by putting the search text in double quotes. For example a search for the site USA will find American cities and also Lausanne SUI, which is probably not what you wanted! A search for the site "*USA" (remember to use the double-quotes) will only match cities in the United States. 

- You can do case-sensitive wildcard searches for the White, Black, Event, Site and Round fields (with ? representing one character and * representing zero or more characters) by putting the search text in double quotes. For example a search for the site USA will find American cities and also Lausanne SUI, which is probably not what you wanted! A search for the site "*USA" (remember to use the double-quotes) will only match cities in the United States. 
+If you are searching for a particular player (or pair of opponents) as White or Black and it does not matter what color they played, select the Ignore Colors option. 
+
+##### Can I Search for Text within the Games? 

- If you are searching for a particular player (or pair of opponents) as White or Black and it does not matter what color they played, select the Ignore Colors option. 
- 
- Additionally, an Annotator may be searched case insensitively. Note that this function requires the Annotator header field to be set properly. The checkbox [annotated games only] acts as a logical OR filter for the flags Comments, Variations, Anotations, that is can be used to select only those games that got any type of annotations. 
- 
- Finally, the Header search can be used to find any text (case-sensitive and without wildcards) in the PGN representation of each game. You may enter up to three text phrases, and they must all appear in a game for it to be a match. This search is very useful for searching in the comments or extra tags of a game (such as lost on time or Annotator), or for a move sequence like Bxh7+ and Kxh7 for a bishop sacrifice on h7 that was accepted. However, this type of search can be very slow since all the games that match other criteria must be decoded and scanned for the text phrases. So it is a good idea to limit these searches as much as possible. Here are some examples. To find games with under-promotions to a rook, search for =R and also set the Promotions flag to Yes. When searching for text that would appear in comments, set the Comments flag to Yes. If you are searching for the moves Bxh7+ and Kxh7, you may want to restrict the search to games with a 1-0 result and at least 40 half-moves, for example, or do a material/pattern search first to find games where a white bishop moves to h7. 
- 
- Note If a search by ECO code is performed, games that have no ECO code attached are ignored. 
- 
+Finally, the Header search can be used to find any text (case-sensitive and without wildcards) in the PGN representation of each game. You may enter up to three text phrases, and they must all appear in a game for it to be a match. 
+
+This search is very useful for searching in the comments or extra tags of a game (such as lost on time or Annotator), or for a move sequence like Bxh7+ and Kxh7 for a bishop sacrifice on h7 that was accepted. However, this type of search can be very slow since all the games that match other criteria must be decoded and scanned for the text phrases. So it is a good idea to limit these searches as much as possible. Here are some examples. To find games with under-promotions to a rook, search for =R and also set the Promotions flag to Yes. When searching for text that would appear in comments, set the Comments flag to Yes. If you are searching for the moves Bxh7+ and Kxh7, you may want to restrict the search to games with a 1-0 result and at least 40 half-moves, for example, or do a material/pattern search first to find games where a white bishop moves to h7. 
+
+##### What about 
+
+Note If a search by ECO code is performed, games that have no ECO code attached are ignored.

SearchHeader modified by Benoit St-Pierre

Benoit St-Pierre — Wed, 11 Jun 2014 19:49:23 -0000

SearchHeader modified by Benoit St-Pierre

Benoit St-Pierre — Tue, 10 Jun 2014 18:07:39 -0000

Search: Header

This search can be used to find aspects of the game that are stored in the header (such as date, result, names, flags and ratings), so it does not require any moves to be decoded.

For a game to match a Header search, all fields that you specify must match.

The name fields (White, Black, Event, Site and Round) match on any text inside the name, case-insensitive and ignoring spaces.

You can do case-sensitive wildcard searches for the White, Black, Event, Site and Round fields (with ? representing one character and * representing zero or more characters) by putting the search text in double quotes. For example a search for the site USA will find American cities and also Lausanne SUI, which is probably not what you wanted! A search for the site "*USA" (remember to use the double-quotes) will only match cities in the United States.

If you are searching for a particular player (or pair of opponents) as White or Black and it does not matter what color they played, select the Ignore Colors option.

Additionally, an Annotator may be searched case insensitively. Note that this function requires the Annotator header field to be set properly. The checkbox [annotated games only] acts as a logical OR filter for the flags Comments, Variations, Anotations, that is can be used to select only those games that got any type of annotations.

Finally, the Header search can be used to find any text (case-sensitive and without wildcards) in the PGN representation of each game. You may enter up to three text phrases, and they must all appear in a game for it to be a match. This search is very useful for searching in the comments or extra tags of a game (such as lost on time or Annotator), or for a move sequence like Bxh7+ and Kxh7 for a bishop sacrifice on h7 that was accepted. However, this type of search can be very slow since all the games that match other criteria must be decoded and scanned for the text phrases. So it is a good idea to limit these searches as much as possible. Here are some examples. To find games with under-promotions to a rook, search for =R and also set the Promotions flag to Yes. When searching for text that would appear in comments, set the Comments flag to Yes. If you are searching for the moves Bxh7+ and Kxh7, you may want to restrict the search to games with a 1-0 result and at least 40 half-moves, for example, or do a material/pattern search first to find games where a white bishop moves to h7.

Note If a search by ECO code is performed, games that have no ECO code attached are ignored.