Source Code 1994 March/Source_Code_CD-ROM_Walnut_Creek_March_1994.iso/compsrcs/misc/volume40/cwish/part01

Text File | 1993-11-01 | 59.6 KB | 1,788 lines

Newsgroups: comp.sources.misc
From: [e-mail] (Hellmuth Michaelis)
Subject: v40i068:  cwish - Window Shell / Filemanager v2.00, Part01/05
Message-ID: <csm-v40i068=[e-mail]>
X-Md4-Signature: 45ee672a298ad436387d881cfc776824
Sender: [e-mail] (Kent Landfield)
Reply-To: [e-mail]
Organization: HCS Hanseatischer Computerservice GmbH
Date: Mon, 1 Nov 1993 22:05:37 GMT
Approved: [e-mail]

Submitted-by: [e-mail] (Hellmuth Michaelis)
Posting-number: Volume 40, Issue 68
Archive-name: cwish/part01
Environment: UNIX, ANSI-C, SYSV-CURSES
Supersedes: cwish: Volume 39, Issue 97-100

Cwish is an easy to use tool for travelling through the filesystem,
either for doing administrative work or as a shell replacement.
I also use it frequently to browse through CDROM's, a special mode
is avaliable to handle untranslated ISO 9660 filenames.

It depends on an ANSI C-compiler and a System V curses library,
if there is no System V curses library available on your system
(i.e. 386BSD), I recommend getting "ncurses", which is available
from netcom.com:pub/zmbenhal, the author is Zeyd M. Ben-Halim
([e-mail]) - I use it for running cwish on 386BSD.

Wish has been tested with Hewlett-Packard Terminals such as the
2392 and 70092, with DEC Terminals VT100 and VT220, with the 386BSD
console drivers pccons and pcvt and with the Linux console driver.

This release is a much cleaned-up version which fixes portability
issues, has support for more platforms, adds some enhancements and
renames everything from wish to cwish.

If you need help with cwish, just ask!

Thank you,
hellmuth

Hellmuth Michaelis    HCS Hanseatischer Computerservice GmbH    Hamburg, Europe
------
#! /bin/sh
# This is a shell archive.  Remove anything before this line, then feed it
# into a shell via "sh file" or similar.  To overwrite existing files,
# type "sh file -c".
# Contents:  README commandline.c cwish.1 showtime.c
# Wrapped by kent@sparky on Fri Oct 29 14:39:09 1993
PATH=/bin:/usr/bin:/usr/ucb:/usr/local/bin:/usr/lbin:$PATH ; export PATH
echo If this archive is complete, you will see the following message:
echo '          "shar: End of archive 1 (of 5)."'
if test -f 'README' -a "${1}" != "-c" ; then
  echo shar: Will not clobber existing file \"'README'\"
else
  echo shar: Extracting \"'README'\" \(8089 characters\)
  sed "s/^X//" >'README' <<'END_OF_FILE'
X================================================================================
X#                                                                              #
X#        cwish - user friendly windowing shell for character terminals         #
X#        -------------------------------------------------------------         #
X#                                                                              #
X#                        Release 2.00 - October 1993                           #
X#                                                                              #
X#                 Written and (c) Copyright 1988-1993 by                       #
X#                        Hellmuth Michaelis ([e-mail])                  #
X#                        Eggerstedtstr. 28                                     #
X#                        22765 Hamburg                                         #
X#                        Germany                                               #
X#                                                                              #
X#        See the file COPYING for restriction and warranty information         #
X#                                                                              #
X================================================================================
X
XCwish is an easy to use tool for travelling through the filesystem, either for
Xdoing administrative work or as a shell replacement.
X
XIt was rewritten several times, a fact which is noticable in many dark corners
Xof the source, flames to /dev/null please!
X
XThe code is neither beautiful nor elegant, as are the underlying data-
Xstructures, so this is definitely NOT usable for an intro class into device
Xindependant programming - it just does the job for many years now and the
Xusers (yes, REAL users!) are satisfied with it.
X
XIt is SYSV-curses based, with the exception of two areas of terminal handling:
X- the first being the access of alternate character sets (ACS_XXXXX), which
X  is used for drawing horizontal lines across the screen, and
X- second, the access of function keys labels (slk_xxxx) in general
X  (and HP-terminal function keys labels in special).
X
XBefore you cry, there is no alternate character handling and function key
Xlabel handling available in the current version of HP-UX's curses (9.0)
Xwhich was and is my main development platform for cwish.
X
XWhat i did was, that i programmed "around" curses, which is a very bad thing
Xfor portability and other reasons - i know, but i did not found any other way.
X
XI think, i found failsafe methods in order to run cwish on other than the
Xtested terminals, but due to the lack of appropriate hardware, i tested it
Xonly on HP and DEC terminals or clones or terminal emulation packages
Xemulating one of the before mentioned.
X
XIf you get cwish to run on some other terminals (Wyse, Qume, Televideo etc.)
Xplease tell me !
X
X
XHISTORY                                     (see file ChangeLog for description)
X--------------------------------------------------------------------------------
X
XRelease        Changes/Features
X-------        ----------------------------------------------------------------
X1.00        First public release to comp.sources.misc
X2.00        Everything renamed to cwish, support for more platforms,
X        some small enhancements and confusion cleanups
X
X
XTHANK YOU
X--------------------------------------------------------------------------------
X
XGertjan van Oosten                   ([e-mail])
XThomas E. Dickey                     ([e-mail])
XJean-Yves Kerjan                     ([e-mail])
XJim Graham                           ([e-mail])
XNathan D. Lane                       ([e-mail])
X
X
XINSTALLATION
X--------------------------------------------------------------------------------
X
XPlease have a look at the beginning of the Makefiles for a description of the
Xavailable compile time options !
X
XHP-UX:
X    You need an ANSI-C compiler to compile everything. You should have no
X    problems using the 8.0 and 9.0 compiler or GCC from the Free Software
X    Foundation.
X
X    Copy Makefile.hpux to Makefile and execute make.
X
X    I had some problems with terminfo entries for "unsupported" terminals
X    under HP-UX 8.0, contact me if you need help.
X
X    "make install" installs cwish to /usr/local/bin, "make man-hpux"
X    installs the manual page to /usr/local/man/man1/cwish.1.
X
X
X386BSD, NetBSD, FreeBSD:
X    Zeyd M. Ben-Halim ([e-mail]) rewrote Pavel Curtis'
X    ncurses library and made it available for 386BSD and Linux.
X
X    This library is needed in order to get cwish up and running on
X    386BSD and NetBSD, i did not test FreeBSD, but i see no problems.
X
X    It is available from netcom.com:pub/zmbenhal.
X
X    Uncomment the appropriate Makefile-entry and execute make.
X
X    "make install" installs cwish to /usr/local/bin, "make man-386bsd"
X    installs the manual page to /usr/local/man/cat1/cwish.0.
X
X        --------
X
X    There were some reports that cwish ( on xxxBSD ONLY !!) dumps
X    core when it is linked with ncurses 1.8. If you have problems
X    with ncurses, let me know so we can fix those problems !
X
X    I am using a (much hacked) version of ncurses 0.73 on 386BSD
X    (patchkit 0.2.4) and NetBSD 0.9.
X
X
XUltrix:
X    Copy Makefile.ultrix to Makefile and execute make.
X
X    The Ultrix Makefile and the patches are from Gertjan van Oosten,
X    [e-mail].
X
X
XSunOS 4.1.3:
X    Copy Makefile.sunos to Makefile and execute make.
X
X    The SunOS 4.1.3 Makefile and patches are from Thomas E. Dickey,
X    [e-mail]. (See bugs section below)
X
X
XLinux:
X    Copy Makefile.linux to Makefile and execute make.
X
X    Reported to run with newer versions of ncurses - older versions
X    of ncurses do not handle inverse video properly and give
X    segmentation faults with terminals, get the latest available
X    version from Zeyd!
X    Thanks to Nils Gerloff ([e-mail]) for the setup of a
X    Linux machine to get the makefile done.
X
X
XRS/6000:
X    Copy Makefile.aix to Makefile and execute make.
X
X    Reported to run on AIX 3.2.4. The Makefile is from Nathan D. Lane,
X    [e-mail] (See bugs below)
X
X
XOTHER:
X    You are on your own! I will be glad to get Makefile entries and/or
X    diffs for other machines, if you need help, get in touch with me!
X
X
X
XWYSIWYG - WHAT YOU SHARE IS WHAT YOU GET
X--------------------------------------------------------------------------------
X
XPLEASE, if you fix bugs, add features, hack this program to work on your
Xterminal and/or operating system or simply don't get it up and running, get
Xin contact with me!
X
XThe code is far from being perfect, YOU are very welcome to enhance it !
X
XPlease mail bug reports/fixes, suggestions, enhancements & diffs to
X
X            [e-mail]
X
XI will support this program as my time permits it, feel free to contact me!
X
XThank You!
X
X
XKNOWN BUGS
X-------------------------------------------------------------------------------
X
XRS/6000:    return key does not work
X
XIntel SVR4:    "no exec/read permission found", no files listed, S_ISLNK
X        and S_ISSOCK not defined - this needs some work ....
X
XHP-UX 8.0:    the bottom function key labels in an hpterm stay after
X        leaving cwish, modification of SoftLinks in the config
X        screen has no effect
X
XSunOS 4.1.3:    on startup cwish does not do a refresh, after an initial
X        return all runs as expected.
X
X
XTESTED TERMINALS
X--------------------------------------------------------------------------------
X
XDEC VT100           no function keys, have to use escape + number
XDEC VT220           F1 .. F8 mapped to F6 .. F13
XHP2392A             slooow, but ok
XHP700/92            ok, but very small font
XWRQ R1+             nice, fast & easy
XWRQ R2+             nice, fast & easy, F1 .. F8 mapped to F6 .. F13
X386BSD pcvt         fully supported
X386BSD pc3          supported
XHPUX 9.0 hpterm     supported
XLinux console       fast ...
X
X
XGood Luck and Have Fun !
X
XHellmuth
X
Xe-mail:    [e-mail] (...mcsun!unido!hcshh!hm)
Xs-mail:    c/o HCS GmbH, Oldesloer Str 97-99, 22457 Hamburg, Germany
Xtel:    +49/40/55903-0 or +49/40/55903-170    (business)
Xfax:    +49/40/5591486                (business)
Xtel:    +49/40/384298                (private)
END_OF_FILE
  if test 8089 -ne `wc -c <'README'`; then
    echo shar: \"'README'\" unpacked with wrong size!
  fi
  # end of 'README'
