Online Manual 0.40 ================== 70 Camm Street, Walkley, Sheffield, S6 3TR jgh@mdfs.net *Man is an online manual after the style of the 'man' online manual on Unix systems. It will run on any filing system, but best runs on a hierarchial system as the documentation files are best stored in subdirectories of a remotely-referenced directory. Supplied files -------------- ScrMan/src - Create *Man file for BBC/Master ArcMan - *Man command for RISC OS ArclpS - RISC OS version of lpS Man/txt - This documentation Docs.M.1Man - Manual file for *man command Docs.O.0OSFILE - Manual file for OSFILE Docs.O.0OSGBPB - Manual file for OSGBPB Docs.O.0OSARGS - Manual file for OSARGS Docs.N.3Number - Manual file for Number Docs.F.7FSNums - Manual file for FSNums Setting up ---------- The ScrMan/src program creates the *Man command. When run it prompts for the directory the manual files live in and the filename to save the *man command as. Pressing RETURN will use sensible values of '%.ManPages' for the manual entries and '%.Man' for the *Man command. When the *Man command is used, text is display a page at a time. MORE> is displayed when waiting to continue. Pressing B up the up cursor will go back half a page, Q or Escape will quit, any other key will go forwards half a page. RISC OS ------- The online manual system can also be used on RISC OS. The ArcMan and ArclpS files should be put in the RISC OS system library, for example, net::System.ArthurLib You can set the following system variables to override ArcMan's default display command and manual directory: Man$Cmd : display command, eg ArclpS Man$Dir : manual direcory, eg net::Docs.ManPages Writing manual files -------------------- The manual files use extended View highlights as demonstrated in the example files. These files can be used as the basis of writing additional files. Manual files can also be links to documentation elsewhere, so that, for example, an application's Manual files can be kept together with the application. A link file must have a load address of &FFFFC0xx (ie, filetyped to &FC0) and contain a CR-terminated or zero-terminated path starting with ':' pointing to the actual manual file. The Zip and UnZip manual files are examples of link files.