Changeset 88 for trunk/NLS/en/gotcha_en.ipf

Timestamp:

Aug 4, 2020, 5:13:02 PM (5 years ago)

Author:

lewisr

Message:

Add Spanish help and update English help. (Alfredo)

File:

• trunk/NLS/en/gotcha_en.ipf (modified) (18 diffs)

trunk/NLS/en/gotcha_en.ipf

@@ -6 +6 @@
 :h1 id=about res=1000.About &progname. and &quiet.
 :artwork name='..\..\data\gotcha.bmp' align=center.
-:p.&progname. is a small (well, not :hp1.that:ehp1. small any more)
-utility for OS/2 which allows you to easily capture windows, window interiors,
-parts of the screen or the whole desktop and save them to disk or
-clipboard. Many image formats are available. Installation of Heiko Nitzsche's
-:link refid=GBM reftype=fn.GBM.dll:elink. is now required to generate these images.
-
-:p.&progname. comes in 2 versions the original on screen
+:p.&progname. is a small (well, not :hp1.that:ehp1. small any more) utility for
+OS/2 which allows you to easily capture windows, window interiors, parts of the
+screen or the whole desktop and save them to disk or clipboard. Many image
+formats are available. Installation of Heiko Nitzsche's
+:link refid=GBM reftype=fn.GBM.dll:elink. is now required to generate these
+images.
+
+:p.&progname. comes in 2 versions: the original on-screen
 :link refid=mainwin reftype=hd.&progname.:elink. and
-:link refid=gotquiet reftype=hd.&quiet.:elink. a version that runs in
-the background, captures the print screen key combinations and does
-a capture based on your preferences.
-
-:p.&progname. also has features for automatic capture every "n"
-seconds and for capture of the whole screen and then exiting (for
-commandline scripts e.g.).
+:link refid=gotquiet reftype=hd.&quiet.:elink., a version that runs in the
+background, captures the Print Screen key combinations and does a capture based
+on your preferences.
+
+:p.&progname. also has features for automatic capture every "n" seconds and for
+capture of the whole screen and then exiting (for commandline scripts e.g.).
 
 :p.&progname. was originally written mainly because all other screen capture
@@ -38 +38 @@
 :fn id=GBM.
 Install using&colon.
+
 :p.Yum install GBMDLL from netlabs-rel or use ANPM
+
 :p.A zip package is available here&colon.
-http&colon.//hobbes.nmsu.edu/download/pub/os2/apps/graphics/gbmos2_176_bin.zip
+https&colon.//hobbes.nmsu.edu/download/pub/os2/apps/graphics/gbmos2_176_bin.zip
+
 :p.ArcaOS installs it by default.
 :efn.
@@ -59 +62 @@
 :dl break=all tsize=5.
 :dt.:hp2.Save image to:ehp2.
-:dd.Here you can select, where you want to store the captured image. To
-copy the image to the clipboard for pasting into other applications'
-documents select "Clipboard". If you want to write the image to a file
-to disk, select "File". Easy, isn't it? &colon.-)
+:dd.Here you can select where you want to store the captured image. To copy the
+image to the clipboard for pasting into other applications' documents select
+"Clipboard". If you want to write the image to a file to disk, select "File".
+Easy, isn't it? &colon.-)
 
 :p.If you selected "Prompt for filename" in the :link refid=settings1
 reftype=hd.settings notebook:elink., a file dialog will appear after the
-capture occurs where you can select or enter the filename the image
-should be saved as. If you activated "Autosave to numbered files",
-the filename will be determined automatically. It will try to
-include some information about what was captured as part of the name.
-If you selected "Force saving to file (&progname. only)", the image will
-always be written to exactly the file you specified there (even if you selected
-"Clipboard" here).
+capture occurs where you can select or enter the filename the image should be
+saved as. If you activated "Autosave to numbered files", the filename will be
+determined automatically. &progname. will try to include some information about
+what was captured as part of the name. If you selected "Force saving to file
+(&progname. only)", the image will always be written to exactly the file you
+specified there (even if you selected "Clipboard" here).
 
 :dt.:hp2.Options:ehp2.
 :dd.Check "Hide &progname." (&progname. only) if you want the &progname.
 window to disappear from the screen before the capture starts. Useful if
-you want to capture a maximized window the full screen without &progname.
+you want to capture a maximized window, or the full screen without &progname.
 or something under &progname..
+
 :p. Check "Don't reshow" (&quiet. only) if you don't want &quiet.&apos.s
 settings notebook to reopen after the capture.
@@ -93 +96 @@
 intended capture target).
 :p."Screen" will automatically capture the whole desktop.
+
 :p."Screen region" allows you to select an area of the screen with the
