From owner-freebsd-hackers@FreeBSD.ORG Sun Sep 11 13:08:37 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 1D4EB1065673; Sun, 11 Sep 2011 13:08:37 +0000 (UTC) (envelope-from utisoft@gmail.com) Received: from mail-yx0-f182.google.com (mail-yx0-f182.google.com [209.85.213.182]) by mx1.freebsd.org (Postfix) with ESMTP id BD63B8FC12; Sun, 11 Sep 2011 13:08:36 +0000 (UTC) Received: by yxk36 with SMTP id 36so3176398yxk.13 for ; Sun, 11 Sep 2011 06:08:36 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=gamma; h=mime-version:sender:in-reply-to:references:from:date :x-google-sender-auth:message-id:subject:to:cc:content-type :content-transfer-encoding; bh=AyCGYtXfHltQjcYJRTL3bAEkSLOkOkOWqQf/byG7OKc=; b=UP/vd+g9PqvR02ASIfflwANu0jhC5vtfne44K8Hlznzwsg2nadqztTnCN6nrbhgmQ3 lVYWVYQ46Acof6hQw6V1ohGphvXlSA2TwMci+MhggGbi7YN5x20Opv9KXpgJv/rRq4UA /HxWBiislUGg1ZUGR4qWj9mPSLs5X+UOct/bA= Received: by 10.43.132.130 with SMTP id hu2mr415529icc.352.1315746515288; Sun, 11 Sep 2011 06:08:35 -0700 (PDT) MIME-Version: 1.0 Sender: utisoft@gmail.com Received: by 10.231.61.148 with HTTP; Sun, 11 Sep 2011 06:08:05 -0700 (PDT) In-Reply-To: <201109111219.p8BCJXwY059714@fire.js.berklix.net> References: <201109111219.p8BCJXwY059714@fire.js.berklix.net> From: Chris Rees Date: Sun, 11 Sep 2011 14:08:05 +0100 X-Google-Sender-Auth: kQoX3bdDJ0l49ZHeuWj4sFKb2So Message-ID: To: "Julian H. Stacey" Content-Type: text/plain; charset=ISO-8859-1 Content-Transfer-Encoding: quoted-printable Cc: bf1783@gmail.com, freebsd-hackers@freebsd.org, Raphael Kubo da Costa 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:08:37 -0000 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, >> > >> > =A0 =A0 =A0 =A0 FreeBSD-8.2-RELEASE & current man bzip2 >> > =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 .../-current/src/contrib/bzip2/bzip2.1 >> > >> > adding URLs >> > =A0 =A0 =A0 =A0 http://www.7-zip.org/download.html =A0 =A0 =A0-> >> > =A0 =A0 =A0 =A0 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. =A0(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. =A0& 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