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)
 .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
 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
 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
 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
 .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
 .IR command 's

-name actually begins with
+name containing an
+.RB ` = '
+or, less plausibly, beginning with

 .RB ` + ',
 an argument consisting of a
 .RB ` + '
 .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.
 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


@@ -352,6 +362,7 @@ set up by the
 .B via
 parameter.
 The default is to use
 .B via
 parameter.
 The default is to use

+.\" FIXME Fuck you openssh

 127.1.0.1:119.
 It is
 .I not
 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.
 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
 .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
 .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)
 .IR tag . pid \fR.
 Each such directory corresponds to a running
 (or failed)