-mouse or the cursor keys; move to the lower left corner of the rectangle that
-moves with the mouse pointer to the lower left corner of the region you want
-to capture, press the mouse button or enter/return key. Size the rectangle by
-moving the mouse or using the cursor keys. Press the mouse button or enter
-again to capture the selected region. A dialog will open for you to confirm
-the capture.
+mouse or the cursor keys; use them to move the capture area until its lower
+left corner is over the one of the region you want to capture, and press the
+mouse button or enter/return key. Size the rectangle by moving its upper
+right corner with the mouse or using the cursor keys. Press the mouse button or
+enter again to capture the selected region. A dialog will open for you to
+confirm the capture.
+
 :p."Window" will capture a whole window. Select the window with the mouse.
 It will rise to the surface and be captured.
@@ -105 +110 @@
 of the window (not titlebar, etc.).
 :p.To cancel a capture (&progname. only) (before it has started, e.g. during
-the "delayed capture" delay), just press the escape key (the main window must
+the "delayed capture" delay), just press the Escape key (the main window must
 have focus) or click the :link refid=snapshot reftype=hd.snapshot window:elink.
 with the mouse.
-:dt.:hp2.Terminate  &progname. (&quiet. only):ehp2.
-:dd. "Exit" This exits &quiet. The close button/menu item only close
-the notebook leaving &quiet. still running.
+:dt.:hp2.Terminate &quiet. (&quiet. only):ehp2.
+
+:dd."Exit" This exits &quiet. The close button/menu item only close the
+notebook leaving &quiet. still running.
 
 :edl.
 
-:p.Selecting the "About" button (or pressing "ALT+A") opens a nice dialog
-containing information about the program.
-
-:p.Selecting the "Settings" button opens the
+:p.Selecting the "About" button (or pressing "ALT+A", &progname. only) opens a
+nice dialog containing information about the program.
+
+:p.Selecting the "Settings" button (&progname. only) opens the
 :link refid=settings reftype=hd.settings notebook:elink..
 
@@ -151 +157 @@
 :ul.
 :li.:hp2.Prompt for filename:ehp2.
-:p.Opens the save file dialog after the capture, so you can select or enter
-the name of the file.
+
+:p.Opens the Save file dialog after the capture, so you can select or enter the
+name of the file.
+
 :p.Note&colon. Several of the :link refid=cmdlineargs reftype=hd.command line
-arguments:elink. automatically change this settings.
+arguments:elink. automatically change this setting.
 
 :li.:hp2.Autosave to numbered files in directory:ehp2.
+
 :p.This does not prompt you for a filename, but &progname./&quiet. will create
