diff --git a/docs/src/gcode/coordinates.adoc b/docs/src/gcode/coordinates.adoc index 435f5b9bef9..a473aa36d6d 100644 --- a/docs/src/gcode/coordinates.adoc +++ b/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 <>), 'G52' offsets will also persist after machine reset, 'M02' or 'M30'. Beware that a 'G52' offset in effect during a program diff --git a/docs/src/gcode/g-code.adoc b/docs/src/gcode/g-code.adoc index 55178ed77d8..37c4c23e047 100644 --- a/docs/src/gcode/g-code.adoc +++ b/docs/src/gcode/g-code.adoc @@ -162,10 +162,10 @@ M2 (end program) If cutter compensation is active, the motion will differ from the above; see the <> -Section. +section. If 'G53' is programmed on the same line, the motion will also differ; -see the <> Section for more information. +see the <> section for more information. The path of a G0 rapid motion can be rounded at direction changes and depends on the <> settings @@ -212,10 +212,10 @@ M2 (end program) If cutter compensation is active, the motion will differ from the above; see the <> -Section. +section. If 'G53' is programmed on the same line, the motion will also differ; -see the <> Section for more information. +see the <> section for more information. It is an error if: @@ -963,8 +963,8 @@ The UV, WU and VW planes do not support arcs. It is a good idea to include a plane selection in the preamble of each G-code file. -The effects of having a plane selected are discussed in Section -<> and Section <>. +The effects of having a plane selected are discussed in section +<> and section <>. [[gcode:g20-g21]] == G20, G21 Units(((G20 Units))) @@ -1262,7 +1262,7 @@ A comment of the form '(PROBEOPEN filename.txt)' will open 'filename.txt' and store the 9-number coordinate consisting of XYZABCUVW of each successful straight probe in it. The file must be closed with '(PROBECLOSE)'. For more information -see the <> Section. +see the <> section. An example file 'smartprobe.ngc' is included (in the examples directory) to demonstrate using probe moves to log to a file the coordinates of a @@ -1349,7 +1349,7 @@ User M100-M199 commands are allowed when Cutter Compensation is on. The behavior of the machining center when cutter compensation is on is described in the <> -Section along with code examples. +section along with code examples. It is an error if: @@ -1390,7 +1390,7 @@ G43 * '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 <> Section for an +See the <> section for an overview of coordinate systems. [[gcode:g61]] @@ -1637,7 +1637,7 @@ G64 > arc-line cases as well as line-line benefit from the 'naive cam detector'. This improves contouring performance by simplifying the path. It is OK to program for the mode that is already active. See - also the <> Section for + also the <> section for more information on these modes. If Q is not specified then it will have the same behavior as before and use the value of P-. @@ -2029,7 +2029,7 @@ The height of the retract move at the end of each repeat (called 'clear Z' in the descriptions below) is determined by the setting of the retract mode, either to the original Z position (if that is above the R position and the retract mode is 'G98', OLD_Z), or otherwise to -the R position. See the <> Section. +the R position. See the <> section. [[gcode:canned-cycle-errors]] === Canned Cycle Errors(((Canned Cycle Errors))) @@ -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 <> 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. @@ -2198,7 +2198,7 @@ N240 M2 (program end) ---- [NOTE] -Notice the z position change after the first four holes. +Notice the Z position change after the first four holes. Also, this is one of the few places where line numbers have some value, being able to point a reader to a specific line of code. @@ -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 <> parallel to the XY-plane to (X5, Y7) -* Move parallel to the Z-axis at the <> to +* Move parallel to the Z-axis at the <> to (Z4.2) * A rapid move parallel to the Z-axis to (X5, Y7, Z4.8) @@ -2601,13 +2601,13 @@ program a G92.2 (to remove them - they are still stored). [NOTE] The 'G52' command can also be used to change this offset; see the -<> Section for more details about +<> section for more details about 'G92' and 'G52' and how they interact. -See the <> Section for an +See the <> section for an overview of coordinate systems. -See the <> Section for more +See the <> section for more information. [[gcode:g92.1-g92.2]] diff --git a/docs/src/gcode/m-code.adoc b/docs/src/gcode/m-code.adoc index 507309142b2..b7fbe2c83d1 100644 --- a/docs/src/gcode/m-code.adoc +++ b/docs/src/gcode/m-code.adoc @@ -132,7 +132,7 @@ M5 $2 ---- If the $ is omitted then behaviour is exactly as normal for a single -spindle machine +spindle machine. It is OK to use 'M3' or 'M4' if the <> spindle speed is set to zero. If this is done diff --git a/docs/src/gcode/machining-center.adoc b/docs/src/gcode/machining-center.adoc index 7f5ebef5730..bfc30e12339 100644 --- a/docs/src/gcode/machining-center.adoc +++ b/docs/src/gcode/machining-center.adoc @@ -74,7 +74,7 @@ directions. === Coolant(((coolant))) Flood coolant and mist coolant may each be turned on independently. -The RS274/NGC language turns them off together see Section +The RS274/NGC language turns them off together see section <>. === Feed and Speed Override(((feed override)))(((spindle override))) @@ -86,13 +86,13 @@ speed used in machining at some percentage of the programmed rate. === Block Delete Switch A CNC machine can have a block delete switch. -See the <> Section. +See the <> section. [[sub:optional-program-stop-switch]] === Optional Program Stop Switch A CNC machine can have an optional program stop switch. -See the <> Section. +See the <> section. == Control and Data Components @@ -171,7 +171,7 @@ rate unobtainable, all axes are slowed to maintain the desired path. The rate at which the controlled point moves is nominally a steady rate which may be set by the user. In the Interpreter, the feed rate is interpreted as follows (unless 'inverse time feed' or 'feed -per revolution' modes are being used, in which case see Section +per revolution' modes are being used, in which case see section <>). . If any of XYZ are moving, F is in units per minute in the XYZ @@ -194,7 +194,7 @@ See section about <>. A machining center may be commanded to dwell (i.e., keep all axes unmoving) for a specific amount of time. The most common use of dwell is to break and clear chips, so the spindle is usually turning during a -dwell. Regardless of the Path Control Mode (see Section +dwell. Regardless of the Path Control Mode (see section <>) the machine will stop exactly at the end of the previous programmed move, as though it was in exact path mode. @@ -206,7 +206,7 @@ machine control cannot be changed. Different quantities use different specific units. Spindle speed is measured in revolutions per minute. The positions of rotational axes are measured in degrees. Feed rates are expressed in current length units per minute, or degrees per -minute, or length units per spindle revolution, as described in Section +minute, or length units per spindle revolution, as described in section <>. === Current Position @@ -254,19 +254,19 @@ See also <>. The machining center may be put into any one of three path control modes: -* exact stop mode:: +exact stop mode:: In exact stop mode, the machine stops briefly at the end of each programmed move. -* exact path mode:: +exact path mode:: In exact path mode, the machine follows the programmed path as exactly as possible, slowing or stopping if necessary at sharp corners of the path. -* continuous mode:: +continuous mode:: In continuous mode, sharp corners of the path may be rounded slightly so that the feed rate may be kept up (but by no more than the tolerance, if specified). -See Sections <> and <>. +See sections <> and <>. [[cnc:interpreter-interaction-with-switches]] == Interpreter Interaction with Switches @@ -306,7 +306,7 @@ is paused. A tool table is required to use the Interpreter. The file tells which tools are in which tool changer slots and what the size and type of -each tool is. The name of the tool table is defined in the ini file: +each tool is. The name of the tool table is defined in the INI file: [source,{ini}] ---- @@ -318,7 +318,7 @@ TOOL_TABLE = tooltable.tbl The default filename probably looks something like the above, but you may prefer to give your machine its own tool table, using the -same name as your ini file, but with a tbl extension: +same name as your INI file, but with a tbl extension: [source,{ini}] ---- @@ -333,7 +333,7 @@ TOOL_TABLE = EMC-AXIS-SIM.tbl ---- For more information on the specifics of the tool table format, see the -<> Section. +<> section. [[sec:machine-center-parameters]] == Parameters(((Parameters))) diff --git a/docs/src/gcode/tool-compensation.adoc b/docs/src/gcode/tool-compensation.adoc index fdcd4fb3af7..8fec7435919 100644 --- a/docs/src/gcode/tool-compensation.adoc +++ b/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 <> Section for an example of the lathe tool table format. The maximum pocket number is 1000. -The <> 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 <> 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,29 +177,29 @@ 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* @@ -207,26 +207,26 @@ The io program provides hal output pins to facilitate toolchanger management: ==== 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 <> 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}] ---- @@ -315,8 +315,8 @@ path without knowing the exact tool diameter. The only caveat is the programmer must program the lead in move to be at least as long as the largest tool radius that might be used. -There are two possible paths the cutter can take while cutter -compensation is on to the left or right side of a line when facing the +There are two possible paths the cutter can take since the cutter +compensation can be on to the left or right side of a line when facing the direction of cutter motion from behind the cutter. To visualize this imagine you were standing on the part walking behind the tool as it progresses across the part. G41 is your left side of the line and G42 diff --git a/docs/src/getting-started/about-linuxcnc.adoc b/docs/src/getting-started/about-linuxcnc.adoc index 4f54a20799b..df65c7232f6 100644 --- a/docs/src/getting-started/about-linuxcnc.adoc +++ b/docs/src/getting-started/about-linuxcnc.adoc @@ -15,10 +15,11 @@ * LinuxCNC provides: ** easy discovery and testing without installation with the LiveCD ** easy installation from the Live CD -** Easy to use graphical configuration wizards to rapidly create a configuration +** easy to use graphical configuration wizards to rapidly create a configuration specific to the machine +** directly offered with recent releases of Debian (since Bookworm) and Ubuntu (since Kinetic Kudu) ** a graphical user interface (actually several interfaces to choose from) -** A graphical interface creation tool (Glade) +** a graphical interface creation tool (Glade) ** an interpreter for 'G-code' (the RS-274 machine tool programming language) ** a realtime motion planning system with look-ahead diff --git a/docs/src/getting-started/getting-linuxcnc.adoc b/docs/src/getting-started/getting-linuxcnc.adoc index 359f0307615..7545e008ae3 100644 --- a/docs/src/getting-started/getting-linuxcnc.adoc +++ b/docs/src/getting-started/getting-linuxcnc.adoc @@ -58,7 +58,7 @@ working on some versions of the Pi. You can experiment with removing this limit by editing the config-rt.txt file in the boot directory. If you can't boot after the change then the file can be edited back by mounting the SD card in a a different computer (maybe even a Pi with a -USB card reader) +USB card reader). === Download using zsync @@ -128,7 +128,7 @@ https://help.ubuntu.com/community/HowToMD5SUM[How To MD5SUM] The Raspbery Pi image is a completes SD card image and should be written to an SD card in -https://www.raspberrypi.org/documentation/installation/installing-images/README.md[the normal way] +https://www.raspberrypi.org/documentation/installation/installing-images/README.md[the normal way]. The LinuxCNC Live/Install ISO Image is a hybrid ISO image which can be written directly to a USB storage device (flash drive) or a DVD and @@ -232,7 +232,7 @@ using the RTAI realtime kernel which will often give better latency. To install LinuxCNC from the LiveCD select 'Install (Graphical)' at bootup. -== Updates to LinuxCNC (((Updates to LinuxCNC))) +== Updates to LinuxCNC(((Updates to LinuxCNC))) With the normal install the Update Manager will notify you of updates to LinuxCNC when you go on line and allow you to easily upgrade with no @@ -372,8 +372,8 @@ Alternate keyserver: keyserver.ubuntu.com . Add the apt repository: + ---- - echo deb http://linuxcnc.org/ buster base 2.8-rtpreempt | sudo tee -a /etc/apt/sources.list.d/linuxcnc.list - echo deb-src http://linuxcnc.org/ buster base 2.8-rtpreempt | sudo tee -a /etc/apt/sources.list.d/linuxcnc.list +echo deb http://linuxcnc.org/ buster base 2.8-rtpreempt | sudo tee -a /etc/apt/sources.list.d/linuxcnc.list +echo deb-src http://linuxcnc.org/ buster base 2.8-rtpreempt | sudo tee -a /etc/apt/sources.list.d/linuxcnc.list ---- . Update the package list from linuxcnc.org @@ -416,8 +416,8 @@ sudo apt-key adv --keyserver hkp://keys.openpgp.org --recv-key 3cb9fd148f374fef . Add the apt repository: + ---- - echo deb http://linuxcnc.org/ buster base 2.8-rt | sudo tee /etc/apt/sources.list.d/linuxcnc.list - echo deb-src http://linuxcnc.org/ buster base 2.8-rt | sudo tee -a /etc/apt/sources.list.d/linuxcnc.list +echo deb http://linuxcnc.org/ buster base 2.8-rt | sudo tee /etc/apt/sources.list.d/linuxcnc.list +echo deb-src http://linuxcnc.org/ buster base 2.8-rt | sudo tee -a /etc/apt/sources.list.d/linuxcnc.list ---- . Update the package list from linuxcnc.org @@ -461,7 +461,7 @@ sudo apt-key adv --keyserver hkp://keys.openpgp.org --recv-key 3cb9fd148f374fef . Add the apt repository: + ----- - echo deb http://linuxcnc.org/ buster base 2.8-rtpreempt | sudo tee /etc/apt/sources.list.d/linuxcnc.list +echo deb http://linuxcnc.org/ buster base 2.8-rtpreempt | sudo tee /etc/apt/sources.list.d/linuxcnc.list ----- . Update the package list from linuxcnc.org diff --git a/docs/src/gui/axis.adoc b/docs/src/gui/axis.adoc index 67f1266db7e..a8b80c9d780 100644 --- a/docs/src/gui/axis.adoc +++ b/docs/src/gui/axis.adoc @@ -23,7 +23,7 @@ image::images/axis.png["AXIS main window",align="center"] == Getting Started If your configuration is not currently set up to use AXIS, -you can change it by editing the .ini file. In the +you can change it by editing the .ini file (INI file). In the section `[DISPLAY]` change the `[DISPLAY]` line to read `DISPLAY = axis`. The sample configuration 'sim/axis.ini' is already configured to use AXIS as its front-end. @@ -33,7 +33,7 @@ When AXIS starts, a window like the one in the figure === INI settings -For more information on ini file settings that can change how AXIS +For more information on INI file settings that can change how AXIS works see the <> of the INI Configuration Chapter. @@ -81,16 +81,16 @@ The AXIS window contains the following elements: * A menu bar and toolbar that allow you to perform various actions * 'Manual Control Tab' - which allows you to make the machine move, turn the spindle on or off, and turn the coolant on or - off if included in the ini file. + off if included in the INI file. * 'MDI Tab' - where G-code programs can be entered manually, one line at a time. This also shows the 'Active G Codes' which shows which modal G Codes are in effect. * 'Feed Override' - which allows you to scale the speed of programmed motions. The default maximum is 120% and can be set to a different - value in the ini file. See the <> of the + value in the INI file. See the <> of the INI file for more information. * 'Spindle Override' - which allows you to scale the spindle speed up or down. -* 'Jog Speed' - which allows you to set the jog speed within the limits set in the ini file. +* 'Jog Speed' - which allows you to set the jog speed within the limits set in the INI file. See the <> of the INI file for more information. * 'Max Velocity' - which allows you to restrict the maximum velocity of all programmed motions (except spindle synchronized motion). @@ -102,7 +102,7 @@ The AXIS window contains the following elements: === Menu Items -Some menu items might be grayed out depending on how you have your .ini +Some menu items might be grayed out depending on how you have your INI file configured. For more information on configuration see the <>. @@ -114,7 +114,7 @@ file configured. For more information on configuration see the for more information. * 'Recent Files' - Displays a list of recently opened files. * 'Edit...' - Open the current G code file for editing if you have an editor - configured in your ini file. See the <> + configured in your INI file. See the <> for more information on specifying an editor to use. * 'Reload' - Reload the current g code file. If you edited it you must reload it for the changes to take affect. If you stop a file and want to start @@ -156,7 +156,7 @@ Do not use 'Run From Selected Line' if your g code program contains subroutines. * 'Paste to MDI history' - Paste from the clipboard to the MDI history window * 'Calibration' - Starts the Calibration assistant (emccalib.tcl). Calibration reads the HAL file and for every 'setp' that uses a variable - from the ini file that is in an [AXIS_L],[JOINT_N],[SPINDLE_S], or [TUNE] + from the INI file that is in an [AXIS_L],[JOINT_N],[SPINDLE_S], or [TUNE] section it creates an entry that can be edited and tested. * 'Show HAL Configuration' - Opens the HAL Configuration window where you can monitor HAL Components, Pins, Parameters, Signals, Functions, and Threads. @@ -233,7 +233,7 @@ So be familiar with your machine's design and interpret the display as needed. * 'Show Offsets' - The selected fixture offset (G54-G59.3) origin location can be shown as a set of three orthogonal lines, one each of red, blue, and green. This offset origin (or fixture zero) display can be disabled if desired. -* 'Show Machine Limits' - The machine's maximum travel limits for each axis, as set in the ini +* 'Show Machine Limits' - The machine's maximum travel limits for each axis, as set in the INI file, are shown as a rectangular box drawn in red dashed lines. This is useful when loading a new G code program, or when checking for how much fixture offset would be needed to bring the G code program within @@ -335,7 +335,7 @@ The 'extents' of the program in each axis are shown. At the ends, the least and greatest coordinate values are indicated. In the middle, the difference between the coordinates is shown. -When some coordinates exceed the 'soft limits' in the .ini file, +When some coordinates exceed the 'soft limits' in the INI file, the relevant dimension is shown in a different color and enclosed by a box. In figure below the maximum soft limit is exceeded on the X axis as indicated by the box surrounding the coordinate value. @@ -370,7 +370,7 @@ Axis can optionally display a grid when in orthogonal views. Enable or disable the grid using the 'Grid' menu under 'View'. When enabled, the grid is shown in the top and rotated top views; when coordinate system is not rotated, the grid is shown in the front and side views as well. -The presets in the 'Grid' menu are controlled by the inifile item `[DISPLAY]GRIDS`. +The presets in the 'Grid' menu are controlled by the INI file item `[DISPLAY]GRIDS`. If unspecified, the default is `10mm 20mm 50mm 100mm 1in 2in 5in 10in`. Specifying a very small grid may decrease performance. @@ -442,13 +442,13 @@ as long as the button or key is pressed. If another value is selected, the machine will move exactly the displayed distance each time the button is clicked or the key is pressed. -By default, the available values are '0.1000, 0.0100, 0.0010, 0.0001' +By default, the available values are '0.1000, 0.0100, 0.0010, 0.0001'. See the <> for more information on setting the increments. .Homing (Identity Kinematics) -The inifile setting [KINS]JOINTS defines the total number of +The INI file setting [KINS]JOINTS defines the total number of joints for the system. A joint may be configured with a home switch or for 'immediate' homing. Joints may specify a home sequence that organizes the order for homing groups @@ -738,7 +738,7 @@ running 'in-place', this can be done by using 'scripts/rip-environment'. == Using AXIS in Lathe Mode(((Axis:Lathe Mode))) By including the line 'LATHE = 1' -in the [DISPLAY] section of the ini file, AXIS selects lathe mode. The +in the [DISPLAY] section of the INI file, AXIS selects lathe mode. The 'Y' axis is not shown in coordinate readouts, the view is changed to show the Z axis extending to the right and the X axis extending towards the bottom of the screen, and several controls (such as those for @@ -765,7 +765,7 @@ image::images/axis-back-tool-lathe.png["Lathe Back Tool Shape",align="center"] == Using AXIS in Foam Cutting mode By including the line 'FOAM = 1' -in the [DISPLAY] section of the ini file, AXIS selects foam-cutting mode. +in the [DISPLAY] section of the INI file, AXIS selects foam-cutting mode. In the program preview, XY motions are displayed in one plane, and UV motions in another. In the live plot, lines are drawn between corresponding points on the XY plane and the UV plane. The special comments (XY_Z_POS) and (UV_Z_POS) @@ -785,7 +785,7 @@ guaranteeing the widget's HAL pins are available. You can have multiple line of 'POSTGUI_HALFILE=' in the INI. Each will be run one after the other in the order they appear. -For more information on the ini file settings that can change the way AXIS +For more information on the INI file settings that can change the way AXIS works, see the << sub:ini:sec:display,Display Section>> of the INI configuration chapter. === Program Filters @@ -795,7 +795,7 @@ This filter can do any desired task: Something as simple as making sure the file ends with 'M2', or something as complicated as generating G-Code from an image. -The '[FILTER]' section of the ini file controls how filters work. +The '[FILTER]' section of the INI file controls how filters work. First, for each type of file, write a 'PROGRAM_EXTENSION' line. Then, specify the program to execute for each type of file. This program is given the name of the input file as its first argument, @@ -911,10 +911,10 @@ root_window.tk.call("wm","protocol",".","WM_DELETE_WINDOW","destroy .") === USER_COMMAND_FILE -A configuration-specific python file may be specified with an ini file +A configuration-specific python file may be specified with an INI file setting '[DISPLAY]USER_COMMAND_FILE=filename.py'. Like a `~/.axisrc` file, this file is sourced just before the AXIS GUI is displayed. This file -is specific to an ini file configuration not the user's home directory. +is specific to an INI file configuration not the user's home directory. === user_live_update() @@ -941,7 +941,7 @@ HAL comp.ready() is called just after this function returns. === External Editor The menu options File > Edit... and File > Edit Tool Table... become -available after defining the editor in the ini section [DISPLAY]. +available after defining the editor in the INI section [DISPLAY]. Useful values include EDITOR=gedit and EDITOR=gnome-terminal -e vim. For more information, see the <> of the INI Configuration Chapter. @@ -1129,7 +1129,7 @@ root_window.bind('',lambda event: set_feedrate(100)) [source,python] ---- -# read an ini file item +# read an INI file item machine = inifile.find('EMC','MACHINE') print('machine name =',machine) ----