:userdoc. :docprof toc=123456. :title.fpGUI DocView Help .* ************************************************************ .* Subject: Help for DocView .* ************************************************************ .* .* .* ************************************************************ .* Introduction .* ************************************************************ :h1 res=30000 id='Introduction'.Introduction :i1 id=30001.support .* :artwork runin name='images\DocView.bmp'. :hp2.Welcome to DocView!:ehp2. :p. DocView is a program for reading fpGUI or OS/2 (aka eComStation) Help Files. Both the INF and OS/2 HLP file formats can be read. :p.:link reftype=hd refid='Support'.Support and Licensing:elink. :p.:link reftype=hd refid='Using'.Using DocView:elink. :p.:hp1.To stop this file appearing when you start DocView without specifying a help file, see "Settings - Options - General" tab.:ehp1. :p. :hp2.History:ehp2. :p. DocView was originally based on the OS/2 NewView program. It was ported from the Sibyl development environment, to the fpGUI Toolkit and the Free Pascal Compiler. Since then the code and features of DocView has diverged. :p. It improves upon many aspects of the origin IBM View program, with a modern, easy to use interface, more options, and new features that View simply didn't have. And don't forget, DocVIew is also cross platform - currently available as native executable for Linux, FreeBSD and Windows. DocView is also available in 32-bit or 64-bit. .* ************************************************************ .* Support and Licensing .* ************************************************************ :h2 res=1 id='Support'.Support and Licensing :i1 id=30002.license :i2 refid=30001.Support and Licensing :i2 refid=30001.Introduction :i1 id=30003.bugs :i1 id=30004.source code :i1 id=30007.features planned :hp2.Support and Licensing:ehp2. :p.DocView is Copyright 2009-2010 by Graeme Geldenhuys. It is also licensed under the GNU Public License v2, which means you have the right to obtain the source code. :p. DocView is part of the fpGUI Toolkit project and is the default help viewer for any fpGUI based applications. Source code for DocView is available in the fpGUI git repository on SourceForge.net, inside the :hp1.docview:ehp1. directory. :p. If you find DocView helpful, please email me and/or make a donation to support further development. It's nice to hear from you! :ul. :li.Project is hosted on SourceForge.net at http://sourceforge.net/projects/fpgui/ :li.Suggestions, compliments or bug reports can be left on the fpGUI support newsgroups. The news server is accessible via NNTP at news://opensoft.homeip.net/ .br There is also a web interface to the NNTP news server for those behind company firewalls. http://opensoft.homeip.net/webnews/ :li.Translate DocView to your language. :li.A donation to fpGUI development. You can contact me via email at: graemeg@gmail.com :eul. :p.:hp2.Reporting Bugs:ehp2. :p.If you need to report a crash or other problem, then be as specific as possible about what files were being used, what you were doing, etc. If at all possible, compile DocView with debug information and supply a backtrace. This will greatly help me fix problems. :p. If it is specific to a particular help file, then send them to me via email. :p. It would be helpful if you could include the following information with your bug report: :ul. :li.DocView version (Help - Product Information) :li.The file names of the help files you have problems with. :li.A screenshot may be useful, if the problem is an incorrect or corrupt display. :eul. :p.:hp2.Why doesn't my help file work properly?:ehp2. :p.Some of the less used features of the original View program are not implemented. This is either because I have not got around to it, or because they are simply not worth the time. Examples include metafiles, index synonyms, application control API (like toolbar button customisation), MDI style window management and so on. :p.Unfortunately, IBM seems to have used every one of these features in there INF documents, so you may find an occasional file that doesn't load or doesn't work properly. :p.:hp2.Features still planned?:ehp2. :ul. :li.Image support. The Ric Text View component can already handle images, I am only struggling to decode the images inside INF help files. This should hopefully be fixed soon. :li.Bookmark support :li.Annotations of help files :li.Printing support :li.Cross-file linking. Clicking a hyperlink that automatically opens another INF help file and goes to the correct topic. DocView already supports loading multiple files, so this is almost complete. :li.Some optimization of the Rich Text View component. Better startup time, improved text wrapping and font substitution support. :eul. .* ************************************************************ .* Using DocView .* ************************************************************ :h1 res=2 id='Using'.Using DocView :hp2.Using DocView:ehp2. :p. Once you have :link reftype=hd refid='OpeningFiles'.opened a file:elink., you can read it in various ways. :p. You can read the :link reftype=hd refid='contents'.table of contents:elink., use the :link reftype=hd refid='Index'.alphabetical index:elink., or :link reftype=hd refid='search'.search:elink.. :p. To simply read the help file like a paper book, use the "Previous" .* :artwork runin name='images\previous.bmp'. and "Next" .* :artwork runin name='images\next.bmp'. buttons to work your way through all the topics. They are the Up and Down arrow buttons on the toolbar. :p.You can also use the help file like web pages, using "Back" .* :artwork runin name='images\back.bmp'. and "Forward" .* :artwork runin name='images\forward.bmp'. buttons to go back to wherever you were before, or to retrace your steps. They are the Left and Right arrow buttons on the toolbar. :p. Colours and some of the behaviour of DocView can be adjusted from the "Tools - Options" menu. .* TODO .* :p.You can also :link reftype=hd refid='notes'.annotate:elink. or :link .*reftype=hd refid='bookmarks'.bookmark:elink. topics. .* ************************************************************ .* Opening Help File .* ************************************************************ :h1 res=3 id='OpeningFiles'. Opening Files :i1 id=30005.open :p.:hp2.Opening Help Files:ehp2. :p. To open a help file, you can use any of the following: :ul. :li.Double-click a :link reftype=hd refid='HelpIcons'.help icon:elink. that is already set up. The DocView executable needs to be associated with INF files in your desktop environment. :li.Type "docview :hp1.filename:ehp1." from the :link reftype=hd refid='CommandLine'.command line:elink.. :li.Click the Open button .* :artwork runin name='images\open.bmp'. from within DocView, or the "File - Open" menu item. :li.Click the "File - Open additional file" menu item to open more files, without closing the already opened files. :li.Click the "File - Open Special" to load help files based on an Environmnt Variable that was previous set. :li.Reload a recently viewed file from the "File - Open Recent" menu. :eul. :p. Once the file is loaded, you should see the :link reftype=hd refid='contents'.table of contents:elink. and the first help topic. :p. :hp2.Loading Multiple Files Together:ehp2. :p. DocView can load multiple files at once, presenting them as if they were one book, and read environment variables for filenames. :p. For example, on my system I can do the following: :xmp. docview FPCHELP :exmp. which loads the whole Free Pascal help library on my system. FPCHELP is an environment variable set in ~/.profile (Linux) or config.sys (Windows) consisting of "rtl+fcl+ref" which tells DocView to load the help files rtl.inf, fcl.inf and ref.inf. The files are searched for in the path specified by two :link reftype=hd refid='L_EnvironmentVariables'.environment variables:elink.. :p. The files are all loaded and effectively appended to each other. :p. Being able to load multiple files like this can be helpful for various reasons. For example, I use this method to integrate DocView with the various IDE's (Integrated Development Environments) I use. I can then easily search for help on language keywords, source code classes or units etc. :p. You can also open additional help files by selecting the "File - Open additional file" menu option. .* TODO .* :p. .* When you click a link to a different help file&comma. DocView loads the other .* file without closing your current files&per. :p. At any time, you can find out what files are open by using the "Help - Show help file header info" menu option. :p. :hp2.Loading Additional Files:ehp2. :p. You can select the "File - Open additional file" menu option, and DocView will open the file you have selected without closing the currently opened files. .* TODO .* :p.:hp2.Drag and Drop:ehp2. .* :p.You can drag and drop &per.INF or &per.HLP files onto DocView and they will .* be opened&per. If you hold down the Shift key&comma. they will be opened without .* closing the current files&per. .* :p.You can drop files onto any of the main content areas&comma. such as the .* Contents or Index windows&comma. or an existing topic window&per. .* :note text='Note:'.Some links that go across files&comma. will only work if the correct set of .* files is loaded&per. .* ************************************************************ .* Help Icons .* ************************************************************ :h2 res=17 id='HelpIcons'.Help Icons :hp2.Help Icons:ehp2. :p. Help Icons on the desktop are usually "program shortcuts" or "filesystem objects". Details on how to create a program shortcut for DocView, or how to associate INF files to be opened with DocView, is beyond the scope of this document. Please see the help of your operating system for more information. :p. Saying that, with the fpGUI source code, in the "docview/install" directory, there is some information on how to setup a Gnome desktop with DocView. Unfortunately those instructions don't seem to work on all Linux or FreeBSD systems, so you again need to refer to your desktop system's help for guidance. .* :p.Some programs create these icons automatically at install time&per. .* :p.You can create these icons yourself by using the desktop program .* template&per. See desktop help for more information&per. .* :p.If you create icons by dragging help files to the desktop&comma. then you .* cannot give them a meaningful title&comma. because that would change the name of .* the file&comma. which might prevent programs from finding the help file&per. .* Therefore program objects are currently the recommended means of creating help .* icons&per. .* ************************************************************ .* Navigation Panel Tabs .* ************************************************************ :h1 res=200 id='NavigationPanel'.Navigation Panel Tabs :hp2.Navigation Panel Tabs:ehp2. :p. The left hand panel contains several tabs for moving through the current help file in different ways. :ul. :li.:link reftype=hd refid='contents'.Contents:elink. :li.:link reftype=hd refid='index'.Index:elink. :li.:link reftype=hd refid='search'.Search:elink. :li.:link reftype=hd refid='notes'.Notes:elink. :li.:link reftype=hd refid='history'.History:elink. :eul. :p.You can hide this panel to get more space, by draging the splitter bar .* :artwork runin name='images\navigator.bmp'. or by selecting View to the left, or simply double-clicking on the splitter bar. To show the Left Panel again, drag the splitter bar to the right. :p. The last location of the splitter bar (width of the Left Panel) is remembered between DocView sessions. So when you open DocView, the Left Panel is the same width as the last time you used DocView. .* TODO .* :p.You can stop the navigation panel from appearing when a help file is opened .* in Tools &endash. Options &endash. General tab&per. .* ************************************************************ .* Contents View .* ************************************************************ :h2 res=4 id='contents'.Contents View :i1 id=30006.Table of Contents :hp2.Table of Contents:ehp2. :p. Most help files have a table of contents that shows you the topics in the file, in a hierarchy or "tree". This is usually the first view you see when you open a file. :p. You can expand or collapse branches on the tree by clicking the [+] or [-] buttons, or using the left and right arrow keys on the keyboard. :p. To view a topic from the contents, just click on it. You can also move through the contents by using the arrow keys. :p. To move through :hp2.all:ehp2. topics in the contents tree, in order, you can use the .* TODO .* Ctrl &plus. Up and Ctrl &plus. Down&comma. or the "Previous" .* :artwork runin name='images\previous.bmp'. and "Next" .* :artwork runin name='images\next.bmp'. buttons on the toolbar. This is one way to treat the help file as a normal book, reading through each page. :p. You can also review the whole table of contents by using "Expand All" in the tree view's popup menu. This expands all the branches of the contents table so you can quickly look through it. However, it's usually easier to use :link reftype=hd refid='search'.Search:elink. or :link reftype=hd refid='Index'.Index:elink. for this purpose. .* ************************************************************ .* Index .* ************************************************************ :h2 res=5 id='index'.Index :hp2.About the Index:ehp2. :p. The Index tab contains an alphabetical listing of topics or keywords in the help file. You can quickly search through it just by typing the first few characters of the word you want to look up. DocView jumps to the first match in the index automatically. To view the highlighted topic, press enter. :note text='Note:'. Help files may or may not include an "official" index. The index is manually created by the author, so (for the original OS/2 View program) it's usefulness is strictly dependent on how much work the author put into it. There may not even be Index information in the help file. :p. However, a useful index can be provided simply by listing the titles of each topic alphabetically, and this is what DocView does. It then merges the original index (if any) with the list of topic titles. :p. If for some reason you don't like this, you can change this behaviour in "Settings - Options - General" tab. There are three options to choose from. :dl tsize=16. :dt.Alphabetical :dd.All topics from the table of content are sorted and displayed as an Index. :dt.File Only :dd.Only the "official" index created by the author of the help file is used. Some help files don't include an official index, so then the Index listbox will be empty. :dt.Full :dd.Both the topics and the official index are combined to display a larger and more useful Index to the user. This is the default option. :edl. .* ************************************************************ .* Search .* ************************************************************ :h2 res=6 id='search'.Search :hp2.Searching:ehp2. :p. Searching is a quick way to find information, when you don't know where to start. Simply go to the Search tab, type some related words and press Enter, or click the Go button. You'll see a listing of all topics containing that word, or words like it, with the best matches at the top. The best match will be displayed automatically. :p. Words that matches your search are highlighted in the topic. .* TODO .* :p. .* :hp2.Global search:ehp2. .* :p.You can also search all help files on your system using the :link reftype=hd .* refid='GlobalSearch'.global search:elink. in "Settings - Search all Help .* Files". :p. :hp2.Phrase search:ehp2. :p. If you want to search for a phrase made up of more than one word, put double quotes around it, for example "os/2 warp". :p. :hp2.Matching features:ehp2. :p. DocView allows you finer control of searching. You can add either of the two symbols directly infront of a word (no spaces between symbol and word), to narrow down a search even more. :dl compant tsize=15. :dt.+ (plus sign) :dd.indicates a word that :hp2.must:ehp2. be matched :dt.- (minus sign) :dd.indicates a word that must :hp2.not:ehp2. be matched :edl. :p. To make searching even more useful, DocView implements a special search algorithm which does partial word matches. That is, if you search for "win", DocView will also find "window", "following", "showing" etc. However, the better the match is the higher the rank will be. The search rank is displayed in square brackets behind each search result. Searches are :hp2.not:ehp2. case-sensitive. :p. :hp2.How DocView ranks results:ehp2. :p.DocView ranks matching topics by various means: :ul. :li.a closer match to a full word :li.number of matching words in a topic :li.matches within the title :li.matches within an index entry :eul. .* ************************************************************ .* Notes .* ************************************************************ :h2 res=7 id='notes'.Notes :hp2.Adding and Using Notes:ehp2. :p. DocView allows you to add notes &lpar.annotations&rpar. to your help files&per. :p.To add a note&comma. simply click where you want to make a note and click the &odq.Note&cdq. button .* :artwork runin name='images\note.bmp'. &comma. then type your text and click OK&per. The text will be inserted into the help topic with a different color &lpar.default is green&semi. you can change this in Tools &endash. Options &endash. Colors&rpar.&per. :p.To edit or delete a note&comma. click on the colored note text&semi. you can then edit the note text&comma. or click on delete to get rid of it&per. :p.You can also review all the notes that you&apos.ve made in the current help file&lpar.s&rpar. by going to the Notes tab&semi. this allows you to add&comma. edit and delete&comma. and also jump to the topics containing your notes&per. :p. :p.Notes are saved in a file with the extension &per.nte&comma. in the same directory as the help file they are for&per. :note text='Note:'.If a help file is changed &lpar.for example a program is upgraded&rpar. then notes will no longer appear in the correct place&semi. however&comma. you can still read them from the Notes tab&per. .* ************************************************************ .* History .* ************************************************************ :h2 res=21 id='history'.History :p.:hp2.About the History:ehp2. :p. .* .* .* ************************************************************ .* Global Search .* ************************************************************ :h1 res=18 id='GlobalSearch'. Global Search :p.:hp2.Global search:ehp2. :p.You can search all help files on your system&comma. by clicking the Search All button .* :artwork runin name='images\search.bmp'. &comma. using Tools &endash. Search all Help Files in the menu&comma. or pressing Ctrl&plus.S&per. :p.This search works similarly to :link reftype=hd refid='search'.searching within a file:elink.&comma. but it also tells you what help file the results were found in&per. :p.These searches may take some time&comma. depending on what you search for&per. You can stop the search at any time&per. :p.:hp2.Where DocView searches:ehp2. :p.The default is to search for help files in the help paths&comma. which are specified by the BOOKSHELF and HELP :link reftype=hd refid='L_EnvironmentVariables'.environment variables:elink.&per. :p.You can choose other places to search by choosing from the drop&endash.down list&comma. or customise the list by clicking the Select button&per. :p.:hp2.Search in&colon. Standard Help Paths:ehp2. :p.This is the default and will search BOOKSHELF and HELP as specified above&per. :p.Clicking the select button will allow you to choose which of the directories in the help paths will be used&per. Click each item in the list to select or de&endash.select it&per. After you choose this&comma. the location will show as &odq.Selected Help Paths&cdq. :p.:hp2.Search in&colon. All Hard Drives:ehp2. :p.This option will search all hard &lpar.non&endash.removable&rpar. drives on your system&per. You can click &odq.Select&per.&per.&per.&cdq. to customise the location&per. :p.Searching drives can find more help files&comma. but might be much slower than just the help paths&per. :p.:hp2.Search in&colon. Selected Help Paths:ehp2. :p.If you have already selected particular help paths to search&per.&comma. you can click &odq.Select&per.&per.&per.&cdq. to customise again&per. :p.:hp2.Search in&colon. Directory List:ehp2. :p.In the &odq.Select Directories&cdq. dialog&comma. clicking the &odq.Add&per.&per.&per.&cdq. button will allow you to add one or more directories to the search list&per. :p.Select the drive and directory using the controls that appear&comma. then click &odq.<. Add Directory&cdq. to add the chosen directory&per. You can do this as many times as you like&per. Choose &odq.With sub&endash.directories&cdq. if you want sub&endash.directories of the selected directory to be searched as well&per. In this case&comma. &per.&per.&per. will show on the end of the directory&per. :p.After you add a custom directory like this&comma. the location for searching will show as &odq.Directory List&cdq.&per. :note text='Note:'.If you add a custom directory to standard or selected help paths&comma. then the list will become a custom list&comma. and you can no longer re&endash.select help paths&per. To get back to the original help paths&comma. choose &odq.Standard Help Paths&cdq. then click &odq.Select&per.&per.&per.&cdq. again&per. :p.:hp2.Search in&colon. Typing a location:ehp2. :p.You can type a drive or directory into the &odq.Search in&colon.&cdq. entry field&per. Add &odq.&per.&per.&per.&cdq. on the end of the directory if you want to search subdirectories as well&per. :p.Example&colon. :p. Search in&colon. &lbracket. E&colon.&bsl.mydocs&bsl.&per.&per.&per. &rbracket. :p.This will search help files in E&colon.&bsl.mydocs&bsl. and any subdirectories&per. .* .* .* ************************************************************ .* Bookmarks .* ************************************************************ :h1 res=8 id='bookmarks'. Bookmarks :p.:hp2.Bookmarks:ehp2. :p. :p.DocView allows you to bookmark particular topics within the current help file&per. Simply click the bookmark button .* :artwork runin name='images\bookmark.bmp'. to add the current topic as a bookmark&per. :p.To jump to a bookmark&comma. go to the &odq.Bookmarks&cdq. menu&comma. and click on the bookmark you want to open&per. :p.You can view or delete all your bookmarks by clicking on &odq.Edit&per.&per.&cdq. in the &odq.Bookmarks&cdq. menu&per. This window can remain open while you read&comma. so that you can quickly look through your bookmarks&per. :p. :note text='Note:'. :p.DocView bookmarks remember all the topic windows that are open&comma. if there is more than one&per. :p.Bookmarks are saved in a file with the extension &per.bmk&comma. in the same directory as the help file they are for&per. .* .* .* ************************************************************ .* Internet Links .* ************************************************************ :h1 res=100 id='InternetLinks'. Internet Links :p.:hp2.Internet Links:ehp2. :p.When you click a web URL like http&colon.&slash.&slash.www&per.google&per.com&comma. DocView launches your default web browser&per. :p.This web browser is specified by operating system settings&comma. not DocView itself&per. To configure it&comma. you can open a URL object on the desktop&comma. edit the browser path in the :hp2.Browser:ehp2. tab&comma. then click Set Default&per. Alternatively&comma. download the utility ConfigApps from Hobbes :p. http&colon.&slash.&slash.hobbes&per.nmsu&per.edu&slash.cgi&endash.bin&slash.h&endash.search?key&eq.configapps .br :p.Browsers may also have the ability to make themselves the default&comma. either at install time or in preferences&per. :p.Email&comma. Newsgroups and FTP links are also passed to the web browser&per. At this time&comma. it isn&apos.t possible to choose a different program for these links&per. :p.:hp2.Note to help file authors:ehp2. :p.The original View had no understanding of URL or email links&comma. so the only way to implement them was a link to&comma. for example&comma. &odq.netscape&per.exe&cdq. with the correct parameters&per. :p.DocView translates program links to &odq.netscape&cdq.&comma. &odq.explore&cdq. or &odq.mozilla&cdq. into links to the default browser&per. :p.It also auto&endash.detects URLs in the forms&colon. :p. http&colon.&slash.&slash.x https&colon.&slash.&slash.x ftp&colon.&slash.&slash.x :p. mailto&colon.x news&colon.x :p.Things that look like URLs are also detected&comma. even without the protocol prefix&colon. :p. www&per.a&per.b &endash. browser :p. ftp&per.a&per.b &endash. ftp :p. a&atsign.b&per.c &endash. email :p.where a&comma. b and c are any alphanumeric string&per. :p.You don&apos.t need to do anything for DocView to recognise these&per. .* .* .* ************************************************************ .* Command Line .* ************************************************************ :h1 res=9 id='CommandLine'. Command Line Parameters :p.:hp2.Command Line Parameters:ehp2. :p.When you run DocView from the command line you can supply various parameters&per. None of them are required&per. :p. :p.:hp2.DocView &lbracket.options&rbracket. &lbracket.<.filename>. &lbracket.<.search text>.&rbracket.&rbracket.:ehp2. :p.If DocView is installed as a replacement for view&comma. then the command starts with view instead of DocView&per. :p.:link reftype=hd refid='CommandLineExamples'.Examples:elink. .* :p.:hp2.<.filename>.:ehp2. :p.The file for DocView to load&per. You can load multiple files at once by using filename1&plus.filename2 etc&per. .br If a path isn&apos.t specified&comma. then the files are searched for in the :link reftype=hd refid='L_EnvironmentVariables'.BOOKSHELF and HELP paths:elink.&per. .br If you path and&slash.or filename contains special characters (like blank) then you have to enclose the filename in double qoutes&per. .* :p.:hp2.<.search text>.:ehp2. :p.Search topic titles and index entries for this text&per. This is :hp2.not:ehp2. the same as a normal search&comma. for compatibility with original View&per. To do a proper search use the &slash.s option &lpar.see below&rpar.&per. For more details&comma. see :link reftype=hd refid='CommandLineTopicSearch'.Command Line Topic Search:elink.&per. :p.:hp2.Options:ehp2. :p.:hp2.&slash.s:ehp2. :p.After opening the file&comma. performs a :link reftype=hd refid='search'.search:elink. for the given text (do a real full text search intead of the default topic titles search)&per. The result is the same as performing the search from the :link reftype=hd refid='search'.serach navigation panel:elink.&per. :p.Example&colon. .br :lm margin=4. To search for copy in the whole cmdref document you can call :xmp. DocView &slash.s cmdref copy :exmp. DocView is clever enought to handle multiple words (like the :link reftype=hd refid='search'.serach navigation panel:elink.)&per. This is a OR search&per. :xmp. DocView &slash.s cmdref net access :exmp. To perform a AND search enclose the search phrase in double quotes&per. :xmp. DocView &slash.s cmdref &odq.net access&cdq. :exmp. :lm margin=1. .* :p.:hp2.&slash.g:ehp2. :p.Performs a :link reftype=hd refid='GlobalSearch'.global search:elink. for the given text&comma. on all the help files in your system&per. :p.Example&colon. .br :lm margin=4. To search for copy in all help files use :xmp. DocView &slash.g copy :exmp. Provide the file name as first parameter if you like to open a help file before the search starts. :xmp. DocView &slash.g cmdref copy :exmp. :lm margin=1. .* :p.:hp2.&slash.?:ehp2. or :hp2.&slash.h:ehp2. or :hp2.&slash.help:ehp2. :p.Show command line help :p.See also&colon. :link reftype=hd refid='AdvancedParameters'.Advanced Parameters:elink. .* ************************************************************ .* Command Line Topic Search .* ************************************************************ :h2 res=13 id='CommandLineTopicSearch'. Command Line Topic Search :p.:hp2.Command line topic search:ehp2. :p. view <.filename>. <.topic>. :p.The topic search parameter specified on the command line&comma. copies the behaviour of old view&per. :p.Text within topics is not searched&comma. only titles and index entries&per. This makes it less useful to humans&comma. but is used by some programs to reference help topics in a predictable way&per. :p.You can use multiple words here&per. :p.The search performed is&colon. :p.&endash. topic title starts with search text :p.&endash. index entry starts with search text :p.&endash. topic title contains search text :p.&endash. index entry contains search text&per. :p.Developers should make sure that the expected document will be found if using this technique to identify topics when starting New or Old view&per. .* ************************************************************ .* Advanded Parameters .* ************************************************************ :h2 res=14 id='AdvancedParameters'. Advanced Parameters :p.:hp2.Advanced Parameters:ehp2. :p.The following command line parameters are intended mainly for software developers&comma. but can be used for any purpose&per. :p.:hp2.&slash.lang&colon.<.language spec>.:ehp2. :p.Loads the specified language&per. Overrides the default chosen based on the LANG environment variable&per. For example&comma. :xmp. DocView cmdref &slash.lang&colon.en :exmp. loads English&per. See readme&per.txt for more information&per. :p.:hp2.&slash.pos&colon.<.left>.&comma.<.bottom>.&comma.<.width>.&comma.<.height>.:ehp2. :p.Set the main program window to the given position and size&per. All values must be given&per. Put a :hp2.P:ehp2. after a number to specify a percentage&per. For example&colon. :xmp. DocView &slash.pos&colon.10P&comma.10P&comma.80P&comma.80P :exmp. :p.makes the window centered and 80&percent. of the screen size&per. :p.:hp2.&slash.title&colon.<.window title>.:ehp2. :p.Sets the title of the DocView window to the specified text&comma. overriding whatever appears in the help file&per. The text &odq.Help &endash. &cdq. will always be inserted in front of the specified text&comma. unless the specified text is &odq.help&cdq.&comma. in which case the title will simply become &odq.Help&cdq.&per. This is to make sure that help windows are always obvious as such in the window list&per. :p.If you need to specify multiple words&comma. surround the entire option with quotes&comma. for example&colon. :xmp. DocView cmdref &odq.&slash.title&colon.Command Line Help&cdq. :exmp. .* ************************************************************ .* Command Line Examples .* ************************************************************ :h2 res=15 id='CommandLineExamples'. Command Line Examples :p.:hp2.Command Line Examples:ehp2. .* :p.The following examples assume that DocView is installed as a complete replacement and therefore view is actually DocView&per. :p.:hp2.view cmdref:ehp2. :lm margin=4. :p.Open the file cmdref&per.inf &lpar.OS&slash.2 Command Reference&rpar. from the help path&per. :lm margin=1. .* :p.:hp2.view cmdref&plus.os2ug:ehp2. :lm margin=4. :p.Open two files&comma. cmdref&per.inf and os2ug&per.inf &lpar.OS&slash.2 User Guide&rpar.&comma. in the same window&per. .br The table of contents from os2ug&per.inf is added to the end of the contents from cmdref&per.inf&per. The indexes are combined alphabetically&per. :lm margin=1. .* :p.:hp2.view c&colon.&bsl.os2&bsl.book&bsl.os2ug&per.inf:ehp2. :lm margin=4. :p.Open the file os2ug&per.inf in the c&colon.&bsl.os2&bsl.book directory&per. :lm margin=1. .* :p.:hp2.view &odq.c&colon.&bsl.os2 book&bsl.os2ug&per.inf&cdq.:ehp2. :lm margin=4. :p.Surround path&bsl.file with double quotes if they contain special characters (like blank)&per. :lm margin=1. .* :p.:hp2.view cmdref dir:ehp2. :lm margin=4. :p.Open the file cmdref &lpar.OS&slash.2 command reference&rpar. and look in titles and index for the word &odq.dir&cdq.&per. Will show the help page for the DIR command&per. :lm margin=1. .* :p.:hp2.view &slash.s os2ug desktop:ehp2. :lm margin=4. :p.Open the file os2ug&per.inf and search for the word &odq.desktop&cdq.&per. The best match is shown&per. :lm margin=1. .* :p.:hp2.view &slash.g permissions:ehp2. :lm margin=4. :p.Performs a search of all help files for the word &odq.permissions&cdq.&per. :lm margin=1. .* :p.:hp2.set myhelp&eq.cmdref&plus.os2ug&plus.rexx:ehp2. .br :hp2.view myhelp:ehp2. :lm margin=4. :p.The first line sets an environment variable MYHELP to contain the names of three help files&per. The second line opens the three files&per. :lm margin=1. .* .* .* ************************************************************ .* Keyboard Shortcuts .* ************************************************************ :h1 res=10 id='KeyboardShortcuts'. Keyboard Shortcuts :p.:hp2.Keyboard Shortcuts:ehp2. :p.Most keyboard shortcuts are visible in the menu&comma. but a few are not&per. The additional shortcuts are&colon. :p.:hp2.Alt&plus.F4:ehp2. Exit :p.:hp2.Ctrl&plus.C:ehp2. Copy selected text to clipboard :p.:hp2.F7:ehp2. Back :p.:hp2.F8:ehp2. Forward :p.:hp2.Ctrl&plus.Left:ehp2. Back :p.:hp2.F11:ehp2. Previous in contents :p.:hp2.F12:ehp2. Next in contents :p. :p.:hp2.Shortcuts visible in the menu:ehp2. :p.:hp2.Ctrl&plus.O:ehp2. Open files :p.:hp2.Ctrl&plus.E:ehp2. Open files from help paths :p.:hp2.Ctrl&plus.N:ehp2. Open a new window :p.:hp2.Ctrl&plus.P:ehp2. Print topic :p.:hp2.F3:ehp2. Exit :p. :p. :p.:hp2.Ctrl&plus.A:ehp2. Select all text in topic :p.:hp2.Ctrl&plus.Ins:ehp2. Copy selected text to clipboard :p. :p.:hp2.Ctrl&plus.F:ehp2. Find within current topic :p.:hp2.Ctrl&plus.G:ehp2. Repeat last find :p. :p.:hp2.Ctrl&plus.S:ehp2. Open global search tool :p. :p.:hp2.Alt&plus.C:ehp2. Change to the contents tab :p.:hp2.Alt&plus.I:ehp2. Change to the index tab :p.:hp2.Alt&plus.S:ehp2. Change to the search tab :p.:hp2.Alt&plus.N:ehp2. Change to the notes tab :p.:hp2.Alt&plus.P:ehp2. Toggle the left panel &lpar.tabs&rpar. on and off :p.:hp2.F5:ehp2. Expand all contents :p.:hp2.F6:ehp2. Collapse all contents :p. :p.:hp2.Esc:ehp2. Back :p.:hp2.Ctrl&plus.Right:ehp2. Forward :p.:hp2.Ctrl&plus.Up:ehp2. Previous topic in contents :p.:hp2.Ctrl&plus.Down:ehp2. Next topic in contents :p. :p.:hp2.Ctrl&plus.D:ehp2. Edit bookmarks :p.:hp2.Ctrl&plus.B:ehp2. Bookmark current topic :p. :p.:hp2.Ctrl&plus.M:ehp2. Add note at cursor position :p. :p.:hp2.F1:ehp2. Help for DocView .* .* .* ************************************************************ .* Environment Variables .* ************************************************************ :h1 res=11 id='L_EnvironmentVariables'. Environment Variables :p.:hp2.Environment Variables:ehp2. :p. :p.Both the :hp2.BOOKSHELF:ehp2. and :hp2.HELP:ehp2. environment variables define paths &lpar.lists of directories&rpar. for searching for help files&per. DocView uses both paths without distinction&per. :p.These paths are searched when you&colon. :p.o specify a help file without a path on the command line :p.o use the File &endash. Open Special&per.&per.&per. menu item :p.o do a :link reftype=hd refid='GlobalSearch'.global search:elink. :p.You can permanently add directories of help files to the :hp2.HELP:ehp2. or :hp2.BOOKSHELF:ehp2. paths by modifying the CONFIG&per.SYS file&per. Add to both paths&comma. if you also want old view to be able to find the files&per. :p.:hp2.Other environment variables:ehp2. :p.The :hp2.LANG:ehp2. environment variable is examined to decide the default language that DocView will be displayed in&per. &lpar.Overridden by the &slash.lang :link reftype=hd refid='AdvancedParameters'.command line parameter:elink.&per.&rpar. See the DocView readme&per.txt for more information about languages&per. :p.The directory defined in :hp2.LOGFILES:ehp2. is used for logging crashes or other information&per. :p.The subdirectory &odq.lang&cdq. under the directory defined by :hp2.OSDIR:ehp2. is searched for language files at startup&per. :p.The path :hp2.ULSPATH:ehp2. is also searched for language files&per. .* .* .* ************************************************************ .* For Authors and Developers .* ************************************************************ :h1 res=20 id='ForAuthors'. For Authors and Developers :p.:hp2.For Authors and Developers:ehp2. :p. :p.This section contains some notes for document authors and software developers&per. :p.Also see the section about URL recognition in the :link reftype=hd refid='InternetLinks'.Internet Links :elink.topic&per. .* ************************************************************ .* Writing Help Files .* ************************************************************ :h2 res=12 id='WritingHelpFiles'. Writing Help Files :p.:hp2.Writing OS&slash.2 Help Files :ehp2. :p. :p.OS&slash.2 Help Files are produced using the IPF Compiler&per. IPF stands for Information Presentation Facility&per. :p.The IPF Compiler takes a text file written in a language that tells it about things like headings&comma. links&comma. text and images&comma. and produces either a &per.INF or &per.HLP file&per. :p.The official way to obtain the IPF compiler &lpar.ipfc&per.exe&rpar. is from the OS&slash.2 Developers Toolkit&per. This is included free with eComStation &lpar.http&colon.&slash.&slash.www&per.ecomstation&per.com&rpar.&per. :p.Since the language for IPFC is tedious &lpar.for example all punctuation must be typed as special keywords&comma. like &.comma&per.&rpar. many people use other tools besides the IPF compiler itself&per. :p.I use Vyperhelp &lpar.http&colon.&slash.&slash.www&per.vyperhelp&per.com&rpar. since it is simple and graphical&per. It can also export to Windows Help&comma. HTML and others&comma. though it only runs on OS&slash.2&per. Not free&per. :p.Some other popular options are&colon. :p.o HyperText&slash.2 IPF Preprocessor &lpar.http&colon.&slash.&slash.www&per.clanganke&per.de&slash.os2&slash.sw&slash.htext&slash. .br &rpar. &endash. preprocesses a simpler starting language into the very difficult IPF format&per. Free&per. :p.o HyperMake &lpar.http&colon.&slash.&slash.www&per.hypermake&per.com&rpar.&per. Similar&comma. but can also produce Windows Help and HTML&per. :p.o Sibyl &lpar.which DocView was created with&rpar. comes with an IPF preprocessor&per. :p.o IPFEditor from PCS &lpar.http&colon.&slash.&slash.www&per.pcs&endash.soft&per.com&slash.productipfe212&per.htm .br &rpar.&per. Probably the most complete&comma. but significant cost&per. Note&colon. DocView doesn&apos.t support everything IPFE can do&xclm. .br In the past there were many other options&per. Those listed should still be available and have some support&per. .* ************************************************************ .* Topic Resource IDs .* ************************************************************ :h2 res=16 id='TopicResourceIDs'. Topic Resource IDs :p.:hp2.Topic Resource IDs:ehp2. :p.Resource IDs are used by authors of online help for applications&comma. to identify help topics&per. Applications call the Help Manager specifying a resource ID&comma. either directly using the HM&us.DISPLAY&us.HELP message&comma. or indirectly via help tables added to their resources&comma. which PM automatically handles&per. The resource ID is stored in a table inside the help file&per. :p.For document authors&comma. DocView offers the ability to see and find resource IDs&per. :p.:hp2.Finding by Resource ID:ehp2. :p.Use Tools &endash. Find Resource ID to search for a specified resource ID in all opened files&per. :p.:hp2.Displaying Resource IDs:ehp2. :p.Use topic properties &lpar.right mouse click &endash. Properties&rpar. to see which resource IDs are associated with a topic&per. .* ************************************************************ .* TopicNames .* ************************************************************ :h2 res=19 id='TopicNames'. Topic Names :p.:hp2.Topic Names:ehp2. :p. :p.Like resource IDs&comma. topic names can be used by developers to link to help topics from within their application&comma. using the HM&us.DISPLAY&us.HELP message with parameter 2 being HM&us.PANELNAME&per. :p.These are not so often used&per. :p.DocView can find a particular topic name&comma. using Tools &endash. Find Topic Name&per. :euserdoc.