home *** CD-ROM | disk | FTP | other *** search
/ The CDPD Public Domain Collection for CDTV 3 / CDPDIII.bin / fish / 771-780 / ff773 / ls / readme < prev    next >
Text File  |  1992-12-05  |  7KB  |  188 lines
  1.                                  LS 4.7ljr
  2.                      UPDATE TO 4.5 USER DOCUMENTATION
  3.                   AND BUG/FEATURE FIXES SINCE 4.5 RELEASE
  4.                          Fri Nov 20 01:07:41 1992
  5.  
  6. The ls.doc file has only been halfway updated to show all the changes
  7. since the 4.5ljr release.  Please read this README file for full
  8. details.  I've dragged my feet for a month now with regards to getting
  9. the doc file updated.  It just isn't going to happen in the near future
  10. and thus I thought it better to release this now as is.
  11.  
  12. Thanks to Dan B. and Chris W. for their recent help in getting some
  13. important bug and feature fixes into ls.  Many others have helped
  14. since 4.5 by reporting problems and oddness when ls is used under
  15. 3rd party shells. [BTW, ls was operating correctly, but I have added
  16. a patch to ls that flushes Output() to work around limitations in
  17. some user shells.]
  18.  
  19. Please read the manual if you have never read the LS 4.5ljr manual.
  20. Please read the following if you have read the manual.
  21.  
  22. --
  23.  
  24. First release to be compiled with SAS/C v 6.0.  Smaller and
  25. Faster.  Way to go SAS! :-)
  26.  
  27. --
  28.  
  29. For me:
  30.  
  31. Fixed bug that caused any format not ending in '\n' to have an output
  32. problem!  Extra junk after some entries was being output.
  33.  
  34. --
  35.  
  36. Added for Dan:
  37.  
  38. \" is now a valid way to include a quote on the command line.  E.g.:
  39.  
  40. <some command> `ls -fHF "\"%n\" "`
  41.  
  42. will protect filenames with spaces in them.
  43.  
  44. --
  45.  
  46. For Dan:
  47.  
  48. Looked into problem related to removal of non-fixed disk while ls '-R' is
  49. scanning the media.  Basically ls puts up one requestor per subdirectory
  50. in the current scan directory and then quits.  Examine() / ExNext() appear
  51. to have some weirdness and don't respond with the correct error message.
  52. at least they don't set IoErr to the proper value under the OFS:
  53. IoErr() returns ERROR_NO_MORE_ENTRIES!  even if the scan is interrupted
  54. due to disk removal --- what the hell?  I'm leaving it alone.
  55.  
  56. Did fix one bug, ls wasn't actually checking IoErr() when ExNext()
  57. quit returning entries!
  58.  
  59. Fixed AsimCDFS CD-ROM file handler / ls interaction.  ls had a bug.  It
  60. didn't treat entries with non-listed filetype numbers as it should (I
  61. guess - things are a bit vague in this area, IMHO).  ls was just being
  62. stricter than it should have been.  Ls will now print any file entry with
  63. a negative (or =3) type number as a file.  It will still only recurse
  64. into directories (>=0 & !=3) if they have a C= listed number.
  65. In the long listing, s and S appear in the file type field in place
  66. of - and d if special files.
  67.  
  68. --
  69.  
  70. For Chris:
  71.  
  72.     [Filenote comments used to always come on the line following
  73.      the long listing entry for the file it referred to.]
  74.  
  75.     The placement and way filenotes are displayed can now be modified
  76.     by setting the ls_highlight0.on and ls_highlight0.off local
  77.     environment variables (see subsection entitled, ``Environment
  78.     variables'') and the format string (see subsection entitled,
  79.     ``Formatted Output'') and the 'w' string.  The default format
  80.     string is "%p %5b %8s %d %n%w%C\n".  The %C sequence is the place the
  81.     filenote will appear in the output if requested with the '-c' option.
  82.     If filenotes not requested or none present for a given file, %C
  83.     expands to 0 characters, even if the highlighting strings are set to
  84.     a displayable characters.
  85.  
  86.     '%w' is expanded to the current w (for whitespace? set via '-w' command
  87.     line switch, e.g. ls -c -w " " ram:) string if %C would expands
  88.     to a non-zero number of characters for the current entry.
  89.  
  90.     The %w string defaults to "\n".
  91.     ls_highlight0.on defaults to "\x9b" "2m/* " and ls_highlight0.off
  92.     defaults to " */\x9b" "22m".  Thus all filenotes will appear on the
  93.     line after the normal long listing entry in an alternate color in
  94.     a C-style comment.  E. g.
  95.  
  96.     R(0);T(00.266) > ls -c ram:a
  97.     -----rwed c     1        0 Sep 30 22:37 a
  98.     /* this file is neat */
  99.  
  100.     For example:
  101.     R(0);T(00.000) > set ls_highlight0.on " /** "
  102.     R(0);T(00.016) > set ls_highlight0.off " **/"
  103.     R(0);T(00.000) > ls -cw " " ram:a
  104.         -----rwed c     1        0 Sep 30 22:37 a /* this file is neat */
  105.  
  106.    BTW, %w and -w are a hack, pure and simple.
  107.  
  108. --
  109.  
  110. new formats for -F option argument:
  111.  
  112.     %C   Print filenote comment if present and requested with '-c'.
  113.          Filenote comment will have the highlight entry 0 applied to it
  114.          (see comments given in section describing '-c' option) before
  115.          printing.  In general, highlighting (ANSI color sequences, etc.)
  116.          should never be placed in the format string directly
  117.          as it will not be filtered out correctly when ls is given the
  118.          '-k' option or when ls is printing to a non-interactive device.
  119.          In %C's case, this is especially important and in fact nothing
  120.          related to filenote formatting should be included because not
  121.          all files have filenotes and in any event they are not always
  122.          printed.
  123.  
  124.    '%w'  is expanded to the current w (for whitespace? set via '-w' command
  125.          line switch, e.g. ls -c -w " " ram:) string if %C would expands
  126.          to a non-zero number of characters for the current entry.
  127.  
  128. --
  129.  
  130. New since 4.5ljr:
  131.  
  132. 4.6ljr was an internal version that only fixed the Flush() 'problem'.
  133. I've been meaning to release an update to ls for a long time...
  134. ...been busy with new job and...
  135. ...been waiting for SAS/C 6.0 offical release [couldn't release *anything*
  136. based on it until the offical release.]
  137.  
  138. --
  139.  
  140. For various people:
  141.  
  142. hack to Flush (Output ()) before ls terminates to allow some broken
  143. 3rd party shells to work with ls's use of 2.0's buffered IO.
  144.  
  145. --
  146.  
  147. For Dan:
  148.  
  149. changing the hide pattern:
  150.  
  151.     [NOTE: No support for changing how 'h' protection bit based
  152.      hiding works.  It really doesn't seem worth the effort... :-)
  153.      I don't have any '+h' protected files anyways.  And, excluding
  154.      files with other protection bit settings doesn't make a lot of
  155.      sense IMHO.]
  156.  
  157.     "(#?.(info|bak)|.#?)" is the default hide pattern.  This
  158.     can be changed by setting the ls_hidepattern local environment
  159.     variable (see subsection entitled, ``Environment variables'').
  160.     For example, the following issued in a shell (or added to a
  161.     shell-startup command file): set ls_hidepattern ".#?",
  162.     would cause Amiga ls to function as a normal unix ls.
  163.  
  164. --
  165.  
  166. update list of ls_highlight#'s:
  167.  
  168. With the advent of Amiga OS Release 2.04, there are now many more types of
  169. entries that can appear on a filing system (a disk).  A number is
  170. associated with each entry type, e.g.:
  171. -4     is associated with a FILE LINK (hard link)
  172. -3     " " " PLAIN FILE
  173. -2 - -1 " " " NOT USED CURRENTLY
  174. 0      " " " (hack to provide a space for) FILENOTE (related highlighing)
  175. 1      " " " ROOT
  176. 2      " " " USER DIR
  177. 3      " " " SYMBOLIC LINK (soft link)
  178. 4      " " " DIR LINK (hard link)
  179.  
  180. [the space for FILENOTE was always used this way, I just forgot to
  181. document this aspect in 4.5]
  182.  
  183. --
  184.  
  185. Regards,
  186. Loren
  187. rittle@comm.mot.com
  188.