"Fossies" - the Fresh Open Source Software Archive

Member "libisoburn-1.5.6/frontend/README-tcltk" (8 Jul 2020, 4876 Bytes) of package /linux/misc/libisoburn-1.5.6.tar.gz:

    1 ------------------------------------------------------------------------------
    2                                 xorriso-tcltk
    3 ------------------------------------------------------------------------------
    4 Copyright (C) 2012 - 2013
    5 Thomas Schmitt <scdbackup@gmx.net>, libburnia-project.org
    6 Provided under BSD license: Use, modify, and distribute as you like.
    7 ------------------------------------------------------------------------------
    8 
    9 xorriso-tcltk is mainly a proof of concept for a frontend that operates
   10 xorriso in dialog mode.
   11 
   12 Dependencies:
   13 - xorriso ISO 9660 Rock Ridge filesystem manipulator and CD/DVD/BD burn program
   14 - Tcl programming language
   15 - Tk widget toolkit
   16 - optionally the Tcl/Tk package BWidget
   17 
   18 It exercises several fundamental gestures of communication:
   19 - connecting via two pipes
   20 - sending commands
   21 - receiving replies
   22 - inquiring the xorriso message sieve
   23 - using the xorriso parsing service
   24 
   25 Note that any other language than Tcl/Tk could be used, if it only can
   26 do i/o via standard input and standard output or via named pipes.
   27 Further it has to perform integer arithmetics and string manipulations.
   28 And, well, a graphical widget set would be nice.
   29 
   30 See man xorriso for a documentation of xorriso concepts and commands.
   31 See man xorrecord for details of the burn image file feature.
   32 
   33 
   34                              Quick start
   35 
   36 In the xorriso build directory, without installation of xorriso:
   37 
   38   xorriso/xorriso -launch_frontend frontend/xorriso-tcltk --stdio --
   39 
   40 After installation of xorriso by make install:
   41 
   42   xorriso-tcltk
   43 
   44 
   45                             Overview of GUI
   46 
   47 The window is separated into three main areas:
   48 - Connection to xorriso.
   49 - Management of drives and image files.
   50 - Inspection, manipulation, and exploitation of xorriso ISO image model.
   51 
   52 Click the rightmost mouse button while being over any of the GUI elements
   53 in order to get the particular help text for that element.
   54 There is no need to close the help window. Just click another element to
   55 get another help text.
   56 
   57 The "Help" button in the upper right corner gives a short overview and
   58 instructions for several common use cases.
   59 
   60 
   61                          Program start options
   62 
   63 The Tcl shell "wish" is allergic to options which start by "-h".
   64 So here is the output of  xorriso-tcltk --help :
   65 ------------------------------------------------------------------------
   66 
   67 Usage:
   68   frontend/xorriso-tcltk [options]
   69 Options:
   70  All options must be given with two dashes ("--option") in
   71  order to distinguish them from any options of the Tcl shell.
   72  --help
   73      Print this text and exit.
   74  --stdio
   75      Establish connection to xorriso via stdin and stdout.
   76      E.g. when letting xorriso start this frontend program:
   77        xorriso -launch_frontend $(which xorriso-tcltk) --stdio --
   78  --named_pipes cmd_fifo reply_fifo
   79      Establish connection to a xorriso process started by:
   80        xorriso -dialog on <cmd_fifo >reply_fifo
   81      which is then ready for a run of:
   82        xorriso-tcltk --named_pipes cmd_fifo reply_fifo
   83      It is important that the parent of xorriso and of this
   84      tcl/tk frontend opens the named pipe for commands before
   85      it opens the named pipe for replies. This avoids deadlock.
   86  --silent_start
   87      Do not issue the start message xorriso-tcltk-version.
   88      This works only if --silent_start is the first argument.
   89  --no_extract
   90      Do not allow extraction of files from ISO filesystem to
   91      hard disk. This is not revokable during the program run.
   92  --no_bwidget
   93      Do not try to load the Tcl/Tk package BWidget which is
   94      a prerequisite for the "/" file browser buttons.
   95  --geometry {+|-}X{+|-}Y
   96      Sets the position of the main window.
   97  --click_to_focus
   98      Chooses that input fields and list boxes get the keyboard
   99      focus only when being clicked by the mouse. (Default)
  100  --auto_focus
  101      Chooses that the keyboard focus is where the mouse
  102      pointer is.
  103  --pipe_log_file path
  104      Set a file address for logging of xorriso commands and
  105      reply messages and enable this logging.
  106      The log lines will be appended. Path "-" means stderr.
  107  --script_log_file path
  108      Set a file address for logging of essential xorriso
  109      commands and enable this logging.
  110      The log lines will be appended. Path "-" means stderr.
  111  --script_log_all_commands
  112      With logging of commands log non-essential commands too.
  113  --use_command_move
  114      Use xorriso command -move for the "Move to: button
  115      if xorriso version is >= 1.2.8
  116  --use_command_mv
  117      Use xorriso command -mv for the "Move to:" button.
  118 
  119 If neither --stdio nor --named_pipes is given, then this script
  120 will try to locate itself in the filesystem and start a xorriso
  121 run that launches it again.
  122 
  123 In the running GUI, click with the rightmost mouse button on
  124 any GUI element to get its particular help text.
  125 
  126 ------------------------------------------------------------------------
  127