man: add link to functionfs docs

Also reword some ungainly grammar constructs.

diff --git a/man/systemd.service.xml b/man/systemd.service.xml
index 642d95a029578330ab537202cd078cafb4e87f37..eac7504feed42a14038187e497e5fe763838706e 100644 (file)
--- a/man/systemd.service.xml
+++ b/man/systemd.service.xml
@@ -905,12 +905,15 @@
 
       <varlistentry>
         <term><varname>USBFunctionDescriptors=</varname></term>
-        <listitem><para>Configure the location of file containing
-        FunctionFS descriptors. This is is used only when socket with
-        <varname>ListenUSBFunction</varname> line want to activate this service. Content of
-        this file is writen to ep0 file after it is opened. This is required
-        for socket activation using <varname>ListenUSBFunction</varname>
-        (i.e. for passing all ffs endpoints to service).</para></listitem>
+        <listitem><para>Configure the location of the file containing
+        <ulink url="https://www.kernel.org/doc/Documentation/usb/functionfs.txt">functionfs</ulink>
+        descriptors. This is is used only when a socket with
+        <varname>ListenUSBFunction</varname> configured wants to
+        activate this service. Content of this file is writen to
+        <filename>ep0</filename> file after it is opened. This is
+        required for socket activation using
+        <varname>ListenUSBFunction</varname> (i.e. for passing all
+        functionfs endpoints to the service).</para></listitem>
       </varlistentry>
 
       <varlistentry>

diff --git a/man/systemd.socket.xml b/man/systemd.socket.xml
index 7f884aa1be3192c61ee43a069455623918dae255..e63a33a47be160302ed231c2256d24b44828c5bc 100644 (file)
--- a/man/systemd.socket.xml
+++ b/man/systemd.socket.xml
@@ -262,13 +262,17 @@
 
       <varlistentry>
         <term><varname>ListenUSBFunction=</varname></term>
-        <listitem><para>Specifies a functionfs endpoint location
-        to listen on. This expects an absolute file system path as
+        <listitem><para>Specifies a
+        <ulink url="https://www.kernel.org/doc/Documentation/usb/functionfs.txt">functionfs</ulink>
+        endpoint location to
+        listen on. This expects an absolute file system path as the
         argument. Behavior otherwise is very similar to the
         <varname>ListenFIFO=</varname> directive above. Use this to
-        open functionfs endpoint ep0. When using this option, activated
-        service has to have <varname>USBFunctionDescriptors</varname>
-        and <varname>USBFunctionStrings</varname> options set.</para></listitem>
+        open functionfs endpoint <filename>ep0</filename>. When using
+        this option, activated service has to have the
+        <varname>USBFunctionDescriptors</varname> and
+        <varname>USBFunctionStrings</varname> options set.
+        </para></listitem>
       </varlistentry>
 
       <varlistentry>

diff --git a/man/timedatectl.xml b/man/timedatectl.xml
index 9a86c4126a932d3b2276121ffbbf7fcb2ccc7a42..c439bc56ede96669ca787130151db0ae7f0438f9 100644 (file)
--- a/man/timedatectl.xml
+++ b/man/timedatectl.xml
@@ -178,7 +178,7 @@
         protected by a different access policy.</para>
 
         <para>Note that even if time synchronization is turned off
-        with this command another, unrelated system service might
+        with this command, another unrelated system service might
         still synchronize the clock with the network. Also note that
         strictly speaking
         <filename>systemd-timesyncd.service</filename> does more than