From owner-freebsd-doc Mon Jul 10 18:50: 8 2000 Delivered-To: freebsd-doc@freebsd.org Received: from freefall.freebsd.org (freefall.FreeBSD.ORG [204.216.27.21]) by hub.freebsd.org (Postfix) with ESMTP id ECE0F37B940 for ; Mon, 10 Jul 2000 18:50:04 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.9.3/8.9.2) id SAA39226; Mon, 10 Jul 2000 18:50:04 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Date: Mon, 10 Jul 2000 18:50:04 -0700 (PDT) Message-Id: <200007110150.SAA39226@freefall.freebsd.org> To: freebsd-doc@freebsd.org Cc: From: Ben Smithurst Subject: Re: docs/15408: Description of ls and nlist wrong in man page for ftp Reply-To: Ben Smithurst Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org The following reply was made to PR docs/15408; it has been noted by GNATS. From: Ben Smithurst To: freebsd-gnats-submit@FreeBSD.org Cc: inwap@best.com Subject: Re: docs/15408: Description of ls and nlist wrong in man page for ftp Date: Tue, 11 Jul 2000 01:58:21 +0100 > 2) Change the docs to show that 'ls' is different from 'nlist'. > > Update the man page, so that the paragraph on 'dir' includes > a statement how 'dir' differs from 'nlist'. I'd rather the other way around, but I don't feel strongly either way. It already explains that 'dir' returns system-dependent information. How about adding something like this to the 'nlist' description: Note that this command only returns the filenames in the remote directory. If you wish to see more information about the files (often size, modification time, and so on) use the dir command instead. Perhaps something could be added to the 'dir' description too: If you want a plain list of files, with no extra information, use the nlist command instead. ok? > Replace the paragraph on > 'ls' with "ls [remote-directory [local-file]]\nA synonym for dir." > Move the old description of 'ls' to 'nlist'. That's easy... > Make it clear that, according to the RFC, this command returns > a list of files on the remote machine, explictly excluding the > names of any subdirectories in the remote directory. (The > wu-ftpd-2.6.0 server enforces this.) What do you mean by "this command"? The "nlist" client command? The NLST server command? Either way, I don't see subdirectories excluded: ftp> ls ---> PORT 192,168,91,33,192,13 200 PORT command successful. ---> LIST 150 Opening ASCII mode data connection for /bin/ls. total 12 d--x--x--x 2 root wheel 512 Apr 5 19:14 bin d--x--x--x 2 root wheel 512 Apr 5 19:18 etc drwxrwx-wt 2 root wheel 512 Apr 5 19:13 incoming drwxr-xr-x 4 root wheel 512 Aug 11 1999 local drwxr-xr-x 39 root bin 1024 Jul 10 01:34 packages drwxr-xr-x 5 root wheel 512 Jul 1 20:38 pub 226 Transfer complete. ftp> dir ---> PORT 192,168,91,33,192,14 200 PORT command successful. ---> LIST 150 Opening ASCII mode data connection for /bin/ls. total 12 d--x--x--x 2 root wheel 512 Apr 5 19:14 bin d--x--x--x 2 root wheel 512 Apr 5 19:18 etc drwxrwx-wt 2 root wheel 512 Apr 5 19:13 incoming drwxr-xr-x 4 root wheel 512 Aug 11 1999 local drwxr-xr-x 39 root bin 1024 Jul 10 01:34 packages drwxr-xr-x 5 root wheel 512 Jul 1 20:38 pub 226 Transfer complete. ftp> nlist ---> PORT 192,168,91,33,192,15 200 PORT command successful. ---> NLST 150 Opening ASCII mode data connection for file list. bin etc incoming local packages pub 226 Transfer complete. Am I misunderstanding something? The server in question is running wu-ftpd-2.6.0. Could you explain what should be happening a bit better? thanks, -- Ben Smithurst / ben@FreeBSD.org / PGP: 0x99392F7D To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message