📝 M110 Get or Set

MarlinFirmware/Marlin#27090

Author: thinkyhead

_gcode/M110.md

@@ -1,14 +1,15 @@
 ---
 tag: m0110
-title: Set Line Number
-brief: Set the current line number.
+title: Set / Get Line Number
+brief: Set or get the current (last-used) host command line number.
 author: thinkyhead
 
 group: hosts
 
 codes: [ M110 ]
+related: [ M999 ]
 
-notes: "All these are valid: `N100 M110`, `M110 N100`, `N101 M110 N100`."
+notes: "All these are valid host command lines: `N100 M110`, `M110 N100`, `N101 M110 N100`."
 
 parameters:
 
@@ -19,6 +20,19 @@ parameters:
   - tag: line
     type: int
 
+examples:
+
+- pre: Set the last line to 56
+  code: M110 N56
+
+- since: 2.1.3
+  pre: Report the last-set or last-processed line number
+  code: |
+    > M110
+    Line: 1297
+
 ---
 
-Hosts can use `M110` to set the current line number in a print job. Each line number sent by a host must be one higher than the previous line number, or the firmware will ignore the line and send an error requesting a resend of the missing line. This is one technique Marlin uses to keep in sync with hosts.
+Hosts shuld use `M110` to set the current line number as-needed during a host-controlled print job. The last `N` value found in the line will be applied. Each line number sent by the host must be one higher than the previous line number, or the firmware will ignore the line and send an error requesting a resend of the missing line. This is one technique Marlin uses to keep in sync with hosts.
+
+Since Marlin 2.1.3 this command without parameters reports the last line number processed out of the host command queue.

_gcode/M999.md

@@ -7,6 +7,7 @@ author: thinkyhead
 group: control
 
 codes: [ M999 ]
+related: [ M110 ]
 
 parameters:
 

_includes/gcode-info.html

@@ -219,6 +219,9 @@ <h3>Related Media</h3>
   <div class="col-lg-12 row examples">
     <h3>Example{% if ex[1] %}s{% endif %}</h3>
     {%- for item in ex -%}
+    {% if item.since %}
+      <span class="label label-success"><span data-toggle="tooltip" data-placement="bottom" title="{% if item.until %}Availability{% else %}Available since{% endif %}"><i class="fa fa-code" aria-hidden="true"></i> {{ item.since }}</span></span>
+    {% endif %}
       {%- if item.pre -%}
         {%- for line in item.pre -%}{{ line | markdownify }}{%- endfor -%}
       {%- endif -%}