From 46da48cd9f8be3f36e36031b10681e3baff0dc94 Mon Sep 17 00:00:00 2001 From: infirit Date: Sat, 3 Aug 2013 01:24:52 +0200 Subject: Use yelp-tools instead of mate-doc-utils --- gsearchtool/help/C/index.docbook | 536 ++++++++++++++++++++++++++++++++ gsearchtool/help/C/legal.xml | 2 +- gsearchtool/help/C/mate-search-tool.xml | 536 -------------------------------- 3 files changed, 537 insertions(+), 537 deletions(-) create mode 100644 gsearchtool/help/C/index.docbook delete mode 100644 gsearchtool/help/C/mate-search-tool.xml (limited to 'gsearchtool/help/C') diff --git a/gsearchtool/help/C/index.docbook b/gsearchtool/help/C/index.docbook new file mode 100644 index 00000000..f3cbb9a0 --- /dev/null +++ b/gsearchtool/help/C/index.docbook @@ -0,0 +1,536 @@ + + + + + + + +]> + + +
+ + + + &app; Manual + + + + A search tool to find files, folders and documents on your computer. + + + + + 2005 + Dennis Cranston + + + 2002 + 2003 + 2004 + Sun Microsystems + + + 2000 + Alexander Kirillov + + + + MATE Documentation Project + + + &legal; + + + + Dennis + Cranston + + &app; Maintainer +
dennis_cranston@yahoo.com
+ + + + Sun + MATE Documentation Team + + Sun Microsystems +
+ + + + Alexander + Kirillov + + MATE Documentation Project +
kirillov@math.sunysb.edu
+ + + + + + + + + &app; Manual V2.7 + June 2005 + + Joachim Noreiko + jnoreiko@yahoo.com + + &app; Maintainer + + + + &app; Manual V2.6 + January 2005 + + Dennis Cranston + dennis_cranston@yahoo.com + + &app; Maintainer + + + + &app; Manual V2.4 + February 2004 + + Sun MATE Documentation Team + MATE Documentation Project + + + + &app; Manual V2.3 + September 2002 + + Sun MATE Documentation Team + MATE Documentation Project + + + + &app;l Manual V2.2 + August 2002 + + Sun MATE Documentation Team + MATE Documentation Project + + + + &app; Manual V2.1 + July 2002 + + Sun MATE Documentation Team + MATE Documentation Project + + + + &app; Manual V2.0 + May 2002 + + Sun MATE Documentation Team + MATE Documentation Project + + + + &app; Manual + 2000 + + Alexander Kirillov + kirillov@math.sunysb.edu + + MATE Documentation Project + + + + + This manual describes version &appversion; of &app;. + + + Feedback + To report a bug or make a suggestion regarding the &app; application or this manual, follow the directions in the MATE Feedback Page. + + + + + + + Search Tool + + + + + + + Introduction + The &app; application enables you to search for files on your system. To perform a basic search, you can type a filename or a partial filename, with or without wildcards. To refine your search, you can apply additional search options. + &app; uses the find, grep, and locate UNIX commands. By default, when performing a basic search &app; first uses the locate command, and then uses the slower but more thorough find command. + The case sensitivity of the search depends on your operating system. For example, on Linux, the find, grep, and locate commands support the -i option, so all searches are case-insensitive. + + + + Getting Started + + You can start &app; in the following ways: + + + + From a Menu Bar on a panel + + Choose PlacesSearch for Files... + + + + From a Main Menu on a panel + + Choose Search for Files... + + + + From a command line + + Execute the following command: mate-search-tool + + + + + + + When you start &app;, the following window is displayed. + + +
+ &app; Window + + + + + + Shows &app; main window. + + + +
+ + + + + + + + Usage + + + To Perform a Basic Search + + To perform a basic search for a file on the system, perform the following steps: + + Enter the search text in the Name contains field. The search text can be a filename or partial filename, with or without wildcards, as shown in the following table: + + + + + + + + + + Name Contains Text + + Example + + Result + + + + + + Full or partial filename + + + + myfile.txt + + + + &app; searches for all files that contain the text myfile.txt in the filename. + + + + + + Partial filename combined with wildcards (*, [, ]) + + + + *.[ch] + + + + &app; searches for all files that have extension .c or .h. + + + + + + + + In the Look in folder field, select the folder or device from which you want &app; to begin the search. + + Click Find to perform the search. + + + + &app; searches in the directory that you specify and the subdirectories of the directory. +&app; displays the results of the search in the Search results list box. If &app; does not find any files that match the search criteria, the application displays the message "No files found" in the Search results list box. + + By default, &app; will perform a quick search using the locate command followed by a more thorough second search using the find command. The locate command is faster because it uses a database of information about files. If this database is more than a week old, &app; could warn you that the search results may be out of date and give you the option of disabling the quick search. To update the database, run the command updatedb as the root user. + + + + To Add Search Options + You can add additional options to search for a file on the system. To add search options, perform the following steps: + + Click on the Select more options text. + Click on the Available options drop-down list. + Select the search option that you want to apply. + Click Add. + Specify the required search information for the search option, as described in . + Repeat the above steps for each search option that you want to apply. + + To remove a search option from the current search, click on the Remove button next to the option. + To disable the search options from the current search, click on the Select more options text. + + + Search Options + + + + + + + Option Name + + Description + + + + + + Contains the text + + Search for files of type plain text that contain the specified text. + + + + Date modified less than + + Search for files that are modified less than the period specified in days. + + + + Date modified more than + + Search for files that are modified longer than the period specified in days. + + + + Size at least + + Search for files that are equal to or larger than the size specified in kilobytes. + + + + Size at most + + Search for files that are smaller than or equal to the size specified in kilobytes. + + + + File is empty + + Search for empty files. + + + + Owned by user + + Search for files that are owned by the user specified. Type the name of the user in the text box provided. + + + + Owned by group + + Search for files that are owned by the group specified. Type the name of the group in the text box provided. + + + + Owner is unrecognized + + Search for files that are owned by a user or group that is unknown to the system. + + + + Name does not contain + + Search for filenames that do not contain the string that you enter. Enter a full filename or a partial filename with wildcards in the field provided. Use * to indicate a sequence of characters. Use ? to indicate a single character. The search is case sensitive. + + + + Name matches regular expression + + Search for files that contain the specified regular expression in their directory path or filename. Type the regular expression in the text box provided. + + + + Show hidden and backup files + + Include hidden and backup files in the search. + + + + Follow symbolic links + + Follow symbolic links when searching for files. + + + + Exclude other filesystems + + Search in directories that are in the same filesystem as the start directory. + + + + +
+ + + + + To Stop a Search + Click Stop to stop a search before &app; completes the search. + + + + To Open a Displayed File + To open a file displayed in the Search results list box, perform one of the following steps: + + Right-click on the file, then choose Open. + Double-click on the file. + + To open the folder that contains a file displayed in the Search results list box, right-click on the file, then choose Open Folder. + + + + To Delete a Displayed File + To delete a file displayed in the Search results list box, right-click on the file, then choose Move to Trash. + + + + + + To Save the Search Results + To save the results of the last search that &app; performed, right-click in the Search results list, then choose Save Results As. Enter the name of the file to which you want to save the results, then click Save. + + + + + + + + Settings + + &app; provides gsettings keys to modify some of its behavior. The gsettings values can be changed by starting the Configuration Editor in the following ways: + + + + Applications menu + + Choose System Toolsdconf Editor. + + + + Command line + + Execute the following command: dconf-editor + + + + + + Disable Quick Search + Key name: org.mate.search-tool.disable-quick-search + Default value: false + &app; speeds up file name searches by using the locate command. Locate provides a secure way to index and quickly search for file names. Because locate relies on a file index, the Search results list may not always be up to date. + + + + Disable Quick Search Second Scan + Key name: org.mate.search-tool.disable-quick-search-second-scan + Default value: false + After completing a quick search, &app; will perform a thorough search using the find command. The purpose of this second scan is to find files that have not been indexed. Files that match the search criteria are added to the Search results list keeping the list up to date. + + + + Quick Search Excluded Paths + Key name: org.mate.search-tool.quick-search-excluded-paths + Default values: [/mnt/*,/media/*,/dev/*,/tmp/*,/proc/*,/var/*] + &app; will not perform a quick search for paths defined by this key. File name searches in the defined paths will use the find command. The wildcards '*' and '?' are supported. + + + + Quick Search Second Scan Excluded Paths + Key name: org.mate.search-tool.quick-search-second-scan-excluded-paths + Default values: [/] + &app; will not perform a second scan after a quick search for the paths defined by this key. Quick searches in the defined paths will not be followed by a thorough search using the find command. The wildcards '*' and '?' are supported. + + + + Show Additional Options + Key name: org.mate.search-tool.show-additional-options + Default value: false + This key determines if the Select more options section is expanded when &app; is started. + + + + +
diff --git a/gsearchtool/help/C/legal.xml b/gsearchtool/help/C/legal.xml index acb0b403..9c4e2480 100644 --- a/gsearchtool/help/C/legal.xml +++ b/gsearchtool/help/C/legal.xml @@ -6,7 +6,7 @@ by the Free Software Foundation with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. You can find a copy of the GFDL at this link or in the file COPYING-DOCS + url="help:fdl">link or in the file COPYING-DOCS distributed with this manual. This manual is part of a collection of MATE manuals diff --git a/gsearchtool/help/C/mate-search-tool.xml b/gsearchtool/help/C/mate-search-tool.xml deleted file mode 100644 index d1b94d7d..00000000 --- a/gsearchtool/help/C/mate-search-tool.xml +++ /dev/null @@ -1,536 +0,0 @@ - - - - - - - -]> - - -
- - - - &app; Manual - - - - A search tool to find files, folders and documents on your computer. - - - - - 2005 - Dennis Cranston - - - 2002 - 2003 - 2004 - Sun Microsystems - - - 2000 - Alexander Kirillov - - - - MATE Documentation Project - - - &legal; - - - - Dennis - Cranston - - &app; Maintainer -
dennis_cranston@yahoo.com
- - - - Sun - MATE Documentation Team - - Sun Microsystems -
- - - - Alexander - Kirillov - - MATE Documentation Project -
kirillov@math.sunysb.edu
- - - - - - - - - &app; Manual V2.7 - June 2005 - - Joachim Noreiko - jnoreiko@yahoo.com - - &app; Maintainer - - - - &app; Manual V2.6 - January 2005 - - Dennis Cranston - dennis_cranston@yahoo.com - - &app; Maintainer - - - - &app; Manual V2.4 - February 2004 - - Sun MATE Documentation Team - MATE Documentation Project - - - - &app; Manual V2.3 - September 2002 - - Sun MATE Documentation Team - MATE Documentation Project - - - - &app;l Manual V2.2 - August 2002 - - Sun MATE Documentation Team - MATE Documentation Project - - - - &app; Manual V2.1 - July 2002 - - Sun MATE Documentation Team - MATE Documentation Project - - - - &app; Manual V2.0 - May 2002 - - Sun MATE Documentation Team - MATE Documentation Project - - - - &app; Manual - 2000 - - Alexander Kirillov - kirillov@math.sunysb.edu - - MATE Documentation Project - - - - - This manual describes version &appversion; of &app;. - - - Feedback - To report a bug or make a suggestion regarding the &app; application or this manual, follow the directions in the MATE Feedback Page. - - - - - - - Search Tool - - - - - - - Introduction - The &app; application enables you to search for files on your system. To perform a basic search, you can type a filename or a partial filename, with or without wildcards. To refine your search, you can apply additional search options. - &app; uses the find, grep, and locate UNIX commands. By default, when performing a basic search &app; first uses the locate command, and then uses the slower but more thorough find command. - The case sensitivity of the search depends on your operating system. For example, on Linux, the find, grep, and locate commands support the -i option, so all searches are case-insensitive. - - - - Getting Started - - You can start &app; in the following ways: - - - - From a Menu Bar on a panel - - Choose PlacesSearch for Files... - - - - From a Main Menu on a panel - - Choose Search for Files... - - - - From a command line - - Execute the following command: mate-search-tool - - - - - - - When you start &app;, the following window is displayed. - - -
- &app; Window - - - - - - Shows &app; main window. - - - -
- - - - - - - - Usage - - - To Perform a Basic Search - - To perform a basic search for a file on the system, perform the following steps: - - Enter the search text in the Name contains field. The search text can be a filename or partial filename, with or without wildcards, as shown in the following table: - - - - - - - - - - Name Contains Text - - Example - - Result - - - - - - Full or partial filename - - - - myfile.txt - - - - &app; searches for all files that contain the text myfile.txt in the filename. - - - - - - Partial filename combined with wildcards (*, [, ]) - - - - *.[ch] - - - - &app; searches for all files that have extension .c or .h. - - - - - - - - In the Look in folder field, select the folder or device from which you want &app; to begin the search. - - Click Find to perform the search. - - - - &app; searches in the directory that you specify and the subdirectories of the directory. -&app; displays the results of the search in the Search results list box. If &app; does not find any files that match the search criteria, the application displays the message "No files found" in the Search results list box. - - By default, &app; will perform a quick search using the locate command followed by a more thorough second search using the find command. The locate command is faster because it uses a database of information about files. If this database is more than a week old, &app; could warn you that the search results may be out of date and give you the option of disabling the quick search. To update the database, run the command updatedb as the root user. - - - - To Add Search Options - You can add additional options to search for a file on the system. To add search options, perform the following steps: - - Click on the Select more options text. - Click on the Available options drop-down list. - Select the search option that you want to apply. - Click Add. - Specify the required search information for the search option, as described in . - Repeat the above steps for each search option that you want to apply. - - To remove a search option from the current search, click on the Remove button next to the option. - To disable the search options from the current search, click on the Select more options text. - - - Search Options - - - - - - - Option Name - - Description - - - - - - Contains the text - - Search for files of type plain text that contain the specified text. - - - - Date modified less than - - Search for files that are modified less than the period specified in days. - - - - Date modified more than - - Search for files that are modified longer than the period specified in days. - - - - Size at least - - Search for files that are equal to or larger than the size specified in kilobytes. - - - - Size at most - - Search for files that are smaller than or equal to the size specified in kilobytes. - - - - File is empty - - Search for empty files. - - - - Owned by user - - Search for files that are owned by the user specified. Type the name of the user in the text box provided. - - - - Owned by group - - Search for files that are owned by the group specified. Type the name of the group in the text box provided. - - - - Owner is unrecognized - - Search for files that are owned by a user or group that is unknown to the system. - - - - Name does not contain - - Search for filenames that do not contain the string that you enter. Enter a full filename or a partial filename with wildcards in the field provided. Use * to indicate a sequence of characters. Use ? to indicate a single character. The search is case sensitive. - - - - Name matches regular expression - - Search for files that contain the specified regular expression in their directory path or filename. Type the regular expression in the text box provided. - - - - Show hidden and backup files - - Include hidden and backup files in the search. - - - - Follow symbolic links - - Follow symbolic links when searching for files. - - - - Exclude other filesystems - - Search in directories that are in the same filesystem as the start directory. - - - - -
- - - - - To Stop a Search - Click Stop to stop a search before &app; completes the search. - - - - To Open a Displayed File - To open a file displayed in the Search results list box, perform one of the following steps: - - Right-click on the file, then choose Open. - Double-click on the file. - - To open the folder that contains a file displayed in the Search results list box, right-click on the file, then choose Open Folder. - - - - To Delete a Displayed File - To delete a file displayed in the Search results list box, right-click on the file, then choose Move to Trash. - - - - - - To Save the Search Results - To save the results of the last search that &app; performed, right-click in the Search results list, then choose Save Results As. Enter the name of the file to which you want to save the results, then click Save. - - - - - - - - Settings - - &app; provides gsettings keys to modify some of its behavior. The gsettings values can be changed by starting the Configuration Editor in the following ways: - - - - Applications menu - - Choose System Toolsdconf Editor. - - - - Command line - - Execute the following command: dconf-editor - - - - - - Disable Quick Search - Key name: org.mate.search-tool.disable-quick-search - Default value: false - &app; speeds up file name searches by using the locate command. Locate provides a secure way to index and quickly search for file names. Because locate relies on a file index, the Search results list may not always be up to date. - - - - Disable Quick Search Second Scan - Key name: org.mate.search-tool.disable-quick-search-second-scan - Default value: false - After completing a quick search, &app; will perform a thorough search using the find command. The purpose of this second scan is to find files that have not been indexed. Files that match the search criteria are added to the Search results list keeping the list up to date. - - - - Quick Search Excluded Paths - Key name: org.mate.search-tool.quick-search-excluded-paths - Default values: [/mnt/*,/media/*,/dev/*,/tmp/*,/proc/*,/var/*] - &app; will not perform a quick search for paths defined by this key. File name searches in the defined paths will use the find command. The wildcards '*' and '?' are supported. - - - - Quick Search Second Scan Excluded Paths - Key name: org.mate.search-tool.quick-search-second-scan-excluded-paths - Default values: [/] - &app; will not perform a second scan after a quick search for the paths defined by this key. Quick searches in the defined paths will not be followed by a thorough search using the find command. The wildcards '*' and '?' are supported. - - - - Show Additional Options - Key name: org.mate.search-tool.show-additional-options - Default value: false - This key determines if the Select more options section is expanded when &app; is started. - - - - -
-- cgit v1.2.1