@DATABASE CDWrite-Relabel.guide

@$VER: CDWrite-Relabel V1.0 (3-Oct-95)
@(C) Copyright 1995 by Angela Schmidt, Neu-Ulm, Germany
@AUTHOR "Angela Schmidt"
@INDEX MAIN


@NODE MAIN "About CDWrite-Relabel"
@{B}CDWrite-Relabel@{UB}

This  program  replaces  the  volume  kludge  of CD-Write by renaming the
original  CD-ROM  and passing the original volume name the the handler of
CD-Write.  So  the assign of the volume kludge is no longer necessary and
some  programs won't have problems any longer. Some persons also say that
it  looks much better on Workbench, when CD-Write has the original volume
name.

@{"Function" LINK FUNCTION}
@{"Requirements" LINK REQUIREMENTS}
@{"When you don't need this program" LINK DONTNEED}
@{"When is it useful to use this program" LINK USEFUL}
@{"Syntax" LINK SYNTAX}
@{"Copyright" LINK COPYRIGHT}

@ENDNODE


@NODE FUNCTION "Function"
@{B}Function@{UB}

This  program  relabels  CD-ROMs using the ISO9660 standard by adding the
prefix "CDR-". So CD-Write is able to use the original volume name of the
CD-ROM while the original CD-ROM uses a different volume name.

This  is  done  by  pretending the original CD-ROM filesystem a different
name  of  the  CD-ROM. This name consists of the concaternation of "CDR-"
and  the  original  volume  name.  Sometimes it is necessary to cut a few
characters at the end of the name. So CD-Write mostly will use the volume
name  "CDW-CDR-", plus the original name. When CDWrite-Relabel recognizes
this  name,  it  relabels  the  CD-Write  volume  using Relabel(), so the
CD-Write volume will have the original volume name after that.
@ENDNODE


@NODE REQUIREMENTS "Requirements"
@{B}Requirements@{UB}

To  use  this program in a conventient way, you need CD-ROM filesystem, a
CD-ROM  drive,  a  CD-ROM  and  of course CD-Write. The CD-ROM filesystem
should  use trackdisk commands to access the CD-ROM, however, SCSI direct
commands probably will work, too. Other access methodes are not supported
at  the  moment  and that's why you cannot use this program with CD-ROMs,
which are mounted over a network, for example.
@ENDNODE


@NODE DONTNEED "When you don't need this program"
@{B}When you don't need this program@{UB}

In  the  following cases, there is no need for this program - but it does
not matter either:

- If  the original name is not directly accessed by programs contained on
  the  CD-ROM,  you  won't  run  into trouble without this program and so
  don't  need  this  program.  If the person who compiles a CD-ROM does a
  good  job,  the  files  will  be  relative  to the current directory or
  relative  to  the  root  directory  anyway. Otherwise it is for example
  difficult to install some drawers to harddisk by just copying them.

- CD-ROMs  which  contain  only data but no Amiga programs won't run into
  trouble  without  this  program, since such CD-ROMs normally don't need
  the name of the CD-ROM.
@ENDNODE


@NODE USEFUL "When is it useful to use this program"
@{B}When is it useful to use this program@{UB}

As  you  know  CD-Write supports the so-called volume-kludge (see section
3.6  of your manual). Of course, this is a possibility to redirect CD-ROM
accesses  to  the  volume of CD-Write. But this solution has at least one
ugly "feature":

Some  programs  which are not written in the best way - for example CED -
expand  the  pathname  before  loading a file. If you now want to load an
@{I}unchanged@{UI}  file  (a  file from the original CD-ROM), you have bad luck if
you are using CED and the volume-kludge, because if you enter for example

    Ed CD0:clickme.first

This  will be expanded (if the name of the CD-ROM is "Meeting_Pearls_II")
to

    Ed Meeting_Pearls_II:clickme.first

since  the  volume  name  of  "CD0:"  is "Meeting_Pearls_II". But now the
volume  kludge  will  redirect  the access to the CD-Write volume, so you
will get the changed file rather than the original one, which is not what
you wanted.

Similar  problems  probably  will happen with some other applications and
can   cause   strange   effects   which   won't   happen   when  you  use
CDWrite-Relabel.
@ENDNODE


@NODE SYNTAX "Syntax"
@{B}Syntax@{UB}

You  should start this program once. The best time to do this is directly
after  mounting  all  connected  CD-ROM drives. You should not break this
program, although this is possible.


@{B}Syntax@{UB}

  Activate: CDWrite-Relabel [<options>] <cd-rom-devices>: ...
  Change:   CDWrite-Relabel <options>
  Remove:   CDWrite-Relabel QUIT | EXIT


@{B}Options@{UB}

  [NO]TRACKDISKPATCH - do (not) patch trackdisk commands
  [NO]SCSIPATCH      - do (not) patch SCSI direct commands
  [NO]AUTODISKCHANGE - do (not) send automatic diskchanges
  [NO]DEBUG          - debug output to the serial.device. (catch
                       it using sushi)
  RELABELDELAY <n>   - number of 1/50 seconds to wait until sending
                       the relabel command after recognizing the
                       CD-Write volume 
  PRI <n>            - work using priority <n>


@{B}Default options@{UB}

  TRACKDISKPATCH SCSIPATCH AUTODDISKCHANGE NODEBUG RELABELDELAY 100


@{B}Examples@{UB}

  1> Run <NIL: >NIL: CDWrite-Relabel CD0:

  This command relabels CD0: and passes the original volume name along
  to CD-Write.


  1> Run <NIL: >NIL: CDWrite-Relabel CD0: CD1: CD2:

  This command relabels CD0:, CD1: and CD2: and passes the original
  volume names along to CD-Write.


  1> Run <NIL: >NIL: CDWrite-Relabel CD0: PRI 3

  This command relabels CD0: and passes the original volume name along
  to CD-Write. The program uses priority 3 to run.


  1> Run <NIL: >NIL: CDWrite-Relabel CD0: RELABELDELAY 50

  This command relabels CD0: and passes the original volume name along
  to CD-Write. This already happens after one second. Note: if you
  choose too small values for RELABELDELAY, this can make Workbench
  running into trouble.


  1> Run <NIL: >NIL: CDWrite-Relabel CD0: NOAUTODISKCHANGE

  This command relabels CD0: but you have to manually cause a diskchange
  afterwards.


  1> CDWrite-Relabel PRI 2

  This command changes the task pri of a already started CDWrite-Relabel
  to 2.


  1> CDWrite-Relabel QUIT

  This quits CDWrite-Relabels. If you prefer sending ^C, this is no
  problem either.
@ENDNODE


@NODE COPYRIGHT "Copyright"
Copyright 1995 by Angela Schmidt, Finkenweg 26, 89233 Neu-Ulm
                                                                 
Without  the written consent of the author no portion of this work may by
commercially  distributed.  Any  violation  will  be  persued in both the
criminal and the civil courts.

The  AmigaGuide  icon  included  in  this  archive is Copyright © 1995 by
Michael-Wolfgang Hohmann.
@ENDNODE