Re: Description to man pages

2002-04-10 Thread Tille, Andreas
Hello,

in general I like the idea of descriptions of manpages.  I would like it
even more if it would regard i18n descriptions which are produced by
the ddtp server.

Kind regards

Andreas.


-- 
To UNSUBSCRIBE, email to [EMAIL PROTECTED]
with a subject of unsubscribe. Trouble? Contact [EMAIL PROTECTED]




Re: Description to man pages

2002-04-09 Thread Otto Wyss
 On Sat, Apr 06, 2002 at 10:01:16AM +0200, Otto Wyss wrote:
  The best would be if man keyword would bring up a list of man pages
  with a choose facility when more than one page exists. Maybe this change
  in behavior could be set through an environment variable.
 
 No need. Try 'man -a keyword'.
 
 Also, when more than one page exists man will ask you if you want to
 display the next one it's found after displaying the first one. Try it.

I'd rather like it if the menu is shown before not after the first man
page. If I knew another page is following I might jump directly there.
Also I'd rather like this to be the default if multiple pages where
available.

O. Wyss

-- 
Author of Debian partial mirror synch script
(http://dpartialmirror.sourceforge.net/;)


-- 
To UNSUBSCRIBE, email to [EMAIL PROTECTED]
with a subject of unsubscribe. Trouble? Contact [EMAIL PROTECTED]




Re: Description to man pages

2002-04-08 Thread Colin Watson
On Sat, Apr 06, 2002 at 10:01:16AM +0200, Otto Wyss wrote:
 The best would be if man keyword would bring up a list of man pages
 with a choose facility when more than one page exists. Maybe this change
 in behavior could be set through an environment variable.

No need. Try 'man -a keyword'.

Also, when more than one page exists man will ask you if you want to
display the next one it's found after displaying the first one. Try it.

-- 
Colin Watson  [EMAIL PROTECTED]


-- 
To UNSUBSCRIBE, email to [EMAIL PROTECTED]
with a subject of unsubscribe. Trouble? Contact [EMAIL PROTECTED]




Re: Description to man pages

2002-04-06 Thread Otto Wyss
 On Thu, Apr 04, 2002 at 11:03:53PM +0200, Otto Wyss wrote:
  I've now choosen 7dsc since packages aren't commands.
 
 How about something more descriptive than dsc?  Say, package,
 pkg, or deb (in my order of preference)?
 

I'm also not very happy with dsc but I neither are with the others.
What do anybody else think? 

If there isn't another man page man keyword will show the package
description. You could get a list of all man pages for a keyword with
man -f keyword.

The best would be if man keyword would bring up a list of man pages
with a choose facility when more than one page exists. Maybe this change
in behavior could be set through an environment variable.

O. Wyss

-- 
Author of Debian partial mirror synch script
(http://dpartialmirror.sourceforge.net/;)


-- 
To UNSUBSCRIBE, email to [EMAIL PROTECTED]
with a subject of unsubscribe. Trouble? Contact [EMAIL PROTECTED]




Re: Description to man pages

2002-04-05 Thread Andrew Pimlott
On Thu, Apr 04, 2002 at 11:03:53PM +0200, Otto Wyss wrote:
 I've now choosen 7dsc since packages aren't commands.

How about something more descriptive than dsc?  Say, package,
pkg, or deb (in my order of preference)?

Andrew


-- 
To UNSUBSCRIBE, email to [EMAIL PROTECTED]
with a subject of unsubscribe. Trouble? Contact [EMAIL PROTECTED]




Re: Description to man pages

2002-04-04 Thread Otto Wyss
 dpkg -s package
 
This doesn't show the package description!

O. Wyss

-- 
Author of Debian partial mirror synch script
(http://dpartialmirror.sourceforge.net/;)


-- 
To UNSUBSCRIBE, email to [EMAIL PROTECTED]
with a subject of unsubscribe. Trouble? Contact [EMAIL PROTECTED]




Re: Description to man pages

2002-04-04 Thread Otto Wyss
  To minimize possible conflicts with other names it creates man pages in
  section 6 (games!). Of course this can be configured in the config file.
  I'd rather like to know which is a better place for it.
 
 Use a subsection. For instance, somepackage(1dsc) goes in
 $(mandir)/man1/somepackage.1dsc.gz. This should avoid clashes, and you
 can pass man the '-e dsc' option to look at those pages exclusively. It
 might also be a good idea to write to /usr/local/man by default rather
 than /usr/share/man.
 
I didn't know that man has subsection, the man howto which I found on
the web didn't tell it.

I've now choosen 7dsc since packages aren't commands.

 Would it be possible to make it easier to use for those who don't use
 debiansynch? I couldn't figure out how to get it to work at all -
 whatever I tried just ended up with 0 processed of 0. I don't have a
 local mirror, so I'd like it just to use the available file.

Actually dsc2man search for Packages files inside the basedir if no
distribution list is specified (empty parameter distsfile in
dsc2man.conf or if the file isn't found). I've changed the behavior so
that searching is the default. Of course the Packages files have to be
located anywhere locally inside the searched basedir (regardless of
structure).

There was also a bug which prevented the search under certain
circumstances, but now it should work.

O. Wyss

-- 
Author of Debian partial mirror synch script
(http://dpartialmirror.sourceforge.net/;)


-- 
To UNSUBSCRIBE, email to [EMAIL PROTECTED]
with a subject of unsubscribe. Trouble? Contact [EMAIL PROTECTED]




Re: Description to man pages

2002-04-04 Thread Otto Wyss
 Is it better than `apt-cache show foo` ?

No if you are a power user, otherwise yes. Beside not everbody has
apt-cache installed.

O. Wyss

-- 
Author of Debian partial mirror synch script
(http://dpartialmirror.sourceforge.net/;)


-- 
To UNSUBSCRIBE, email to [EMAIL PROTECTED]
with a subject of unsubscribe. Trouble? Contact [EMAIL PROTECTED]




Re: Description to man pages

2002-04-04 Thread Henrique Pedroni Neto
 dpkg -s package
 
 This doesn't show the package description!
 
 O. Wyss

To show the description of one package use this command:

dpkg -p package

[]'s
Henrique



-- 
To UNSUBSCRIBE, email to [EMAIL PROTECTED]
with a subject of unsubscribe. Trouble? Contact [EMAIL PROTECTED]




Re: Description to man pages

2002-04-04 Thread Peter Mathiasson
On Thu, Apr 04, 2002 at 11:03:52PM +0200, Otto Wyss wrote:
  Is it better than `apt-cache show foo` ?
 
 No if you are a power user, otherwise yes. Beside not everbody has
 apt-cache installed.

I think most people do have apt installed.

$ dpkg -S `which apt-get` `which apt-cache`
apt: /usr/bin/apt-get
apt: /usr/bin/apt-cache

-- 
Peter Mathiasson, peter at mathiasson dot nu, http://www.mathiasson.nu
GPG Fingerprint: A9A7 F8F6 9821 F415 B066 77F1 7FF5 C2E6 7BF2 F228


pgpoSivUMfSFb.pgp
Description: PGP signature


Re: Description to man pages

2002-04-03 Thread Thom May
* Otto Wyss ([EMAIL PROTECTED]) wrote :
 Since I hated to start dselect again and again just to read a package
 description I wrote a script dsc2man which creates appropriate man
 pages for each package. 
 
 To minimize possible conflicts with other names it creates man pages in
 section 6 (games!). Of course this can be configured in the config file.
 I'd rather like to know which is a better place for it.
 
 The script does only create pages if none exists. But for upgrading the
 force switch has to be used, which means any existing page will be
 overwritten.
 
 The script can be down loaded from
 http://dpartialmirror.sourceforge.net/dsc2man.html;
 
 O. Wyss
 
Is it better than `apt-cache show foo` ?
-Thom


-- 
To UNSUBSCRIBE, email to [EMAIL PROTECTED]
with a subject of unsubscribe. Trouble? Contact [EMAIL PROTECTED]




Re: Description to man pages

2002-04-03 Thread Michael Banck
On Wed, Apr 03, 2002 at 10:45:29PM +0200, Otto Wyss wrote:
 Since I hated to start dselect again and again just to read a package
 description I wrote a script dsc2man which creates appropriate man
 pages for each package. 

Apart from this being quite cool, you surely know that you can read
packages' description via

apt-cache show package

or

dpkg -s package

?

Michael, just asking

-- 
Don't come crying to me about your 30 minute compiles!!  I have to build X
uphill both ways!  In the snow!  With bare feet! And we didn't have compilers!
We had to translate the C code to mnemonics OURSELVES! And I was 18 before we
even had assemblers!   -- Overfiend


-- 
To UNSUBSCRIBE, email to [EMAIL PROTECTED]
with a subject of unsubscribe. Trouble? Contact [EMAIL PROTECTED]




Re: Description to man pages

2002-04-03 Thread David Roundy
On Wed, Apr 03, 2002 at 10:45:29PM +0200, Otto Wyss wrote:
 Since I hated to start dselect again and again just to read a package
 description I wrote a script dsc2man which creates appropriate man
 pages for each package. 

Wouldn't it be easier to just use apt-cache show package?
-- 
David Roundy
http://civet.berkeley.edu/droundy/


-- 
To UNSUBSCRIBE, email to [EMAIL PROTECTED]
with a subject of unsubscribe. Trouble? Contact [EMAIL PROTECTED]




Re: Description to man pages

2002-04-03 Thread Colin Watson
On Wed, Apr 03, 2002 at 10:45:29PM +0200, Otto Wyss wrote:
 Since I hated to start dselect again and again just to read a package
 description I wrote a script dsc2man which creates appropriate man
 pages for each package. 
 
 To minimize possible conflicts with other names it creates man pages in
 section 6 (games!). Of course this can be configured in the config file.
 I'd rather like to know which is a better place for it.

Use a subsection. For instance, somepackage(1dsc) goes in
$(mandir)/man1/somepackage.1dsc.gz. This should avoid clashes, and you
can pass man the '-e dsc' option to look at those pages exclusively. It
might also be a good idea to write to /usr/local/man by default rather
than /usr/share/man.

Would it be possible to make it easier to use for those who don't use
debiansynch? I couldn't figure out how to get it to work at all -
whatever I tried just ended up with 0 processed of 0. I don't have a
local mirror, so I'd like it just to use the available file.

-- 
Colin Watson  [EMAIL PROTECTED]


-- 
To UNSUBSCRIBE, email to [EMAIL PROTECTED]
with a subject of unsubscribe. Trouble? Contact [EMAIL PROTECTED]