with-authinfo-kludge.1: Explain that we don't configure the client.

[with-authinfo-kludge] / with-authinfo-kludge.1

diff --git a/with-authinfo-kludge.1 b/with-authinfo-kludge.1
index 070148a..de0e417 100644 (file)
--- a/with-authinfo-kludge.1
+++ b/with-authinfo-kludge.1
@@ -328,6 +328,14 @@ name from the section heading
 and may be equal to the
 .I remote
 address (below) without causing difficulty.
 and may be equal to the
 .I remote
 address (below) without causing difficulty.

+Note that
+.B with-authinfo-kludge
+will not do anything to encourage the client
+to connect to the right address;
+its caller must arrange to configure the client correctly,
+e.g., by setting the
+.B NNTPSERVER
+environment variable appropriately.

 .TP
 .BI nntpauth= "parameter arguments\fR..."
 Set the AUTHINFO GENERIC authentication parameter and arguments
 .TP
 .BI nntpauth= "parameter arguments\fR..."
 Set the AUTHINFO GENERIC authentication parameter and arguments


@@ -493,6 +501,10 @@ The runtime directory is chosen as follows.
 If the
 .B \-d
 option is present, then its value is used.
 If the
 .B \-d
 option is present, then its value is used.

+Otherwise, if the configuration file specifies
+a value for the global
+.B rundir
+parameter then that it used.

 .hP 2.
 If the environment variable
 .B XDG_RUNTIME_DIR
 .hP 2.
 If the environment variable
 .B XDG_RUNTIME_DIR


@@ -556,12 +568,13 @@ Let
 be the local machine's hostname,
 as reported by
 .BR gethostname (2).
 be the local machine's hostname,
 as reported by
 .BR gethostname (2).

-If
+Then

 .IB cache-home /with-authinfo-kludge. hostname
 .IB cache-home /with-authinfo-kludge. hostname

-does not exist,
+is used as the runtime directory.
+.PP
+If the directory chosen by the above procedure does not exist,

 then it is created as a directory,
 with mode 0700 (and modified by the umask).
 then it is created as a directory,
 with mode 0700 (and modified by the umask).

-This directory is then used as the runtime directory.

 (If it exists, but is not in fact a directory,
 then later operations will fail.)
 .PP
 (If it exists, but is not in fact a directory,
 then later operations will fail.)
 .PP