WOMAN(1) UTILITIES WOMAN(1) NAME WOMAN : To display command's manual pages. SYNOPSIS WOMAN [[-p Man_Path]|[command]] REGISTRATION WOMAN is a Shareware software written by Bernard Piette. This is a demo version that can only read 30 files per directory. The registered version of WOMAN comes with over 350 manual entries and has no limitations on the number of files that can be displayed. TO REGISTER Send 5 British pounds or 10$ US (no cheques from outside the UK ) to Bernard Piette Collingwood College, South road DURHAM DH13LT ENGLAND DESCRIPTION WOMAN lists a short manual for the specified command on the Amiga screen. WOMAN opens its own screen and make it possible to scroll through the text using arrow gadgets, a proportional gadget, or keyboard keys. The UP and DOWN cursor keys scroll the text upwards or downwards one line at a time. The SHIFT UP and SHIFT DOWN keys scroll the text 10 lines at a time. Moreover, the "b" and "t" move respectively to the bottom and the top of the text. There are different way to select a given manual. The first one is to select the "Open" item of the "File" menu. This will produce a requester prompting for a manual name. After entering a name, one can either click on the "OK" button to display the desired manual, or click on the "CANCEL" button to abort. The easiest way to select a manual is to click twice on its name when it appears on the screen. If there is a manual for that name, it will automatically apear on the screen. This is very useful as many manuals refer to other ones, or use technical words. Clicking on these name in the text, displays the corresponding manual. The manuals are grouped together into different categories, (Dos, Utils ...) each one of them being represented by a subdirectory of the MAN: directory that contains the manual for that category. The DIR menu items correspond to the list of the available categories. When one of these items is selected, WOMAN list the names for the manuals of that category. Clicking twice on one of these names will automatically display the corresponding manual on the screen. When a manual is read by WOMAN, it is kept in memory so that further references to it are faster. WOMAN also keeps a list of the last manuals read. It is then possible to recall the previous manuals using the "Last File" item of the file menu (or the corresponding keyboard shortcut). There is no limit on the number of manuals that can be linked that way. When reading a given manual, it is then very easy to display other manual entries one after another and then go back one entry at a time up to the first one. When the content of a directory (category) is listed on the screen, the list of linked manuals is reset to zero. The "Dir" item of the "File" menu lists the content of the directory to which the current manual belongs. The "Close All" item remove all the manuals in memory. This will free some memory, but means that WOMAN will have to read from disk all the manual that will be selected afterward. When a manual is selected, WOMAN looks first for that manual in the current category. If it does not find it, it then looks in all the other category, starting in the first one. As different categories can contain manuals with the same name, the way the categories are ordered is important. If WOMAN does not find a name that maches exactly the selected name it then look for a name that is close to it. This is useful for example for manual like "directory". The name can appear either as "directory" or "directories" in a text. Clicking on either of them will display the "directory" manual. WOMAN followed by a manual name will start WOMAN and will display the specified manual. By default, WOMAN list the content of the first category after startup. WOMAN looks for the manual in the MAN: volume or assignment. If WOMAN is started with -p followed by a path name for its argument, that path name is assigned to MAN: and manual categories are extracted from it. MENU WOMAN has two menus, each of them containing items that can be selected with the mouse, or using the appropriate key short cut. -FILE : The file menu contains 6 items: -Open : to open a manual entry by typing in its name. -Last File : to display the previous manuals. -Dir : to list the content of the category to which the current manual belongs. -Close All : To free all the previously read manuals, and thus freeing some memory. -About : a short registration message about WOMAN. -QUIT : to quit WOMAN. -DIR : the content of this menu will vary according to the defined categories. Each item correspond to a category. Selecting one of them list the manuals names for that category. When it starts WOMAN first look for the file MAN:.dirs . If it exists, its content (one name per line) is interpreted as the list of category in the specified order. The names in the list must correspond directories existing in MAN: . The files in these directory being the manuals for the corresponding category. If the file MAN:.dirs does not exist, WOMAN build the list of categories from all the subdirectory of the MAN: directory, ordering then alphabetically. SPECIAL KEYS -UP : move 1 line upwards. -DOWN : move 1 line downwards. -SHIFT UP : move 10 line upwards. -SHIFT DOWN : move 10 line downwards. -b : move to bottom of text. -t : move to top of text. SEE ALSO MAN. EXAMPLES The simplest way to start WOMAN is by running it in the background: > RUN WOMAN It is not necessary to RUN it, but it does not make any harm, and as reading the list of manual entries take some time, it is better to keep it running all the time. To open a manual immediately at startup: > RUN WOMAN ask To select a different path for the manual entry: > RUN WOMAN -p MyDisk:man ; list the manual for MORE.