This is Info file uit.info, produced by Makeinfo-1.55 from the input
file uit.texi.


File: uit.info,  Node: Top,  Next: Introduction,  Prev: (dir),  Up: (dir)

   This file documents the UNIX Interactive Tools package.

   Copyright (c) 1993, 1994 Tudor Hulubei & Andrei Pitis

* Menu:

* Introduction::
* Installing UIT::
* Configuration Files::
* uit::
* uitps::
* uitview::
* uitmount::
* uitcmp::
* uitkeys::
* uitmatch::
* uitaction::
* .uitaction::
* Starting uit/uitps/uitview/uitmount::
* Canceling Operations::
* Limitations::
* Bugs::
* Copyright::
* Authors::


File: uit.info,  Node: Introduction,  Next: Installing UIT,  Prev: Top,  Up: Top

Introduction
============

   This document presents some basic information that users should know
in order to use UIT effectively. Any questions, comments, or bug
reports, should be emailed to the authors. Please be sure to include
the version number. The email addresses are:

                        tudor@ulise.cs.pub.ro
                        tudor@habarnam.cs.pub.ro


File: uit.info,  Node: Installing UIT,  Next: Configuration Files,  Prev: Introduction,  Up: Top

Installing UIT
==============

   Please read the INSTALL file that comes with the UIT package.


File: uit.info,  Node: Configuration Files,  Next: uit,  Prev: Installing UIT,  Up: Top

Configuration Files
===================

   There is one configuration file per terminal type in
uit/uitps/uitview.  The configuration file(s) resides in the user's
home directory or (the default versions) in the directory $(prefix)/lib
(usually /usr/local/lib).  The generic name is .uitrc.TERM. UIT 4.3.1
allows each terminal type to have its own configuration file (TERM is
the value of the TERM environment variable (e.g vt102). For the Linux
console the configuration file is .uitrc.console).

   If you have compiled the UIT package with USE_TERMCAP and your
system has a huge termcap database (/etc/termcap), you can copy the
termcap definition(s) of your terminal(s) in a file ($HOME/.termcap
e.g.). After that, set your TERMCAP environment variable to point to
it. You should add something like this to your .profile :

   TERMCAP=/home/mike/.termcap

   uit/uitps/uitview can run without such a file, but on systems with
huge termcap databases, copying the definitions of the most used
terminals in a local .termcap will result in uit/uitps/uitview starting
faster.

   uit/uitps/uitview doesn't use termcap key definitions. You must
define the keys you want directly in the .uit.TERM file in
[UITxxx-Keys] sections.

   If you have compiled the UIT package with USE_TERMINFO, or on your
system the termcap database is emulated using the terminfo library
(like in the HP-UX system), don't bother about speed.

   The configuration file .uitrc.TERM is the file searched by uit /
uitps / uitview each time they are started, in order to configure
themselves.  .uitrc.TERM it is first searched in the home directory
then, if not found, in the directory $(prefix)/lib (usually
/usr/local/lib). The configuration file is structured on sections, each
section containing variables in the following format:

   	variable_name = first_field;second_field; ...

   After the 'variable_name' at least one space or tab is required. All
characters after a '#' are ignored and if you comment a section name,
the whole section is ignored.

   The default configuration file .uitrc.TERM supports most of the usual
commands. To find out more about them please read it. uit allows you to
change both the utility used to perform a particular operation (using
compress instead of gzip :-) ) and the key associated with it. There is
also possible to remove/add new commands.

   The configuration file contains the following sections:

* Menu:

* Section [Setup]::
* Section [UIT-Setup]::
* Section [UITPS-Setup]::
* Section [UITVIEW-Setup]::
* Sections [UITxxx-Color] / [UITxxx-Monochrome]::
* Sections [UITxxx-Keys]::


File: uit.info,  Node: Section [Setup],  Next: Section [UIT-Setup],  Up: Configuration Files

Section [Setup]
===============

   In this section the variables have only one field.

   a. TempDirectory

   - this variable specifies the location of the temporary files
created by uit.

   b. AnsiColorSequences

   - this variable should be set to ON if the terminal supports
standard ANSI color sequences. Otherwise it should be OFF.  If
AnsiColorSequences is ON, [UITxxx-Color] sections will be used in the
configuration files .uitrc.TERM. Otherwise, uit / uitps / uitview will
use the [UITxxx-Monochrome] sections.

   *Note Sections [UITxxx-Color] / [UITxxx-Monochrome]::.


File: uit.info,  Node: Section [UIT-Setup],  Next: Section [UITPS-Setup],  Prev: Section [Setup],  Up: Configuration Files

Section [UIT-Setup]
-------------------

   In this section the variables have only one field.

   a. StartupFileDisplayMode

   - this variable specifies the file specific information displayed at
startup.  It can be any of OwnerGroup, DateTime, Size, Mode or FullName.

   -  this value initially affects both panels but it can be changed
separately afterwards.

   b. StartupFileSortMethod

   - this variable specifies the startup sort method. It can be any of
Name, Extension, Size, Date, Mode, OwnerId, GroupId, OwnerName or
GroupName.

   -  this value initially affects both panels but it can be changed
separately afterwards.

   c. StartupLeftPanelPath

   d. StartupRightPanelPath

   - those variables specifies the startup path for each panel.

   e. HistoryFile - this variable specifies the history file name. The
default value is ~/.uithistory.

   f. NormalModeHelp

   g. CommandLineModeHelp

   - those variables describe the status bar contents for each uit mode
when no errors occurred.    uit can display on the status bar a help
string and/or some system information (system type, hostname, machine
type and the current date) using escape characters:

             \s      ->      the system type
             \h      ->      the host name
             \m      ->      the machine type
             \d      ->      the current date

   *Note <ShowTty>::.

   h. InfoDisplay

   - if this variable is OFF, auxiliary file informations are not
displayed. This can be useful if you are using a very slow terminal.

   i. FrameDisplay

   - if this variable is OFF, the uit frame is not displayed. This can
be useful if you are using a very slow terminal.

   *Note uit::.

   j. LeadingDotMatch

   - if this variable is OFF when matching files for
