Hal,.ini,punctuation - small bits noticed during translation

Author: smoe

docs/src/gcode/coordinates.adoc

@@ -304,7 +304,7 @@ By default, 'G92' offsets are restored after the machine is started.
 Programmers that wish for Fanuc behavior, where 'G92' offsets are
 cleared at machine start and after a reset or program end, may disable
 'G92' persistence by setting 'DISABLE_G92_PERSISTENCE = 1' in the
-'[RS274NGC]' section of the '.ini' file.
+'[RS274NGC]' section of the INI file.
 
 [NOTE]
 It is good practice to clear the 'G92' offsets at the end of their use
@@ -318,7 +318,7 @@ will be applied when an axis is homed.  See
 There are at least two ways to set G92 values:
 
 * With a right click on the position displays in tklinuxcnc, a window opens
-  where it is possible to enter a value
+  where it is possible to enter a value.
 * With the G92 command
 
 Both work from the current position of the axis that should be moved.
@@ -384,13 +384,13 @@ effect a startup will cause them to become active again.  As a
 safeguard, always have your preamble to set the environment as you
 expect it.  Additionally, 'G92' persistence may be disabled by setting
 'DISABLE_G92_PERSISTENCE = 1' in the '[RS274NGC]' section of the
-'.ini' file.
+INI file.
 
 [[sec:g92-g52-interaction-cautions]]
 === G92 and G52 Interaction Cautions
 
 'G52' and 'G92' share the same offset registers. Unless 'G92'
-persistence is disabled in the '.ini' file(see
+persistence is disabled in the INI file (see
 <<sec:g92-commands,G92 Commands>>),
 'G52' offsets will also persist after machine reset,
 'M02' or 'M30'.  Beware that a 'G52' offset in effect during a program

docs/src/gcode/g-code.adoc

@@ -1390,7 +1390,7 @@ G43 <H->
 
 * 'H' - tool number (optional)
 
-* 'G43' - enables tool length compensation. 
+* 'G43' - enables tool length compensation.
   G43 changes subsequent motions by offsetting the axis coordinates by
   the length of the offset. G43 does not cause any motion. The next time
   a compensated axis is moved, that axis's endpoint is the compensated
@@ -1497,10 +1497,10 @@ location.
 
 It is an error if:
 
-* 'H' is unspecified and no axis offsets are specified
-* 'H is specified and the given tool number does not exist in the tool
-  table
-* 'H' is specified and axes are also specified
+* 'H' is unspecified and no axis offsets are specified.
+* 'H' is specified and the given tool number does not exist in the tool
+  table.
+* 'H' is specified and axes are also specified.
 
 NOTE: G43.2 does not write to the tool table.
 
@@ -1590,7 +1590,7 @@ It is an error if:
 
 * selecting a coordinate system is used while cutter compensation is on.
 
-See the <<cha:coordinate-system,Coordinate System>> Section for an
+See the <<cha:coordinate-system,Coordinate System>> section for an
 overview of coordinate systems.
 
 [[gcode:g61]]
@@ -2066,7 +2066,7 @@ In addition, at the beginning of the first cycle and each repeat, the
 following one or two moves are made
 
 * A <<gcode:g0,rapid move>> parallel to the XY-plane to
-  the given XY-position,
+  the given XY-position.
 * The Z-axis make a rapid move to the R position, if it is
   not already at the R position.
 
@@ -2279,7 +2279,7 @@ The first preliminary move is a maximum rapid move along the Z axis to
 The first repeat consists of 3 moves.
 
 * A <<gcode:g0,rapid move>> parallel to the XY-plane to (X5, Y7)
-* Move parallel to the Z-axis at the <<sec:set-feed-rate,feed rate>> to 
+* Move parallel to the Z-axis at the <<sec:set-feed-rate,feed rate>> to
   (Z4.2)
 * A rapid move parallel to the Z-axis to (X5, Y7, Z4.8)
 

docs/src/gcode/tool-compensation.adoc

@@ -56,14 +56,14 @@ G-code for more detailed explanations.
 The 'Tool Table' is a text file that contains information about each
 tool. The file is located in the same directory as your configuration
 and is called 'tool.tbl' by default.  A file name may be specified
-with the ini file [EMCIO]TOOL_TABLE setting.  The tools might be in a
+with the INI file [EMCIO]TOOL_TABLE setting.  The tools might be in a
 tool changer or just changed manually.  The file can be edited with a
 text editor or be updated using G10 L1. See the
 <<sec:lathe-tool-table,Lathe Tool Table>> Section for an example of
 the lathe tool table format. The maximum pocket number is 1000.
 
-The <<cha:tooledit-gui,Tool Editor>> or a text editor can be used to edit 
-the tool table. If you use a text editor make sure you reload the tool 
+The <<cha:tooledit-gui,Tool Editor>> or a text editor can be used to edit
+the tool table. If you use a text editor make sure you reload the tool
 table in the GUI.
 
 [[sub:tool-table-format]]
@@ -177,56 +177,56 @@ is used for all machines.
 
 The userspace program specified by *[EMCIO]EMCIO = io* is conventionally
 used for tool changer management (and other io functions for enabling
-LinuxCNC and the control of coolant/lube hardware).  The hal pins used for
-tool management are prefixed with *iocontrol.0.*
+LinuxCNC and the control of coolant/lube hardware).  The HAL pins used for
+tool management are prefixed with *iocontrol.0.*.
 
