home *** CD-ROM | disk | FTP | other *** search
/ Amiga Elysian Archive / AmigaElysianArchive.iso / newc_dev / newlist6.lzh / NewList6 / NewList.doc < prev    next >
Text File  |  1991-12-18  |  29KB  |  639 lines
  1.  
  2.                                  NewList 6
  3.                           (too good to be GNUlist!)
  4.                                      by
  5.  
  6.                                  Phil Dietz
  7.                                  PO Box 306
  8.                               Yutan, Nebraska
  9.                                    68073
  10.  
  11.                                  18-Dec-91
  12.  
  13.  
  14.  
  15.       This is TuitionWare.  Send some bucks to help me get through college.
  16.     It's only a buck.  It's not like $35.00 that some dingos ask for.
  17.     
  18.     "What!  You expect Jack Radigan to send FREE updates for a measly
  19.        $35.00 ShareWare Fee!  You have to be kidding!"-- many USENET posters
  20.  
  21.     Forget Jack.  I care for my customers.  No matter how much you give,
  22.     no matter how far away you live, I'll send you updates!  I ain't no
  23.     fogey stogey author getting rich.  BTW (by the way), I think Jack
  24.     is going to be on "Life Styles of the Rich and Famous" next month.
  25.     With this release, all patrons have received 2 different versions 
  26.     in the mail (6 different countries!).  Sure, some only sent a 
  27.     buck but who cares! (I'm going for the Best Shareware Author
  28.     Award :-)
  29.  
  30.                SUBLIMINAL HINT:    B     U     C     K     S
  31.  
  32.        Oh yeah.  Spread this mother too!  Upload it to your favorite BBS.
  33.     Upload it to GENIE, Compu-Serve, etc.  Offer it to your User Group
  34.     for inclusion.  Spread it like those lamey viruses seem to do.
  35.     NOTE:  all documentation must accompany newlist.  With exception to
  36.            Fred Fish, all commercial PD disk makers must notify me of
  37.            my inclusion (you won't be denied though).
  38.  
  39. What is Newlist?
  40.  
  41.       NewList is "THE" replacement for the CLI commands-- dir, list, 
  42.    ls, lsjr, dr, and all the rest.  Through newlist's development, it
  43.    has been optimized and new features were designed to be their quickest.
  44.    All of the most important features of a 'list' program have been
  45.    put into newlist.  It's configurable, it's very fast, and it has tons
  46.    of commands and options available to please almost everyone.
  47.    Newlist is like having 3 or 4 commands all rolled together
  48.    (with some extras all over the place) in one handy command.
  49.  
  50. Ain't it like LS?
  51.  
  52.        Well sorta.  LS and LS-jr are very good LIST replacements.  They
  53.     are quick and offer UNIX compatibility, but Newlist is JAM PACKED with
  54.     options.  The best of ls, the best of dr, the best of list, and bunches
  55.     of special features are all put in one package.  With NewList, the user
  56.     is given processing power.  You can sort a directory the way YOU want it.
  57.  
  58.        Newlist was designed to be quick and offer all the MEAT commands
  59.     most CLI users need.  From the ground level on up, newlist was
  60.     optimized and new features were designed to be their quickest.
  61.     Fast flexible file manipulation, nice powerful customization,
  62.     and all those extra 'goodies' were melded into one.
  63.  
  64.  
  65. Features of NewList:
  66.  
  67.    1)  It's PURE!  NewList is REALLY quick if it's resident.
  68.    2)  Very fast algorithms.
  69.    3)  Completely dynamic.
  70.    4)  Tons of sorts and filters (name, date, size, as-read, even comments!)
  71.    5)  Full UNIX and AmigaDOS wildcards (n*l*s#? = newlist)
  72.    6)  Character filtering (show files that start with l-s)
  73.    7)  ANSI.
  74.    8)  Fetches console window bounds and adjusts accordingly.
  75.    9)  A slick multi-columnar quick option to utilize screen space.
  76.   10)  ENV: support!
  77.   11)  Date  construction kit with 8 premades (or create your own!)
  78.   12)  Print construction kit with 2 premades (or create your own!)
  79.   13)  Fast non-recursive recursive directories!  (a mouthful ain't it)
  80.   14)  Multiple paths.
  81.   15)  Built-in hunt mode like whereis.
  82.   16)  A Pager.
  83.   17)  Complete link support, detection, and traversal.
  84.   18)  WB2.0 compatible !!!!
  85.   19)  Tons and Tons and Tons O' Flags and Switches!
  86.   20)  Optimized and Optimized!  Every 4 byte saving was found!
  87.  
  88.  
  89. Usage:  NewList ?
  90.  
  91. NewList  6.0  WB2.0 only  by  Phil Dietz  NCEMRSoft
  92. NewList  [FLAGS ie. -sgbi -v] <paths and wildcards>
  93.        o  Overlook ENV:NEWLIST          a  Don't use Today, Yesterday, etc.
  94.    b | k  Display blocks or disk keys   /  Add / to dirs
  95.   d0...7  Eight date/time formats       u  Show DEVICE: usage info
  96.        r  Display list in reverse       n  Display comments
  97.        s  Sort by name                 ss  Sort by file size
  98.  sc | sr  Sort by comment or as-read   sd  Sort by date
  99.  gd | gf  Show ONLY dirs or files      gb  Show BOTH dirs/files grouped
  100.        h  No header                     i  Ignore .info files
  101.       fA  Files start with A           tZ  Files go to Z
  102.        c  CASE sensative with -f -t     z  C= list style directories
  103.        q  Quick option                 qs  Quick option with file sizes
  104.        v  Vertical sort quick columns   p  Page prompt when screen is full
  105.       x#  Max # dir-levels to enter    y#  Use # columns for quick
  106.        S  Show only stat totals         T  No totals
  107.        R  Enter sub-directories         W  Enter with wildcard on ALL levels
  108.        H  Hunt for files on disk        Q  No system requesters
  109.        J  Do not follow links
  110.    L | l  dd-mmm-yy or #  Files made before/after date or # days ago
  111.       df  Custom date  format " %y %m %d %h %n %s %i %t %T \nte' "
  112.    E | F  Custom print format " %p %U %d %b %k %s %v %c %C %N %n %P \nte' "
  113.  
  114.  
  115. FLAGS IN DEPTH:
  116.  
  117.    Note:  All these flags are compatible with WB2.0 version.  
  118.           WB1.3 version will be missing a few commands.
  119.           Please see history and/or 1.3 newlist usage for further help.
  120.  
  121.    [-o]   When you want to OVERLOOK the ENV:NEWLIST variable.  Using
  122.           [-o] (or any another overriding flag) yields the normal
  123.           print-as-being-read format.  This print-as-being-read format
  124.           can be helpful for checking what order some programs will
  125.           process files ['GIFFY' displays GIFs in this order]
  126.  
  127.    [-a]   Forgets about the TODAY, YESTERDAY, bologna.
  128.  
  129. [-b] [-k] Instead of the default display of filesize, newlist will
  130.           instead display BLOCKS or DISKKEYS respectively.
  131.  
  132.    [-/]   Append a slash '/' to directories and a '>' to links.  
  133.           Output is similar to NeXT Unix, A/UX, and dr.
  134.           The link sign '>' will only be printed in [-q] mode.
  135.           Oh yeah, I think the '@' is an ugly motha so I switched to the '>'
  136.           Note: newlist wb1.3 version does not handle links very well.
  137.                 As a result, bad soft links will not be detected
  138.                 so they will appear to be dir links.
  139.           
  140. [-d0...7] Eight different pre-made date formats ranging from the
  141.           fully expanded 1st grade letterhead (Friday, November 9, 1991,
  142.           05:30:24 PM), to the default LIST format, to Euro-Styles to slashes,
  143.           dots and dashes, to DateStamp values (Handy for programmers!).
  144.  
  145.   [-df]   Allows you to create your own Date format.  
  146.           The format is -df "DATE STRING".  Here are the flags available:
  147.  
  148.                %y -  year  as 2 digits  (90)
  149.                %Y -  year  as 4 digits  (1991)
  150.                %m -  month as 2 digits  (07)
  151.                %M -  month name         ("January".."December")
  152.              %.3M -  abbreviated month  ("Jan".."Dec")
  153.                %d -  day of month       (1-31)
  154.                %D -  day name           ("Monday".."Sunday")
  155.              %.3D -  abbreviated day    ("Mon".."Sun")
  156.                %h -  hour in twenty-four hour notation
  157.                %H -  hour in twelve hour notation
  158.                %i -  12 hour indicator for H notation (AM or PM)
  159.                %n -  minutes
  160.                %s -  seconds
  161.                %t -  prints TODAY, YESTERDAY, or Day name if applicable
  162.                %T -  Two must be present.  Mark off block which will be
  163.                      substituted with Today, Yesterday, if applicable.
  164.                      If not applicable, it will process the inner block.
  165.                      (ie  -df "Date: %T%3M %2d%T" will sometimes print
  166.                      Date: Today  or  Date: Mar 16)
  167.    \n, \t, \e, \' -  Newline, tab, escape key, or quote ".  \e can be used 
  168.                       to make neat ANSI sequences.  See aliases 'color'.
  169.  
  170.                        Make a C string like printf.
  171.                -df "Date: %02d-%3.3M-%02y at %02h:02n:02s" 
  172.  
  173.                                 yields
  174.                       Date: 09-Nov-91 at 01:03:20
  175.  
  176.                        It's Easy.  It adds spice.
  177.  
  178.   [-r]    Displays a list in REVERSE from top to bottom.  WHY?  
  179.           Instead of waiting for the whole list to scroll by to see a
  180.           file at the bottom, you can reverse the list and ctrl-c to
  181.           stop quick!  It's also handy when sorting by date.  All of
  182.           the newest files will be displayed first.
  183.  
  184.    [-s]   Sorts files alphabetically.
  185.  
  186.   [-ss]   Sorts files by file size (or blocks [-b]).
  187.  
  188.   [-sd]   Sorts files by time (date of creation).  Very handy!!
  189.  
  190.   [-sc]   Sorts files by comments.  If you use FileNotes wisely, you can
  191.           have your directories be grouped by file type.  Simply
  192.           add a filenote to each file and give it a type (Picture, GIF,
  193.           Utility, NoiseTracker, etc.)  Now when you view by [-sc],
  194.           the files will be grouped together by type!  You can also use
  195.           the included alias 'dirtype' which will display the filetype 
  196.           in a nice position.
  197.  
  198.   [-sr]   Sorts files as-read (actually as hashed), but fully buffered.
  199.           To sort by diskkey use [-sr -k].
  200.  
  201. [-gd|-gf] Groups the display so ONLY dirs or ONLY files are shown
  202.           respectively. Similar to 'dir dirs' or 'dir files'
  203.  
  204.   [-gb]   Shows BOTH directories and files, all dirs then all files.
  205.           [-v] may now be used in conjunction.  Output is similar to DIR.
  206.  
  207.    [-u]   Shows bytes FREE and bytes USED on disk.  Now you can get
  208.           all your needed info with one command instead of a "dir
  209.           list info" combo.  Note: due to RAM:'s variable size,
  210.           the bytes free will be zero.  Also note: sometimes the
  211.           size is off....I don't know why, but be aware.
  212.  
  213.    [-n]   Do you hate seeing those huge FILENOTES destroying your
  214.           directory list?  This flag will toggle if you want to see them.
  215.           If not present, a simple "Comment" or "c" will be shown to tell
  216.           you "hey mister, you can read me if you wanna."
  217.  
  218.    [-h]   Doesn't display the header file.....ohhhhh.....big deal!
  219.           Well it does seem out of place in the -q quick directory, so
  220.           it might help.  Another LIST option (holy cow!)
  221.           If you are auto-executing [-E] a format, [-h] will turn off
  222.           the verbose output.
  223.  
  224.   [-fA]   The MINIMUM letter for the filter.  Let's say you only want to
  225.           view files greater than or equal to t.  Just set -ft.  Very
  226.           handy for printing lists where you left off.
  227.           Remember -f as FROM A
  228.  
  229.   [-tZ]   The MAXIMUM letter for the filter.  Only files less than or equal
  230.           to the letter will be shown.  To see files h through l 
  231.           Just set   -fh -tl.
  232.           Remember -t as TO Z
  233.  
  234.    [-c]   When using the letter filters [-f -t], this flag will also take 
  235.           into affect the CASE of the filter letter.  So now only upper or
  236.           only lower case files can be displayed.
  237.  
  238.           NOTE: [-fA] or [-tZ] MUST be set to an alphabetic character
  239.                 to utilize case sensativity!  The default letters are
  240.                 1 and 255, so [-c] will not work unless you change 
  241.                 one of them to an alphabet letter!
  242.                 If you give both [-f and -t], it will use -f's case.
  243.  
  244.    [-i]   Ignore *.info files!
  245.  
  246.    [-l]   dd-MMM-yy or # days
  247.           Show files made in the last # days or files made since dd-MMM-yy.
  248.           Suppose today is Sat 10-Nov-91 and you want to see files made
  249.           yesterday.  You can enter these:
  250.  
  251.           nl -l 1     nl -l 09-Nov-91   nl -l Friday   nl -l yesterday
  252.  
  253.           Note how you can enter the # of days, the date, the day name 
  254.           (Friday, Saturday, etc.), or today, yesterday, etc., to represent
  255.           the same thing!  Using my program Envoy, you may also enter
  256.  
  257.                                nl -l Freitag     (German for Friday)
  258.  
  259.           Day names like Friday represent 'last Friday' not
  260.           'this coming Friday.'
  261.  
  262.    [-L]   dd-MMM-yy or # days
  263.           Show files made before # days ago or files made before dd-MMM-yy.
  264.           See above [-l] for examples of usage.
  265.  
  266.  [-y #]   Force # columns for [-q] quick option.  Use this option when
  267.           re-directing the output to a WIDE printer.  ie. to utilize a
  268.           printer with 20 pitch type, use  nl >prt: -q -y 9 dh0:
  269.  
  270.    [-q]   Gives a QUICK and easy listing of the directory.  The entire
  271.           screen will be utilized and multi-columns will be created.
  272.           Names will be white, and directories will be another color.
  273.           Because of its simplicity, not all of the flags are usuable.
  274.           (like -df etc.)
  275.  
  276.   [-qs]   Quick option WITH file-sizes!  A very very handy option very
  277.           similar to DIR opt s, but with multi-columns.  Note: if you'd
  278.           rather see blocks or keys instead, add -b or -k (ie nl -qs -b)
  279.  
  280.    [-v]   Vertical sort the [-q] and [-qs] outputs.  Vertical sort
  281.           now works properly with [-gb] group both option.  Giving
  282.           [-v] all by itsself means [-q -v].
  283.  
  284.    [-E]   Execute print format immediately.  This will prevent
  285.           unnecessary script files from being generated.  For example:
  286.  
  287.                    nl dh0:iff/sounds/* -E "sound %P"
  288.                 will play all sounds in dh0:iff/sounds.
  289.  
  290.                nl -H -l 1 -E "copy %P to backupdisk:" dh0:
  291.              will copy all files made in the last day on dh0:
  292.                           to your backupdisk:.
  293.  
  294.           If you want to copy or move files, etc. with spaces in them
  295.           ("Read Me"), you should pad the filename with quotes so
  296.           Amiga will run it properly.  (ie nl -E "copy \'%P\'" )
  297.                                                        ^   ^
  298.                                                     Quote Characters
  299.  
  300.           By default, -E prints in verbose mode (prints Executing xxx....)
  301.           To turn it off, turn off the header with [-h] flag.
  302.           
  303.           WB2.0 version will allow interactive input and output with
  304.           CLI programs so you can "delete %P ASK" or whatever.  WB1.3
  305.           version DOES NOT!
  306.  
  307.    [-F]   Allows designing of custom print format.  Now you can design the
  308.           way YOU want the output to be.  Here are the flags supported:
  309.  
  310.                %b  -  block size
  311.                %c  -  micro-comment 'c' if filenote available
  312.                %C  -  'Comment' if filenote available
  313.                %d  -  Date (this date can be constructed with -df!)
  314.                %k  -  disk key
  315.                %n  -  file name
  316.              %.5n  -  file name truncated to 5 chars
  317.                %N  -  filenote
  318.                %p  -  show protection bits
  319.                %P  -  file name with complete path
  320.                %s  -  file size
  321.                %v  -  variable output.  Depends if [-b] [-k] or [none]
  322.                        are used.
  323.                %U  -  UNIX protection bits.  Adds d for dirs and l for links
  324.                        Routine distinguishes directory and file links.
  325.                %L  -  Prints expanded link names in the form
  326.                        " -> Full-path-of-file".  Soft Links that have
  327.                        their link not mounted will be displayed as
  328.                        " -> :UNKNOWN FILE:"
  329.                       
  330.    \n, \t, \e, \'  -  Add newline, tab, escape charater, or quote ".  These 
  331.                       sequences may be used to create neat ANSI stuff.  Check
  332.                       out 'color' in the file 'aliases'.  \' is very useful
  333.                       when filenames you are manipulating contain spaces.
  334.                       It you put \' around the name ( \'%n\' ) most DOS
  335.                       commands will now recognize the file.
  336.  
  337.                       Here is a UNIX ls format example
  338.              -F " %U %c %4b  %7s %d %n" -df "%M %2d %02h:%02n"
  339.  
  340.           Custom print formats also allow easy batch script making!
  341.           This format will make a script file test.script that will
  342.                    copy all *.c files in current dir to ram:
  343.  
  344.                    nl >test.script -F "copy \'%n\' to ram:" *.c
  345.  
  346.           This format will make a script file test.script that will
  347.                 copy ALL files made in the last 2 days to df1: 
  348.  
  349.                    nl >test.script -l 2 -H -F "copy \'%P\' to df1:" *
  350.  
  351.                    So ya still like LS?  Take off, ya hoser.
  352.          
  353.    [-p]   Turns on pagnation.  When each the screen fills, a prompt
  354.           will be put up so you can read all the files before they fly by!
  355.           The prompt contains the current grand totals as well as
  356.           some neat inverse video effects.  Press return to continue.
  357.           To break the list enter q or quit or
  358.           quintessential-list-replacement.....anything with a q. :-)
  359.           To make the list non-stop, enter n.
  360.  
  361.           If you re-direct the output of newlist, paging will be turned off.
  362.  
  363.  
  364.    [-R]   Recursion.  This will enter subdirectories, print info, enter
  365.           the subdirectories in the subdirectories etc.  It's similar
  366.           dir opt all.
  367.  
  368.              nl -R FF:n*   will show complete listings of dirs that
  369.                            start with n.
  370.  
  371.           There are 3 different types of recursion available.  Mostly they
  372.           affect how the wildcard will be applied.  Here's how they work:
  373.                      ie   nl [-R|-H|-W] dh0:c*    will list
  374.  
  375.                use [-R]                           use [-H]
  376.              candy/snickers (dir)               candy/chocolate (dir)
  377.               Cars/datsun                        cars/cadillac
  378.               Cars/cadillac                    drinks/coffee
  379.               Cars/yugo                        lemons/cray-computer
  380.  
  381.  (all files in dirs starting with c)(all files starting with c in all dirs)
  382.  
  383.                                  use [-W]
  384.                               candy/chocolate (dir)
  385.                                cars/cadillac
  386.  
  387.             (All files starting with c in dirs starting with c)
  388.  
  389.  
  390.           [-R] uses the wildcard only on the first level.  All files
  391.                and subdirectories after that will be displayed.
  392.           [-W] uses the wildcard on all levels.  Only files and directories
  393.                matching the wildcard will be shown/entered.
  394.           [-H] enters every single directory no matter the wildacard,
  395.                and will only print info that matches the wildcard.
  396.  
  397.    [-W]   Will exclusively use wildcard to match files and sub-directories
  398.           on EVERY level.  Default mode for [-R] is to use wildards only 
  399.           on the root level.  Now ONLY files matching wildcard will be shown
  400.           and ONLY subdirectories matching wildcard will be entered.
  401.  
  402.           [-W] is the method that ls uses- enter only dirs matching pat
  403.  
  404.    [-H]   Hunt files down.  Will recursively enter subdirectories, but 
  405.           will enter all directories regardless of wildcards, etc.  Why?
  406.           Now let's say you want a list of all 'c' files on your harddisk.
  407.  
  408.                            Simply  nl -H dh0:*.c
  409.  
  410.           Besides matching wildcards, [-H] will also accept the other
  411.           conditional flags (like -f -i -l etc.)
  412.           Now you can list all capitalized *.info files on your harddisk...
  413.  
  414.                          nl -H -fA -c dh0:*.info
  415.  
  416.           Now you can view all files made since yesterday....
  417.  
  418.                              nl -H -l yesterday dh0:
  419.  
  420.           [-H] enters every directory it finds (up to -x #) levels and
  421.           tries to match corresponding files and dirs.
  422.  
  423.           Hunt mode will now match both files and directories.  If you
  424.           want to see only matching files, use [-gf] with it.
  425.  
  426.    [-J]   Jump links.  Newlist will not enter or follow links when in
  427.           recursion mode.  Works in conjunction with -R, -W, or -H.
  428.  
  429.  [-x #]   Only enter # subdirectory levels in recursion mode.  Otherwise it 
  430.           will enter every sub-directory it will find.  Use with [-R, -W, -H]
  431.           Root level only is [-x 0].
  432.  
  433.    [-S]   Stats only option.  Only prints totals for each directory.
  434.           All newlist filters (*.c -fA etc.) will still affect the results.
  435.  
  436.    [-T]   Don't show totals.
  437.   
  438.    [-A]   Include Assign Add's.  WB2.0 allows multiple assigns to a name
  439.           (ie many font dirs point to fonts:)  This option will have newlist
  440.           fetch all the different assign paths and view them.  Wild
  441.           cards, recursion, and multiple ASSIGN: paths will still work 100%.
  442.                  
  443.  <paths>  the directories to view.  You can view as many directories at once
  444.           as you like.  Simply add it's path and wildcard.  
  445.  
  446.           Important points:
  447.  
  448.           + Both Amiga and UNIX wildcards are supported (1.3 ver. only UNIX)
  449.             To use a wildcard simply add it right after the path.
  450.  
  451.           + The wildcard MUST be connected to the path.  If you say
  452.                                nl dh0: *.c
  453.             NewList will think you want a dir of dh0: AND a dir of
  454.             files matching *.c in the current directory.
  455.  
  456.           + Each new path may have a totally different wildcard
  457.  
  458.                     nl *.doc ram:*.c df0:*.lzh c:d?r df0:
  459.                          ^               ^             ^
  460.                    just wildcard        both       just path
  461.                   (assume current                 (assume * as
  462.                      directory)                     wildcard)
  463.  
  464.           + Paths will be entered by newlist from right to left.
  465.             
  466.           + The Amiga currentdir character "" may not always work.
  467.             An alternative is to have a single wild card, *.
  468.             nl * vdk:  will list vdk: then the current directory.
  469.  
  470.           + All of the flags and paths can be used in ANY order.  
  471.             nl dh0:*.c -s -r df1:*.o  =  nl -r dh0:*.c df1:*.o -s
  472.  
  473.           + Flags may be joined together:  nl -rsgbi  
  474.                                seperated:  nl -r -s -gb -i
  475.                                  or both:  nl -rs -gbi
  476.  
  477.           + "nl ?" brings up the help message.  To use '?' as a wildcard
  478.              add a space ' ' or a flag or path before the '?'.
  479.  
  480.                     ie   "nl ? "  or  "nl ? -s"  or  "nl dh0:?"
  481.  
  482.           + All of the flags can be used together (-q has exceptions):
  483.             You can view a directory through a case sensative character
  484.             filter, of files made in the last 2 weeks, sorted by date
  485.             in reverse order, showing block size , with a custom 
  486.             dateformat string, custom print string, hiding .info files,
  487.             paging, using a UNIX wildcard, etc. etc.
  488.  
  489.  
  490. Support for WB2.0 Links:
  491.  
  492.       NewList has complete support for WB2.0's new link format.
  493.       NewList has the BEST link support available.  This complete support 
  494.       includes:
  495.  
  496.         1) Both hard and soft links are supported.
  497.  
  498.         2) Links will be shown VIA the UNIX style protection bits.
  499.  
  500.                 ie   dH----rwed   and   -H----rwed
  501.                      ^(dir link)        ^(file link)
  502.  
  503.            depending if they point to a directory or a file.  Hard
  504.            and soft links will also be shown by the bits H and S
  505.                               after the d
  506.  
  507.                 ie   dH----rwed   and   -S----rwed
  508.                       ^(hard link)       ^(soft link)
  509.  
  510.         3) Link names can be fully expanded to tell where they point to!
  511.                           link -> dh0:source/tdraw
  512.  
  513.         4) Soft links will be distinguished as being dir links or file links.
  514.            Thus, softlinks will be transparently identical to hard links.
  515.            (softlinks do not tell if they point to a file or a dir.  NewList
  516.             will find out for itsself.)
  517.  
  518.         5) Intelligent link traversals.  All 3 recursion modes will allow
  519.            link traversals.  A special method is used to prevent
  520.            circular directories and back-links.  A directory will ONLY
  521.            be shown once.  If a link wants to show it again, it will be
  522.            ignored.
  523.  
  524.         6) Bad soft links or links that can't be resolved will be 
  525.                       detected and have the value:
  526.                         link -> :UNKNOWN FILE:
  527.  
  528.         7) [-/] will display links with a trailing >.  Dir links
  529.            will be color3 while file links will be color1 (use -gb to
  530.            easily separate the two).
  531.  
  532.         8) Soft links that are not mounted will have a ! in front of
  533.            them.    ie.   link -> !df1:myfile
  534.  
  535.         9) Recursive modes [-R -W -H] by default will traverse links.
  536.            If you wish for them not to be traversed, give [-J] jump option.
  537.  
  538.        10) Better link utilities are given in my LinkSupport package.
  539.            A new 'makelink' utility that supports soft link generation
  540.            and a 'deletelink' utility to erase them are included.  They
  541.            include full 'C' source.
  542.  
  543. Environment Variable Support:
  544.  
  545.       ENV: variables are now supported.  Now long customized argument 
  546.    lists can be spared!  The variable ENV:NEWLIST contains any flags
  547.    you want to be default and have automagically set upon running NewList.
  548.    To utilize the ENV: support, use 'ed' and create ENV:NEWLIST by 
  549.    typing in the flags you want to have default (ie. -r -sd). Easy.
  550.  
  551.       With ENV: comes a diminished return.  Now if you want the standard
  552.    'list' type display (files out of order and displayed as they are read),
  553.    then the [-o] option must be used.
  554.   
  555.    NOTE1: to override the ENV:NEWLIST, you can enter [-o] or you can type
  556.           any different flag.  Suppose  ENV:NEWLIST is "-r -sd -d3",
  557.           to sort by size:    nl -o -ss    or simply    nl -ss
  558.  
  559.    NOTE2: the variable is called ENV:NEWLIST not ENV:nl!
  560.  
  561.  
  562. Easier Way to Create ENV: Variables:
  563.  
  564.      Make sure ENV: is assigned to a permanent directory.  Now use the 
  565.    Commodore supplied command setenv.  Here is my ENV:newlist setting:
  566.  
  567.                     setenv  NEWLIST  "-sd -u -i -gb -Q"
  568.          or better  setenv  NEWLIST  "-sduigbQ"
  569.  
  570. Tired of ENV: not being read?
  571.  
  572.       Do you want to add just one more flag to ENV: (like -i or -p), but 
  573.     find out that ENV: is ignored all together?  The solution is to create
  574.     aliases.  Aliases will guarentee that certain flags will be set no matter
  575.     what "extras" you give it.  I have included some basic ones in the file,
  576.     'Aliases'.  Append it to s:Shell-Startup.  Now when you want to add
  577.     paging and list reversal to an ls-style dir, enter ls -p -r.
  578.     
  579.     NOTE: you will not be able to get help from an alias [mrdir ?].  You
  580.           must call 'nl ?' instead of mrdir ?.
  581.  
  582.  
  583. -----------------------
  584. WB2.0 tip O' the day 1:
  585. -----------------------
  586.  
  587.       Do you miss the really fast scroll displays of wb1.3?  I've found
  588.     a way to get them back!  You can open a shell that disables the
  589.     super-auto-refresh to increase scrolling speed by 20%!  
  590.     Do the following to open a WB1.3 style fast shell:
  591.  
  592.         newshell CON:0/0/640/200/PhilDOS/CLOSE/SMART
  593.                                                  ^
  594.                                                this is the secret!
  595.  
  596. -----------------------
  597. WB2.0 tip O' the day 2:
  598. -----------------------
  599.  
  600.       Wish your shell had more than 80 columns?  Now you can use any size
  601.    font with WB2.0's neat new command setfont.  Try this out:
  602.  
  603.            setfont topaz 7 scale  and   setfont topaz 20 scale
  604.                              ^
  605.                            this is the secret!
  606.  
  607.       NewList will recognize the new font and will adjust its output!
  608.    Try the 7 point font and nl -v -gb.  Cool huh!
  609.  
  610.  
  611. ~~~~~~~~~~~~~~~~
  612.  
  613. Comments:  First off.  Rename newlist to nl (for newlist), stick it in
  614.            your c: directory, and PURE it (protect c:nl prwed). People use 
  615.            names that are short and you know that you want to type nl 
  616.            instead of newlist.
  617.  
  618.            Now edit your Startup-Sequence to make nl RESIDENT upon bootup.
  619.            (add  RESIDENT c:nl PURE ADD or ARES c:nl, depending if you use 
  620.            Workbench or ARP)
  621.  
  622.            Use setenv ENV:NEWLIST "flags" to set your default flags.
  623.  
  624.            Enjoy.  Keep in mind: this is a super useful tool!  A tool that
  625.                    costs only a few dollars.  It's like one of those 1001
  626.                    in 1 cooking tools.  "Flip the lever, and now it makes
  627.                    julienne style potatoes! [clap....clap]  You get the
  628.                    slicer, the dicer, the juicer, and turkey jerky maker
  629.                    for only $49.95!  But wait there's more......"
  630.                    Oh my....I've lost my mind :-) 
  631.  
  632.            Bare with me if Newlist doesn't like your set-up.  Please
  633.            write me if you encounter any bugs or heinous crashes.
  634.  
  635.                        Phil Dietz -- NCEMRSoft
  636.                        PO Box 306             
  637.                        Yutan, Nebraska 68073  
  638.                        USA                    
  639.