<FilePatternSelect> / <FilePatternUnselect> then the leading '.' in the
file name is matched only explicitly.


File: uit.info,  Node: Section [UITPS-Setup],  Next: Section [UITVIEW-Setup],  Prev: Section [UIT-Setup],  Up: Configuration Files

Section [UITPS-Setup]
---------------------

   In this section the variables have only one field.

   a. UitPsModeHelp

   - this variable describe the uitps status bar contents.

   *Note uitps::.


File: uit.info,  Node: Section [UITVIEW-Setup],  Next: Sections [UITxxx-Color] / [UITxxx-Monochrome],  Prev: Section [UITPS-Setup],  Up: Configuration Files

Section [UITVIEW-Setup]
-----------------------

   In this section the variables have only one field.

   a. UitViewModeHelp

   - this variable describe the uitview status bar contents.

   *Note uitview::.


File: uit.info,  Node: Sections [UITxxx-Color] / [UITxxx-Monochrome],  Next: Sections [UITxxx-Keys],  Prev: Section [UITVIEW-Setup],  Up: Configuration Files

Sections [UITxxx-Color] / [UITxxx-Monochrome]
---------------------------------------------

   In this sections the variables have only one field.

   These sections permits you to customize the colors of uit, uitps and
uitview.  Reading the .uitrc.TERM configuration file should be self
explanatory.

     *Note Section [Setup]::,
     *Note Configuration Files::.


File: uit.info,  Node: Sections [UITxxx-Keys],  Prev: Sections [UITxxx-Color] / [UITxxx-Monochrome],  Up: Configuration Files

Sections [UITxxx-Keys]
----------------------

   These sections describe the actions uit/uitps/uitview takes when a
specified key is pressed. In this sections a variable can have up to 6
fields separated by ';'. Each line in this section looks like:

   key_sequence = command_name;formatted_command;new_dir;
save_screen;pause;hide

WARNING: you can't continue the variable fields description on the next
line.

* Menu:

* key_sequence::
* command_name::
* formatted_command::
* new_dir::
* save_screen::
* pause::
* hide::


File: uit.info,  Node: key_sequence,  Next: command_name,  Up: Sections [UITxxx-Keys]

key_sequence
------------

   - 'key_sequence' is the key sequence associated with the given
