'\" t
.\"     Title: awesome2-menu
.\"    Author: [see the "AUTHORS" section]
.\" Generator: DocBook XSL Stylesheets v1.76.1 <http://docbook.sf.net/>
.\"      Date: 02/19/2016
.\"    Manual: \ \&
.\"    Source: \ \&
.\"  Language: English
.\"
.TH "AWESOME2\-MENU" "1" "02/19/2016" "\ \&" "\ \&"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
awesome2-menu \- awesome2 menu system
.SH "SYNOPSIS"
.sp
awesome2\-menu [\-c config] [\-e command] <title>
.SH "DESCRIPTION"
.sp
awesome2\-menu is a tool which will pop up a menu on your screen, grabbing keyboard and allowing you to search through an initial completion list, or using your files as completion\&.
.SH "USAGE"
.sp
By default, awesome2\-menu reads completion from standard input\&. If nothing is read, the completion list is built from the current working directory files\&.
.sp
To build a menu with all the executable files of /usr/bin:
.sp
.if n \{\
.RS 4
.\}
.nf
ls /usr/bin | awesome2\-menu \-e \*(Aqexec \*(Aq \*(AqExecute\*(Aq
.fi
.if n \{\
.RE
.\}
.sp
To build the same menu and run the programs in a terminal window:
.sp
.if n \{\
.RS 4
.\}
.nf
ls /usr/bin | awesome2\-menu \-e \*(Aqxterm \-e exec \*(Aq \*(AqExecute in terminal\*(Aq
.fi
.if n \{\
.RE
.\}
.sp
To build an ssh connection prompt:
.sp
.if n \{\
.RS 4
.\}
.nf
cut \-d\*(Aq \*(Aq \-f1 ~/\&.ssh/known_hosts | cut \-d, \-f1 | awesome2\-menu \-e \*(Aqxterm \-e ssh \*(Aq \*(Aqssh to:\*(Aq
.fi
.if n \{\
.RE
.\}
.sp
If you do not specify the \-e option, the result will be sent to standard output\&. You can do things like that:
.sp
.if n \{\
.RS 4
.\}
.nf
gzip "$(awesome2\-menu \*(Aq"File to gzip\*(Aq)"
.fi
.if n \{\
.RE
.\}
.SH "OPTIONS"
.PP
\-c config
.RS 4
Use an alternate configuration file instead of $HOME/\&.awesome2rc\&.
.RE
.PP
\-e command
.RS 4
Command to execute\&. The result is appended to the end of this command (like xargs)\&.
.RE
.PP
<title>
.RS 4
Print this title\&. This is also used to identify the menu section in the awesome2rc file\&.
.RE
.SH "SEE ALSO"
.sp
awesome2(1) awesome2rc(5)
.SH "AUTHORS"
.sp
Julien Danjou <\m[blue]\fBjulien@danjou\&.info\fR\m[]\&\s-2\u[1]\d\s+2>
.SH "WWW"
.sp
\m[blue]\fBhttp://awesome2\&.naquadah\&.org\fR\m[]
.SH "NOTES"
.IP " 1." 4
julien@danjou.info
.RS 4
\%mailto:julien@danjou.info
.RE