awesome-menu.1.txt

   1 awesome-menu(1)
   2 =================
   3
   4 NAME
   5 ----
   6
   7 awesome-menu - awesome menu system
   8
   9 SYNOPSIS
  10 --------
  11
  12 awesome-menu [-c config] [-e command] <title>
  13
  14 DESCRIPTION
  15 -----------
  16
  17 awesome-menu is a tool which will pop up a menu on your screen, grabbing
  18 keyboard and allowing you to search through an initial completion list, or
  19 using your files as completion.
  20
  21 USAGE
  22 -----
  23 By default, awesome-menu read completion from standard input. If nothing is
  24 read, the completion list is built from the current working directory files.
  25
  26 To build a menu with executable program:
  27
  28     ls /usr/bin | awesome-menu -e 'exec ' 'Execute'
  29
  30 To build the same menu with executable run in a terminal window:
  31
  32     ls /usr/bin | awesome-menu -e 'xterm -e exec ' 'Execute in terminal'
  33
  34 To build an ssh connection prompt:
  35
  36     cut -d' ' -f1 ~/.ssh/known_hosts | cut -d, -f1 | awesome-menu -e 'xterm -e ssh ' 'ssh to:'
  37
  38 If you do not specify the -e option, result will be printed to standard output.
  39 You can do things like that:
  40
  41     gzip "$(awesome-menu '"File to gzip')"
  42
  43 OPTIONS
  44 -------
  45 -c config::
  46     Use an alternate configuration file instead of $HOME/.awesomerc.
  47 -e command::
  48     Command to execute. The result is appended to the end of this command (like xargs).
  49 <title>::
  50     Print this title. This is also used to identify the menu section in the awesomerc file.
  51
  52 SEE ALSO
  53 --------
  54 awesome(1) awesomerc(5)
  55
  56 AUTHORS
  57 -------
  58 Julien Danjou <julien@danjou.info>
  59
  60 WWW
  61 ---
  62 http://awesome.naquadah.org