command. You can *se any key sequence wich doesn't start with an ascii
character (0x20 to 0x7e).  You can specify the ESC character as ^[ ,
the ^ character as ^^ and space as ^ . Ascii characters are used by the
command line.


File: uit.info,  Node: command_name,  Next: formatted_command,  Prev: key_sequence,  Up: Sections [UITxxx-Keys]

command_name
------------

   - 'command_name' is a command generic name. Even if it is not always
used, the 'command_name' must be present (if a command is associated
with 'key_sequence') . If it is not, no action will be taken when
pressing 'key_sequence'. There are two types of commands in uit:
built-in commands and user defined commands.  Built-in commands are
specified between <> (<Copy>, <RenameMove>, <MkDir> etc) and if the
'command_name' section contains a built-in command specification, the
other fields are ignored.

   uitps and uitview are using only built-in commands. These are all the
built-in commands used by uit, uitps and uitview:

   The BUILT-IN COMMANDS are:

* Menu:


* <Copy>::				Available in: uit
* <RenameMove>::			Available in: uit
* <MkDir>::				Available in: uit
* <Delete>::				Available in: uit
* <Exit>::				Available in: uit, uitps, uitview
* <HistoryBack>::			Available in: uit
* <ShowTty>::				Available in: uit
* <Refresh>::				Available in: uit, uitps, uitview
* <GotoRoot>::				Available in: uit
* <SwitchPanels>::			Available in: uit
* <HistoryNext>::			Available in: uit
* <FileDisplayNextMode>::		Available in: uit
* <FileDisplayOwnerGroup>::		Available in: uit
* <FileDisplayDateTime>::		Available in: uit
* <FileDisplaySize>::			Available in: uit
* <FileDisplayMode>::			Available in: uit
* <FileDisplayFullName>::		Available in: uit
* <FileSortNextMethod>::		Available in: uit
* <FileSortByName>::			Available in: uit
* <FileSortByExtension>::		Available in: uit
* <FileSortBySize>::			Available in: uit
* <FileSortByDate>::			Available in: uit
* <FileSortByMode>::			Available in: uit
* <FileSortByOwnerId>::			Available in: uit
* <FileSortByGroupId>::			Available in: uit
* <FileSortByOwnerName>::		Available in: uit
* <FileSortByGroupName>::		Available in: uit
* <DeleteCmdLn>::			Available in: uit
* <FileSelect>::			Available in: uit
* <CopyFileToCmdLn>::			Available in: uit
* <Home>::				Available in: uit, uitps, uitview
* <End>::				Available in: uit, uitps, uitview
* <PageUp>::				Available in: uit, uitps, uitview
* <PageDown>::				Available in: uit, uitps, uitview
* <CursorLeft>::			Available in: uit
* <CursorRight>::			Available in: uit
* <CursorUp>::				Available in: uit, uitps, uitview
* <CursorDown>::			Available in: uit, uitps, uitview
* <ChangePanel>::			Available in: uit
* <ChangeDir>::				Available in: uit
* <HardRefresh>::			Available in: uit, uitps, uitview
* <FilePatternSelect>::			Available in: uit
* <FilePatternUnselect>::		Available in: uit
* <DeleteCmdLnWord>::			Available in: uit
* <ConformCurrentDir>::			Available in: uit
* <ConformOtherDir>::			Available in: uit
* <CopyPathToCmdLn>::			Available in: uit
* <CopySelectedFilesToCmdLn>::		Available in: uit
* <NextSignal>::			Available in: uitps
* <SIGHUP>::				Available in: uitps
* <SIGINT>::				Available in: uitps
* <SIGQUIT>::				Available in: uitps
* <SIGILL>::				Available in: uitps
* <SIGFPE>::				Available in: uitps
* <SIGKILL>::				Available in: uitps
* <SIGUSR1>::				Available in: uitps
* <SIGSEGV>::				Available in: uitps
* <SIGUSR2>::				Available in: uitps
* <SIGPIPE>::				Available in: uitps
* <SIGALRM>::				Available in: uitps
* <SIGTERM>::				Available in: uitps
* <SIGCHLD>::				Available in: uitps
* <SIGCONT>::				Available in: uitps
* <KillProcess>::			Available in: uitps

     *Note uit::,
     *Note uitps::,
     *Note uitview::.


File: uit.info,  Node: <Copy>,  Next: <RenameMove>,  Up: command_name

<Copy>
------

   in uit:

   - copies files from one panel to another.


File: uit.info,  Node: <RenameMove>,  Next: <MkDir>,  Prev: <Copy>,  Up: command_name

<RenameMove>
------------

   in uit:

   - moves files from one panel to another.


File: uit.info,  Node: <MkDir>,  Next: <Delete>,  Prev: <RenameMove>,  Up: command_name

<MkDir>
-------

   in uit:

   - makes directories.


File: uit.info,  Node: <Delete>,  Next: <Exit>,  Prev: <MkDir>,  Up: command_name

<Delete>
--------

   in uit:

   - deletes files and empty directories.


File: uit.info,  Node: <Exit>,  Next: <HistoryBack>,  Prev: <Delete>,  Up: command_name

<Exit>
------

   - exits.


File: uit.info,  Node: <HistoryBack>,  Next: <ShowTty>,  Prev: <Exit>,  Up: command_name

<HistoryBack>
-------------

   in uit:

   - copies to the command line the previous command in the history
list.


File: uit.info,  Node: <ShowTty>,  Next: <Refresh>,  Prev: <HistoryBack>,  Up: command_name

<ShowTty>
---------

   in uit:

   - switches between the two uit modes (starting with Linux 0.99.12
this option is completely used only if you are super user because
normal users can't do a screen dump).


File: uit.info,  Node: <Refresh>,  Next: <GotoRoot>,  Prev: <ShowTty>,  Up: command_name

<Refresh>
---------

   in uit:

   - refreshes the contents of the current panel.

   in uitps:

   - refresh the processes list by recalling ps(1).

   in uitview:

   - refresh the screen by re-reading the file.


File: uit.info,  Node: <GotoRoot>,  Next: <SwitchPanels>,  Prev: <Refresh>,  Up: command_name

<GotoRoot>
----------

   in uit:

   - changes the current directory to root.


File: uit.info,  Node: <SwitchPanels>,  Next: <HistoryNext>,  Prev: <GotoRoot>,  Up: command_name

<SwitchPanels>
--------------

   in uit:

   - switches the left panel with the right one.


File: uit.info,  Node: <HistoryNext>,  Next: <FileDisplayNextMode>,  Prev: <SwitchPanels>,  Up: command_name

<HistoryNext>
-------------

   in uit:

   - copies the next command in the history list to the command line.


File: uit.info,  Node: <FileDisplayNextMode>,  Next: <FileDisplayOwnerGroup>,  Prev: <HistoryNext>,  Up: command_name

<FileDisplayNextMode>
---------------------

   in uit:

   - switches to the next file display mode.


File: uit.info,  Node: <FileDisplayOwnerGroup>,  Next: <FileDisplayDateTime>,  Prev: <FileDisplayNextMode>,  Up: command_name

<FileDisplayOwnerGroup>
-----------------------

   in uit:

   - displays the file owner & group.


File: uit.info,  Node: <FileDisplayDateTime>,  Next: <FileDisplaySize>,  Prev: <FileDisplayOwnerGroup>,  Up: command_name

<FileDisplayDateTime>
---------------------

   in uit:

   - displays the file date & time.


File: uit.info,  Node: <FileDisplaySize>,  Next: <FileDisplayMode>,  Prev: <FileDisplayDateTime>,  Up: command_name

<FileDisplaySize>
-----------------

   in uit:

   - displays the file size.


File: uit.info,  Node: <FileDisplayMode>,  Next: <FileDisplayFullName>,  Prev: <FileDisplaySize>,  Up: command_name

<FileDisplayMode>
-----------------

   in uit:

   - displays the file mode.


File: uit.info,  Node: <FileDisplayFullName>,  Next: <FileSortNextMethod>,  Prev: <FileDisplayMode>,  Up: command_name

<FileDisplayFullName>
---------------------

   in uit:

   - displays the full file name (if possible).


File: uit.info,  Node: <FileSortNextMethod>,  Next: <FileSortByName>,  Prev: <FileDisplayFullName>,  Up: command_name

<FileSortNextMethod>
--------------------

   in uit:

   - switches to the next sort method.


File: uit.info,  Node: <FileSortByName>,  Next: <FileSortByExtension>,  Prev: <FileSortNextMethod>,  Up: command_name

<FileSortByName>
----------------

   in uit:

   - sorts the files by name.


File: uit.info,  Node: <FileSortByExtension>,  Next: <FileSortBySize>,  Prev: <FileSortByName>,  Up: command_name

<FileSortByExtension>
---------------------

   in uit:

   - sorts the files by extension.


File: uit.info,  Node: <FileSortBySize>,  Next: <FileSortByDate>,  Prev: <FileSortByExtension>,  Up: command_name

<FileSortBySize>
----------------

   in uit:

   - sorts the files by size.


File: uit.info,  Node: <FileSortByDate>,  Next: <FileSortByMode>,  Prev: <FileSortBySize>,  Up: command_name

<FileSortByDate>
----------------

   in uit:

   - sorts the files by date.


File: uit.info,  Node: <FileSortByMode>,  Next: <FileSortByOwnerId>,  Prev: <FileSortByDate>,  Up: command_name

<FileSortByMode>
----------------

   in uit:

   - sorts the files by file mode.


File: uit.info,  Node: <FileSortByOwnerId>,  Next: <FileSortByGroupId>,  Prev: <FileSortByMode>,  Up: command_name

<FileSortByOwnerId>
-------------------

   in uit:

   - sorts the files by owner id.


File: uit.info,  Node: <FileSortByGroupId>,  Next: <FileSortByOwnerName>,  Prev: <FileSortByOwnerId>,  Up: command_name

<FileSortByGroupId>
-------------------

   in uit:

   - sorts the files by group id.


File: uit.info,  Node: <FileSortByOwnerName>,  Next: <FileSortByGroupName>,  Prev: <FileSortByGroupId>,  Up: command_name

<FileSortByOwnerName>
---------------------

   in uit:

   - sorts the files by owner name.


File: uit.info,  Node: <FileSortByGroupName>,  Next: <DeleteCmdLn>,  Prev: <FileSortByOwnerName>,  Up: command_name

<FileSortByGroupName>
---------------------

   in uit:

   - sorts the files by group name.


File: uit.info,  Node: <DeleteCmdLn>,  Next: <FileSelect>,  Prev: <FileSortByGroupName>,  Up: command_name

<DeleteCmdLn>
-------------

   in uit:

   - deletes the command line contents.


File: uit.info,  Node: <FileSelect>,  Next: <CopyFileToCmdLn>,  Prev: <DeleteCmdLn>,  Up: command_name

<FileSelect>
------------

   in uit:

   - selects/unselects files. All the files can be selected by pressing
'+' (and ENTER) or unselected by pressing '-'. By pressing '*' selected
files becomes unselected and unselected files becomes selected.


File: uit.info,  Node: <CopyFileToCmdLn>,  Next: <Home>,  Prev: <FileSelect>,  Up: command_name

<CopyFileToCmdLn>
-----------------

   in uit:

   - copies to the command line the current file name.


File: uit.info,  Node: <Home>,  Next: <End>,  Prev: <CopyFileToCmdLn>,  Up: command_name

<Home>
------

   in uit:

   - puts the cursor onto the first entry in the current directory list.

   in uitps:

   - moves to the first process in the processes list.

   in uitview:

   - moves to the beginning of the file.


File: uit.info,  Node: <End>,  Next: <PageUp>,  Prev: <Home>,  Up: command_name

<End>
-----

   in uit:

   - puts the cursor onto the last entry in the current directory list.

   in uitps:

   - moves to the last process in the processes list.

   in uitview:

   - moves to the end of the file.


File: uit.info,  Node: <PageUp>,  Next: <PageDown>,  Prev: <End>,  Up: command_name

<PageUp>
--------

   in uit:

   - puts the cursor up one page in the current directory file list.

   in uitps:

   - moves one page up in the processes list.

   in uitview:

   - moves one page up (0x100 bytes) in the file.


File: uit.info,  Node: <PageDown>,  Next: <CursorLeft>,  Prev: <PageUp>,  Up: command_name

<PageDown>
----------

   in uit:

   - puts the cursor down one page in the current directory file list.

   in uitps:

   - moves one page down in the processes list.

   in uitview:

   - moves one page down (0x100 bytes) in the file.


File: uit.info,  Node: <CursorLeft>,  Next: <CursorRight>,  Prev: <PageDown>,  Up: command_name

<CursorLeft>
------------

   in uit:

   - acts like <PageUp>.


File: uit.info,  Node: <CursorRight>,  Next: <CursorUp>,  Prev: <CursorLeft>,  Up: command_name

<CursorRight>
-------------

   in uit:

   - acts like <PageDown>.


File: uit.info,  Node: <CursorUp>,  Next: <CursorDown>,  Prev: <CursorRight>,  Up: command_name

<CursorUp>
----------

   in uit:

   - puts the cursor up one entry in the current directory file list.

   in uitps:

   - moves to the previous process in the processes list.

   in uitview:

   - moves to the previous line (16 bytes) in the file.


File: uit.info,  Node: <CursorDown>,  Next: <ChangePanel>,  Prev: <CursorUp>,  Up: command_name

<CursorDown>
------------

   in uit:

   - puts the cursor down one entry in the current directory file list.

   in uitps:

   - moves to the next process in the processes list.

   in uitview:

   - moves to the next line (16 bytes) in the file.


File: uit.info,  Node: <ChangePanel>,  Next: <ChangeDir>,  Prev: <CursorDown>,  Up: command_name

<ChangePanel>
-------------

   in uit:

   - puts the cursor in the other panel.


File: uit.info,  Node: <ChangeDir>,  Next: <HardRefresh>,  Prev: <ChangePanel>,  Up: command_name

<ChangeDir>
-----------

   in uit:

   - changes the current directory to a user specified directory.


File: uit.info,  Node: <HardRefresh>,  Next: <FilePatternSelect>,  Prev: <ChangeDir>,  Up: command_name

<HardRefresh>
-------------

     in uit:
     in uitps:
     in uitview:

   - forces a screen refresh.


File: uit.info,  Node: <FilePatternSelect>,  Next: <FilePatternUnselect>,  Prev: <HardRefresh>,  Up: command_name

<FilePatternSelect>
-------------------

   in uit:

   - selects files matching a given pattern.


File: uit.info,  Node: <FilePatternUnselect>,  Next: <DeleteCmdLnWord>,  Prev: <FilePatternSelect>,  Up: command_name

<FilePatternUnselect>
---------------------

   in uit:

   - unselects files matching a given pattern.


File: uit.info,  Node: <DeleteCmdLnWord>,  Next: <ConformCurrentDir>,  Prev: <FilePatternUnselect>,  Up: command_name

<DeleteCmdLnWord>
-----------------

   in uit:

   - deletes the last command line word.


File: uit.info,  Node: <ConformCurrentDir>,  Next: <ConformOtherDir>,  Prev: <DeleteCmdLnWord>,  Up: command_name

<ConformCurrentDir>
-------------------

   in uit:

   - the other panel current directory will become the current
directory of the current panel.


File: uit.info,  Node: <ConformOtherDir>,  Next: <CopyPathToCmdLn>,  Prev: <ConformCurrentDir>,  Up: command_name

<ConformOtherDir>
-----------------

   in uit:

   - the current directory of the current panel will become the current
directory of the other panel.


File: uit.info,  Node: <CopyPathToCmdLn>,  Next: <CopySelectedFilesToCmdLn>,  Prev: <ConformOtherDir>,  Up: command_name

<CopyPathToCmdLn>
-----------------

   in uit:

   - copy the other panel path to the command line.


File: uit.info,  Node: <CopySelectedFilesToCmdLn>,  Next: <NextSignal>,  Prev: <CopyPathToCmdLn>,  Up: command_name

<CopySelectedFilesToCmdLn>
--------------------------

   in uit:

   - copy all the currrent panel selected file names to the command
line.


File: uit.info,  Node: <NextSignal>,  Next: <SIGHUP>,  Prev: <CopySelectedFilesToCmdLn>,  Up: command_name

<NextSignal>
------------

   in uitps:

   - sets the next signal in the signals list as the current signal.


File: uit.info,  Node: <SIGHUP>,  Next: <SIGINT>,  Prev: <NextSignal>,  Up: command_name

<SIGHUP>
--------

   in uitps:

   - sets the SIGHUP signal as the current signal.


File: uit.info,  Node: <SIGINT>,  Next: <SIGQUIT>,  Prev: <SIGHUP>,  Up: command_name

<SIGINT>
--------

   in uitps:

   - sets the SIGINT signal as the current signal.


File: uit.info,  Node: <SIGQUIT>,  Next: <SIGILL>,  Prev: <SIGINT>,  Up: command_name

<SIGQUIT>
---------

   in uitps:

   - sets the SIGQUIT signal as the current signal.


File: uit.info,  Node: <SIGILL>,  Next: <SIGFPE>,  Prev: <SIGQUIT>,  Up: command_name

<SIGILL>
--------

   in uitps:

   - sets the SIGILL signal as the current signal.


File: uit.info,  Node: <SIGFPE>,  Next: <SIGKILL>,  Prev: <SIGILL>,  Up: command_name

<SIGFPE>
--------

   in uitps:

   - sets the SIGFPE signal as the current signal.


File: uit.info,  Node: <SIGKILL>,  Next: <SIGUSR1>,  Prev: <SIGFPE>,  Up: command_name

<SIGKILL>
---------

   in uitps:

   - sets the SIGKILL signal as the current signal.


File: uit.info,  Node: <SIGUSR1>,  Next: <SIGSEGV>,  Prev: <SIGKILL>,  Up: command_name

<SIGUSR1>
---------

   in uitps:

   - sets the SIGUSR1 signal as the current signal.


File: uit.info,  Node: <SIGSEGV>,  Next: <SIGUSR2>,  Prev: <SIGUSR1>,  Up: command_name

<SIGSEGV>
---------

   in uitps:

   - sets the SIGSEGV signal as the current signal.


File: uit.info,  Node: <SIGUSR2>,  Next: <SIGPIPE>,  Prev: <SIGSEGV>,  Up: command_name

<SIGUSR2>
---------

   in uitps:

   - sets the SIGUSR2 signal as the current signal.


File: uit.info,  Node: <SIGPIPE>,  Next: <SIGALRM>,  Prev: <SIGUSR2>,  Up: command_name

<SIGPIPE>
---------

   in uitps:

   - sets the SIGPIPE signal as the current signal.


File: uit.info,  Node: <SIGALRM>,  Next: <SIGTERM>,  Prev: <SIGPIPE>,  Up: command_name

<SIGALRM>
---------

   in uitps:

   - sets the SIGALRM signal as the current signal.


File: uit.info,  Node: <SIGTERM>,  Next: <SIGCHLD>,  Prev: <SIGALRM>,  Up: command_name

<SIGTERM>
---------

   in uitps:

   - sets the SIGTERM signal as the current signal.


File: uit.info,  Node: <SIGCHLD>,  Next: <SIGCONT>,  Prev: <SIGTERM>,  Up: command_name

<SIGCHLD>
---------

   in uitps:

   - sets the SIGCHLD signal as the current signal.


File: uit.info,  Node: <SIGCONT>,  Next: <KillProcess>,  Prev: <SIGCHLD>,  Up: command_name

<SIGCONT>
---------

   in uitps:

   - sets the SIGCONT signal as the current signal.


File: uit.info,  Node: <KillProcess>,  Prev: <SIGCONT>,  Up: command_name

<KillProcess>
-------------

   in uitps:

   - sends the current signal to the current process.


File: uit.info,  Node: formatted_command,  Next: new_dir,  Prev: command_name,  Up: Sections [UITxxx-Keys]

formatted_command
-----------------

   - 'formatted_command' is a shell command which can contain some
scanf like format specifiers. With their help you can get the current
directory entry name (the directory entry under the cursor), owner,
group and mode.

   Note that using uppercase format specifiers you will be able to
access the other panel path, file and directory names.

   These are the available format specifiers:

* Menu:

* %s::
* %f::
* %d::
* %l::
* %t::
* %z::
* %a::
* %m::
* %g::
* %o::
* %p::
* %b::
* %i::


File: uit.info,  Node: %s,  Next: %f,  Up: formatted_command

%s
--

   The format of the %s parameter is:  %s{question,default_answer}

   When uit encounters a %s in the 'formatted_command' asks the user
the question 'question' whose default answer is 'default_answer' and
replaces the %s{ , } with the user answer. Both 'question' and
'default_answer' can contain any other format specifiers except %s.

   WARNING: no spaces between %s and '{'.


File: uit.info,  Node: %f,  Next: %d,  Prev: %s,  Up: formatted_command

%f
--

   uit will replace %f with the current directory entry name only if it
is a file (not a directory).


File: uit.info,  Node: %d,  Next: %l,  Prev: %f,  Up: formatted_command

%d
--

   uit will replace %d with the current directory entry name only if it
is a directory (not a file).


File: uit.info,  Node: %l,  Next: %t,  Prev: %d,  Up: formatted_command

%l
--

   uit will replace %l with the current directory entry name only if it
is a symbolic link.


File: uit.info,  Node: %t,  Next: %z,  Prev: %l,  Up: formatted_command

%t
--

   uit will replace %t with the current directory entry name only if it
is a named pipe.


File: uit.info,  Node: %z,  Next: %a,  Prev: %t,  Up: formatted_command

%z
--

   uit will replace %z with the current directory entry name only if it
is a socket.


File: uit.info,  Node: %a,  Next: %m,  Prev: %z,  Up: formatted_command

%a
--

   uit will always replace %a with the current directory entry name.


File: uit.info,  Node: %m,  Next: %g,  Prev: %a,  Up: formatted_command

%m
--

   uit will always replace %m in the 'formatted_command' with the
current file mode.


File: uit.info,  Node: %g,  Next: %o,  Prev: %m,  Up: formatted_command

%g
--

   uit will always replace %g in the 'formatted_command' with the
current file group.


File: uit.info,  Node: %o,  Next: %p,  Prev: %g,  Up: formatted_command

%o
--

   uit will always replace %o in the 'formatted_command' with the
current file owner.


File: uit.info,  Node: %p,  Next: %b,  Prev: %o,  Up: formatted_command

%p
--

   uit will always replace %p in the formatted_command with the current
panel path.


File: uit.info,  Node: %b,  Next: %i,  Prev: %p,  Up: formatted_command

%b
--

   uit will always replace %b in the 'formatted_command' with the
current panel directory name.


File: uit.info,  Node: %i,  Prev: %b,  Up: formatted_command

%i
--

   uit will always replace %i in the 'formatted_command' with all the
current panel selected file names.


File: uit.info,  Node: new_dir,  Next: save_screen,  Prev: formatted_command,  Up: Sections [UITxxx-Keys]

new_dir
-------

   - if the 'formatted_command' successfully exits (exit code = 0) and
this field is present then 'new_dir' will become the current panel
directory.  The character ~ used at the begining of the new_dir field
is replaced by the user's home directory.


File: uit.info,  Node: save_screen,  Next: pause,  Prev: new_dir,  Up: Sections [UITxxx-Keys]

save_screen
-----------

   - this field is a character (usually 'y' or 'n') who tells uit to
save ('y') or not to save ('n') the terminal screen after executing the
'formatted_command'.  Saving the screen is not necessary while editing
or viewing a file because the information left after the editor or the
viewer exits is not important. Saving the screen means that that screen
will be restored before the execution of the next command. This field
is used only if you are super user under Linux and you are working on a
virtual console. By default this field is 'y'.


File: uit.info,  Node: pause,  Next: hide,  Prev: save_screen,  Up: Sections [UITxxx-Keys]

pause
-----

   - for some commands you may wish to read their results before
repainting the panels. If this field is present uit will wait for a key
to be pressed before restoring the panels. By default this field is 'n'.


File: uit.info,  Node: hide,  Prev: pause,  Up: Sections [UITxxx-Keys]

hide
----

   - there are some commands that aren't displaying any useful
information if successfully complete their execution: mount, chmod,
chown, chgrp, sync ...  and if an error occurs then a line or two are
sended to stderr. If this option is 'y', the stdout and stderr will be
redirected to some files (stdout.pid and stderr.pid, where pid is uit
pid) and only if the command exit code is not 0, the stderr.pid file
will be displayed, line by line, onto the status bar. This way the
panels will not be deleted and then repainted and the command appears
to be built-in. stdout.pid and stderr.pid are created in the
TempDirectory specified in the [Setup] section. By default this field
is 'n'.


File: uit.info,  Node: uit,  Next: uitps,  Prev: Configuration Files,  Up: Top

uit
===

   uit is a file system browser with some shell facilities which was
designed to make your work much easier and much efficient. uit is made
of two panels.  The left one and the right one. Each one contains a
file system directory.  You can browse the directory tree with the
usual cursor keys and pressing ENTER when you want to enter or leave a
directory. You may change the panels by pressing TAB.

   Under the two panels there is a shell like command line which you
can use to type normal shell commands. The command line supports up to
256 characters and 512 commands in the history list. UIT uses the GNU
history library for that.

   Under the command line there is a status bar. You can see there the
status of the currently executed command, the warnings and errors and
you will be prompted if a decision has to be taken.

     *Note Configuration Files::,
     *Note uitps::,
     *Note uitview::,
     *Note uitcmp::,
     *Note uitkeys::,
     *Note uitmount::,
     *Note uitmatch::,
     *Note uitaction::,
     *Note .uitaction::.


File: uit.info,  Node: uitps,  Next: uitview,  Prev: uit,  Up: Top

uitps
=====

   uitps is an interactive process viewer/killer. It calls internally
the ps(1) utility so that's the reason why uitps parameters are in fact
ps(1) ones.  Running uitps it is self explanatory. Use the arrows,
PageUp, PageDown, Home, End, ^Y, ^B, ^Ku, ^Kv to move in the list, ^R
to refresh it and F10 or ^C to leave. You can change these keys, just
read the sections [UITPS-Setup], [UITPS-Color], [UITPS-Monochrome] and
[UITPS-Keys] in the configuration file .uitrc.TERM.

     *Note Configuration Files::,
     *Note uit::,
     *Note uitview::,
     *Note uitcmp::,
     *Note uitkeys::,
     *Note uitmount::,
     *Note uitmatch::,
     *Note uitaction::,
     *Note .uitaction::.


File: uit.info,  Node: uitview,  Next: uitmount,  Prev: uitps,  Up: Top

uitview
=======

   uitview is an hex/ascii file viewer. Too simple to need a separate
manual page.  Use the arrows, PageUp, PageDown, Home, End, ^Y, ^B, ^Ku,
^Kv to move in the file, ^R to refresh the screen and F10 or ^C to
leave. You can change those keys, just read the sections
[UITVIEW-Setup], [UITVIEW-Color], [UITVIEW-Monochrome] and
[UITVIEW-Keys] in the configuration file .uitrc.TERM.

     *Note Configuration Files::,
     *Note uit::,
     *Note uitps::,
     *Note uitcmp::,
     *Note uitkeys::,
     *Note uitmount::,
     *Note uitmatch::,
     *Note uitaction::,
     *Note .uitaction::.


File: uit.info,  Node: uitmount,  Next: uitcmp,  Prev: uitview,  Up: Top

uitmount
========

   uitmount is a script which allows you to mount any block device
without specifying the file system type. You may now insert the floppy
in the drive and type  'uitmount fd0'  and the first floppy will be
mounted in the directory /mnt/fd0. On Linux just press F11 or F12.  You
don't need to know the file system type anymore. The directories
/mnt/fd0 and /mnt/fd1 must exist. If you want to use uitmount with the
block device /dev/xxx then the directory /mnt/xxx must exist too.

     *Note Configuration Files::,
     *Note uit::,
     *Note uitps::,
     *Note uitview::,
     *Note uitcmp::,
     *Note uitkeys::,
     *Note uitmatch::,
     *Note uitaction::,
     *Note .uitaction::.


File: uit.info,  Node: uitcmp,  Next: uitkeys,  Prev: uitmount,  Up: Top

uitcmp
======

   uitcmp is a file compare utility. It outputs to stderr, uit catching
its error messages this way. uitcmp was designed to be used in
$HOME/.uitrc.TERM (uit configuration file) and should not be used as a
stand alone program *Note hide::.

     *Note Configuration Files::,
     *Note uit::,
     *Note uitps::,
     *Note uitview::,
     *Note uitmount::,
     *Note uitkeys::,
     *Note uitmatch::,
     *Note uitaction::,
     *Note .uitaction::.


File: uit.info,  Node: uitkeys,  Next: uitmatch,  Prev: uitcmp,  Up: Top

uitkeys
=======

   uitkeys is a program that displays the key sequence sent by the
pressed key. This is the key sequence received by UIT tools, so this
program is useful when setting up the .uitrc.TERM configuration files.

     *Note Configuration Files::,
     *Note uit::,
     *Note uitps::,
     *Note uitview::,
     *Note uitcmp::,
     *Note uitmatch::,
     *Note uitmount::,
     *Note uitaction::,
     *Note .uitaction::.


File: uit.info,  Node: uitmatch,  Next: uitaction,  Prev: uitkeys,  Up: Top

uitmatch
========

   uitmatch is a program that tries to match its first parameter (the
file name) against some patterns, returning the number of the pattern
that matches.  uitmatch is called by the uitaction/.uitaction scripts
and was not designed to be used as a stand alone program.

     *Note Configuration Files::,
     *Note uit::,
     *Note uitps::,
     *Note uitview::,
     *Note uitcmp::,
     *Note uitkeys::,
     *Note uitmount::,
     *Note uitaction::,
     *Note .uitaction::.


File: uit.info,  Node: uitaction,  Next: .uitaction,  Prev: uitmatch,  Up: Top

uitaction
=========

   uitaction is a script that executes a different action for each file
type specified. It is called by the uit program when pressing F2 or ^Kz.
*Note Configuration Files::.

   The first parameter is the current directory name and the second one
is the file name to be matched against the default patterns. The
matching is done using the uitmatch utility. *Note uitmatch::

   If you press F2 or ^Kz on a *.c file, uit will compile it, if you
press F2 or ^Kz on a *.tar.gz file, uit will list the tar archive
contents, if you press the same keys on a *.gz file, uit will display
its uncompressed contents on the screen,  etc  ...

   By default uitaction checks for the following patterns:

   "*.cc"  "*.c"  "*.l"  "*.y"  "*.h" "*.s" "*.S" "*.o" "*.a"
"*.sa" "Makefile" "makefile" "*.tar.gz" "*.tgz"  "*.tar.z"
"*.tar.Z"  "*.taz"  "*.tar"  "*.gz"  "*.z"  "*.Z"  "*.doc"
"*.txt" "*.gif" "*.jpg" "*.tif" "*.bmp"

   and acts as appropriate. If no pattern is found, the file is
displayed using more. Feel free to change this.

   If you want to find out what the default action for each file type
is (or if you want to modify it), just read/modify the uitaction script.

   If you press F2 or ^Kz on a *.gif file or *.jpg file and you have
the zgv utility installed, you will be able to see it. If you want to
change the gif/jpeg viewer, all you need to do is to change its name in
the uitaction script. I don't know a *.bmp or *.tif viewer. Feel free
to add one in the uitaction script.

   The script can be easy enhanced. Just read it.

     *Note Configuration Files::,
     *Note uit::,
     *Note uitps::,
     *Note uitview::,
     *Note uitcmp::,
     *Note uitkeys::,
     *Note uitmount::,
     *Note uitmatch::,
     *Note .uitaction::.


File: uit.info,  Node: .uitaction,  Next: Starting uit/uitps/uitview/uitmount,  Prev: uitaction,  Up: Top

.uitaction
==========

   The .uitaction script is a local version of the uitaction script.
When started, uitaction tries to search a script called  .uitaction in
the current directory and, if it finds it, it starts it. If
.uitaction's exit code is 0 (.uitaction couldn't find a matching
pattern), uitaction starts its own case statement trying to match the
current file name (the second parameter) against its default patterns.

   The .uitaction script *must* be executable. An example of .uitaction
can be fount in /usr/local/lib. You should copy the example in the
current directory and then modify it.

     *Note Configuration Files::,
     *Note uit::,
     *Note uitps::,
     *Note uitview::,
     *Note uitcmp::,
     *Note uitkeys::,
     *Note uitmount::,
     *Note uitmatch::,
     *Note uitaction::.


File: uit.info,  Node: Starting uit/uitps/uitview/uitmount,  Next: Canceling Operations,  Prev: .uitaction,  Up: Top

Starting uit/uitps/uitview/uitmount
===================================

   These are the command line parameters supported by the programs in
the UIT package:

            uit
            uitps    [ps(1) like parameters]
            uitview  filename
            uitmount device


File: uit.info,  Node: Canceling Operations,  Next: Limitations,  Prev: Starting uit/uitps/uitview/uitmount,  Up: Top

Canceling Operations
====================

   Built-in cyclic operations can be stopped by pressing ^C. uit can be
suspended by pressing ^Z.

   *Note command_name::.


File: uit.info,  Node: Limitations,  Next: Bugs,  Prev: Canceling Operations,  Up: Top

Limitations
===========

   1. Background execution is not fully supported. That means you may
specify an & terminated command line in the configuration file but the
result of the background executed command (stdout and stderr
redirection, *Note hide::) will be overwritten by the result of newer
commands and, if an error occurs, you will not see it.

   2. No command line editing is provided. You can only modify the
contents of the command line by appending new characters, deleting them
with backspace or ^H, or deleting the last word with the key sequence
associated with <DeleteCmdLnWord> (*Note <DeleteCmdLnWord>::). You can
also insert the current file name into the command line using the key
sequence associated with <CopyFileToCmdLn> (*Note <CopyFileToCmdLn>::)
and the other panel path using the key sequence associated with
<CopyPathToCmdLn> (*Note <CopyPathToCmdLn>::).

   3. When uit is compiled for Linux, the default built-in color
descriptions are for color monitors, so you can't (decently) run uit on
a b/w monitor without the .uitrc.TERM file corectly configured.
.uitrc.TERM should be configured with AnsiColorSequences = OFF.

   4. Only POSIX terminals are supported.

   5. Job support is implemented only in uit.

   6. Due to the fact that the ';' character is used as a field
separator in the configuration files, you can't write something like
that in the .uitrc.TERM files: ^AAA = SHOW-USERS-AND-GROUPS; more
/etc/passwd; more /etc/group because 'more /etc/group' will be
considered as a directory to switch to.  You must write a small script
instead:

   #!/bin/sh

   more /etc/passwd more /etc/group

   Supposing the script name is 'show_ug', the .uitrc.TERM line will be
like that:

   ^AAA = SHOW-USERS-AND-GROUPS; show_ug


File: uit.info,  Node: Bugs,  Next: Copyright,  Prev: Limitations,  Up: Top

Bugs
====

   None so far. :-)

   Please send bug reports to

     	tudor@ulise.cs.pub.ro 		or to
     	tudor@habarnam.cs.pub.ro.


