home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / hcshdemo.zip / csh-os2.zip / SAMPLES / README < prev    next >
Text File  |  1994-02-15  |  6KB  |  145 lines
  1. Hamilton C shell(tm) Samples Directory, Release 2.2.i
  2. Copyright (c) 1989-1993 by Hamilton Laboratories.  All rights reserved.
  3.  
  4. The sample C programs and C shell scripts in this directory are meant
  5. to help you install or experiment with Hamilton C shell.  Deliberately,
  6. they're relatively trivial.
  7.  
  8. (All these files should be viewed with TABS=3)
  9.         
  10.  
  11. args.c         A simple C program that prints out the *argv[] (argument)
  12.                     and *envp[] (environmental variable) arrays.  Notice that
  13.                     wildcarding, variable substitutions, quoting and command
  14.                     substitutions are done before the C program is started.  If
  15.                     you do a lot of wildcarding, you can create and pass VERY
  16.                     long parameter lists (up 64K characters).  Try some of these
  17.                     commands:
  18.  
  19.                         % args "ho"w 'no'w
  20.                         % args "$cwd" '$cwd'
  21.                         % args * "*" '*'
  22.                         % args `whereis more`
  23.                         % args '`whereis more`'
  24.                         % args * *\* *\*\* | more
  25.  
  26. bits.csh            A simple self-loading procedure that calculates the minimum
  27.                     bits required to represent the argument it's passed as a
  28.                     binary integer.
  29.  
  30. bumpdate.csh    Print the date n number of days forward or backward from a
  31.                     given date.  If only the bump value is given, today's date
  32.                     is bumped.
  33.  
  34. caldate.csh        Print the date corresponding to a given Julian day.
  35.  
  36. calendar.csh    A C shell script for printing out the calendar for any
  37.                     given month, highlighting the current date.  If no date
  38.                     is given, this month's calendar is printed.
  39.  
  40. colors.csh        Instructions and examples on customizing the screen colors.
  41.  
  42. deltaday.csh    Print the number of days separating two dates.  If only
  43.                     one date is given, the difference between it and today's date
  44.                     is returned.
  45.  
  46. dumpenv.c        This C program writes out the environment it's passed in
  47.                     the form of setenv commands.  If you're installing Hamilton
  48.                     C shell for the first time, dumpenv is a convenient way to
  49.                     snapshot the environmental variables you've been using with
  50.                     cmd.exe in a form you can append to your login.csh file.
  51.  
  52. duplicat.csh    Look for duplicate files anywhere in a directory tree.
  53.  
  54. easter.csh        A C shell script that calculates when Easter will occur in
  55.                     any given year.  If no year is given, the current year is
  56.                     assumed.
  57.  
  58. factor.csh        The simple factor C shell script shown in the User Guide.
  59.                     Intended to show examples of recursion, expressions, and
  60.                     a self-loading procedure.
  61.  
  62. finance.csh        Another C shell script showing expression evalution.  This
  63.                     defines a number of routines for calculating financial
  64.                     conversion factors, e.g., from present to future value.
  65.  
  66. getprio.c        This C program retrieves and prints its scheduling priority,
  67.                     demonstrating the effect of using the eval command to run
  68.                     a command at a higher or lower priority.  Try these examples:
  69.  
  70.                         % getprio
  71.                         % eval -i getprio
  72.                         % eval +20 (getprio; eval +20 getprio; getprio); getprio
  73.  
  74. julian.csh        Calculate the Julian day number (number of days since January 1,
  75.                     4713 BC) for any given date.  If you don't give a date, it
  76.                     uses today's date.
  77.  
  78. makecpgm.csh    A simple C shell script showing how a "make" function might
  79.                     be written in the C shell language.  This one rebuilds any
  80.                     .exe files in the current directory that are older than the
  81.                     corresponding .c file or any of the .h files.
  82.  
  83. mcvisa.csh        A simple C shell script that constructs a special checksum
  84.                     of a credit card number to tell if the card number is
  85.                     plausible or not.  The checksum used is designed to catch
  86.                     transposed or incorrect digits.  Try it on the cards in
  87.                     your wallet.
  88.  
  89. member.csh        Test whether the first argument word appears somewhere in the
  90.                     list given by the second argument.
  91.  
  92. myecho.c            A variation on the builtin echo command that prints its
  93.                     *argv[] (argument) list with quotes around each word it's
  94.                     passed and tells the total character count.  Try these
  95.                     examples:
  96.  
  97.                         % myecho now     is the
  98.                         % myecho "now     is" the
  99.                         % myecho `ls`
  100.                         % myecho `echo`
  101.                         % myecho `echo hello`
  102.                         % myecho * *\* *\*\* | more
  103.  
  104. newfiles.csh    List all the files or directories in the current directory
  105.                     that do not occur in the specified directory.
  106.  
  107. postage.csh        Calculate the U.S. first class postage required for a
  108.                     given weight in ounces.
  109.  
  110. rcode.c            A trivial C program that just prints, then exits with the
  111.                     return code value you pass it.  You can use this routine to
  112.                     see how the status variable is set and also, how the ";",
  113.                     "||" and "&&" statement connectors work.  Try these examples:
  114.  
  115.                         % rcode
  116.                         % calc status
  117.                         % rcode 1
  118.                         % calc status
  119.                         % echo $status
  120.                         % echo status
  121.                         % rcode 2
  122.                         % calc status
  123.                         % rcode 0 || rcode 1
  124.                         % rcode 1 || rcode 2
  125.                         % rcode 0 && rcode 1
  126.                         % rcode 1 && rcode 2
  127.                         % rcode 0 ;  rcode 1
  128.                         % rcode 1 ;  rcode 2
  129.  
  130. sh_2_csh.csh    A script for converting Bourne or Korn shell scripts into
  131.                     Hamilton C shell scripts using a set of sed scripts contained
  132.                     in the sh_2_csh directory.
  133.  
  134. sizeof.csh        A C shell script that calculates the total disk space used
  135.                     by whatever files or directories are given as arguments.
  136.                     
  137. ts.csh            A C shell script that searches for occurrences of a simple
  138.                     string in all the files with a given extension anywhere in
  139.                     a directory tree.
  140.  
  141. viopaste.c        A short C program to enable pasting into a Presentation
  142.                     Manager text window under OS/2 1.2 or 1.3.
  143.  
  144. weekday.csh        Print the day of the week corresponding to any given date.
  145.