-one automatically (of the form "tpxxxxxxxx??.ext" where "tp" is the capture
-type (SC = screen, SR = screen region, WD = Window, WI = Window interior),
-"xxxxxxxx" is the first 8 characters of the title of the window that has
-focus (or all the characters if it has less than 8) and "??" will be
-replaced by a unique number, that will increase with every saved file with
-the same prefix. The "ext" is replaced by the appropriate extension for
-the selected image format.
-:p.You must provide a valid directory in the entry field underneath to
-tell &progname./&quiet. where the files should be saved. It defaults to
-the &progname. install directory.
+one automatically of the form "tpxxxxxxxx??.ext" where "tp" is the capture type
+(SC = screen, SR = screen region, WD = Window, WI = Window interior),
+"xxxxxxxx" is the first 8 characters of the title of the window that has focus
+(or all the characters if it has less than 8) and "??" will be replaced by a
+unique number, that will increase with every saved file with the same prefix.
+The "ext" is replaced by the appropriate extension for the selected image
+format.
+
+:p.You must provide a valid directory in the entry field underneath to tell
+&progname./&quiet. where the files should be saved. It defaults to the
+&progname. install directory.
 
 :li.:hp2.Force saving to file (&progname. only):ehp2.
-:p. This will :hp1.always:ehp1. write the image to
-the file you give in the entry field underneath, even if you selected
-"Clipboard" in the "Save image to ..."  group in the :link refid=mainwin
-reftype=hd.main window:elink.. If a file with that name already exists, it
-will be overwritten without further warning!
+
+:p.This will :hp1.always:ehp1. write the image to the file you give in the
+entry field underneath, even if you selected "Clipboard" in the "Save image to"
+group in the :link refid=mainwin reftype=hd.main window:elink.. If a file with
+that name already exists, it will be overwritten without further warning!
+
 :eul.
 
@@ -209 +220 @@
 behind other windows. It will always float above of them.
 
-:li.:hp2.Hide when doing a capture:ehp2.
+:li.:hp2.Hide &progname. during capture:ehp2.
+
 :p.This is similar to the "Hide &progname." checkbox in the
 :link refid=mainwin reftype=hd.main window:elink.. When
@@ -231 +243 @@
 
 :dt.:hp2.Serial capture:ehp2.
-:dd.Using this option, you can have &progname. automatically take a
-capture every n seconds/20. Just select the checkbox and when you take a
-capture the next time, &progname. will not stop after the first capture is
-done. It will wait a number of seconds/20 (that you can adjust with the
-spinbutton below it) and then capture the screen/screen region/window again
-and again and again until you press the escape key (the main window must
-have focus) or click the :link refid=snapshot reftype=hd.snapshot
-window:elink. (or, in case of a window [interior] capture, until the window
-to be captured has been closed).
-:p.:hp1.Note&colon.:ehp1. The amount of time it takes to make the
-actual capture and to write the image to disk is not included in this
-delay, as it depends heavily on your system and personal configuration.
-So if e.g. you want to make a capture every 10 seconds, but it takes 4
-seconds to capture the screen and write the file, you must set the
-delay to 120 seconds/20 (6 seconds).
-:p.The timer used is not really very accurate, especially on slow systems;
-You will need to experiment to find the settings that work best.
+:dd.Using this option, you can have &progname. automatically take a capture
+every n seconds/20. Just select the checkbox and when you take a capture the
+next time, &progname. will not stop after the first capture is done. It will
+wait a number of seconds/20 (that you can adjust with the spinbutton below it)
+and then capture the screen/screen region/window again and again and again
+until you press the Escape key (the main window must have focus) or click the
+:link refid=snapshot reftype=hd.snapshot window:elink. (or, in case of a window
+[interior] capture, until the window to be captured has been closed).
+
+:p.:hp1.Note&colon.:ehp1. The amount of time it takes to make the actual
+capture and to write the image to disk is not included in this delay, as it
+depends heavily on your system and personal configuration. So if e.g. you want
+to make a capture every 10 seconds, but it takes 4 seconds to capture the
+screen and write the file, you must set the delay to 120 seconds/20 (6
+seconds).
+
+:p.The timer used is not really very accurate, especially on slow systems; you
+will need to experiment to find the settings that work best.
 
 :dt.:hp2.Use sound when capture finished:ehp2.
@@ -270 +283 @@
 
 :dt.:hp2.Delayed capture:ehp2.
-:dd.When you select the "Countdown timer with beeps" checkbox,
-&progname. will output a beep for every second of the :link refid=mainwin
-reftype=hd.delayed capture:elink. delay time. With the spinbutton below
-you can set, how many seconds &progname. should wait when you use
-"Delayed capture", before actually taking the capture. This is useful if
-you wish to capture a window with a menu open (start the capture then open
-the menu during the delay).
+
+:dd.When you select the "Countdown timer with beeps" checkbox, &progname. will
+output a beep for every second of the :link refid=mainwin reftype=hd.delayed
+capture:elink. delay time. With the spinbutton below you can set, how many
+seconds &progname. should wait when you use "Delayed capture", before actually
+taking the capture. This is useful if you wish to capture a window with a menu
+open (start the capture then open the menu during the delay).
 
 :dt.:hp2.Serial capture:ehp2.
-:dd.Using this option, you can have &progname. automatically take a
-capture every n seconds/20. Just select the checkbox and when you take a
-capture the next time, &progname. will not stop after the first capture is
-done, but wait a number of seconds/20 (that you can adjust with the
-spinbutton below it) and then capture the screen/screen region/window over
-and over again until you press the escape key (the main window must
-have focus) or click the :link refid=snapshot reftype=hd.snapshot
-window:elink. (or, in case of a window [interior] capture, until the
-window to be captured has been closed).
-:p.:hp1.Note&colon.:ehp1. The amount of time it takes to make the
-actual capture and to write the image to disk is not included in this
-delay, as it depends heavily on your system and personal configuration.
-So if e.g. you want to make a capture every 10 seconds, but it takes 4
-seconds to capture the screen and write the file, you must set the
-delay to 120 seconds/20 (6 seconds).
+
+:dd.Using this option, you can have &progname. automatically take a capture
+every n seconds/20. Just select the checkbox and when you take a capture the
+next time, &progname. will not stop after the first capture is done, but wait a
+number of seconds/20 (that you can adjust with the spinbutton below it) and
+then capture the screen/screen region/window over and over again until you
+press the escape key (the main window must have focus) or click the :link
+refid=snapshot reftype=hd.snapshot window:elink. (or, in case of a window
+[interior] capture, until the window to be captured has been closed).
+
+:p.:hp1.Note&colon.:ehp1. The amount of time it takes to make the actual
+capture and to write the image to disk is not included in this delay, as it
+depends heavily on your system and personal configuration. So if e.g. you want
+to make a capture every 10 seconds, but it takes 4 seconds to capture the
+screen and write the file, you must set the delay to 120 seconds/20 (6
+seconds).
+
 :p.The timer used is not really very accurate, especially on slow systems;
-You will need to experiment to find the settings that work best.
+you will need to experiment to find the settings that work best.
 
 :edl.
@@ -308 +323 @@
 change until you restart the program.
 
-:p.:hp1.Note&colon.:ehp1. Only English has been updated to be consistent
-with version 2.0 or higher. The other languages work with the updated
-interface but are partly in English.
+:p.:hp1.Note&colon.:ehp1. Not all languages have been updated to be consistent
+with version 2.0 or higher. The others work with the updated interface but are
+partly in English.
 
 :p.:hp1.Note&colon.:ehp1. If you want to translate &progname. to another
@@ -350 +365 @@
 :pd.Also captures to file
 :pt.:hp2.Alt+Print screen:ehp2.
-:pd.Opens &quiet.&apos.s settings which are very similar to &progname.&apos.s
-The differences are indicated on the :link refid=mainwin reftype=hd.Main
-window page:elink. and in the :link refid=settings reftype=hd.settings
-notebook section:elink..
+
+:pd.Opens &quiet.&apos.s settings, which are very similar to &progname.&apos.s.
+The differences are indicated on the
+:link refid=mainwin reftype=hd.Main window:elink. page and in the
+:link refid=settings reftype=hd.settings notebook:elink. section.
+
 :pt.:hp2.Ctrl+Print screen :ehp2.
 :pd.Captures to clipboard
@@ -362 +379 @@
 the notebook leaving &quiet. still running.
 
-:h1 id=cmdlineargs res=3000.Commandline arguments
-:p.In the "Properties" notebook of &progname.'s/&quiet.&apos.s WPS object
-or when starting &progname./&quiet. from the command line, you may give
-the following parameters&colon.
+:h1 id=cmdlineargs res=3000.Command line arguments
+:p.In the "Properties" notebook of &progname.'s/&quiet.&apos.s WPS object or
+when starting &progname./&quiet. from the command line, you may give the
+following parameters&colon.
 
 :dl break=all tsize=5.
@@ -408 +425 @@
 :dt.:hp2.-p (&quiet. only):ehp2.
 :dd. Allows the default WPS behavior for "Print Screen". If enabled in
-the screen settings it will print to the printer. If disabled it will do
-nothing.
+the Screen or System object settings it will print to the printer. If disabled
+it will do nothing.
 
 :dt.:hp2.-q (&progname. only):ehp2.
@@ -423 +440 @@
 :dl break=all tsize=5.
 :dt.:hp2.Version 2.0:ehp2.
-:dd.This version is the first from the Netlabs Gotcha! team and the first
+:dd.This version is the first from the Netlabs &progname. team and the first
 built with Open Watcom. The following is a list of changes in this version:
 :ul compact.
@@ -444 +461 @@
 :li.Fixed a failure to update the file extension following an image file format
 change.
-:li.Updated the English documentation.
+:li.Updated the documentation.
 :eul.
 
@@ -562 +579 @@
 
 :p.The full source code is available at svn.netlabs.org/repos/gotcha.
-See http&colon.//trac.netlabs.org/gotcha for details.
+See https&colon.//trac.netlabs.org/gotcha for details.
 
 :p.All trademarks mentioned anywhere around here are property of their
@@ -960 +977 @@
 
 :h1 id=helpwanted res=5006.Help wanted!
-:p.Now that &progname. supports other languages, We of course want to include
-as many as possible. The problem is that I only speak English. So if anybody
-out there wants to translate &progname. to a new language or update an existing
-language you are gladly welcome to do so!
+:p.Now that &progname. supports other languages, we of course want to include
+as many as possible. The problem is that I, Gregg Young, only speak English. So
+if anybody out there wants to translate &progname. to a new language or update
+an existing language you are gladly welcome to do so!
 
 :p.The sources for the help file and program resources are in the SVN. For
-existing languages just take the *.rc and *.hlp file and sync them with the
-English versions. For new languages simply start with the English versions.
-If you have any questions or want me to send the files directly to you, feel
-free to :link refid=author reftype=hd.contact me:elink.!
+existing languages just take the *.rc and *.ipf files and sync them with the
+English versions. For new languages simply start with the English versions. If
+you have any questions or want me to send the files directly to you, feel free
+to :link refid=author reftype=hd.contact me:elink.!
 
 :p.If you haven't got the time to do (or just don't feel like doing ;-) a
@@ -981 +998 @@
 
 :h1 id=credits res=5007.Credits
-:p.The Netlabs Gotcha! Team
+
+:p.The Netlabs &progname. team
+
 :ul.
 :li.Gregg Young