Bug#610478: suckless-tools: man dmenu_run fails
Thanks Jason from your contribution here. I will go over your patch when I next prepare a package. Tbh I didn't think dmenu was used outside dwm. I don't think users need to know about the cache. It's auto-refreshed depending the mtime. http://hg.suckless.org/dmenu/file/tip/dmenu_path.c#l96 I know you're keen to contribute, though remember suckless is usually about removing stuff. ;) Less is more. Kind regards, -- To UNSUBSCRIBE, email to debian-bugs-dist-requ...@lists.debian.org with a subject of unsubscribe. Trouble? Contact listmas...@lists.debian.org
Bug#610478: suckless-tools: man dmenu_run fails
On 2011-01-27 10:48AM, Kai Hendry wrote: Thanks Jason from your contribution here. I will go over your patch when I next prepare a package. Tbh I didn't think dmenu was used outside dwm. Oh, interesting. I think it gets recommended from time to time from various minimalist circles. I haven't actually used dwm, though I have read about it. I think I used dmenu years ago with ion2. And probably later with wmii. Recently dmenu got installed on my debian unstable because of the browse package depends on it. The uzbl folks recommend dmenu from time to time too. It's just so awesomely fast. I don't think users need to know about the cache. It's auto-refreshed depending the mtime. http://hg.suckless.org/dmenu/file/tip/dmenu_path.c#l96 Oh, you check the mtime of folders in $PATH. Very cool. I love when I find out that the software I'm using does exactly what it should do. And I agree that this makes it unnecessary to mention in the man page. I know you're keen to contribute, though remember suckless is usually about removing stuff. ;) Less is more. Feel free to ignore all the + lines in my patch ;) Take care, - Jason -- To UNSUBSCRIBE, email to debian-bugs-dist-requ...@lists.debian.org with a subject of unsubscribe. Trouble? Contact listmas...@lists.debian.org
Bug#610478: suckless-tools: man dmenu_run fails
On 27 January 2011 14:18, Jason Woofenden ja...@jasonwoof.com wrote: Oh, interesting. I think it gets recommended from time to time from various minimalist circles. I haven't actually used dwm, though I have read about it. I think I used dmenu years ago with ion2. And probably later with wmii. Recently dmenu got installed on my debian unstable because of the browse package depends on it. The uzbl folks recommend dmenu from time to time too. Oh of course. I forgot about that. Surf uses it too I think. It's just so awesomely fast. Simple good software is like that. ;) -- To UNSUBSCRIBE, email to debian-bugs-dist-requ...@lists.debian.org with a subject of unsubscribe. Trouble? Contact listmas...@lists.debian.org
Bug#610478: suckless-tools: man dmenu_run fails
Oh of course. I forgot about that. Surf uses it too I think. Oops, surf is what I meant. There's no browse package. -- To UNSUBSCRIBE, email to debian-bugs-dist-requ...@lists.debian.org with a subject of unsubscribe. Trouble? Contact listmas...@lists.debian.org
Bug#610478: suckless-tools: man dmenu_run fails
On 18 January 2011 22:05, Jason Woofenden ja...@jasonwoof.com wrote: I've started using dmenu_run in place of my home grown run dialog. dmenu_run (view the source by all means) invokes dmenu with all the binaries in the path (thanks to dmenu_path). dmenu_path is obv. a little hack to iterate the binaries it finds, since you can't do this easily with typical filesystems. http://lists.suckless.org/dev/1101/6804.html I know the Debian rules say you should have a manpage for every binary, though since these commands are so tightly integrated to what dmenu is typically used to do (launch binaries), it seems a bit of overkill to me. Nonetheless I accept patches. ;) Perhaps I could bury these binaries in some other place (i.e. not /bin) in the Debian FHS as to avoid the every binary needs a man page rule. Ho humm... -- To UNSUBSCRIBE, email to debian-bugs-dist-requ...@lists.debian.org with a subject of unsubscribe. Trouble? Contact listmas...@lists.debian.org
Bug#610478: suckless-tools: man dmenu_run fails
Kai, Sorry if I was unclear. I'm not asking for new manual pages to be written, I just want a symlink so that the dmenu man page comes up for man dmenu_run as well (and it's supposed to for man dmenu_path too). Just like how man fprintf and man sprintf bring up the same man page. That's what this bug is about. I consider it fixed when man dmenu_run brings up a man page (the current dmenu man page is fine.) But while we're talking about the man page (and you brought up patches) I've attached a patch with suggestions for tweaks to the man page. Please apply as much or as little as you want. Even though few people will use dmenu_path directly, I think it's nice to say what it does. Some rationale on a nitpick: from my perspective (wanting to know what the programs do and how to call them from xbindkeys) I don't care that dwm was originally designed for dwm. If that tidbit is in the man page I think it should be in a HISTORY section or something. Oh, and while editing the man page, I started to get real curious about the dmenu_path cache file. Seems like users might need to know about this. Info about when it's refreshed and how to manually refresh it would be appropriate I think (perhaps a FILES section?) Thank you,- Jason diff --git a/dmenu/dmenu.1 b/dmenu/dmenu.1 index d2a93d1..5bde96e 100644 --- a/dmenu/dmenu.1 +++ b/dmenu/dmenu.1 @@ -1,6 +1,6 @@ .TH DMENU 1 dmenu\-VERSION .SH NAME -dmenu \- dynamic menu +dmenu, dmenu_run, dmenu_path \- dynamic menu .SH SYNOPSIS .B dmenu .RB [ \-b ] @@ -28,8 +28,7 @@ dmenu \- dynamic menu .B dmenu_path .SH DESCRIPTION .B dmenu -is a dynamic menu for X, originally designed for -.BR dwm (1). +is a dynamic menu for X. It manages huge numbers of user-defined menu items efficiently. .P dmenu reads a list of newline-separated items from standard input and creates a @@ -37,11 +36,12 @@ menu. When the user selects an item or enters any text and presses Return, their choice is printed to standard output and dmenu terminates. .P .B dmenu_run -is a dmenu script used by dwm which lists programs in the user's PATH and +runs dmenu with the list of programs in the user's PATH then executes the selected item. .P .B dmenu_path -is a program used by dmenu_run to find and cache a list of executables. +outputs a list of all programs in the user's PATH, one per line alphabetically +with no duplicates. This list is cached in ~/.dmenu_cache. .SH OPTIONS .TP .B \-b
Bug#610478: suckless-tools: man dmenu_run fails
Package: suckless-tools Version: 38-1 Severity: minor Thanks for packaging dmenu! I've started using dmenu_run in place of my home grown run dialog. man dmenu documents the dmenu and dmenu_run commands. So man dmenu_run should bring up that same man page (but it currently says No manual entry for dmenu_run Ditto for dmenu_path, though this program doesn't seem as useful. Thanks! - Jason -- System Information: Debian Release: 6.0 APT prefers unstable APT policy: (500, 'unstable') Architecture: i386 (i686) Kernel: Linux 2.6.32-5-686 (SMP w/2 CPU cores) Locale: LANG=en_US.UTF-8, LC_CTYPE=en_US.UTF-8 (charmap=UTF-8) Shell: /bin/sh linked to /bin/dash Versions of packages suckless-tools depends on: ii libc6 2.11.2-8 Embedded GNU C Library: Shared lib ii libx11-6 2:1.3.3-4 X11 client-side library ii libxext6 2:1.1.2-1 X11 miscellaneous extension librar ii libxinerama1 2:1.1.1-1 X11 Xinerama extension library suckless-tools recommends no packages. Versions of packages suckless-tools suggests: pn dwm none (no description available) -- no debconf information -- To UNSUBSCRIBE, email to debian-bugs-dist-requ...@lists.debian.org with a subject of unsubscribe. Trouble? Contact listmas...@lists.debian.org