💾 Archived View for mirrors.apple2.org.za › archive › apple.cabi.net › Utilities › FilePassage.DOCS … captured on 2024-02-05 at 14:51:01.
⬅️ Previous capture (2023-01-29)
-=-=-=-=-=-=-
COMMON CONTROLS ACROSS FUNCTIONS Each of the functions under the WORK menu have the same type of controls. The shared controls are two basic text edit controls, one current template control, one mode description control, and six button controls. TEXT EDIT CONTROLS With text edit controls, you can type data directly into the control. Menu EDIT commands can be used on text edit controls. At the top of the function window is the source text edit control. Whenever File Passage (FP) begins a function, FP scans this control to determine which file or disk will begin operations. If the scan verifies that a path is valid, then FP will remember the text for the next time the function is used. Below the source text edit control is the target text edit control. The target text edit control doesn't reside in every function's window. Data passes from the source path to target path. Eject The eject menu item acts on the active text edit control by determining the volume or device specification, and then ejecting the removable media matching the volume or device name. CURRENT TEMPLATE CONTROL This control, bounded by a rectangle, changes to indicate the current filter template that is in memory. The active window loads its filter template into memory. Some functions do not use filters and filter templates, and will not have this control. MODE DESCRIPTION CONTROL At the top-center of the function window, the mode description control resides. This control doesn't interact with user generated events, but instead provides feedback on the internal FP state. The mode may be one of the following: o Stasis : The function's waiting for your input. o Preview : The Preview button was selected and FP's performing that function. o Suspension : The function has been suspended and can still be continued. o Selection : FP's collecting files for a selection dialog. o Transfer : FP's transferring data, as in Copy. o Traverse : FP's traversing one or more folders, as in Catalog. o Change : FP's changing the status of something, as in Delete. BUTTON CONTROLS The PREVIEW button shows up in data transfer windows. This button activates a data transfer simulation. After the simulation, a PREVIEW window displays the results of the simulation, which resemble the catalog window's output. The PREVIEW window reports source file blocks passed, files passed count, and changes in new target blocks. None of these calculations include the folders, so if the target will have new folders, you need to add the folder blocks to the new target block count. Thus the reason for the "> =" item. The simulation recognizes all option settings except "Prompt on existing file", which defaults to "No prompt on existing file". The PREVIEW catalog output uses the same text format as the catalog window, and can be adjusted from the CATALOG... menu item under the PREFERENCE menu. The catalog output shows the source as it would be passed to the target. If you are screening out the folder filter type, the preview catalog will still show the source folders, but this inaccuracy can be overcome by watching the target text edit in the function window which will accurately reflect the simulated output. Another inaccuracy occurs in the preview output when you're filtering folders: FP won't be able to tell if you're copying multiple files with the same file name, duplicating existing targets. If you're listing Passed Blocks in the PREVIEW window, and sorting the file names, then the Passed Blocks order may become jumbled. If sorting is off, then Passed Blocks will list the total passed blocks of the transfer after each listed file. The BEGIN button is used to start an operation. The source and target path descriptions, if present, are scanned for correctness and used to determine the starting point. Click the mouse on the SUSPEND button, if present, to suspend an operation. A suspended operation can be restarted by selecting the CONTINUE or NEW TARGET buttons. An operation is suspended between file to file operations and not during data transfer. The CONTINUE button, if present, is used to continue an operation. The source and target path descriptors are not scanned. The CONTINUE operation uses internalized data to remember where the user left off. If an operation was suspended due to an error, then the file following the last file (that produced the error) will be the first to be processed. The NEW TARGET button, present in data transfer functions, allows you to continue data transfer to a new target with no disruption in the source file stream. Use this button, after a VOLUME FULL ERROR. See the documentation on MULTIPLE TARGETS on how FP gives special treatment to this error. The NEW TARGET button activates whenever a function becomes suspended, either through a GS/OS error or when the user selects the SUSPEND button. The NEXT VOLUME button affects the current path descriptor, source or target, replacing it's contents with the next volume name found. Each device with readable media can be flipped to using this switch. The NEXT DEVICE button affects the current path descriptor, source or target, replacing it's contents with the next device name found. Device names are translated upon starting an operation. The CHOOSE PATH button affects the current path descriptor, replacing it's contents with the path chosen from a standard get file dialog. This control also seeks to initialize the standard get file dialog to the current path descriptor. If the file type filter is in use, then only the files selected by this filter will be presented in the standard file dialog. The CHOOSE TEMPLATE button calls up a dialog with a list of available filter templates with the current filter template selected. Select, from the list, the template you want to use.