Skip site navigation (1)Skip section navigation (2)
Date:      Sun, 11 Sep 2011 14:08:05 +0100
From:      Chris Rees <crees@freebsd.org>
To:        "Julian H. Stacey" <jhs@berklix.com>
Cc:        bf1783@gmail.com, freebsd-hackers@freebsd.org, Raphael Kubo da Costa <rakuco@freebsd.org>
Subject:   Re: man bzip2 - suggest we add to See Also
Message-ID:  <CADLo838fac5JyQxoEq04FHJ7vQN2Z%2Bu=cRSD7LJxSs4=ypPyXw@mail.gmail.com>
In-Reply-To: <201109111219.p8BCJXwY059714@fire.js.berklix.net>
References:  <CAGFTUwNdiEUJhDjN=dJ8B5NoAaJ9W6%2BP6J4THG0Fb26z4u0kqQ@mail.gmail.com> <201109111219.p8BCJXwY059714@fire.js.berklix.net>

next in thread | previous in thread | raw e-mail | index | archive | help
On 11 September 2011 13:19, Julian H. Stacey <jhs@berklix.com> 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



Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?CADLo838fac5JyQxoEq04FHJ7vQN2Z%2Bu=cRSD7LJxSs4=ypPyXw>