spec: try to improve comment about AF_UNIX path

The comment refers to the nul-padding of sockaddr_un member sun_path and
using an addrlen of sizeof(sockaddr_un). There is not much need to
document an old now "broken" behaviour.

Signed-off-by: Marc-André Lureau <marcandre.lureau@redhat.com>

diff --git a/doc/dbus-specification.xml b/doc/dbus-specification.xml
index a43b925609f99678ffea4b10f183c064663c2477..7ebf13ff442f58e971b3a30e1be60008d165f072 100644 (file)
--- a/doc/dbus-specification.xml
+++ b/doc/dbus-specification.xml
@@ -3655,12 +3655,10 @@
       </para>
 
       <para>
-        When a socket is opened by the D-Bus library it truncates the path
-        name right before the first trailing Nul byte.  This is true for both
-        normal paths and abstract paths.  Note that this is a departure from
-        previous versions of D-Bus that would create sockets with a fixed
-        length path name.  Names which were shorter than the fixed length
-        would be padded by Nul bytes.
+        When a Unix socket is opened by the D-Bus library, the socket address
+        length does not include the whole <literal>struct sockaddr_un</literal>,
+        but only the length of the pathname or abstract string (beside other
+        fields).
       </para>
       <para>
         Unix domain sockets are not available on Windows.