fi
if test -f 'commandline.c' -a "${1}" != "-c" ; then
  echo shar: Will not clobber existing file \"'commandline.c'\"
else
  echo shar: Extracting \"'commandline.c'\" \(19109 characters\)
  sed "s/^X//" >'commandline.c' <<'END_OF_FILE'
X/*---------------------------------------------------------------------------*
X *
X *                  cwish - windowing user friendly shell
X *                  -------------------------------------
X *
X *              (c) Copyright Hellmuth Michaelis 1989 - 1993
X *
X *                  Eggerstedtstr. 28
X *                  22765 Hamburg
X *                  Germany
X *
X *                  Tel:    +49 / 40 / 384298    (private)
X *                  Tel:    +49 / 40 / 55903-170 (at work)
X *                  e-mail: [e-mail]
X *
X *           All rights are reserved except as explicitly granted
X *                  by written permission of the author.
X *
X *             See the file COPYING, distributed with cwish, for
X *                  restriction and warranty information
X *
X *---------------------------------------------------------------------------*
X *
X *      last edit-date: [Fri Oct 29 13:13:52 1993]
X *
X *      -hm     debugging "more" output
X *      -hm     separate sys-call function exec_command
X *      -hm     time suspend/resume
X *      -hm     nochng flag introduced
X *      -hm     current dir preserve when cd ..
X *      -hm     compress / gzip support
X *      -hm     tar support
X *      -hm     no space on echo to first cmdline pos
X *      -hm     fixed no space bug ....
X *      -hm     curdir debugging
X *      -hm     housekeeping
X *      -hm     cd bugfix, cdmount did not do what it should
X *      -hm     new routine ending to support multiple extensions
X *      -hm     cd with wildcards
X *      -hm     cdrom special processing for filenames containing ';'
X *    -hm    reread after edit
X *
X *----------------------------------------------------------------------------*/
X
X#include "cwish.h"               /* local includes */
X
Xstatic int waitcr = 0;          /* do not wait for cr */
Xstatic int reread = 0;          /* reread current dir */
Xstatic int nochng = 0;          /* nothing has changed */
Xstatic int preserve = PRES_NO;  /* preserve highlighted position */
Xstatic char curdirb[MAXPATHLEN+1];
Xstatic char *curdir = curdirb;  /* current dir to preserve if cd .. */
X
Xstatic char *str_nxtw(char *, int); /* returns a pointer to the next word in string */
Xstatic char *ending(char *filename);
Xstatic char *adjustfn(register char *name);
X
X/*---------------------------------------------------------------------------*
X *      echo the current highlighted filename onto the commandline
X *---------------------------------------------------------------------------*/
Xvoid name_echo(void)
X{
X        char *ptr;              /* temp ptr */
X
X        ptr = &(cur_file->onam[1]);     /* ptr = current filename */
X                                        /* check for delimiter */
X
X        if( (!(cr_on_files())) && (cbuff[curcol()-1] != SPACE) )
X                cmdline(SPACE);         /* if none, insert one */
X
X        ptr = adjustfn(ptr);
X
X        while((*ptr) && ((cmdline(*ptr++)) == GOOD))
X                ;
X}
X
X/*---------------------------------------------------------------------------*
X *      returns a pointer to the next word in string
X *---------------------------------------------------------------------------*/
Xstatic char *str_nxtw(char *str, int frst)
X{
X        char *r;
X
X        if((str == NULL) || (*str == '\0'))
X                return(NULL);
X
X        r = str;
X
X        if(frst)
X        {
X                while(*r == SPACE)      /* while leading delimiters */
X                        r++;
X                if(*r != '\0')
X                        return(r);      /* first non-space char */
X                else
X                        return(NULL);
X        }
X        else
X        {
X                while((*r != SPACE) && (*r != '\0')) /* find space */
X                        r++;
X                if(*r == '\0')          /* test for end of string */
X                        return(NULL);
X                while(*r == SPACE)      /* while there are delimiters */
X                        r++;
X                if(*r != '\0')
X                        return(r);      /* first non-space char */
X                else
X                        return(NULL);   /* end of string */
X        }
X}
X
X/*---------------------------------------------------------------------------*
X *      expand the selection character onto the commandline
X *---------------------------------------------------------------------------*/
Xvoid expsel(char *p)
X{
X        char rest[512];         /* save buffer */
X        struct onefile *info;   /* our file struct ptr */
X        int i;                  /* free space counter in cbuff */
X        register char *fnp;     /* for filename conversion */
X
X        strcpy(rest,p+1);       /* save right half of cbuff after EXPSEL-char */
X
X        if(*(p-1) != SPACE)     /* check for delimiter present */
X        {
X                *p = SPACE;
X                p++;
X        }
X
X        i = (p - cbuff) + strlen(rest); /* count of already occupied chars */
X
X        info = first;           /* first in list */
X
X        *p = '\0';              /* terminate left half of cbuff */
X
X        while(info)             /* scan through dir - list */
X        {
X                if(info->tag)   /* search for tagged files */
X                {
X                        fnp = adjustfn(&(info->onam[1]));
X
X                        if(((strlen(fnp))+1) < (HISLNLEN - i))
X                        {
X                                /* we have enough space  */
X
X                                i += (strlen(fnp)+1);
X                                strcat(cbuff, fnp);
X                                strcat(cbuff," ");
X                        }
X                }
X                info = info->next;      /* next entry */
X        }
X        strcat(cbuff,rest);     /* copy saved right half to generated part */
X}
X
X/*---------------------------------------------------------------------------*
X *      user has typed a <CR>
X *---------------------------------------------------------------------------*/
Xvoid handlecr(void)
X{
X        nochng = 0;             /* anything may change on screen */
X        preserve = PRES_NORM;   /* nothing to preserve */
X
X        if(cr_on_files())       /* nothing on commandline, process high- */
X        {                       /*  lighted filename field */
X                h_files();      /* cr on a filename */
X        }
X        else    /* something in commandlinebuffer */
X        {
X                h_line();       /* commandline */
X        }
X
X        if(waitcr && opt_return)        /* wait for <cr> being hit */
X        {
X                move(LINES-1, 0);       /* last line */
X                clrtoeol();             /* clear it */
X                move(LINES-1, 0);       /* last line */
X                attrset(A_REVERSE);             /* highlight on */
X                addstr("Press any key to continue ...");
X                attroff(A_REVERSE);             /* highlight on */
X                refresh();
X                getch();
X                move(LINES-1, 0);       /* last line */
X                clrtoeol();             /* clear it */
X                touchwin(stdscr);
X                wnoutrefresh(stdscr);
X        }
X        header();       /* new header */
X        dis_hist();     /* display current history entry */
X
X        if(reread)      /* directory has to be re-read */
X        {
X                free_list();            /* free malloc'ed buffers */
X                init_files(preserve, curdir);   /* yes, read current dir */
X        }
X        else
X        {
X                if(!nochng)
X                        fresh_files();  /* just refresh window */
X        }
X        resume_time();          /* restart time display update */
X        if(!nochng)
X        {
X                attribs(1);             /* new attributes */
X                init_flabels();         /* fk-labels onto screen */
X                update_all();           /* update all windows */
X        }
X        else
X        {
X                wrefresh(cmnd_w);
X        }
X}
X
X/*---------------------------------------------------------------------------*
X *      user has typed <CR> and something is on commandline
X *---------------------------------------------------------------------------*/
Xvoid h_line(void)
X{
X        char *cptr = cbuff+3;   /* ptr to start of line after prompt */
X        char *cp;               /* command ptr */
X        char *ap;               /* argument ptr */
X        char *ep;               /* expansion char ptr */
X
X        if((cp = str_nxtw(cptr,1)) == NULL)     /* just spaces on commandline ? */
X        {
X                nochng = 1;
X                errno = 0;                      /* yes ... */
X                error("commandline empty ... ");
X                waitcr = 0;
X                reread = 0;
X        }
X        else if( (*cp == 'c') && (*(cp+1) == 'd') &&
X                 ( (*(cp+2) == ' ') || (*(cp+2) == '\t') || (*(cp+2) == '\0') ) )
X        {
X                int ret;
X                if((ap = str_nxtw(cp, 0)) == NULL)
X                {
X                        ret = chdir(envhome);   /* cd to home */
X                }
X                else
X                {
X                        char *ptr;
X
X                        if((ptr = (char *)index(ap, '.')) != NULL)
X                        {
X                                if(!(strncmp(ptr, "..", 2)))
X                                {
X                                        if(getcwd(curdir, MAXPATHLEN) == NULL)
X                                                *curdir = '\0';
X                                        preserve = PRES_DD;
X                                }
X                        }
X                        ret = cd(ap);   /* cd to <dir> */
X                }
X
X                if(ret == -1)
X                {
X                        nochng = 1;
X                        error("changing directory failed - chdir() error");
X                        waitcr = 0;
X                        reread = 0;
X                }
X                else
X                {
X                        waitcr = 0;
X                        reread = 1;
X                }
X        }
X        else
X        {
X                if((ep = strchr((cbuff+3),EXPSEL)) != NULL)
X                        expsel(ep);             /* expand selection char */
X
X                exec_command(cbuff+3);
X
X                waitcr = 1;             /* wait for <cr> */
X                reread = 1;             /* reread current dir */
X        }
X        save_line();                    /* save commandline to history */
X}
X
X/*---------------------------------------------------------------------------*
X *      user has typed <CR> and commandline is empty
X *---------------------------------------------------------------------------*/
Xvoid h_files(void)
X{
X        preserve = PRES_NORM;
X
X        if(cur_file->oprm[0] == 'd')    /* directories */
X        {
X                preserve = PRES_DD;
X
X                if(getcwd(curdir, MAXPATHLEN) == NULL)
X                        *curdir = '\0';
X
X                if((chdir(&(cur_file->onam[1]))) == -1)
X                {
X                        nochng = 1;
X                        error("changing directory to current selection failed - chdir() error");
X                        reread = 0;     /* no need to re-read */
X                }
X                else
X                {
X                        reread = 1;     /* (re-) read (new) dir */
X                }
X
X                waitcr = 0;             /* don't wait for <CR> */
X        }
X
X        /* executables */
X
X        else if((cur_file->oprm[3] == 'x') ||
X                (cur_file->oprm[6] == 'x') ||
X                (cur_file->oprm[9] == 'x'))
X        {
X                sprintf(cbuff, "%s/%s", cur_path, &(cur_file->onam[1]));
X
X                exec_command(cbuff);            /* shell-call */
X
X                waitcr = 1;
X                reread = 1;
X        }
X
X        /* data files */
X        else if((cur_file->oprm[1] == 'r') ||
X                (cur_file->oprm[4] == 'r') ||
X                (cur_file->oprm[7] == 'r'))
X        {
X                FILE *pfp;
X                char *pp;
X                char *fnp;
X
X                fnp = adjustfn(&(cur_file->onam[1]));
X
X                sprintf(cbuff, "cat %s/%s", cur_path, fnp);
X
X                if((pp = ending(fnp)) != NULL)
X                        strcat(cbuff, pp);
X
X                strcat(cbuff,"|");              /* pipe to pager */
X                strcat(cbuff, opt_more);        /* pager */
X
X                suspend_time();         /* stop updating time */
X                fini_flabels();         /* remove user labels */
X                move(0, 0);             /* first line */
X                touchwin(stdscr);       /* force */
X                clear();                /* clear it */
X                refresh();              /* update screen */
X                savetty();              /* save tty-modes for resetty() */
X                reset_shell_mode();     /* set tty to pre-curses values */
X
X                if((pfp = popen(cbuff, "w")) == NULL)   /* exec */
X                        error("cannot open pipe to PAGER");
X                else
X                {
X                        if(pclose(pfp) == -1)
X                                error("PAGER pclose error");
X                }
X
X                resetty();              /* restore modes to curses operation */
X
X                reset_prog_mode();      /* set to curses values */
X
X#ifdef CURSESBUG
X                putp(keypad_xmit);      /* hp curses bug .. */
X#endif
X
X                touchwin(cmnd_w);
X                touchwin(fst_w);
X                touchwin(file_w);
X                if(opt_attrib)
X                        touchwin(attr_w);
X                if(opt_labels)
X                        touchwin(flbl_w);
X
X                resume_time();          /* restart updating time */
X                waitcr = 0;             /* don't wait for <CR> */
X                reread = 0;             /* reread dir */
X        }
X
X        /* OOPS, whats this ?? */
X        else
X        {
X                errno = 0;              /* no errno display */
X                error("no exec/read permission found ....");
X                flash();                /* no no .. */
X                waitcr = 0;             /* don't wait for <CR> */
X                reread = 0;             /* don't reread dir !!! */
X        }
X}
X
X/*---------------------------------------------------------------------------*
X *      what to do with the file depending on ending
X *---------------------------------------------------------------------------*/
Xstatic char *ending(char *filename)
X{
X        int i;
X        char *p;
X
X        static char *etab[][2] = {
X                {".tar.Z",      "|compress -dfc|tar tvf -"},
X                {".tar.z",      "|gzip -cdf|tar tvf -"},
X                {".tar.gz",     "|gzip -cdf|tar tvf -"},
X                {".tar",        "|tar tvf -"},
X                {".Z",          "|compress -dfc"},
X                {".z",          "|gzip -cdf"},
X                {".gz",         "|gzip -cdf"},
X                {NULL, NULL}
X        };
X
X        /* see if filename contains a known extension and return the    */
X        /* commandline string to decode that file                       */
X
X        for(i = 0; etab[i][0] != NULL; i++)
X        {
X                if( ((p = strstr(filename, etab[i][0])) != NULL) &&
X                    (strlen(p) == strlen(etab[i][0])) )
X                        return(etab[i][1]);
X        }
X        return(NULL);
X}
X
X/*---------------------------------------------------------------------------*
X *      edit the current file
X *---------------------------------------------------------------------------*/
Xvoid edit_current(void)
X{
X        char *fnp;
X
X        if(cur_file->oprm[0] == 'd')    /* directories */
X                return;
X
X        fnp = adjustfn(&(cur_file->onam[1]));
X
X        sprintf(cbuff,"%s %s/%s", opt_edit, cur_path, fnp);
X
X        exec_command(cbuff);            /* shell-call */
X
X        header();               /* new header */
X        dis_hist();             /* display current history */
X
X#ifdef REREAD_AFTER_EDIT
X        free_list();            /* free malloc'ed buffers */
X    init_files(PRES_NORM, NULL);    /* reread & display files */
X#else
X    fresh_files();        /* refresh display */
X#endif
X
X        attribs(1);             /* new attributes */
X        init_flabels();         /* fk-labels onto screen */
X        update_all();
X        resume_time();          /* restart time display update */
X}
X
X/*---------------------------------------------------------------------------*
X *      close current directory
X *---------------------------------------------------------------------------*/
Xvoid close_cdir(void)
X{
X        if(getcwd(curdir, MAXPATHLEN) == NULL)
X                *curdir = '\0';
X
X        if((chdir("..")) == -1)
X        {
X                error("changing directory to '..' dir failed - chdir() error");
X                return;
X        }
X        else
X        {
X                header();               /* new header */
X                free_list();            /* free malloc'ed buffers */
X                init_files(PRES_DD, curdir);    /* yes, read current dir */
X                attribs(1);             /* new attributes */
X                init_flabels();         /* fk-labels onto screen */
X        }
X        update_all();
X}
X
X/*---------------------------------------------------------------------------*
X *      execute a command/program
X *---------------------------------------------------------------------------*/
Xvoid exec_command(char *cline)
X{
X        suspend_time();         /* no time display update */
X        fini_flabels();         /* remove user labels */
X        move(0, 0);             /* last line */
X        touchwin(stdscr);       /* force */
X        clear();                /* clear it */
X        refresh();
X        savetty();              /* save tty-modes for resetty() */
X        reset_shell_mode();     /* set to pre-curses values */
X        system(cline);          /* shell-call */
X        resetty();              /* restore modes to curses operation */
X        reset_prog_mode();      /* set to curses values */
X
X#ifdef CURSESBUG
X        putp(keypad_xmit);      /* hp curses bug .. */
X#endif
X
X        touchwin(cmnd_w);
X        touchwin(fst_w);
X        touchwin(file_w);
X        if(opt_attrib)
X                touchwin(attr_w);
X        if(opt_labels)
X                touchwin(flbl_w);
X}
X
X/*---------------------------------------------------------------------------*
X *      adjust filename (cdrom, others ?)
X *---------------------------------------------------------------------------*/
Xstatic char *adjustfn(char *name)
X{
X    static char buffer[MAXPATHLEN];
X    register char *bp = buffer;
X    register char *sp = name;
X
X    while(*sp)
X    {
X        if(iscdfs && (*sp == ';'))
X            *bp++ = '\\';
X        *bp++ = *sp++;
X    }
X    *bp = '\0';
X    return((char *)buffer);
X}
X
X/*---------------------------------- EOF -------------------------------------*/
END_OF_FILE
  if test 19109 -ne `wc -c <'commandline.c'`; then
    echo shar: \"'commandline.c'\" unpacked with wrong size!
  fi
  # end of 'commandline.c'
