docs: small changes revisiting translations

Author: smoe

docs/man/man1/mitsub_vfd.1

@@ -222,6 +222,6 @@ net estop-out                     coolant.estop
 
 .SH ISSUES
 
-Some models (eg E500) cannot monitor status, so set the monitor pin to false.
+Some models, e.g. E500, cannot monitor status, so set the monitor pin to false.
 In this case, pins such as up-to-speed, amps, alarm and status bits are not useful.
 

docs/man/man1/qtvcp.1

@@ -30,7 +30,7 @@ qtvcp \- Qt-based virtual control panels
 [\fIOPTIONS\fR] myfile.ui
 
 .SH DESCRIPTION
-\fBqtvcp\fR is a system for creating user interfaces for LinuxCNC. 
+\fBQtVCP\fR is a system for creating user interfaces for LinuxCNC. 
 
 Full documentation at http://linuxcnc.org/docs/html/gui/qtvcp.html
 
@@ -62,8 +62,7 @@ Use -g WIDTHxHEIGHT for just setting size or -g +XOFFSET+YOFFSET for just positi
 Example: -g 200x400+0+100.
 .TP
 \fB\-H\fR [\fI<FILE>\fR]
-Execute HAL statements from FILE with halcmd after the
-component is set up and ready.
+Execute HAL statements from FILE with halcmd after the component is set up and ready.
 .TP
 \fB\-i\fR
 Enable info output.
@@ -78,25 +77,21 @@ Force panel window to fullscreen.
 Set Qt style. Default is system theme.
 .TP
 \fB\-x\fR [\fI<XID>\fR]
-Reparent Qtvcp into an existing window XID instead of creating
-a new top level window.
+Reparent QtVCP into an existing window XID instead of creating a new top level window.
 .TP
 \fB\--push_xid\fR
-Reparent window into a plug add push the plug xid number to
-standardout.
+Reparent window into a plug add push the plug xid number to standardout.
 .TP
 \fB\-u\fR [\fI<USERMOD>\fR]
 File path of user defined handler file.
 .TP
 \fB\-o\fR [\fI<USEROPTS>\fR]
-Pass USEROPTS strings to handler under self.w.USEROPTIONS_ list
-variable.
+Pass USEROPTS strings to handler under self.w.USEROPTIONS_ list variable.
 
 .SH "SEE ALSO"
 \fBLinuxCNC(1)\fR
 
-Much more information about LinuxCNC and HAL is available in the LinuxCNC
-and HAL User Manuals, found at /usr/share/doc/LinuxCNC/.
+Much more information about LinuxCNC and HAL is available in the LinuxCNC and HAL User Manuals, found at /usr/share/doc/LinuxCNC/.
 
 .SH BUGS
 None known at this time. 
