From owner-freebsd-hackers@FreeBSD.ORG Sun Sep 11 13:49:54 2011 Return-Path: Delivered-To: freebsd-hackers@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 73FB2106564A; Sun, 11 Sep 2011 13:49:54 +0000 (UTC) (envelope-from jhs@berklix.com) Received: from tower.berklix.org (tower.berklix.org [83.236.223.114]) by mx1.freebsd.org (Postfix) with ESMTP id D67318FC12; Sun, 11 Sep 2011 13:49:53 +0000 (UTC) Received: from mart.js.berklix.net (p5DCBE209.dip.t-dialin.net [93.203.226.9]) (authenticated bits=0) by tower.berklix.org (8.14.2/8.14.2) with ESMTP id p8BDnpAP078600; Sun, 11 Sep 2011 13:49:52 GMT (envelope-from jhs@berklix.com) Received: from fire.js.berklix.net (fire.js.berklix.net [192.168.91.41]) by mart.js.berklix.net (8.14.3/8.14.3) with ESMTP id p8BDnjm8052774; Sun, 11 Sep 2011 15:49:45 +0200 (CEST) (envelope-from jhs@berklix.com) Received: from fire.js.berklix.net (localhost [127.0.0.1]) by fire.js.berklix.net (8.14.4/8.14.4) with ESMTP id p8BDnRGJ060535; Sun, 11 Sep 2011 13:49:33 GMT (envelope-from jhs@fire.js.berklix.net) Message-Id: <201109111349.p8BDnRGJ060535@fire.js.berklix.net> to: freebsd-hackers@freebsd.org From: "Julian H. Stacey" Organization: http://www.berklix.com BSD Unix Linux Consultancy, Munich Germany User-agent: EXMH on FreeBSD http://www.berklix.com/free/ X-URL: http://www.berklix.com In-reply-to: Your message "Sun, 11 Sep 2011 14:08:05 BST." Date: Sun, 11 Sep 2011 15:49:27 +0200 Sender: jhs@berklix.com Cc: bf1783@gmail.com, Chris Rees , Raphael Kubo da Costa , Julian Seward Subject: Re: man bzip2 - suggest we add to See Also X-BeenThere: freebsd-hackers@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Technical Discussions relating to FreeBSD List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 11 Sep 2011 13:49:54 -0000 Chris Rees wrote: > On 11 September 2011 13:19, Julian H. Stacey wrote: > > "b. f." wrote: > >> > > >> > I suggest we should add a See Also section to man bzip2, > >> > > >> >         FreeBSD-8.2-RELEASE & current man bzip2 > >> >                 .../-current/src/contrib/bzip2/bzip2.1 > >> > > >> > adding URLs > >> >         http://www.7-zip.org/download.html      -> > >> >         http://www.freshports.org/archivers/p7zip/ > >> > > >> > as currently no reference is made to 7zip or 7-zip > >> > >> I'm a bit confused -- are you recommending this because you think that > >> users should be aware of the the other compression methods/archive > >> formats that 7zip uses, so that they can investigate alternatives, or > >> just because it is a Windows program that can decompress bzipped > >> files? > > > > Yes. > > If FreeBSD users happen to export .bz2 files to Microsoft users, > > uts nice to be able to tell MS users at least 1 MS program that can > > access the format. > > > >> In either case, I don't see any reason to single out 7zip -- > >> we have xz(1) in the base system now, and there are other, arguably > >> better compression methods in Ports. And there is a lot of > >> Windows-based software that can decompress bzip2, including Windows > >> ports of bzip2 itself. > > > > OK didnt know that. by all means add a URL. > > > >> I don't think that the bzip2 manpage is the > >> appropriate place to add this kind of information.  (Perhaps the > >> FreeBSD Handbook, in a section about working with files typically > >> found on FreeBSD or other Unixen in Windows, or in libarchive(5), if > >> it were changed to support the 7zip archive format.) And I don't think > >> that -hackers is the appropriate list for this proposal -- -doc seems > >> to be the right place. > > > > Well I'm an old Unix hand, I have much more faith in the man command, > > that works on machines even if no net connected. (& easy to edit, > > & format without the tool chain from hell that doc uses) hence I > > suggested adding a URL in see also of man. > > > > Cos' if eg I get a phone call from an MS [l]user saying "what do I > > do with your .bz2?" I would first by reflex type man bzip2 /See > > Also.  & not first connect to net & mouse around to docs. > > > > Do we usually add a Windows analogue of our commands to the man page? > I would have thought that Google is definitely the most appropriate > medium for finding that out. > > Chris Good point. Consisteny; that would probably tilt to Not adding any URLs; but many Unix commands don't have direct comparable commands, so there's not so many commands to be consistent with I suppose, tar might be a related tool to be consistent with, but bsdtar is quite new, & hasn't had much time to accumulate URLs to compatible tools on other OS's, though it does have a section Standards. Google & other search engines help discovery, (that's how I found bzip2 compression method listed on minux3.org in last URL). I guess author of imported code will decide: Julian Seward Cheers, Julian -- Julian Stacey, BSD Unix Linux C Sys Eng Consultants Munich http://berklix.com Reply below, not above; Indent with "> "; Cumulative like a play script. Format: Plain text. Not HTML, multipart/alternative, base64, quoted-printable. http://www.softwarefreedomday.org 17th Sept, http://berklix.org/sfd/ Oct.