fi
if test -f 'cwish.1' -a "${1}" != "-c" ; then
  echo shar: Will not clobber existing file \"'cwish.1'\"
else
  echo shar: Extracting \"'cwish.1'\" \(24534 characters\)
  sed "s/^X//" >'cwish.1' <<'END_OF_FILE'
X.\"---------------------------------------------------------------------------
X.\"
X.\"                  cwish - windowing user friendly shell
X.\"                  -------------------------------------
X.\"
X.\"               Copyright (c) 1988-1993 Hellmuth Michaelis
X.\"
X.\"                  Eggerstedtstr. 28
X.\"                  22765 Hamburg
X.\"                  Germany
X.\"
X.\"                  Tel:    +49 / 40 / 384298    (private)
X.\"                  Tel:    +49 / 40 / 55903-170 (at work)
X.\"                  e-mail: [e-mail]
X.\"
X.\"                          --------oOo--------
X.\"
X.\"   This program is free software; you can redistribute it and/or modify
X.\"   it under the terms of the GNU General Public License as published by
X.\"   the Free Software Foundation; either version 2 of the License, or
X.\"   (at your option) any later version.
X.\"
X.\"   This program is distributed in the hope that it will be useful,
X.\"   but WITHOUT ANY WARRANTY; without even the implied warranty of
X.\"   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
X.\"   GNU General Public License for more details.
X.\"
X.\"   You should have received a copy of the GNU General Public License
X.\"   along with this program; if not, write to the Free Software
X.\"   Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
X.\"
X.\"---------------------------------------------------------------------------
X.\"
X.\"    last edit-date: [Wed Oct 20 12:30:37 1993]
X.\"
X.\"    -hm    initial manual converted from old text pages
X.\"    -hm    updating to reflect changes, version 1.00
X.\"    -hm    updating to reflect changes, version 2.00
X.\"
X.\"---------------------------------------------------------------------------
X.PU
X.TH cwish 1
X.SH NAME
Xcwish \- windowing user friendly shell
X.SH SYNOPSIS
X.B cwish
X[
X.RB [ + | - ]
X.RB [ acCdflnprw ]
X]
X.SH DESCRIPTION
X.I Cwish
Xis a powerful fullscreen, menu-based, easy to use and user friendly
Xinterface to the UNIX (tm) filesystem. It can also be used as a shell
Xreplacement for interactive use.
XIt is intended for character terminal environments where such tools are not
Xavailable at all and where one needs a general purpose tool for easily
Xwalking through the filesystem.
X.SH OPTIONS
X.I Cwish
Xhas several commandline options to change the runtime behaviour:
X.sp
X.ta 0.4i
X.in +0.4i
X.ti -0.4i
X\fB+a\fR    Display the "attribute" line at the bottom of the screen.
XIf you don't like to contiuously have the line showing the current file's
Xattributes, you can switch this off by using the -a switch. As a side
Xeffect, you will be able to use two more screen lines for the file window
Xdisplay.
X.sp
X.ti -0.4i
X\fB-a\fR    Don't display the "attribute" line.
X.sp
X.ti -0.4i
X\fB+C\fR    On CDROM media, files containing data have often all execute
Xattributes set, so that
X.I cwish
Xtries to execute the file as a shell script when selected for display. By
Xspecifying the
X.B +C
Xoption in conjunction with the
X.B +c
Xoption,
X.I cwish
Xremoves internally all execute permission from ordinary files.
X.sp
X.ti -0.4i
X\fB-C\fR    No execute permission removal is done on regular files.
X.sp
X.ti -0.4i
X\fB+c\fR    On CDROM's conforming to the
X.I High Sierra
Xor the
X.I ISO-9660
Xstandard a version number is appended to a regular file's name delimited
Xby a semicolon. This semicolon is interpreted by the shell as an end of
Xline delimiter. To get around this behaviour,
X.I cwish
Xescapes the semicolon by placing a backslash in front of the semicolon
Xif this option is selected.
X.sp
X.ti -0.4i
X\fB-c\fR    Do not escape the semicolon in CDROM filenames.
X.sp
X.ti -0.4i
X\fB+d\fR    Try to preserve the current directory when walking through
Xthe directory tree.
X.sp
X.ti -0.4i
X\fB-d\fR    Don't try to preserve the current directory.
X.sp
X.ti -0.4i
X\fB+f\fR    Display "virtual" function key labels.
X.I Cwish
Xdetects the presence of a Hewlett-Packard-Terminal by the presence
Xof the "xs"-flag in termcap or the "xhp"-flag in terminfo. If this flag is
Xnot present,
X.I cwish
Xemulates the function key labels in the last line of the
Xscreen. If this behaviour is not desired, use the -f switch to run
X.I cwish
Xwithout emulated function key labels.
X.sp
X.ti -0.4i
X\fB-f\fR    Don't Display "virtual" function key labels.
X.sp
X.ti -0.4i
X\fB+l\fR    Enable the detection and display of symbolic links. This option
Xonly makes sense if the "attributes" line is displayed.
X.sp
X.ti -0.4i
X\fB-l\fR    Disable the detection and display of symbolic links.
X.sp
X.ti -0.4i
X\fB+n\fR    Enable display of filenames starting with a dot.
X.sp
X.ti -0.4i
X\fB-n\fR    Disable display of filenames starting with a dot.
X.sp
X.ti -0.4i
X\fB+p\fR    Display the current directory as "." in the file window
Xof the screen. Usually the first file displayed in the file window is the
X"..", the directory above the current directory. This is convenient for
Xeasy walking through the directory tree. Although the current directory,
X".", is not displayed, it is present and included in the entry count in
Xthe upper right corner of the file window. If you wish to display the
Xcurrent directory too, use the +p switch to turn this option on.
X.sp
X.ti -0.4i
X\fB-p\fR    Don't display the current directory as ".".
X.sp
X.ti -0.4i
X\fB+r\fR    Wait for pressing \fIRETURN\fR after executing an external
Xcommand.
X.sp
X.ti -0.4i
X\fB-r\fR    Don't wait for pressing \fIRETURN\fR after executing an external
Xcommand.
X.sp
X.ti -0.4i
X\fB+w\fR    Enable the processing of wildcard filenames for file display.
XThe wildcard specification must be entered using the
X.B \.cwishrc
Xfile option "wildcard=" or by using
X.I cwish's
Xconfiguration screen.
X.sp
X.ti -0.4i
X\fB-w\fR    Disable the processing of wildcard filenames.
X.sp
X.ti -0.4i
X\fB-?\fR    Displays current version of
X.I cwish
Xand copyright and usage
Xinformation.
X.SH THE DISPLAY SCREEN
XAfter starting
X.I cwish
X, the screen becomes divided into several "windows":
X.SS Command Window
XThe command window consists of the uppermost two lines on screen, the first
Xline is displaying the program's name, version, copyright information,
Xterminal type and the current time. In case that an error message has to be
Xdisplayed, this line is used to display the error message until the next key
Xis pressed.
X.PP
XThe next line in this window is the the \fIcommand line\fR, displaying the
Xcurrent history line number as it's prompt. One can cycle through the command
Xline history by using the popular emacs control sequences. Any alphanumeric
Xinput typed at the keyboard is displayed here and executed by the users
Xshell (system(3)) after pressing <return>.
X.SS File Window
XThe middle part of the screen becomes your "window" into the
Xcurrently selected directory - it's called the file window. The
Xfirst line of the file window contains the full pathname of the current
Xdirectory together with the number of files in this directory labelled
X.B Entries.
XIf filename wildcarding is active, this label becomes
X.B Matches
X, when marking files, this label becomes
X.B Byte.
X.sp
XWith the cursor keys, the user moves a "cursor" or "current file", which is a
Xhighlighted bar, over the filenames in the file window. If a file
Xis made the current selected file by placing the cursor on it,
Xvarious operations can be done on it, i.e. if the file is a
Xdirectory, and the user hits return, a change to that directory is
Xdone. If the file is an executable file, it is either executed as a
Xbinary executable or as a shell script. If the file is a data file
Xit is displayed by the selected pager program - more options are
Xavailable. If there are more files in a directory than fitting into
Xthe file window, it can be paged through by using the page up/down
Xfunction keys.
X.sp
XFiles can be marked in the file window and expanded in the
Xcommandline by the special wildcard character "%" - so if you mark
Xseveral files in the file window, and type "rm % <RETURN>" in the
Xcommandline, all selected files will be deleted.
X.sp
XThe current selected filename can be echoed onto the commandline
Xfor further processing by some other commands.
X.sp
XIf there are more files in the directory than will fit into the file window,
Xone can move through file window "pages" by using the PAGE UP and PAGE DOWN
Xterminal keys. There is an indicator available in the lower right corner
Xof the file window for telling the user if there is page above "^", a page
Xbelow "V" or pages above and below "*" available beside the current one.
X.sp
X.SS Attribute Window
XIf it was configured by either using the commandline switch
X.B a
Xor by using the configuration file option, the lower part of the screen
Xbecomes the attribute window which displays several attributes of the
Xcurrently selected (highlighted) file. By using function key 7 you are able
Xto switch between two types of attribute lines: normal - attributes displayed
Xare permissions, date, time, size, no. of hardlinks, username and groupname;
Xalternate - access date/time, modify date/time, status change date/time
Xand inode.
X.SS Function Key Label Window
XIf it was configured by either using the commandline switch
X.B f
Xor by using the configuration file option, the last part of the screen
Xbecomes the virtual function key label window.
XSome
X.I cwish
Xfunctionality is controllable by the terminals special
Xfunction keys (f1....f8). Hewlett-Packard Terminals have special
Xprogrammable function key labels; for terminals having
Xfunction keys, but no labels,
X.I cwish
Xsimulates 8 function key labels in the last line of the terminal.
X.PP
X.SH Command Window Keys
X.sp
X.ta 0.4i
X.in +0.4i
X.ti -0.4i
X\fBBackspace\fR - Erases the character left of the cursor.
X.sp
X.ti -0.4i
X\fBDelete\fR - Erases the character under the cursor.
X.sp
X.ti -0.4i
X\fBReturn\fR - Return key handling is dependent of the status of
Xthe commandline:
X.br
X.B Commandline contains characters:
X.br
XThe command string entered into the command line is terminated and executed
Xby handing it to the system() call to execute it.
X.br
X.B Commandline is empty:
X.br
XWhile you are maneuvering with the highlighting bar through the file
Xwindow, you are able to do the most natural commands depending on the
Xtype of file to the current selected (highlighted) file by just
Xpressing <RETURN>. This means, that if your file is:
X.br
X\(bu a executable program, it is executed
X.br
X\(bu a data file, it is displayed using the pager program
X.br
X\(bu a directory, the current directory is changed to the highlighted one
X.sp
X.ti -0.4i
X\fBDelete Char\fR - Erases the character under the cursor.
X.sp
X.ti -0.4i
X\fBControl-F\fR - Forward one character on the commandline.
X.sp
X.ti -0.4i
X\fBControl-B\fR - Backward one character on the commandline.
X.sp
X.ti -0.4i
X\fBControl-P\fR - Previous commandline from history buffer.
X.sp
X.ti -0.4i
X\fBControl-N\fR - Next commandline from history buffer.
X.sp
X.ti -0.4i
X\fBControl-D\fR - If the commandline is empty, exit
X.I cwish.
XIf the commandline is not empty, delete the character under the cursor.
X.sp
X.ti -0.4i
X\fBControl-K\fR - Kill the line on the commandline from the cursor
Xposition to the end of the commandline and place the string into the
Xkill-buffer. See also key
X.B
XControl-Y.
X.sp
X.ti -0.4i
X\fBControl-Y\fR - Yank text from the kill-buffer (if any) onto the
Xcommandline at the current cursor position. See also key
X.B
XControl-K.
X.sp
X.ti -0.4i
X\fBControl-A\fR - Position the cursor at the beginning of the
Xcommandline.
X.sp
X.ti -0.4i
X\fBControl-E\fR - Position the cursor at the endo of the commandline.
X.sp
X.ti -0.4i
X\fBControl-L\fR - Refresh display
X.sp
X.ti -0.4i
X\fBAlphanumeric Characters\fR     Any alphanumeric, non-control character
Xtyped on the keyboard is displayed on the commandline.
X.PP
X.SH File Window Keys
X.sp
X.ta 0.4i
X.in +0.4i
X.ti -0.4i
X\fBCursor Right\fR - Move the current file one position
Xto the right. If on the right margin, wrap onto the next line, first position.
XIf on the lowest right position, wrap to the upper left position.
X.sp
X.ti -0.4i
X\fBCursor Left\fR - Move the current file one position
Xto the left. If on the left margin, wrap onto the previous line, last position.
XIf on the upper left position, wrap to the lowest right position.
X.sp
X.ti -0.4i
X\fBCursor Up\fR - Move the current file one position up in the same column.
X.sp
X.ti -0.4i
X\fBCursor Down\fR - Move the current file one position down in the same column.
X.sp
X.ti -0.4i
X\fBCursor Home\fR - Move the current file to the upper left position.
X.sp
X.ti -0.4i
X\fBCursor Home Down\fR - Move the current file to the lower right position.
X.sp
X.ti -0.4i
X\fBNext Page\fR - Display the next file window screen (if any).
X.sp
X.ti -0.4i
X\fBPrevious Page\fR - Display the previous file window screen (if any).
X.PP
X.SH Function Keys
X.sp
X.ta 0.4i
X.in +0.4i
X.ti -0.4i
X\fBFunction Key 1\fR - Edit the current file with your editor.
XThis function is also executable by pressing "ESC 1".
X.sp
X.ti -0.4i
X\fBFunction Key 2\fR - Echo the current filename onto the commandline.
XThis function is also executable by pressing "ESC 2".
X.sp
X.ti -0.4i
X\fBFunction Key 3\fR - Display the help screen.
XThis function is also executable by pressing "ESC 3".
X.sp
X.ti -0.4i
X\fBFunction Key 4\fR - Enter the
X.I cwish
Xruntime configuration menu screen.
XThis function is also executable by pressing "ESC 4".
X.sp
X.ti -0.4i
X\fBFunction Key 5\fR - Mark the current filename.
XThis function is also executable by pressing "ESC 5".
X.sp
X.ti -0.4i
X\fBFunction Key 6\fR - Unmark all marked filenames.
XThis function is also executable by pressing "ESC 6".
X.sp
X.ti -0.4i
X\fBFunction Key 7\fR - If an attribute window is displayed, this key toggles
Xbetween a normal and an alternate attribute line to show nearly all the
Xcurrent files attributes.
XThis function is also executable by pressing "ESC 7".
X.sp
X.ti -0.4i
X\fBFunction Key 8\fR - Close the current directory and open the the next
Xupper directory (this has the same effect as executing "cd .." on the commandline.
XThis function is also executable by pressing "ESC 8".
X.sp
X.PP
X.SH HANDLING OF FILES WITH SPECIAL ENDINGS
XSeveral endings of filenames are detected and handled according to
Xbuilt-in rules, these are:
X.in +0.4i
X.ti -0.4i
X.RS
X.TP 15
X file-ending
X method to handle file
X.PD 0
X.TP
X -----------
X ---------------------
X.TP
X .tar.Z
X | compress -dfc | tar tvf -
X.TP
X .tar.z
X | gzip -cdf | tar tvf -
X.TP
X .tar.gz
X | gzip -cdf | tar tvf -
X.TP
X .Z
X | compress -dfc
X.TP
X .z
X | gzip -cdf
X.TP
X .gz
X | gzip -cdf
X.RE
X.PD
X.sp
X.PP
X.SH MARKING FILES
XA special purpose wildcard character is recognized on the command line and
Xis expanded after pressing <RETURN>, it is the character "%" (percent).
XThis character expands to all marked files in the file window and gives the user
Xa new powerful file handling functionality.
X.sp
XThe behaviour of whether the current
Xfilename advances to the next position or stays at the current one is
Xconfigurable in the runtime configuration menu and with an initfile variable.
XSee also the
X.B
XFunction Key 5
Xand
X.B
XFunction Key 6
Xfunctions and the
X.B
Xtagmove
Xconfiguration file variable.
X.sp
XWhen making/tagging files, the Label
X.B Entries
Xor
X.B Matches
Xin the upper right corner of the file window is replaced by the label
X.B Byte
Xand displays the sum of the sizes of all marked/tagged files.
X.sp
X.PP
X.SH FILENAME COMPLETITION
XThere is a rather primitive filename completition available on the commandline,
Xwhich is initiated by pressing the Escape key twice.
X.sp
X.PP
X.SH COMMANDLINE WILDCARD PROCESSING
XIt is possible to specify wildcard characters in a filename on the commandline.
XIf the command to be performed is not a
X.B cd
Xcommand, the wildcard matching rules of the shell used apply, if the command
Xis a
X.B cd
Xcommand (which is executed by
X.I cwish
Xitself), the wildcard string is interpreted according to the following rules:
X.TP
X.BI \e x
XTurns off the special meaning of
X.I x
Xand matches it directly; this is used mostly before a question mark or
Xasterisk, and is not valid inside square brackets.
X.TP
X.B ~
XAt the beginning of a pathname is replaced with the users's HOME directory
X.TP
X.B ?
XMatches any single character.
X.TP
X.B *
XMatches any sequence of zero or more characters.
X.TP
X.BI [ x...y ]
XMatches any single character specified by the set
X.IR x...y ,
Xwhere any character other than minus sign or close bracket may appear
Xin the set.
XA minus sign may be used to indicate a range of characters.
XThat is,
X.I [0\-5abc]
Xis a shorthand for
X.IR [012345abc] .
XMore than one range may appear inside a character set;
X.I [0-9a-zA-Z._]
Xmatches almost all of the legal characters for a host name.
X.TP
X.BI [!x...y ]
XThis matches any character
X.I not
Xin the set
X.IR x...y ,
Xwhich is interpreted as described above.
X.br
XThere is no way to specify a minus sign in a character range.
X.sp
X.PP
X.SH FILE WINDOW WILDCARD PROCESSING
XIf the users wants to display just some files in the file window, he may do
Xso by specifying a wildcard string in the configuration menu or with the
Xconfiguration file variable
X.B wildcard.
XThe rules for constructing such a string are the same as described in the above
Xparagraph.
XBecause there is a speed penalty in using this option, it has to be enabled
Xin the configuartion menu or file.
X.sp
XIf wildcard processing is in effect, the label
X.B Entries
Xin the upper right corner of the file window is replaced by the label
X.B Matches
Xand displays the number of files matching the wildcard specification.
X.sp
XFilename wildcard processing affect all types of files with the exception
Xof directories, which are always displayed.
X.sp
X.PP
X.SH THE ATTRIBUTE WINDOW
XIf an attribute window is displayed, (see command line options
X.B
X+a
Xand
X.B
X-a
X), some more information for the currently highlighted file in the file
Xwindow is displayable, because there is more information available for
Xa given file than will fit into 80 columns, there are two levels (switchable
Xby using function key F7) available - normal and alternate attribute lines.
X.sp
XThe normal (default after starting
X.I cwish
X) attribute line displays:
X.br
X\(bu the file access permissions in a format as used by the "ls" utility
X.br
X\(bu the file modification date
X.br
X\(bu the file modification time
X.br
X\(bu the file size in bytes
X.br
X\(bu the number of hard links for the file
X.br
X\(bu the name of the owner of the file
X.br
X\(bu the name of the group of the file
X.br
X.sp
XThe alternate attribute line displays:
X.br
X\(bu the file access date and time
X.br
X\(bu the file modification date and time
X.br
X\(bu the file last status change date and time
X.br
X\(bu the inode
X.PP
X.SH CONFIGURATION FILE
XOn startup,
X.I cwish
Xsearches a startup configuration file named ".cwishrc" in the
Xusers HOME directory, and, if found, configures itself using the information
Xin this file.
X.br
XOne can configure
X.I cwish
Xby setting three types of Variables:
X.br
X.sp
X.SS Boolean Variables
X.sp
XBoolean Variables can be set/reset by using the stings "on" or "off"
Xafter the variable name and an equal sign.
X.ta 0.4i
X.in +0.4i
X.ti -0.4i
X\fBattributes\fR - Enable/disable attribute line display
X.sp
X.ti -0.4i
X\fBpreserve\fR - Enable/disable preserve directory
X.sp
X.ti -0.4i
X\fBfkeys\fR - Enable/disable virtual function key label display
X.sp
X.ti -0.4i
X\fBlinks\fR - Enable/disable link detection and display
X.sp
X.ti -0.4i
X\fBpoint\fR - Enable/disable display of the current directory in the file
Xwindow as "." (dot).
X.sp
X.ti -0.4i
X\fBreturn\fR - Enable/disable wait for pressing <RETURN> after a external
Xcommand is executed.
X.sp
X.ti -0.4i
X\fBwildenable\fR - Enable/disable wildcard filename processing.
X.sp
X.ti -0.4i
X\fBcdrom\fR - Enable/disable CDROM semicolon in filename processing.
X.sp
X.ti -0.4i
X\fBcdnoprog\fR - Enable/disable CDROM removal of execute permissions.
X.sp
X.ti -0.4i
X\fBdotnames\fR - Enable/disable the display of filenames starting with a dot.
X.sp
X.ti -0.4i
X\fBtagmove\fR - Enable/disable moving to the next file after marking the current.
X.br
X.sp
X.SS String Variables
X.sp
X.ta 0.4i
X.in +0.4i
X.ti -0.4i
X\fBpager\fR - the partial or full filename of the program to be used as
Xthe pager program.
X.sp
X.ti -0.4i
X\fBeditor\fR - the partial or full filename of the program to be used as
Xthe editor program.
X.sp
X.ti -0.4i
X\fBwildcard\fR - specify a wildcard expression to be used for selecting
Xfilenames to be displayed in the file window.
X.br
X.sp
X.SS Character Variables
X.sp
X.ta 0.4i
X.in +0.4i
X.ti -0.4i
X\fBdelimiter\fR - the delimiter character to be used to delimit the command
Xand the the attribute window from the file window.
X.sp
X.SH STARTUP AND CONFIGURATION-FILE PROCESSING
XWhen
X.I cwish
Xis started, it runtime configures itself in the following
Xorder:
X.br
X.IP 1.
Xit sets up defaults taken from the environment
X.IP 2.
Xit (re-) configures itself by reading the
X.B .cwishrc
Xconfiguration file from the users HOME directory
X.IP 3.
Xthe command line options (if any) are processed and used for (re-)configuration
X.sp
X.SH RUNTIME CONFIGURATION
XWhile running
X.I cwish
Xthe user is able to change several configuration variables on the fly by
Xusing the configuration menu which is entered by pressing
X.B Function Key 4.
X.sp
XYou can leave the configuration menu by pressing
X.B CONTROL-D.
X.sp
XPressing
X.B SPACE
Xtoggles a the value of a boolean variable.
X.sp
XA wildcard string can be entered by moving the curser onto the
X.B Wildcard
Xfield and pressing <RETURN>, the only editing key available is <BACKSPACE>.
XLeave the field by pressing <RETURN> again - remember to enable the processing
Xof wildcards by setting the boolean variable
X.B WildEnabl
Xto YES.
X.sp
XThe variables in the lower half of the screen are just displayed but cannot
Xbe changed here. Use the
X.B .cwishrc
Xconfiguration file options to change these and restart
X.I cwish.
X.sp
X.PP
X.SH ENVIRONMENT
X.I Cwish
Xdepends on some of the following environment variables:
X.sp
X.ta 0.4i
X.in +0.4i
X.ti -0.4i
X\fBHOME\fR - mandatory, the users HOME directory
X.sp
X.ti -0.4i
X\fBPAGER\fR - optional, the pager program used to display text files, this
Xdefaults to using "more".
X.sp
X.ti -0.4i
X\fBEDITOR\fR - optional, the ditor used for editing files, if this variable
Xdoes not exist, the environment variable \fBVISUAL\fR is used, if it also
Xdoes not exist, this defaults to "vi".
X.sp
X.ti -0.4i
X\fBTERM\fR - mandatory, the users termcap/terminfo entry
X.sp
X.PP
X.SH SEE ALSO
Xsh(1), system(3)
X.SH COPYRIGHT
X.I Cwish
Xis
X.br
XCopyright (c) 1988-1993 by Hellmuth Michaelis
X.br
XEggerstedtstr. 28
X.br
X22765 Hamburg
X.br
XGermany
X.br
XTel: [phone] (private)
X.br
XTel: [phone] (at work)
X.br
Xe-mail: [e-mail]
X.sp
XAll rights are reserved except as explicitly granted
Xby written permission of the author.
X.sp
X.I
XCwish
Xis free software; you can redistribute it and/or modify it under the
Xterms of the GNU General Public License as published by
Xthe Free Software Foundation; either version 2 of the License, or
X(at your option) any later version.
X.sp
XSee the file COPYING, distributed with
X.I cwish
X, for restriction
Xand warranty information
X.sp
XThe
X.B wildmat(3)
Xlibrary function used by
X.I cwish
Xto perform all types of wildcard matching was written by Rich $alz
X<[e-mail]> in 1986, and posted to Usenet. The version used here
Xwas taken from volume 17 of comp.sources.misc.
X.sp
XThe
X.B user_from_uid()
Xand
X.B group_from_gid()
Xuser and group name caching functions used by
X.I cwish
X(see usrgrp.c) are from an unknown BSD distribution, so i'd like to
Xsay that ``This product includes software developed by the University
Xof California, Berkeley and its contributors''.
X.SH RETURN VALUES
XThe return value is 0 if
X.I cwish
Xwas exited normally by the user, any other
Xreturn value signals that a fatal error has occured.
X.SH FILES
X$HOME/.cwishrc
X.SH DIAGNOSTICS
X.I Cwish
Xuses the first line (which under no error conditions contains a copyright
Xmessage, version, terminal name and time) to tell the user in case of error
Xwhat type of error has occured. This error message is overwritten with the
Xnormal header when the next key is pressed.
X.SH HISTORY
X.I Cwish
Xwas modeled after a utility called "PAM" (Personal Application Manager)
Xwhich was distributed as part of Hewlett-Packards HP-UX (tm)
XOperating System.
X.sp
XIn contrast to PAM, which runs only on HP's own terminals,
X.I cwish
Xis curses based
Xand should run on all sorts of terminals, although it was tested just with
XHP-terminals (HP2392A,HP700/9x) and DEC-terminals (VT100/VT220) and terminal
Xemulators which come with X Windows (xterm, hpterm).
X.sp
X.I Cwish
Xbegan as a termcap based program on a Microware OS-9/68k (tm) machine,
Xmoved over to the HP-UX environment to replace PAM (still termcap based) and
Xwas then rewritten to use curses.
X.sp
XIn the meantime it compiles and runs on a wide range of architectures, see
Xthe various Makefiles that come with the source.
X
X
END_OF_FILE
  if test 24534 -ne `wc -c <'cwish.1'`; then
    echo shar: \"'cwish.1'\" unpacked with wrong size!
  fi
  # end of 'cwish.1'
fi
if test -f 'showtime.c' -a "${1}" != "-c" ; then
  echo shar: Will not clobber existing file \"'showtime.c'\"
else
  echo shar: Extracting \"'showtime.c'\" \(3545 characters\)
  sed "s/^X//" >'showtime.c' <<'END_OF_FILE'
X/*---------------------------------------------------------------------------*
X *
X *                  cwish - windowing user friendly shell
X *                  -------------------------------------
X *
X *               Copyright (c) 1988-1993 Hellmuth Michaelis
X *
X *                  Eggerstedtstr. 28
X *                  22765 Hamburg
X *                  Germany
X *
X *                  Tel:    +49 / 40 / 384298    (private)
X *                  Tel:    +49 / 40 / 55903-170 (at work)
X *                  e-mail: [e-mail]
X *
X *                          --------oOo--------
X *
X *   This program is free software; you can redistribute it and/or modify
X *   it under the terms of the GNU General Public License as published by
X *   the Free Software Foundation; either version 2 of the License, or
X *   (at your option) any later version.
X *
X *   This program is distributed in the hope that it will be useful,
X *   but WITHOUT ANY WARRANTY; without even the implied warranty of
X *   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
X *   GNU General Public License for more details.
X *
X *   You should have received a copy of the GNU General Public License
X *   along with this program; if not, write to the Free Software
X *   Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
X *
X *---------------------------------------------------------------------------*
X *
X *    last edit-date: [Sun Oct 17 18:08:27 1993]
X *
X *    -hm    added signal.h for hpux 8.0x (and probably others ..)
X *
X *---------------------------------------------------------------------------*/
X
X#include "cwish.h"
X
X#include <signal.h>    /* for hpux 8.0 */
X
Xvoid timeout_hdlr(int sig);
Xstatic void make_time(void);
X
X/*---------------------------------------------------------------------------*
X *    init time display in header
X *---------------------------------------------------------------------------*/
Xvoid init_time(void)
X{
X    signal(SIGALRM, &timeout_hdlr);
X    make_time();
X    alarm(30);
X}
X
X/*---------------------------------------------------------------------------*
X *    print current time into header
X *---------------------------------------------------------------------------*/
Xstatic void make_time(void)
X{
X    static struct tm *tmptr;
X    static time_t t;
X    static char buf[6];
X
X    time(&t);
X    tmptr = localtime(&t);
X    sprintf(buf,"%02d:%02d", tmptr->tm_hour,tmptr->tm_min);
X
X    strcpy(headerline+75,buf);
X}
X
X/*---------------------------------------------------------------------------*
X *    the timeout handler
X *---------------------------------------------------------------------------*/
Xvoid timeout_hdlr(int sig)
X{
X    static int i;
X
X    signal(SIGALRM, SIG_IGN);
X
X    make_time();
X
X    if(!errorflag)
X    {
X        i = 0;
X        if(COLS > 80)
X            i = (COLS - 80)/2;
X        wmove(cmnd_w, C_HEAD, 75+i );
X        wattron(cmnd_w, A_REVERSE);
X        waddstr(cmnd_w, headerline+75);
X        wattroff(cmnd_w, A_REVERSE);
X        wmove(cmnd_w, C_LINE, curcol());
X        wrefresh(cmnd_w);
X    }
X    alarm(30);
X    signal(SIGALRM, timeout_hdlr);
X}
X
X/*---------------------------------------------------------------------------*
X *    stop updating the time
X *---------------------------------------------------------------------------*/
Xvoid suspend_time(void)
X{
X    signal(SIGALRM, SIG_IGN);
X}
X
X/*---------------------------------------------------------------------------*
X *    restart updating the time
X *---------------------------------------------------------------------------*/
Xvoid resume_time(void)
X{
X    signal(SIGALRM, &timeout_hdlr);
X    make_time();
X}
X
X/*---------------------------------- EOF -------------------------------------*/
END_OF_FILE
  if test 3545 -ne `wc -c <'showtime.c'`; then
    echo shar: \"'showtime.c'\" unpacked with wrong size!
  fi
  # end of 'showtime.c'
fi
echo shar: End of archive 1 \(of 5\).
cp /dev/null ark1isdone
MISSING=""
for I in 1 2 3 4 5 ; do
    if test ! -f ark${I}isdone ; then
    MISSING="${MISSING} ${I}"
    fi
done
if test "${MISSING}" = "" ; then
    echo You have unpacked all 5 archives.
    rm -f ark[1-9]isdone
else
    echo You still must unpack the following archives:
    echo "        " ${MISSING}
fi
exit 0
exit 0 # Just in case...