Changeset 451 for trunk/i18n/NewView.ipf


Ignore:
Timestamp:
Aug 16, 2022, 5:16:25 AM (3 years ago)
Author:
Lewis Rosenthal
Message:

EN: Update help (minor edits).
DE: Update help, messages, build script; add readme.
ES: Update help (minor edits.
RU: Update messages; add help, build script.

File:
1 edited

Legend:

Unmodified
Added
Removed
  • trunk/i18n/NewView.ipf

    r445 r451  
    11:userdoc.
    22:docprof toc=123456.
    3 :title.NewView Help
    43.nameit symbol=prod text='NewView'
    54.nameit symbol=os2 text='OS/2'
    65.nameit symbol=ecs text='eComStation'
    76.nameit symbol=aos text='ArcaOS'
     7:title.&prod. Help
    88.* ************************************************************
    99.* Subject: Help for NewView
    10 .* Version: 2020070501
     10.* Version: 2020070502
    1111.* Copyright: Copyright 2004-2005 Aaron Lawrence
    1212.* Copyright: Copyright 2006-2019 Ronald Brill
     
    2323:i1 id=30001.support
    2424:p.:artwork runin name='images\NewView.bmp'.
    25 :hp2.Welcome to NewView!:ehp2.
    26 :p.
    27 :p.NewView is a program for reading OS/2, &ecs., and &aos. Help
    28 Files.
     25:hp2.Welcome to &prod.!:ehp2.
     26:p.
     27:p.&prod. is a program for reading &os2., &ecs., and &aos. help
     28files.
    2929:p.:link reftype=hd refid='Support'.Support and Licensing:elink.
    30 :p.:link reftype=hd refid='Using'.Using NewView:elink.
    31 :p.:hp1.To stop this file appearing when you start NewView without specifying a
     30:p.:link reftype=hd refid='Using'.Using &prod.:elink.
     31:p.:hp1.To stop this file appearing when you start &prod. without specifying a
    3232help file, see Tools - Options - General tab.:ehp1.
    3333:p.:hp2.History:ehp2.
    34 :p.NewView replaces the original IBM program supplied with OS/2.
     34:p.&prod. replaces the original IBM program supplied with &os2..
    3535:p.It improves upon many aspects of View, with a modern, easy to use
    3636interface, more options, and new features that View simply
     
    4444:i1 id=30003.bugs
    4545:i1 id=30004.source code
    46 :p.NewView is Copyright 1999-2006 Aaron Lawrence. It is also licensed
     46:p.&prod. is Copyright 1999-2006 Aaron Lawrence. It is also licensed
    4747under the GNU Public License, which means you have the right to obtain the
    4848source code.
     
    5050improvements have been added by Alexander Taylor.
    5151.br
    52 NewView is a Netlabs project.
     52&prod. is a Netlabs project.
    5353:p.See the Readme.txt for more technical details.
    54 :p.See the Changes.txt file for a history of changes to NewView.
    55 :p.If you find NewView helpful, please let us know and/or make a
     54:p.See the Changes.txt file for a history of changes to &prod..
     55:p.If you find &prod. helpful, please let us know and/or make a
    5656donation to support further development. It's nice to hear from you!
    5757:ul.
    5858:li.Suggestions, compliments or bug reports https&colon.//trac.netlabs.org/newview
    59 :li.Translate NewView to your language.
     59:li.Translate &prod. to your language.
    6060:li.A donation to Netlabs https&colon.//www.arcanoae.com/shop/netlabs/
    6161:eul.
     
    6666log file will be EITHER
    6767.br
    68  - in the same directory as NewView itself
     68 - in the same directory as &prod. itself
    6969.br
    7070 - in the folder set by LOGFILES environment variable (typically eCS
     
    7676it would be helpful if you could include it for verification&colon.
    7777:ul.
    78 :li.NewView version (Help - Product Information)
     78:li.&prod. version (Help - Product Information)
    7979:li.The filenames of the help files.
    8080:li.A screenshot may be useful, if the problem is an incorrect or corrupt
     
    9292
    9393.* ----------------------------------------------------------------------------
    94 :h1 res=2 id='Using'.Using NewView
     94:h1 res=2 id='Using'.Using &prod.
    9595:p.Once you have :link reftype=hd refid='OpeningFiles'.opened a
    9696file:elink., you can read it in various ways.
     
    109109 buttons to go back to wherever you were before, or to retread your
    110110steps.
    111 :p.Colors and some of the behavior of NewView can be adjusted from the Tools
     111:p.Colors and some of the behavior of &prod. can be adjusted from the Tools
    112112- Options menu.
    113113:p.You can also :link reftype=hd refid='notes'.annotate:elink. or :link
     
    124124:p.- Click the Open button
    125125:artwork runin name='images\open.bmp'.
    126  from within NewView
     126 from within &prod.
    127127:p.- Reload a recently viewed file from the &odq.File&cdq. menu
    128128:p.- Drag and drop a Help file from the desktop
    129129:p.Once the file is loaded, you should see the :link reftype=hd
    130130refid='contents'.table of contents:elink. and the first topic.
    131 :note.This assumes you installed NewView as a replacement
     131:note.This assumes you installed &prod. as a replacement
    132132for original View. If you didn't then existing help icons and the
    133133command line may behave differently.
    134134:p.:hp2.Loading Multiple Files Together:ehp2.
    135 :p.NewView can load multiple files at once, presenting them as if they
     135:p.&prod. can load multiple files at once, presenting them as if they
    136136were one book, and read environment variables for filenames.
    137137:p.For example, with the OS/2 Developer's Toolkit
    138138documentation&colon.
    139139.br
    140   NewView cpref
     140  &prod. cpref
    141141.br
    142142loads the &odq.Control Program Guide and Reference&cdq.&per. CPREF is an environment
    143143variable set in config.sys, consisting of &odq.CP1&plus.CP2&plus.CP3&cdq.
    144 which tells NewView (or View) to load the help files CP1, CP2
     144which tells &prod. (or View) to load the help files CP1, CP2
    145145and CP3. The files are searched for in the path specified by two :link
    146146reftype=hd refid='L_EnvironmentVariables'.environment
     
    149149:p.Being able to load multiple files like this can be helpful for various
    150150reasons. For example, 4OS/2 (a CMD.EXE
    151 replacement) uses it to add it's own help on top of the original CMD
     151replacement) uses it to add its own help on top of the original CMD
    152152help. You can do it yourself with any files you like.
    153153:p.You can load multiple files in the Open File dialog by using Ctrl or Shift to
    154154select multiple files.
    155 :p.When you click a link to a different help file, NewView loads the other
     155:p.When you click a link to a different help file, &prod. loads the other
    156156file without closing your current files.
    157157:p.At any time, you can find out what files are open by using File
     
    159159:p.:hp2.Loading Additional Files:ehp2.
    160160:p.You can tick the &odq.Keep current files open&cdq. checkbox in the Open File
    161 dialog, and NewView will open the files you have selected without closing
     161dialog, and &prod. will open the files you have selected without closing
    162162the currently opened files.
    163163:p.:hp2.Drag and Drop:ehp2.
    164 :p.You can drag and drop .INF or .HLP files onto NewView and they will
     164:p.You can drag and drop .INF or .HLP files onto &prod. and they will
    165165be opened. If you hold down the Shift key, they will be opened without
    166166closing the current files.
     
    236236:p.The Index tab contains an alphabetical listing of topics or keywords in the
    237237help file. You can quickly search through it just by typing the first few
    238 characters of the word you want to look up. NewView jumps to the first match
     238characters of the word you want to look up. &prod. jumps to the first match
    239239in the index automatically. To view the highlighted topic, press
    240240enter.
    241241:nt.Help files may or may not include an &odq.official&cdq. index. The index is
    242 manually created by the author, so (for original View) it's
     242manually created by the author, so (for original View) its
    243243usefulness is strictly dependent on how much work the author put into it.
    244244There may not even be one.
    245245:p.However, a useful index can be provided simply by listing the titles of
    246 each topic alphabetically, and this is what NewView does. It then
     246each topic alphabetically, and this is what &prod. does. It then
    247247merges the original index (if any) with the list of topic titles.
    248248:p.If for some reason you don't like this, you can turn it off in
     
    267267double quotes around it, for example &odq.os/2 warp&cdq.&per.
    268268:p.:hp2.Matching features:ehp2.
    269 :p.NewView allows you finer control of searching.
     269:p.&prod. allows you finer control of searching.
    270270:p.&plus. indicates a word that :hp2.must:ehp2. be matched
    271271:p.- indicates a word that must :hp2.not:ehp2. be matched
    272 :p.NewView always does partial word matches. That is, if you search
    273 for &odq.win&cdq. NewView will also find &odq.window&cdq. and &odq.showing&cdq.&per. However, the
     272:p.&prod. always does partial word matches. That is, if you search
     273for &odq.win&cdq. &prod. will also find &odq.window&cdq. and &odq.showing&cdq.&per. However, the
    274274better the match is the higher the rank will be.
    275 :p.:hp2.How NewView ranks results:ehp2.
    276 :p.NewView ranks matching topics by various means&colon.
     275:p.:hp2.How &prod. ranks results:ehp2.
     276:p.&prod. ranks matching topics by various means&colon.
    277277:p.- a closer match to a full word
    278278:p.- number of matching words in a topic
     
    282282.* ----------------------------------------------------------------------------
    283283:h2 res=7 id='notes'.Notes
    284 :p.NewView allows you to add notes (annotations) to your help
     284:p.&prod. allows you to add notes (annotations) to your help
    285285files.
    286286:p.To add a note, simply click where you want to make a note and click the
     
    313313:p.These searches may take some time, depending on what you search
    314314for. You can stop the search at any time.
    315 :p.:hp2.Where NewView searches:ehp2.
     315:p.:hp2.Where &prod. searches:ehp2.
    316316:p.The default is to search for help files in the help paths, which are
    317317specified by the BOOKSHELF and HELP :link reftype=hd
     
    362362.* ----------------------------------------------------------------------------
    363363:h1 res=8 id='bookmarks'.Bookmarks
    364 :p.NewView allows you to bookmark particular topics within the current help
     364:p.&prod. allows you to bookmark particular topics within the current help
    365365file. Simply click the bookmark button
    366366:artwork runin name='images\bookmark.bmp'.
     
    372372that you can quickly look through your bookmarks.
    373373
    374 :note.NewView bookmarks remember all the topic windows that are open, if there
    375 is more than one.
     374:note.&prod. bookmarks remember all the topic windows that are open, if there
     375are more than one.
    376376:p.Bookmarks are saved in a file with the extension .bmk, in the same
    377377directory as the help file they are for.
     
    380380:h1 res=100 id='InternetLinks'.Internet Links
    381381:p.When you click a web URL such as
    382 https&colon.//www.google.com, NewView launches your
     382https&colon.//www.google.com, &prod. launches your
    383383default web browser.
    384 :p.This web browser is specified by operating system settings, not NewView
     384:p.This web browser is specified by operating system settings, not &prod.
    385385itself. To configure it, you can open a URL object on the
    386386desktop, edit the browser path in the :hp2.Browser:ehp2. tab, then
     
    393393:p.Browsers may also have the ability to make themselves the default,
    394394either at install time or in preferences.
    395 :p.NewView takes care of the setup done by Internet-Application-Integration (IAI). Email, Newsgroups and FTP
     395:p.&prod. takes care of the setup done by Internet-Application-Integration (IAI). Email, Newsgroups and FTP
    396396links are passed to the program you have configured. If there is no program for a specific url type,
    397397then the links are passed to the web browser.
     
    400400only way to implement them was a link to, for example,
    401401&odq.netscape.exe&cdq. with the correct parameters.
    402 :p.NewView translates program links to &odq.netscape&cdq., &odq.explore&cdq. or &odq.mozilla&cdq.
     402:p.&prod. translates program links to &odq.netscape&cdq., &odq.explore&cdq. or &odq.mozilla&cdq.
    403403into links to the default browser.
    404404:p.It also auto-detects URLs in the forms&colon.
     
    412412:p. a&atsign.b.c - email
    413413:p.where a, b and c are any alphanumeric string.
    414 :p.You don't need to do anything for NewView to recognize these.
     414:p.You don't need to do anything for &prod. to recognize these.
    415415
    416416.* ----------------------------------------------------------------------------
     
    437437.* ----------------------------------------------------------------------------
    438438:h1 res=9 id='CommandLine'.Command Line Parameters
    439 :p.When you run NewView from the command line you can supply various
     439:p.When you run &prod. from the command line you can supply various
    440440parameters. None of them are required.
    441 :p.:hp2.NewView &lbracket.options&rbracket. &lbracket.&lt.filename&gt.
     441:p.:hp2.&prod. &lbracket.options&rbracket. &lbracket.&lt.filename&gt.
    442442&lbracket.&lt.search text&gt.&rbracket.&rbracket.:ehp2.
    443 :p.If NewView is installed as a replacement for view, then the command
     443:p.If &prod. is installed as a replacement for view, then the command
    444444starts with view instead of newview.
    445445:p.:link reftype=hd refid='CommandLineExamples'.Examples:elink.
    446446
    447447:p.:hp2.&lt.filename&gt.:ehp2.
    448 :p.The file for NewView to load. You can load multiple files at once by
     448:p.The file for &prod. to load. You can load multiple files at once by
    449449using filename1&plus.filename2 etc.
    450450
     
    468468the default topic titles search). The result is the same as performing the search from
    469469the :link reftype=hd
    470 refid='search'.serach navigation panel:elink.&per.
     470refid='search'.search navigation panel:elink.&per.
    471471:p.Example&colon.
    472472.br
     
    475475newview /s cmdref copy
    476476:ecgraphic.
    477 NewView is clever enough to handle multiple words (like the :link reftype=hd
    478 refid='search'.serach navigation panel:elink.). This is a OR search.
     477&prod. is clever enough to handle multiple words (like the :link reftype=hd
     478refid='search'.search navigation panel:elink.). This is a OR search.
    479479:cgraphic.
    480480newview /s cmdref net access
     
    542542makes the window centered and 80&percent. of the screen size.
    543543:p.:hp2./title&colon.&lt.window title&gt.:ehp2.
    544 :p.Sets the title of the NewView window to the specified text, overriding
     544:p.Sets the title of the &prod. window to the specified text, overriding
    545545whatever appears in the help file. The text &odq.Help -  &cdq. will always be
    546546inserted in front of the specified text, unless the specified text is
     
    639639:p.:hp2.Ctrl&plus.I:ehp2. Save current document as IPF source file
    640640:p.
    641 :p.:hp2.F1:ehp2. Help for NewView
     641:p.:hp2.F1:ehp2. Help for &prod.
    642642
    643643.* ----------------------------------------------------------------------------
     
    645645:p.Both the :hp2.BOOKSHELF:ehp2. and :hp2.HELP:ehp2. environment variables
    646646define paths (lists of directories) for searching for help files.
    647 NewView uses both paths without distinction.
     647&prod. uses both paths without distinction.
    648648:p.These paths are searched when you&colon.
    649649:ul.
     
    657657:p.:hp2.Other environment variables:ehp2.
    658658:p.The :hp2.LANG:ehp2. environment variable is examined to decide the default
    659 language that NewView will be displayed in. (Overridden by the
     659language that &prod. will be displayed in. (Overridden by the
    660660/lang :link reftype=hd refid='AdvancedParameters'.command line
    661661parameter:elink.&per.) See the newview readme.txt for more information
     
    676676.* ----------------------------------------------------------------------------
    677677:h2 res=12 id='WritingHelpFiles'.Writing Help Files
    678 :p.OS/2 Help Files are produced using the IPF Compiler. IPF stands for
     678:p.&os2. help files are produced using the IPF Compiler. IPF stands for
    679679Information Presentation Facility.
    680680:p.The IPF Compiler takes a text file written in a language that tells it about
     
    700700:li.HyperMake (http&colon.//www.hypermake.com).
    701701Similar, but can also produce Windows Help and HTML.
    702 :li.Sibyl (used to create NewView) comes with an IPF preprocessor.
     702:li.Sibyl (used to create &prod.) comes with an IPF preprocessor.
    703703:eul.
    704704
    705 :note.NewView may not support everything these editors can produce.
     705:note.&prod. may not support everything these editors can produce.
    706706:p.In the past there were many other options. Those listed should still be
    707707available and have some support.
     
    715715which PM automatically handles. The resource ID is stored in a table inside
    716716the help file.
    717 :p.For document authors, NewView offers the ability to see and find
     717:p.For document authors, &prod. offers the ability to see and find
    718718resource IDs.
    719719:p.:hp2.Finding by Resource ID:ehp2.
     
    730730message with parameter 2 being HM&us.PANELNAME.
    731731:p.These are not so often used.
    732 :p.NewView can find a particular topic name, using Tools - Find
     732:p.&prod. can find a particular topic name, using Tools - Find
    733733Topic Name.
    734734:euserdoc.
Note: See TracChangeset for help on using the changeset viewer.