@@ -108,5 +103,5 @@ Report bugs at https://github.com/LinuxCNC/linuxcnc/issues
 .SH COPYRIGHT
 Copyright \(co 2020 andypugh.
 .br
-This is free software; see the source for copying conditions.  There is NO
-warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
+This is free software; see the source for copying conditions.
+There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.

docs/man/man9/pwmgen.9

@@ -6,49 +6,40 @@ pwmgen \- software PWM/PDM generation
 \fBloadrt pwmgen output_type=\fItype0\fR[,\fItype1\fR...]
 
 .SH DESCRIPTION
-\fBpwmgen\fR is used to generate PWM (pulse width modulation) or
-PDM (pulse density modulation) signals.  The maximum PWM frequency
-and the resolution is quite limited compared to hardware-based 
-approaches, but in many cases software PWM can be very useful.
-If better performance is needed, a hardware PWM generator is a
-better choice.
+\fBpwmgen\fR is used to generate PWM (pulse width modulation) or PDM (pulse density modulation) signals.
+The maximum PWM frequency and the resolution is quite limited compared to hardware-based approaches, but in many cases software PWM can be very useful.
+If better performance is needed, a hardware PWM generator is a better choice.
 .P
-\fBpwmgen\fR supports a maximum of eight channels.  The number of
-channels actually loaded depends on the number of \fItype\fR values
-given.  The value of each \fItype\fR determines the outputs for that
-channel.
+\fBpwmgen\fR supports a maximum of eight channels.
+The number of channels actually loaded depends on the number of \fItype\fR values given.
+The value of each \fItype\fR determines the outputs for that channel.
 .P
 .TP
-type 0: single output
-A single output pin, \fBpwm\fR, whose duty cycle is determined by the
-input value for positive inputs, and which is off (or at \fBmin\-dc\fR)
-for negative inputs.  Suitable for single ended circuits.
+type 0: single output A single output pin, \fBpwm\fR, whose duty cycle is determined by the input value for positive inputs,
+and which is off (or at \fBmin\-dc\fR) for negative inputs.
+Suitable for single ended circuits.
 .TP
 type 1: pwm/direction
-Two output pins, \fBpwm\fR and \fBdir\fR.  The duty cycle on \fBpwm\fR
-varies as a function of the input value.  \fBdir\fR is low for positive
-inputs and high for negative inputs.
+Two output pins, \fBpwm\fR and \fBdir\fR.  The duty cycle on \fBpwm\fR varies as a function of the input value.
+\fBdir\fR is low for positive inputs and high for negative inputs.
 .TP
 type 2: up/down
-Two output pins, \fBup\fR and \fBdown\fR.  For positive inputs, the
-PWM/PDM waveform appears on \fBup\fR, while \fBdown\fR is low.  For
-negative inputs, the waveform appears on \fBdown\fR, while \fBup\fR
-is low.  Suitable for driving the two sides of an H-bridge to generate
-a bipolar output.
+Two output pins, \fBup\fR and \fBdown\fR.
+For positive inputs, the PWM/PDM waveform appears on \fBup\fR, while \fBdown\fR is low.
+For negative inputs, the waveform appears on \fBdown\fR, while \fBup\fR is low.
+Suitable for driving the two sides of an H-bridge to generate a bipolar output.
 
 .SH FUNCTIONS
 .TP 
 \fBpwmgen.make\-pulses\fR (no floating-point)
-Generates the actual PWM waveforms, using information computed by
-\fBupdate\fR.  Must be called as frequently as possible, to maximize
-the attainable PWM frequency and resolution, and minimize jitter.
+Generates the actual PWM waveforms, using information computed by \fBupdate\fR.
+Must be called as frequently as possible, to maximize the attainable PWM frequency and resolution, and minimize jitter.
 Operates on all channels at once.
 .TP
 \fBpwmgen.update\fR (uses floating point)
-Accepts an input value, performs scaling and limit checks, and converts
-it into a form usable by \fBmake\-pulses\fR for PWM/PDM generation.  Can
-(and should) be called less frequently than \fBmake\-pulses\fR.  Operates
-on all channels at once.
+Accepts an input value, performs scaling and limit checks, and converts it into a form usable by \fBmake\-pulses\fR for PWM/PDM generation.
+Can (and should) be called less frequently than \fBmake\-pulses\fR.
+Operates on all channels at once.
 
 .SH PINS
 .TP
@@ -91,12 +82,11 @@ regardless of the setting of \fBmin\-dc\fR.
 .ns
 .TP
 \fBpwmgen.\fIN\fB.offset\fR float in/out
-These parameters provide a scale and offset from the \fBvalue\fR pin to thewactual duty cycle.
+These parameters provide a scale and offset from the \fBvalue\fR pin to the actual duty cycle.
 The duty cycle is calculated according to \fIdc = (value/scale) + offset\fR, with 1.0 meaning 100%.
 .TP
 \fBpwmgen.\fIN\fB.pwm\-freq\fR float in/out
-PWM frequency in Hz.  The upper limit is half of the frequency at which \fBmake\-pulses\fR is invoked,
-and values above that limit will be changed to the limit.
+PWM frequency in Hz.  The upper limit is half of the frequency at which \fBmake\-pulses\fR is invoked, and values above that limit will be changed to the limit.
 If \fBdither\-pwm\fR is false, the value will be changed to the nearest integer submultiple of the \fBmake\-pulses\fR frequency.
 A value of zero produces Pulse Density Modulation instead of Pulse Width Modulation.
 .TP