💾 Archived View for mirrors.apple2.org.za › archive › apple.cabi.net › Utilities › FilePassage.DOCS … captured on 2024-02-05 at 14:51:00.
⬅️ Previous capture (2023-01-29)
-=-=-=-=-=-=-
CATALOG Access CATALOG from the WORK menu. CATALOG to view folder contents, view file attributes, view file contents, check volume stats, and to find files on ProDOS volumes. Follow these steps when performing a CATALOG operation: (1). Determine if the correct filters are switched on for USE (if any). (2). Determine that used FILTERS are correctly set. (3). Determine that the OPTION menu switches are set to your satisfaction. (4). Determine if the source path is correctly made. (5). Select the BEGIN button. (6). Stop cataloging by selecting the suspend button. (7). Select CONTINUE to restart cataloging where you left off. CATALOG SOURCE DESCRIPTIONS There are several initial source types that one can CATALOG: (1). a volume, (2). a subdirectory (also known as a directory), (3). a file name, (4). a wild card file name. When cataloging volume or subdirectory, the CATALOG output window will expand the source file name (a folder) to list its contents: An example: Source: :C:FP Results: :C:FP <-- Source text edit reproduction. 'C' is a volume and 'FP' a folder. Src <-- Found in the folder 'FP'. Other <-- Found in the folder 'FP'. Resources <-- Found in the folder 'FP'. Free blocks: 13259 <-- free blocks in volume 'C'. Used blocks: 3125 <-- used blocks in volume 'C'. When cataloging a file, the CATALOG output window will list only the file with the volume information: Source: :A:RAMFAST.SYSTEM Results: :A:RAMFAST.SYSTEM <-- Source text edit reproduction. 'A' is a volume. RAMFAST.SYSTEM <-- File found in "A" volume. Free blocks: 9133 Used blocks: 7251 When cataloging a wild card file name, the CATALOG output window will list only matching files with their supporting directory structure (with the volume information): Source: :B:?SYS? Results: :B <-- Source reproduction. 'B' is a volume. LIBRARY System <-- Passed wild card file name. GOODIES Ramfast.System <-- Passed wild card file name. Genesys <-- Passed wild card file name. Genesys <-- Passed wild card file name. Genesys.8 <-- Passed wild card file name. Icons Genesys.Icons <-- Passed wild card file name. basic.system <-- Passed wild card file name. Free blocks: 3012 Used blocks: 13372 MORE ON CATALOG OUTPUT AND DIRECTORY STRUCTURE The catalog output listing uses indentation to indicate folder nesting. Any files that belongs to a folder will be indented: Folder Apples Oranges Grapes Apples, oranges and grapes all reside in "Folder". Also, at times you may CATALOG while using the file type filter (or other filters or the wild card file name) to screen out the DIR file type files. The catalog output window will still have DIR file type files in the listing if they structurally support another file that passed the filters: :DISK Folder <---- DIR file type (structural). File <---- Passes file filter(s). OPTIONS See the documentation describing OPTIONS. BUTTONS There are eight buttons in the CATALOG window: BEGIN, SUSPEND, CONTINUE, NEXT VOLUME, NEXT DEVICE, CHOOSE PATH, CHOOSE TEMPLATE, and OUTPUT OPTIONS. See the documentation describing common controls. The OUTPUT OPTIONS button opens up a movable dialog window that features a host of check box controls. Select the attribute(s) that you want placed in the catalog output window. The CONTENT WINDOW switch, when selected, will cause CATALOG to create and then update the CONTENT WINDOW for each file passed to the catalog output. Folders are not passed to the CONTENT WINDOW. The CONTENT WINDOW appears after the inexperienced interface level. Also in the OUTPUT OPTIONS window are two check boxes, one for a file's creation date and one for a file's modification date. The format of the date as presented in the catalog output is controlled by the date setting in the IIGS control panel. CATALOG OUTPUT WINDOW The list output is limited to 64K entries. If your cataloging a large volume, turn sort off in the catalog preference window to speed up the list creation process. Try to limit yourself to three or four file attributes when cataloging. If you specify more than four, the attributes may not have enough room in the catalog list line, and thus will not be viewable. Still, the attributes will be there for saving and printing functions. The catalog... menu item in the PREFERENCE menu allows you to customize the catalog output format on screen and to the printer. Changing the margins is useful for when you want to print the catalog output or preview output (preview output uses the same margins as catalog when printing). Words Of Advice The catalog buffer dynamically adapts to the cataloged file data requirements. Still, if you're cataloging large volumes with lots of attributes, you can still run short of memory. Short memory will cause FP to stop the catalog or preview process. CATALOG CONTENT WINDOW Depending on catalog... preferences, the content window may convert the file input to ASCII characters and will mask any input that is not ASCII. For the technically inclined, this means that the input stream has its high bit cleared, and any remaining control characters are replaced with the chosen mask character. The content window will only show one block of a file at a time. NEXT BLOCK and PREVIOUS BLOCK (in the FILE menu) allow you to scroll a block of information at a time. You can change the size of the block, up to available memory, from the Catalog... menu item in the PREFERENCE menu. The information bar in the content window shows the data concerning the file in view. The "Fork:" display indicates which file fork your viewing, data or resource. The "Mark:" display field indicates the offset in the fork for the data being viewed. The "EOF:" display field indicate the size of the current fork.