with-authinfo-kludge: Fix a poorly formatted comment.

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

diff --git a/with-authinfo-kludge.1 b/with-authinfo-kludge.1
index 117c474..5a67856 100644 (file)
--- a/with-authinfo-kludge.1
+++ b/with-authinfo-kludge.1
@@ -83,7 +83,7 @@ program is an
 .I adverbial modifier
 which runs another command
 (typically a newsreader)
-in an environment in which at can,
+in an environment in which it can,
 transparently to it,
 make connections to certain NNTP servers
 which usually require
@@ -91,7 +91,7 @@ which usually require
 authentication before they'll permit clients to read or post.
 This is useful because support for
 .B AUTHINFO GENERIC
-has never been especially widely supported by newsreaders
+has never been especially widely implemented by newsreaders
 and now seems to be being withdrawn from those newsreaders
 which used to support it.
 .PP
@@ -234,9 +234,11 @@ is treated exactly the same as a configuration-file section
 .PP
 See below for details about the configuration file.
 .PP
-To hedge against the unlikely event that the desired
+To hedge against the
 .IR command 's
-name actually begins with
+name containing an
+.RB ` = '
+or, less plausibly, beginning with
 .RB ` + ',
 an argument consisting of a
 .RB ` + '
@@ -328,6 +330,14 @@ name from the section heading
 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
@@ -352,6 +362,7 @@ set up by the
 .B via
 parameter.
 The default is to use
+.\" FIXME Fuck you openssh
 127.1.0.1:119.
 It is
 .I not
@@ -444,6 +455,7 @@ if no home directory was determined.
 Let
 .I config-home
 denote the configuration home directory so determined.
+.\" FIXME XDG_CONFIG_DIRS too now
 .hP 5.
 A `tag' is chosen, as follows.
 If the
@@ -572,6 +584,8 @@ then later operations will fail.)
 .PP
 The runtime directory contains a number of other directories,
 named
+.\" FIXME junk, new, naming
+.\" session dirs now entirely different
 .IR tag . pid \fR.
 Each such directory corresponds to a running
 (or failed)