TITLE
    Mac OS X Server: About the Find Application
Article ID:
Created:
Modified:
60123
3/11/99
10/31/00

TOPIC

    This file contains release notes for the Mac OS X Server Release of the Find application. Items specific to the current (Mac OS X Server) release are included.

    Note: This document was installed by Mac OS X Server in /System/Documentation/ReadMe. For a list of other release notes see:
    Article 30925: " Mac OS X Server: Release Notes "


DISCUSSION

    Find

    Find for Mac OS X Server integrates the functionality of Find By Content and Find File within a single tabbed window. Find can be accessed from the Apple menu. Find opens with the Find File tab frontmost by default.

    Find File

    The File File tab allows an non-indexed search of files on the System. Clicking the More Choices button at the bottom left of the tab can refine the search. This increases the size of the window and adds new search criteria. Clicking on the Fewer Choices button removes a field and reduces the window size to fit. The Fewer Choices button is disabled when only one option is available. The More Choices button is dimmed when eight options (the maximum) are visible.

    The volume popup lists a number of useful directory paths such as Home, Root and a series of paths that are chosen from a submenu.Note that choosing the menu item (i.e. applications) will not work. The user must choose the specific submenu item.

    The Browse... button brings up the open dialog and allows the user to add favored directories to the volume popup menu. Added directories are appended to the volume popup menu and last a session only.

    A maximum of eight search criteria are possible. Each one has one or more modifiers, accessed in the middle popup. The default modifier is <is>.

    Drag and Drop to Search Fields

    Dragging a file to the Find File dialog will update all the visible fields for that file, including the permission fields and the date modified field.

    Searching

    When the user presses the Find Button, the search commences and the Find button changes to a Stop button. All items in the window are disabled (except for the feedback field and Stop button). A spinning arrow in the top right of the window indicates activity. The items found field in the bottom center of the window lists the number of items found.

    Pressing the stop button will abort the search and display the results collated up to the abort.

    If no items are found an alert is shown.

    Threading Finds

    More than one find can be run simultaneously. By choosing Reset Find from the file menu or Cmd-R the user can enable all fields while a search is still running. He can then modify his search criteria and launch a simultaneous find by pressing the Find button. This again will disable all fields. By again choosing Reset Find the user can continue to modify and launch new finds. Ten finds can be threaded.

    Note that the item found field will display results from all finds and appear non-sequential.

    Choosing the Stop button in this case will bring up the Process Dialog.

    Process Dialog

    The Process dialog can be launched from the Recent Processes menu item in the Window menu. Or more likely it is shown if a user tries to stop a multi threaded find.

    The Processes dialog lists all threads running at that time in a table. The user can abort any search by clicking on it in the table. This enables the Stop button and displays more information for that find in the status fields. Pressing the Stop button aborts the search for the listed find and displays the result window.

    Results Window

    The result window is the window where the results of the search are displayed to the user. The window is divided in two distinct parts separated by a resizable splitview. The top of the window contains a table that lists the results in columns. The columns order the results by Document, Size, Last Modified, Type, and Owner. The results are originally shown sorted by name. Clicking on the column will sort by that column. Columns can be reordered and resized.

    Clicking on a row of this column will display the icon path of the file in the bottom view. Files can be dragged from the Icon path view to the desktop or to another volume or folder. Files can also be dragged from the workspace to the icon path view or from different result windows. The modifier keys determine the type of drag, as in the workspace. The items found field in the bottom left hand side displays the number of items found for this search.

    Find allows multiple Results windows to be open at one time. The Results window is resizable.

    Saving Search criteria

    A search is saved from the Favorites menu. The Save As Favorite menu item presents a dialog allowing the user to name the saved criteria. It is saved to ~user/Library/FindPreferences. The favorites menu only saves search criteria and NOT results. Each favorite is appended to the menu. Choosing a favorite menu item will reinstate the search fields (enlarging or reducing the window as necessary). The user can launch the find as usual by pressing the Find button.

    Editing Favorites

    Choosing Edit Favorites from the Favorites menu will launch the Edit Favorites dialog. The user can rename or remove a find from the menu. (He cannot in this release change the internal find predicates i.e. the rightmost column of the table). Choosing a favorite and pressing remove removes it from the table , menu and disk.

    Find by Content

    The Find by Content uses Apple Information Access Toolkit (AIAT) to create indexes of the contents of folders, which you can then search for specific contents. Only folders which have been indexed can be searched in this way.
    • If you have only installed User CD, you will have an empty "Search on" popup menu. You need to click the "Indexing" button to index the folder that you want to search on. After the folder is indexed, the folder will be automatically added to the "Search on" popup menu. Then, you can enter the search words, and click the "Find" button to start the searching.
    • If you have installed Developer CD, you will have the Sytem Documentation pre-indexed for you. The "Search on" popup menu has "System Documentation" pre-selected. You can enter the search words, and click the "Find" button to start the searching. If you want to search on other folders, please indexing them first, then you can search for specific contents on those folders.
    • The Find by content doesn't index the files with following extensions: index, idx, o, a, gif, pdf, eps, tiff, app, fbc, x, gz, gzip, zip, tar, dylib, nib, plist, accessor, ps, afm, snd, bom, or img. And, it doesn't index the folders with app, framework, font, bundle, or palette extensions.
    • There are three files in the English resources of the Find application which are used by the Find by Content to do the indexing and searching. They are abbreviations.fbc, Stopwords.fbc, and Substitutions.fbc. You can use a text editor to modify them for other languages.
    • There are some menu or menu items don't apply to the Find by Content : Reset Find, Recent Processes, and Favorites.

    Indexing Dialog

    If you want to create the index for a folder, you can click "Choose A Folder To Index" button to select the folder . Then, you can click the "Begin Indexing" to start the indexing. If the folder has a lot of text files, it will take a while to index the folder. During the indexing, you still can search on other folders.

    After the indexing is completed, the folder name is added to the "Folders which have been indexed" table, and the folder name is automatically added to the "Seach on" popup menu of the main window. Then , you can switch back to the main window, enter the search terms, and click the "Find" button to start the searching.

    If you want to update the index or delete the index, you can click the entry on the "Folders which have been indexed" table to select the folder. Then, you can click the "Begin Indexing" to start the indexing. Or, you can click the "Delete Index" to delete the index.

    Results Window

    The result window is the window where the results of the search are displayed to the user.

    The window is divided in two distinct parts separated by a resizable splitview.

    If no items are found an empty result window is shown.

    The top of the window contains a table that lists the results in columns. The columns order the results by Score, Document, Size, Last Modified, Type, Owner, hit tersms, and Path.The results are shown sorted by score always. Clicking on the column will not sort by that column. Columns can be reordered and resized.

    Clicking on a row of this column will display the summary of the file in the bottom view.

Document Information
Product Area: Mac OS System Software
Category: Mac OS X Server
Sub Category: General Topics
Keywords: kmosXserver

Copyright © 2000 Apple Computer, Inc. All rights reserved.