home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 5 / DATAFILE_PDCD5.iso / utilities / b / bin2 / ReadMe
Encoding:
Text File  |  1994-02-07  |  5.0 KB  |  111 lines
  1.  
  2. This archive contains some GNU and BSD utilities which I have ported to
  3. run under RISC OS. They were compiled using gcc 2.4.5 release 2, linked 
  4. using DrLink version 0.24 and UnixLib 3.6c (gcc release) and finally 
  5. crunched using !Crunch 1.00.
  6.  
  7.                          Isn't hensa useful ;-)
  8.  
  9. Ok, here's the list:
  10.  
  11. apropos   - search the whatis database for strings
  12. basename  - strip directory and suffix from filenames
  13. cat       - concatenate files and print on the standard output
  14. cksum     - checksum and count the bytes in a file
  15. comm      - compare two sorted files line by line
  16. csplit    - split a file into sections determined by context lines
  17. cut       - remove sections from each line of files
  18. dirname   - strip filename suffix from pathname
  19. expand    - convert tabs to spaces
  20. expr      - evaluate expressions
  21. fold      - wrap each input line to fit in specified width
  22. head      - output the first part of files
  23. join      - join lines of two files on a common field
  24. logname   - print user's login name
  25. man       - format and display the on-line manual pages
  26. more      - file perusal filter for crt viewing
  27. nl        - number lines of files
  28. od        - dump files in octal and other formats
  29. paste     - merge lines of files
  30. pr        - convert text files for printing
  31. printf    - format and print data
  32. sleep     - delay for a specified amount of time
  33. sort      - sort lines of text files
  34. split     - split a file into pieces
  35. sum       - checksum and count the blocks in a file
  36. tac       - concatenate and print files in reverse
  37. tail      - output the last part of files
  38. tr        - translate or delete characters
  39. tar       - GNU tar, version 1.11.2
  40. tty       - print the path of the terminal connected to standard input
  41. unexpand  - convert spaces to tabs
  42. uniq      - remove duplicate lines from a sorted file
  43. wc        - print the number of bytes, words, and lines in files
  44. yes       - output a string repeatedly until killed
  45.  
  46. What else can I say ? Well, I can't say I've tested any of these fully. Most 
  47. of the ports came about because GNU code is so easy to port. For example, 
  48. the textutils were all ported because I wanted a working version of sort. If 
  49. any horrible problems arise, I'd like to know about them. The programs are 
  50. all linked to UnixLib, so need some variables setting to run properly.  
  51. Here's a minimal example from my !Boot application:
  52.  
  53. | Setup paths for the Unix Library.
  54. Set TERM          acorn0
  55. Set TERMCAP       /etc/termcap
  56. Set UnixFS$/etc   HD1:$.etc
  57. Set UnixFS$/tmp   HD1:$.tmp
  58. Set UnixFS$/usr   HD1:$.usr
  59. Set UnixFS$/pipe  HD1:$.tmp
  60. Set UnixFS$sfix   a:c:f:h:i:l:o:p:s:y
  61. Set Lib$Path      HD1:$.usr.lib.
  62. Set MANPAGER      zmore
  63. Set MANPATH       /usr/local/man:/usr/linux/man:/usr/sillyman
  64.  
  65. Note that MANPATH has to be colon separated, like on Unix, and this will
  66. confuse it for any RISC OS FS names. You need to have the /etc/termcap
  67. file installed too, or more will not be able to run. 
  68.  
  69. man is a simple version. It doesn't have the capability of calling nroff,
  70. as I've never found a version of nroff which I could port and persuade to
  71. expand man macros. The pages are stored in man/cat[1-8]/[1-8][a-z]/file, 
  72. while the file is compressed using gzip (though this is not necessary, just 
  73. adjust your MANPAGER variable (gzip is available on hensa).
  74.  
  75. Since filecore based filing systems are limited to 77 files per directory, 
  76. I've modified man so that it now looks in (e.g.) cat1/1/ls then cat1/1a/ls, 
  77. and so on. It will search the alphabet until it comes across a non-existent 
  78. directory, so you can't have cat1/1, cat1/1a, cat1/1c as 1c will never be 
  79. examined.
  80.  
  81. If you want man pages for C function calls (man2 and man3) take a look in 
  82. the linux archive on ftp.mcc.ac.uk:/pub/linux/...  
  83.  
  84. The more port has a help file which is displayed when you type ? or h at the 
  85. --- More --- (dd%) prompt. This file must be installed as more_help in your 
  86. Lib: directory.
  87.  
  88. Oh yes, I'm supplying all the sources, as GNU likes. The GNU license says 
  89. that I should announce any modified code. Well, in general I've only had to 
  90. alter makefiles and add a few #ifdef ARCH's in the source. If you want to 
  91. find the changes, just search for ARCH. Don't look too closely at the 
  92. makefiles - since I can't create library files, there's a humungous number 
  93. of -l's on the linker calls. Anyone know if a freeware version of ar for 
  94. RISC OS exists ?
  95.  
  96. Can't think of anything else to say right now. If you have any problems 
  97. installing these, I'll be glad to answer questions. If you find any bugs, 
  98. I'll try to solve them, but time is at a premium for me right now, so don't 
  99. hold your breath (besides, you've got the sources - what more do you 
  100. want ? :-)
  101.  
  102. My mail address is:  auj@aber.ac.uk
  103.  
  104. Snail mail (Home):  Alun Jones,        (Aber)           Alun Jones,
  105.                     Sunny Bank,               C67 Neuadd Cwrt Mawr,
  106.                       Tregynon,                           Waunfawr,
  107.                        Newtown,                        Aberystwyth,
  108.                          Powys SY16 3EH.                     Dyfed SY23 3AN.
  109.                                                (valid until Sep 94)
  110.  
  111.