home *** CD-ROM | disk | FTP | other *** search
/ Frozen Fish 1: Amiga / FrozenFish-Apr94.iso / bbs / alib / d5xx / d501 / newlist.lha / NewList / NewList.doc < prev    next >
Text File  |  1991-06-27  |  19KB  |  411 lines
  1.  
  2.                               NewList 5.0
  3.                        (to good to be GNUlist!)
  4.                                   by
  5.  
  6.                               Phil Dietz
  7.                               PO Box 306
  8.                            Yutan, Nebraska
  9.                                 68073
  10.  
  11.                               24-May-91
  12.  
  13.       This is TuitionWare.  Send some bucks to help me get through college.
  14.     (It's only a buck.  It's not like $35.00 that some dingos ask for.
  15.     
  16.     "What!  You expect Jack Radigen to send FREE updates for a measly
  17.        $35.00!  You have to be kidding!"  -- many USENET posters
  18.  
  19.     Forget them.  I care for my customers.  No matter how much you give,
  20.     no matter how far away you live, I'll send you updates!  I ain't no
  21.     fogey stogey author getting rich.
  22.     
  23.     SUBLIMINAL HINT:    B     U     C     K    S
  24.  
  25.        Oh yeah.  Spread this mother too!  Upload it to your favortie BBS.
  26.     Upload it to GENIE, Compu-Serve, etc.  Offer it to your User Group
  27.     for inclusion.  Spread it like those lamey viruses seem to do.
  28.     NOTE:  all documentation must accompany newlist.  With exception to
  29.            Fred Fish, all commercial PD disk makers must notify me of
  30.            my inclusion (you won't be denied though)
  31.  
  32. What is Newlist?
  33.  
  34.        AmigaDOS is great.  It not only allows you to manipulate files
  35.     graphically VIA workbench, but it also allows you to manipulate
  36.     files on a command line basis.  Commodore utilized the command
  37.     line interface by offering powerful commands to help the user
  38.     do what he wants to do.  One of the handiest is LIST.  It not only
  39.     gives a directory listing of names, but also offers filesizes, file
  40.     protection, and file creation.
  41.    
  42.        But LIST isn't perfect.  It doesn't offer much sorting.  It doesn't
  43.     offer much customization.  It doesn't allow name filters, so
  44.     immense directories HAVE TO BE shown.  TRUE, LIST is small, but
  45.     sometimes POWER comes first.
  46.  
  47. What does that mean?
  48.  
  49.        NewList offers the SPEED of list, and the POWER of a database.
  50.     Now directories can be sorted not only by name, but also by size or
  51.     date.  Now directories can be sorted through an alphabet filter
  52.     so only certain files will be shown (like D through G).  A quick
  53.     option has been added to utilize the screen space, so no more
  54.     2 column output by MR. dir.  Are you tired of the date format?
  55.     Want to customize your print format?  Now you can create your own!
  56.  
  57. Ain't it like LS?
  58.  
  59.        Well sorta.  LS and LS-jr are very good LIST replacements.  They
  60.     are quick and offer UNIX compatibility.  Newlist is JAM PACKED with
  61.     options.  With NewList, the user is given processing power.  You can
  62.     sort a directory the way YOU want it.  
  63.  
  64.        Newlist was designed to be quick and offer all the MEAT commands
  65.     most CLI users need.  From the ground level on up, newlist was
  66.     optimized and new features were designed to be their quickest.
  67.     Fast flexible file manipulation, nice powerful customization,
  68.     and all those extra 'goodies' were melded into one.
  69.  
  70.  
  71. Features of NewList:
  72.  
  73.    1)  It's PURE!  NewList is REALLY quick if it's resident.
  74.    2)  Very fast algorithms.
  75.    3)  Completely dynamic.
  76.    4)  Tons of sorts and filters (including the needed BY DATE!)
  77.    5)  Full UNIX WILDCARDs (n*l*s? = newlist) and character filtering.
  78.    6)  ANSI.
  79.    7)  a slick multi-columnar quick option to utilize screen space.
  80.    8)  ENV: support!
  81.    9)  A slick date construction kit with 8 premades.
  82.   10)  Print construction kit with 2 premades (ls-jr and list)
  83.   12)  Fast non-recursive recursive directories!  (a mouthful ain't it)
  84.   13)  Multiple paths.
  85.   14)  A hunt mode.
  86.   15)  Tons and Tons and Tons O' Flags and Switches!
  87.  
  88.  
  89. Usage:  NewList ?
  90.  
  91. NewList  5.0  by  Phil Dietz  NCEMRSoft
  92. NewList [FLAGS ie. -q -v] <paths and UNIX wildcards>
  93.  
  94.        o  Overlook ENV:NEWLIST          a  Don't use Today, Yesterday, etc.
  95.        b  Display blocks                k  Display diskkeys
  96.   d0...7  Eight date/time formats      df  "string" Custom date.  See docs
  97.        r  Display list in reverse       n  Display comments
  98.        s  Sort by name                 ss  Sort by file size
  99.       sd  Sort by date                 sc  Sort by comment
  100.        h  No header                     i  Ignore .info files
  101.       gd  Show ONLY dirs               gf  Show ONLY files
  102.       gb  Show BOTH dirs/files grouped  u  Show DEVICE: usage info
  103.       fA  Files start with A           tZ  Files go to Z
  104.        c  CASE sensative with -f -t     z  C= list style directories
  105.        q  Quick option                 qs  Quick option with file sizes
  106.        v  Vertical sort quick columns   p  Page prompt when screen is full
  107.      y #  Use # columns for quick     l #  Show files made in last # days
  108.      x #  Max # dir-levels to enter     T  No totals
  109.        R  Enter sub-directories         W  Enter uses wildcard on ALL levels
  110.        H  Hunt for files on disk        Q  No system requesters
  111.        F  Custom format string " %p %U %d %b %k %s %v %c %C %N %n %P \nte "
  112.  
  113. NOTE:  each flag must have a - identifier.  ie  -q -sd -i -z -l 20 -F "%P"
  114.  
  115.  
  116. FLAGS IN DEPTH:
  117.  
  118.    [-o]   When you want to OVERLOOK the ENV:NEWLIST variable.  Using
  119.           [-o] (or any another overriding flag) yields the normal
  120.           print-as-being-read format.  This print-as-being-read format
  121.           can be helpful for checking what order some programs will
  122.           process files ['GIFFY' displays GIFs in this order]
  123.  
  124.    [-a]   Forgets about the TODAY, YESTERDAY, bologna.
  125.  
  126. [-b] [-k] Instead of the default display of filesize, newlist will
  127.           instead display BLOCKS or DISKKEYS respectively.
  128.  
  129. [-d0...7] Eight different pre-made date formats ranging from the
  130.           fully expanded 1st grade letterhead (Friday, November 9, 1990,
  131.           05:30:24 PM), to the default LIST format, to Euro-Styles to slashes,
  132.           dots and dashes, to DateStamp values (Handy for programmers!).
  133.  
  134.   [-df]   Allows you to create your own Date format.  The format is
  135.           -df "DATE STRING".  Here are the flags available:
  136.  
  137.             y => year minus 1900
  138.             Y => full year value
  139.             m => month value as integer
  140.             M => month name
  141.             d => day of month (1..31)
  142.             D => day name ("Monday".."Sunday")
  143.             h => hour in twenty-four hour notation
  144.             H => hour in twelve hour notation
  145.             i => 12 hour indicator for H notation (AM or PM)
  146.             I => same as i
  147.             n => minutes    (sorry...conflict with m = months)
  148.             N => same as n
  149.             s => seconds
  150.             S => same as s
  151.             t => prints TODAY, YESTERDAY, or Day of the week if applicable.
  152.                  If the file doesn't fall in the last week, it will be
  153.                  blank.
  154.             T => Two must be present.  Mark off block which will be
  155.                  substituted with today, yesterday, if applicable.
  156.                  If not applicable, it will process the inner block.
  157.                  (ie  -df "Date: %T%3M %2d%T" will sometimes print
  158.                      Date: Today  or  Date: Mar 16)
  159.             Z => Abbreviated Day Name [Mon, Tue, etc.]
  160.    \n, \t, \e => Newline, tab, and escape key.  \e can be used to make
  161.                  neat ANSI sequences.  See aliases 'color'.
  162.  
  163.                        Make a C string like printf.
  164.                -df "Date: %02d-%M-%02y at %02h:02n:02s" 
  165.  
  166.                                 yields
  167.                       Date: 11-Jan-90 at 01:03:20
  168.  
  169.                        It's Easy.  It adds spice.
  170.  
  171.   [-r]    Displays a list in REVERSE from top to bottom.  WHY?  
  172.           Instead of waiting for the whole list to scroll by to see a
  173.           file at the bottom, you can reverse the list and ctrl-c to
  174.           stop quick!  It's also handy when sorting by date.  All of
  175.           the newest files will be displayed first.
  176.  
  177.    [-s]   Sorts files alphabetically.  A synonym is [-sn].
  178.  
  179.   [-ss]   Sorts files by file size (or blocks or keys).
  180.  
  181.   [-sd]   Sorts files by date of creation.  Very handy!!
  182.  
  183.   [-sc]   Sorts files by comments.  If you use FileNotes wisely, you can
  184.           have your directories be grouped by file type.  Simply
  185.           add a filenote to each file and give it a type (Picture, GIF,
  186.           Utility, NoiseTracker, etc.)  Now when you view by [-sc],
  187.           the files will be grouped together by type!  You can also use
  188.           the included alias 'dirtype' which will display the filetype 
  189.           in a nice position.
  190.  
  191. [-gd|-gf] Groups the display so ONLY dirs or ONLY files are shown
  192.           respectively. Similar to 'dir dirs' or 'list dirs'
  193.  
  194.   [-gb]   Shows BOTH directories and files, all dirs then all files.
  195.           Output is similar to DIR.
  196.  
  197.    [-u]   Shows bytes FREE and bytes USED on disk.  Now you can get
  198.           all your needed 'info' with one command instead of a "dir
  199.           list info" combo.  Note: due to RAM:'s variable size,
  200.           the bytes free will be zero.
  201.  
  202.    [-n]   Do you hate seeing those huge FILENOTES destroying your
  203.           directory list?  This flag will toggle if you want to see them.
  204.           If not present, a simple "Comment" or "c" will be shown to tell
  205.           you "hey mister, you can read me if you wanna."
  206.  
  207.    [-h]   Doesn't display the header file.....ohhhhh.....big deal!
  208.           Well it does seem off place in the -q quick directory, so
  209.           it might help.  Another LIST option (holy cow!)
  210.  
  211.    [-c]   When using the letter filters [-f -t], this flag will also take 
  212.           into affect the CASE of the filter letter.  So now only upper or
  213.           only lower case files can be displayed.
  214.  
  215.           NOTE: [-fA] or [-tZ] MUST be set to an alphabetic character
  216.                 to utilize case sensativity!  The default letters are
  217.                 SPACE and , so [-c] will not work unless you change 
  218.                 one of them!
  219.  
  220.   [-fA]   The MINIMUM letter for the filter.  Let's say you only want to
  221.           view files greater than or equal to t.  Just set -ft.  Very
  222.           handy for printing lists where you left off.
  223.           Remember -f as  FROM A
  224.  
  225.   [-tZ]   The MAXIMUM letter for the filter.  Only files less than or equal
  226.           to the letter will be shown.  To see files h through l 
  227.           Just set   -fh -tl.
  228.           Remember -t as TO Z
  229.  
  230.    [-i]   Ignore *.info files!
  231.  
  232.  [-l #]   Show files made in the last # days.
  233.           Now you can view files that were made in the last two weeks
  234.           without viewing a whole directory. (ie nl -l 14)
  235.  
  236.  [-y #]   Force # columns for [-q] quick option.  Use this option when
  237.           re-directing the output to a WIDE printer.  ie. to utilize a
  238.           printer with 20 pitch type, use  nl >prt: -q -y 9 dh0:
  239.  
  240.    [-q]   Gives a QUICK and easy listing of the directory.  The entire
  241.           screen will be utilized and multi-columns will be created.
  242.           Names will be white, and directories will be another color.
  243.           Because of its simplicity, not all of the flags are usuable.
  244.           (like -df etc.)
  245.  
  246.   [-qs]   Quick option WITH file-sizes!  A very very handy option very
  247.           similar to DIR opt s, but with multi-columns.  Note: if you'd
  248.           rather see blocks or keys instead, add -b or -k  (nl -qs -b)
  249.  
  250.    [-F]   Allows designing of custom print format.  Now you can design the
  251.           way YOU want the output to be.  Here are the flags supported:
  252.  
  253.                %b  -  block size
  254.                %c  -  micro-comment 'c' if filenote available
  255.                %C  -  'Comment' if filenote available
  256.                %d  -  Date (this date can be constructed with -df!)
  257.                %k  -  disk key
  258.                %n  -  file name
  259.                %N  -  filenote
  260.                %p  -  show protection bits
  261.                %P  -  file name with complete path
  262.                %s  -  file size
  263.                %v  -  variable output.  Depends if [-b] [-k] or [none]
  264.                        are used.
  265.                %U  -  UNIX protection bits.  Adds d for dirs and l for links
  266.                        Routine distinguishes directory and file links,
  267.                        but not SoftLinks since they can be either!
  268.        \n, \t, \e  -  Add newline, tab, or escape charater.  These sequences
  269.                        may be used to create neat ANSI stuff.  Check out
  270.                        an example in 'aliases'.
  271.  
  272.                       Here is a UNIX ls format example
  273.              -F " %U %c %4b  %7s %d %n" -df "%M %2d %02h:%02n"
  274.  
  275.           Custom print formats also allow easy batch script making!
  276.           This format will make a script file test.script that will
  277.                    copy all *.c files in current dir to ram:
  278.  
  279.                    nl >test.script -F "copy %n to ram:" *.c
  280.  
  281.           This format will make a script file test.script that will
  282.                 copy ALL files made in the last 2 days to df1: 
  283.  
  284.                    nl >test.script -l 2 -R -F "copy %P to df1:" *
  285.  
  286.           So ya still like LS?  Take off, ya hoser.
  287.          
  288.    [-p]   Turns on pagnation.  When each the screen fills, a prompt
  289.           will be put up so you can read all the files before they fly by!
  290.           Press return to continue.  To break the list enter q or quit or
  291.           quintessential-list-replacement.....anything with a q. :-)
  292.  
  293.    [-R]   Now non-recursively enters subdirectories.  What is non-recursive
  294.           recursion?  Simple.  My stack is kept track by me and not by the
  295.           system.  My stack doesn't waste the precious system stack,
  296.           therefore it can handle 4000 bytes.
  297.  
  298.           ie.   nl -R -l 1 dh0:    will show all files made since yesterday!
  299.  
  300.           [-R] should be used when you want to see ALL the contents of
  301.           subdirectories.  It's similiar to OPT ALL on dir.  Note:
  302.           wildcards affect only the root level with [-R] whereas
  303.           wildcards affect EVERY level with hunt mode [-H].
  304.                      ie    nl [-R|-H] dh0:c*    will list
  305.  
  306.                use [-R]                           use [-H]
  307.              candy/snickers                     candy/chocolate
  308.               Cars/datsun                        cars/cadillac
  309.               Cars/cadillac                    drinks/coffee
  310.               Cars/yugo                         stuff/crayons
  311.  
  312.  (all files in dirs starting with c)(only files starting with c in all dirs)
  313.  
  314.    Note:  WB2.0 allows links.  Since I don't have WB2.0 to test them, I
  315.           made newlist not enter linked directories.  As soon as I obtain
  316.           WB2.0, I will add link traversals.
  317.  
  318.    [-W]   Will exclusively use wildcard to match files and sub-directories
  319.           using [-R] mode.  Default mode is to use wildards only on the
  320.           root level.  Now ONLY files matching wildcard will be shown and
  321.           ONLY subdirectories matching wildcard will be entered.
  322.           (Only files starting with c in dirs starting with c)
  323.  
  324.    [-H]   Hunt files down.  Will recursively enter subdirectories, but 
  325.           will enter all directories regardless of wildcards, etc.  Why?
  326.           Now let's say you want a list of all 'c' files on your harddisk.
  327.  
  328.                            Simply  nl -H dh0:*.c
  329.  
  330.           Besides matching wildcards, [-H] will also accept the other
  331.           conditional flags (like -f -i -l etc.)
  332.           Now you can list all capitalized *.info files on your harddisk...
  333.  
  334.                          nl -H -fA -c dh0:*.info
  335.  
  336.           [-H] enters every directory it finds (up to -x #) levels and
  337.           tries to match corresponding files.
  338.  
  339.  [-x #]   Tells to enter only # subdirectories.  Otherwise it will enter
  340.           every sub-directory it will find.  Use with [-R and -H]
  341.  
  342.  <paths>  the directories to view.  You can view as many directories at once
  343.           as you like.  Simple add it's path.  Wildcards are supported.
  344.           (Yes, UNIX style and yes, complex.   ie.  *ew?is*  = newlist)
  345.  
  346.  
  347.     All of the flags and paths can be used in any order.  
  348.       newlist dh0:*.c -s -r df1:*.o =  newlist -r dh0:*.c df1:*.o -s
  349.  
  350.     All of the flags can be used together (-q has exceptions):
  351.       You can view a directory through a case sensative character filter,
  352.       of files made in the last 2 weeks, sorted by date in reverse order,
  353.       showing block size , with a custom dateformat string, custom
  354.       print string, hiding .info files, paging, using a UNIX wildcard,
  355.       etc. etc.
  356.  
  357. Environment Variable support:
  358.  
  359.       ENV: variables are NOW supported.  Now long customized argument 
  360.    lists can be spared!  The variable ENV:NEWLIST contains any flags
  361.    you want to have automagically set upon initiating newlist5.  To 
  362.    utilize the env: support, use ED and create ENV:NEWLIST by 
  363.    typing in the flags you want to have default (ie. -r -sd). Easy.
  364.  
  365.       With ENV: comes a diminished return.  Now if you want the standard
  366.    'list' type display (files out of order and displayed as they are read)
  367.    , then the [-o] option must be used.
  368.   
  369.    NOTE: to override the ENV:NEWLIST, you can enter [-o] or you can type
  370.          any different flag.  Suppose  ENV:NEWLIST is "-r -sd -d3",
  371.          to sort by size: nl -o -ss  or  nl -ss
  372.  
  373. How to Create ENV: variables:
  374.  
  375.       Make sure ENV: is assigned to a permanent directory.  Now use the 
  376.    Commodore supplied command setenv.  Here is an example of its use:
  377.  
  378.            setenv  newlist  "-q -sd -r -i"
  379.  
  380. Tired of ENV: not being read?
  381.  
  382.       Do you want to add just one more flag to ENV: (like -i or -p), but 
  383.     find out that ENV: is ignored all together?  The solution is to create
  384.     aliases.  Aliases will guarentee that certain flags will be set no matter
  385.     what 'Extras' you give it.  I have included some basic ones in the file,
  386.     'aliases'.  Append it to s:Shell-Startup.  Now when you want to add
  387.     paging to an ls-style dir, enter lss -p.
  388.  
  389.  
  390. ~~~~~~~~~~~~~~~~
  391.  
  392. Comments:  First off.  Rename newlist to nl (for newlist), stick it in
  393.            your c: directory, and PURE it (protect c:nl +p).  People use 
  394.            names that are short and you know that you want to type nl 
  395.            instead of newlist.
  396.  
  397.            Now edit your Startup-Sequence to make nl RESIDENT upon bootup.
  398.            (add  RESIDENT c:nl PURE or ARES c:nl, depending if you use 
  399.            Workbench or ARP)
  400.  
  401.            Enjoy.  Keep in mind: this is a very useful tool.  A tool that
  402.                    costs only a few dollars.  It's a blue light special :-)
  403.  
  404.            Bear with me if Newlist doesn't like your set-up.  Please
  405.            write me if you encounter any bugs or heinous crashes.
  406.  
  407.                            Phil Dietz -- NCEMRSoft
  408.                            PO Box 306
  409.                            Yutan, Nebraska 68073
  410.                            USA
  411.