File: uit.info,  Node: Copyright,  Next: Authors,  Prev: Bugs,  Up: Top

Copyright
=========

UIT is free software; you can redistribute it and/or modify it under the
terms of the GNU General Public License as published by the Free
Software Foundation; either version 2, or (at your option) any later
version.

UIT is distributed in the hope that it will be useful, but WITHOUT ANY
WARRANTY; without even the implied warranty of MERCHANTABILITY or
FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
for more details .

You should have received a copy of the GNU General Public License along
with UIT; see the file COPYING. If not, write to the Free Software
Foundation, 675 Mass Ave, Cambridge, MA 02139, USA.


File: uit.info,  Node: Authors,  Prev: Copyright,  Up: Top

Authors
=======

   Tudor Hulubei, Politechnic University of Bucharest, Romania

                                       tudor@ulise.cs.pub.ro
                                       tudor@habarnam.cs.pub.ro

   Andrei Pitis,  Politechnic University of Bucharest, Romania

                                       pink@ulise.cs.pub.ro
                                       pink@habarnam.cs.pub.ro



Tag Table:
Node: Top85
Node: Introduction574
Node: Installing UIT1033
Node: Configuration Files1230
Node: Section [Setup]3929
Node: Section [UIT-Setup]4608
Node: Section [UITPS-Setup]6613
Node: Section [UITVIEW-Setup]6947
Node: Sections [UITxxx-Color] / [UITxxx-Monochrome]7317
Node: Sections [UITxxx-Keys]7846
Node: key_sequence8501
Node: command_name8910
Node: <Copy>12427
Node: <RenameMove>12573
Node: <MkDir>12746
Node: <Delete>12891
Node: <Exit>13050
Node: <HistoryBack>13169
Node: <ShowTty>13377
Node: <Refresh>13679
Node: <GotoRoot>13987
Node: <SwitchPanels>14164
Node: <HistoryNext>14358
Node: <FileDisplayNextMode>14582
Node: <FileDisplayOwnerGroup>14806
Node: <FileDisplayDateTime>15035
Node: <FileDisplaySize>15254
Node: <FileDisplayMode>15452
Node: <FileDisplayFullName>15650
Node: <FileSortNextMethod>15878
Node: <FileSortByName>16094
Node: <FileSortByExtension>16293
Node: <FileSortBySize>16503
Node: <FileSortByDate>16698
Node: <FileSortByMode>16888
Node: <FileSortByOwnerId>17086
Node: <FileSortByGroupId>17292
Node: <FileSortByOwnerName>17503
Node: <FileSortByGroupName>17722
Node: <DeleteCmdLn>17935
Node: <FileSelect>18127
Node: <CopyFileToCmdLn>18481
Node: <Home>18685
Node: <End>19006
Node: <PageUp>19308
Node: <PageDown>19624
Node: <CursorLeft>19957
Node: <CursorRight>20121
Node: <CursorUp>20289
Node: <CursorDown>20640
Node: <ChangePanel>20989
Node: <ChangeDir>21172
Node: <HardRefresh>21377
Node: <FilePatternSelect>21590
Node: <FilePatternUnselect>21806
Node: <DeleteCmdLnWord>22032
Node: <ConformCurrentDir>22244
Node: <ConformOtherDir>22510
Node: <CopyPathToCmdLn>22779
Node: <CopySelectedFilesToCmdLn>23005
Node: <NextSignal>23266
Node: <SIGHUP>23487
Node: <SIGINT>23664
Node: <SIGQUIT>23838
Node: <SIGILL>24015
Node: <SIGFPE>24189
Node: <SIGKILL>24363
Node: <SIGUSR1>24541
Node: <SIGSEGV>24720
Node: <SIGUSR2>24899
Node: <SIGPIPE>25078
Node: <SIGALRM>25257
Node: <SIGTERM>25436
Node: <SIGCHLD>25615
Node: <SIGCONT>25794
Node: <KillProcess>25977
Node: formatted_command26152
Node: %s26792
Node: %f27244
Node: %d27428
Node: %l27612
Node: %t27787
Node: %z27959
Node: %a28127
Node: %m28279
Node: %g28447
Node: %o28616
Node: %p28785
Node: %b28952
Node: %i29131
Node: new_dir29308
Node: save_screen29685
Node: pause30352
Node: hide30670
Node: uit31443
Node: uitps32581
Node: uitview33350
Node: uitmount34033
Node: uitcmp34819
Node: uitkeys35363
Node: uitmatch35875
Node: uitaction36452
Node: .uitaction38303
Node: Starting uit/uitps/uitview/uitmount39228
Node: Canceling Operations39629
Node: Limitations39918
Node: Bugs41770
Node: Copyright41981
Node: Authors42712

End Tag Table
