home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 5 / DATAFILE_PDCD5.iso / utilities / t / textport / !TextPort / !Help < prev    next >
Encoding:
Text File  |  1995-11-02  |  3.7 KB  |  90 lines

  1.  
  2.  Help on 'TextPort' version 1.02 & 1.03    (c) 1995  ALT-itude software
  3.  ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~    ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  4.  
  5.  See the WARNING at the end before using this program to transfer files.
  6.  
  7.  This is a drag-and drop text file processor designed to simplify the
  8.  business of moving text files between platforms, or between your own
  9.  RISC OS system and the internal PC implimentation or other systems.
  10.  
  11.  There is also a command-line version, nominally labelled v 1.03, inside
  12.  the app. shell (open with shift-double-click) which you can put in your
  13.  library. Running the command-line TextPort with no parameters gives a
  14.  usage summary.
  15.  
  16.  The file TPORT/EXE is a DOS version of the command line program, using
  17.  the same C source code as the RISC OS version except for the system-
  18.  specific file operations. I haven't used this much but it has proved
  19.  reliable during reasonable tests. The only functional difference is
  20.  that it will not let you copy/move a file onto itself (the RISC OS
  21.  version uses a temp file to do this). If you copy this to a DOS disc
  22.  or partition you can rename it to TEXTPORT.EXE.
  23.  
  24.  Explanation
  25.  ~~~~~~~~~~~
  26.  
  27.  Different operating systems use different characters to indicate the
  28.  end-of-line (EOL) in text files. These characters are usually one or
  29.  both of &0D and &0A (these are in hexadecimal).
  30.  
  31.  These characters are more commonly known by their ASCII names, which are
  32.  CR (for Carriage Return) and LF (for Line Feed) respectively. The
  33.  standard usage is as follows:
  34.  
  35.      System          End-of-line sequence
  36.  
  37.      RISC OS         LF
  38.      Unix            LF
  39.      MS-DOS          CR LF
  40.      Apple Macs      CR
  41.  
  42.  I have found that Mac users can't read my text files, and quite often I
  43.  can't read theirs easily. This program helps here, as well as the more
  44.  obvious uses of moving files around on your own machine.
  45.  
  46.  Usage in the RISC OS desktop
  47.  ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  48.  
  49.  Dropping any file onto the 'TextPort' icon will open a dialogue box where
  50.  you can set the type of line feeds you want to give the new file. The
  51.  program assumes that you want to turn foreign files into Acorn format, and
  52.  Acorn files into PC format. You can just click on the required button to
  53.  select your choice.
  54.  
  55.  There is one other option : 'Strip trailing spaces' will remove any
  56.  spaces from the end of the lines.
  57.  
  58.  Since this is a text file processor, the file type of the output file will
  59.  always be set to 'Text' so you can double-click on it to load it.
  60.  
  61.  !!!!!!!!!!!!!!!!!!!!!!!!! WARNING !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
  62.  
  63.  If, like me, you usually can't be bothered to shut down your PC emulator
  64.  or co-processor card, you should be aware that you may confuse the PC
  65.  system by writing to a drive which it thinks it has 'seen'. Try to use
  66.  a floppy to transfer files to DOS, even 'inside' your RiscPC etc., and
  67.  remember to dismount the disc after writing to it. This can be done
  68.  without freezing the PC component and is usually the safest method. If,
  69.  like me, you can't *even* be bothered to do that, then at least set up a
  70.  very small (say 4 Mb) D: drive for your PC and NEVER write to the C:
  71.  drive while !PC is running, even if the window is closed.
  72.  
  73.  Terms, Disclaimer, etc.
  74.  ~~~~~~~~~~~~~~~~~~~~~~~
  75.  
  76.  This software is FREEWARE. Copy it, distribute it, keep it complete.
  77.  
  78.  No liability is accepted for loss or damage caused by this software.
  79.  
  80.  If it seems to go wrong let me know; I'll do my best to fix the problem.
  81.  
  82.  (c) Ian Giblin, ALT-itude, 1995.
  83.  
  84.  +--------------------------------------------------------------------------+
  85.  |   ALT-itude is...  Dr Ian Giblin,      e-mail:  giblin@dm.unipi.it       |
  86.  |                    Dr Paddy Spencer,   e-mail:  spencer@pcu.helsinki.fi  |
  87.  +--------------------------------------------------------------------------+
  88.  
  89. [end]
  90.