-A gcode *TN* command asserts the hal output pin *iocontrol.0.tool-prepare*.
-The hal input pin, *iocontrol.0.tool-prepared*, must be set by external
-hal logic to complete tool preparation leading to a subsequent reset of
+A G-code *T* command asserts the HAL output pin *iocontrol.0.tool-prepare*.
+The HAL input pin, *iocontrol.0.tool-prepared*, must be set by external
+HAL logic to complete tool preparation leading to a subsequent reset of
 the tool-prepare pin.
 
-A gcode *M6* command asserts the hal output pin *iocontrol.0.tool-change*.
-The related hal input pin, *iocontrol.0.tool-prepared*, must be set by
-external hal logic to indicate completion of the tool change leading
+A G-code *M6* command asserts the HAL output pin *iocontrol.0.tool-change*.
+The related HAL input pin, *iocontrol.0.tool-prepared*, must be set by
+external HAL logic to indicate completion of the tool change leading
 to a subsequent reset of the tool-change pin.
 
 Tooldata is accessed by an ordered index (idx) that depends on the
 type of toolchanger specified by *[EMCIO]RANDOM_TOOLCHANGER=type*.
 
 . For *RANDOM_TOOLCHANGER = 0*, (0 is default and specifies a non-random
-  toolchanger) idx is a number indicating the sequence in which tooldata was 
+  toolchanger) idx is a number indicating the sequence in which tooldata was
   loaded.
 . For *RANDOM_TOOLCHANGER = 1*, idx is the *current* pocket number
-  for the toolnumber specified by the gcode select tool command *Tn*.
+  for the toolnumber specified by the G-code select tool command *Tn*.
 
-The io program provides hal output pins to facilitate toolchanger management:
+The io program provides HAL output pins to facilitate toolchanger management:
 
 . *iocontrol.0.tool-prep-number*
 . *iocontrol.0.tool-prep-index*
 . *iocontrol.0.tool-prep-pocket*
 
 ==== IO for non-random toolchanger
 
-. Tool number N==0 indicates no tool
+. Tool number n==0 indicates no tool
 . The pocket number for a tool is fixed when tooldata is loaded
-. At gcode *TN* (N != 0) command:
+. At G-code *Tn* (n != 0) command:
 .. *iocontrol.0.tool-prep-index*  = idx (index based on tooldata load sequence)
-.. *iocontrol.0.tool-prep-number* = N
-.. *iocontrol.0.tool-prep-pocket* = the fixed pocketno for N
-. At gcode *T0* (N == 0 remove) command:
+.. *iocontrol.0.tool-prep-number* = n
+.. *iocontrol.0.tool-prep-pocket* = the fixed pocketno for n
+. At G-code *T0* (n == 0 remove) command:
 .. *iocontrol.0.tool-prep-index*  = 0
 .. *iocontrol.0.tool-prep-number* = 0
 .. *iocontrol.0.tool-prep-pocket* = 0
 
 ==== IO for random toolchanger
 
-. Tool number N==0 is *not special*
-. Pocket number 0 is *special* as it indicates the *spindle*
-. The *current* pocket number for tool N is the tooldata index (idx) for tool N
-. At gcode command *TN*:
-.. *iocontrol.0.tool-prep-index*  = pocket number for tool N
-.. *iocontrol.0.tool-prep-number* = N
-.. *iocontrol.0.tool-prep-pocket* = pocket number for tool N
+. Tool number n==0 is *not special*.
+. Pocket number 0 is *special* as it indicates the *spindle*.
+. The *current* pocket number for tool N is the tooldata index (idx) for tool n.
+. At G-code command *Tn*:
+.. *iocontrol.0.tool-prep-index*  = pocket number for tool n
+.. *iocontrol.0.tool-prep-number* = n
+.. *iocontrol.0.tool-prep-pocket* = pocket number for tool n
 
 [[sub:tool-changers]]
 === Tool Changers(((Tool Changers)))
@@ -238,9 +238,9 @@ is in the <<sub:ini:sec:emcio,EMCIO Section>> of the INI chapter.
 .Manual Tool Changer
 Manual tool changer (you change the tool by hand) is treated like a
 fixed location tool changer.  Manual toolchanges can be aided by
-a hal configuration that employs the userspace program
-*hal_manualtoolchange* and is typically specified in an ini file
-with ini statements:
+a HAL configuration that employs the userspace program
+*hal_manualtoolchange* and is typically specified in an INI file
+with INI statements:
 
 [source,{ini}]
 ----