MaCorpus 1.0.2B - The Manual ************************** ************************** Developer's notes ***************** Limit of finds ( for form searches) is determined within the report print by if( ( (lineLength*numOccur)>(32767- (*outputTe)->teLength) && gNoInfo) || ((lineLength*numOccur)>((32767- (*outputTe)->teLength)/2) && !gNoInfo) ) for no additional info and with added info and not within the create search find-loop by: }while(searchReport != END_OF_FILE && numOccur. //¥but // If another number window was closed, after having numbered ours <1>, a subsquent window willstil be numbered <1>, even though this already exists //¥poss solution // when searching for like windows, if one is found then number it <1>, thereby numbering the original, this should only happen once on the first check // and the original will change back to without one, if all others are closed, when name is changed: // => would be better if changed when activated - phew!! //¥however // the same problem willoccur if the originial window is brought to the front and changed and then changed back again to the original //¥to get round this // number the current window the (maximum existing same name window number + 1 // now if the original,or whichever is brought to the front and changed and changed back again it will be a new number but different from the others in MCUtils.cp FileSearch ++++++++++ One method ¥ Open Master FileSearch dialog ¥ Open standard get file dialog ¥ Get file spec ¥ Close standard get file dialog ¥ Put file name in corpus box ¥ Add file to AEDescList as in AEOpenDoc ¥ Repeat until done ¥ Pass the List to AECreate Search Better to do a la CompactPro ¥ Open Master FileSearch dialog Add/Add All/Open/Cancel/Desktop/Eject/Done/Add only if modified after ¥ Get file spec ¥ Put file name in corpus box ¥ Add file to AEDescList as in AEOpenDoc ¥ Remove file from Master FileSearch dialog ¥ Repeat until done ¥ Pass the List to AECreate Search Implemented *********** ** Under System 7.5 ( and posterior) the open dialogs show mini icons ** Under System 7.1 ( and anterior) the open dialogs show generic icons Use +++ Mouse only - using popchar - menus and buttons keyboard only - command keys ( except prefs) - drag and drop not possible Combination of both (normal) Windows +++++++ Form ---- The Form window is named after the word that is being looked for. This is logical as it is the most important characteristic of the search. In this applications, the files used are largly irrelevent, unless particular relevence is placed upon the sources, English for Specific Purposes (ESP). When Saving the Save Dialog places the window name - i.e. the word searched for - as the default file name + ".crps". Should further details be required, these may be added to the filename as required. Multiple Windows may be open. Untitled windows are numbered accordingly, , , etc. The number of windows is limited by the memory availible to the application, set in the Get InfoÉ dialog box of the finder Windows with the same name are numbered as for untitled windows Due to the dynamic nature of the window title a form loaded from disk, will change if the name is changed, is thi good or confusing Dialog ------ Report Preferences Search Preferences Form Preferences Indicator --------- Status Window Resizing -------- The resizesing of form, will resize the actual size of the field as well as the viewable size, thus resulting in what some may regard as jumpy boxes. Although this is not standard Apple Interface practice, it offers the most comfortable method of use for multi size scren, esp, small scrren. Horizontal scrolling - which makes reading difficult and awkward - is avoided Fields ++++++ The individual fields are accessed by clicking(required field), tabbing (next field) and shift tab (previous field) The Corpi +++++++++ Entering Corpi -------------- Typing Open file Drag and drop with option key (not complete) Accessing Corpi --------------- Drag and drop - list created - files searched on disk, not loaded into form Specifying single corpi files, not load into form - search in situ Specifying list corpi files, not load into form - search in situ - Select folder - earch contents - Select individual files and "Add" to corpus file list Corpi Desktop Actions --------------------- Dragging and Dropping non MaCorpus Text files MaCorpus text files MaCorpus form files Any Combination Doubling Clicking MaCorpus text files MaCorpus form files Any Combination Individually, in like file groups, or combiations, the text files are opened, as a group in a single window, as a file search, unless option is held down in which case they are opened individually, with a window each, and the contained information placed in the corpus field (not implemented) Search Modes ++++++++++++ Search the corpus loaded into form Search draged file collection - not folders Search file on disk - select one file only If a form is loaded, or a search is done, whereas the corpus field lists names - starting with , and a subsequent form search is performed: ¥ the corpus will NOT be taken to be a list of file names, ¥ If a corpus HAS been entered after the filenames, or indeed the uer wishes to search using a list of filenames as the corpus, then they must delete the first forthe field,or sewlect the appropriate preference in the search preferences dialog file search must be initialted to use these names, and only if they are locatiable, will they be used. Add pref to disable using filenames in corpus field as the corpus, or remove this obvious bug Searches output data to the form will give more finds if the No Additional info check box is marked 32767 is the maximum number of finds 32767/lineWidthInCharacters is the maximum number of lines displayable within the form lineWidthInCharacters depends upon the width of the form FindIt button senses if form or file search if a file search has already been done, and a list of file names is in palce in the corpus. The list is not necessariyl the files that it will use if others have subsequently been added or removed from the list without a search being initiated. The actual file list that will be used is that which is displayed in the file search dialog. The FindIt button will not use a list of filenames as a form based search, enven if this option has been selected within the search preferences dialog box. This is a fixed requirement. Preferences +++++++++++ Report Blanklines NoInfo Display paths Display Position in file Display prefs Display Files Substituion/Maintain Text Formating - Substitute with spaces Sub CR/enter Sub others Justification -> show word for right justification, else doesn't appear in report!! Specify width of output in characters -> TE number Append Reports default false Search Ignore Case Diacritical Word In Isolation Spaces at start of word Spaces at end of word Skip word once found Advanced Search Choose search engine Form Character size and fonts Form Style Advanced Form Color Form Size - input dimensions Menus +++++ Dialogs +++++++ AppleEvent aware ++++++++++++++++ Open application - External triggering - Notification manager - Open Docs - drag and drop Print Doc - print from desktop QuitApp - shutdown correct Saving ++++++ Saving the Form, in the format of the form: Name, Output, Corpus Save saves the form in a file under the current name (if saved) otherwise is as for Save AsÉ SaveAsÉ shows the last file name the form was saved as (if saved), or the word looked for (if entered), or as ( the window title) Exporting saves the output (only) as a text file, doublie clicking that file opens up maccorpus, and puts it in the corpus field Export saves the Export AsÉ Possible to export results, doubled click the resulting file and further your search! If saved then use that name if named then used that else untitled window title Known Issues *********** AESearchDialog logic is dodgy To be Implemented ***************** Search draged folder collection Search file on disk - select individual files, add to corpus list - select folder and do contents - a la CompactPro Export as a read only - 'ttro' Future Plans ************ Commentary field and, Sationary aware for group projects, using this commentary field. Internet - corpus download - load NetScape Label saved file Insert commentaries Package ******* CDROM MaCorpus Example corpi, down;laoded, scanned and OCRed media, newspapers, etc Web page interactive help guide (HTML) Rolling demo - CameraMan Manual eDoc/HTML/AMT Endorsement Electronic Book Floppy MacCorpus Manual Net As for CDROM plus, MacCorpus updates Corpus pointers