YUME-meta(1)                     User Manuals                     YUME-meta(1)



NAME
       yume  -  Easy  menu  system with mouse-over user commands, for X Window
       System, based on xforms library

SYNOPSIS
       This man page is not maintained  with  a  current  synopsis  of  yume's
       options; please refer to yume(1) man page for that information.


DESCRIPTION
       yume  has  a  meta mode, which is the sole topic of this man page.  For
       general information about yume [a program for X which creates and  runs
       a menu based on given arguments], please see yume(1).

       A  command  list  that  starts  with a percent sign (%) is processed in
       "meta-mode".  Generally, use meta-mode if you want to  closely  control
       how  commands  are  invoked, or if you want to echo commands for debug-
       ging.  In brief, if command list begins as shown below  left,  it  will
       act as shown below right.

              %%     Print command on stdout before it is executed

              %#     Print command on stdout, don't execute.

              %+     Exit from yume, execute command.

              %-     Execute  command non-fork, non-SHELL.  That is, exit from
                     yume, and execute the command  as  expanded  by  wordexp,
                     without  going  to usual $SHELL.  The first word after %-
                     should be a program name.  yume will present the  command
                     list to that program, as its arguments.

              %:     Execute  command  non-SHELL. That is, execute the command
                     as expanded by wordexp, without going  to  usual  $SHELL.
                     The  first  word after %- should be a program name.  yume
                     will present the command list to  that  program,  as  its
                     arguments.

       See  examples/date-of-file  for  examples  of  the  five %x forms shown
       above, and see examples/date-of-file.txt for explanation of same.



EXAMPLES
       The examples listed below are those that are of specific  interest  for
       meta-mode processing.  The yume-examples(1) man page has general infor-
       mation about these and other yume examples.

       examples/date-of-file
              A line-by-line explanation of examples/date-of-file  appears  in
              examples/date-of-file.txt.  This example is not yet discussed in
              yume-examples(1).


FILES
       See files list in yume(1)

BUGS
       Dealing with errors in shell commands --

       If your command list is wrong or malformed, you probably will see error
       messages in the window where yume was started.  Some general techniques
       for troubleshooting include:

              -      Try out the command at a shell prompt

              -      Add temporary echo commands to display command  text,  or
                     preface  the  command  list with %% (to echo command list
                     before execution) or %# (to echo command  list,  but  not
                     execute it).

              -      Add a temporary -do group with the problematic command


AUTHOR
       James Waldby <j-waldby at pat7 dot com>

SEE ALSO
       yume(1),yume-examples(1),yume-plan(1)



Linux                        $Date:: 2009-03-01#$                 YUME-meta(1)