Subject: bin/24296: Proposed additions to the ftp man page
To: None <gnats-bugs@gnats.NetBSD.org>
From: None <firstname.lastname@example.org>
Date: 02/01/2004 22:24:33
>Synopsis: Proposed additions to the ftp man page
>Arrival-Date: Sun Feb 01 22:25:00 UTC 2004
>Originator: David H. Gutteridge
The current man page for ftp doesn't mention the fact that macdef names can be a maximum of eight characters, and isn't clear enough (in my opinion) that macdefs are only applicable to a particular machine definition or session. Accordingly, I've submitted a proposed patch (against v. 1.101 as current in CVS) under "fix to the problem" below.
--- ftp.1~ Sun Feb 1 16:52:15 2004
+++ ftp.1 Sun Feb 1 17:07:24 2004
@@ -64,7 +64,7 @@
.\" @(#)ftp.1 8.3 (Berkeley) 10/9/94
-.Dd December 19, 2003
+.Dd February 1, 2004
.Dt FTP 1
@@ -667,8 +667,12 @@
in a file or
carriage returns from the terminal) terminates macro input mode.
There is a limit of 16 macros and 4096 total characters in all
-Macros remain defined until a
+defined macros. Macro names can be a maximum of 8 characters.
+Macros are only applicable to the current session they are
+defined within (or if defined outside a session, to the session
+invoked with the next
+command), and remain defined until a
command is executed.
The macro processor interprets `$' and `\e' as special characters.
@@ -2024,8 +2028,19 @@
line and continue until a blank line (consecutive new-line
-characters) is encountered.
-If a macro named
+characters) is encountered. Like the other tokens in the
+is applicable only to the
+definition preceding it. A
+entry cannot be utilized by multiple
+definitions; rather, it must be defined following each
+it is intended to be used with. If a macro named
is defined, it is automatically executed as the last step in the