man: add link to functionfs docs

Also reword some ungainly grammar constructs.

3 files changed, 19 insertions, 12 deletions

diff --git a/man/systemd.service.xml b/man/systemd.service.xml
index 642d95a029..eac7504fee 100644
--- 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 7f884aa1be..e63a33a47b 100644
--- 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 9a86c4126a..c439bc56ed 100644
--- 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