xenial (1) bibledit-rdwrt.1.gz

Provided by: bibledit-gtk_4.9-1_amd64 bug

NAME

       bibledit-rdwrt - Read or writes data to or from a Bibledit-Gtk Bible or project

DESCRIPTION

       Bibledit-rdwrt can read from or write to Bible data.

       Syntax: bibledit-rdwrt ‐r|‐w project book chapter|0 fileName

       Breaking the syntax down we have:

       First  parameter:  ‐r|‐w This can be either ‐r or ‐w which determines whether the remaining arguments are
       going to do a "read" operation from the specified Bibledit-Gtk Bible / project, or do a "write" operation
       to that Bible / project.

       Second  parameter: project This gives the name of the Bibledit-Gtk Bible / project.  All we have to do is
       ensure that the project name we want to access is a valid/existing one.

       Third parameter: book This is simply the 3‐letter book code for the Bible book that is being read/written
       to.  I.e., MAT for Matthew, GEN for Genesis, etc.

       Fourth parameter: chapter|0 This can be either a chapter number or 0 (zero) for reading/writing either an
       individual chapter or reading/writing a whole book (when the parameter is 0).

       Fifth parameter: fileName This is a temporary file name that we assign for our use  with  bibledit-rdwrt.
       For  a  read  (‐r)  operation  this  fileName  argument  is  the name of the file that will be created by
       bibledit-rdwrt containing a copy of the whole book (corresponding to the 3‐letter code), or that contains
       the  individual  chapter  contents (of a designated chapter) of an existing Bibledit-Gtk book file in the
       Bible / project. It should be prefixed with a path us.  For a write (‐w) operation this fileName argument
       is  the  name of the temporary file that bibledit-rdwrt reads to get the text which it then writes to the
       appropriate Bible / project file.  The temporary file can contain the text of a whole book, or  just  the
       text  of  a  single  chapter  for  the  book specified by the book 3‐letter code and the chapter (number)
       argument.

       bibledit-rdwrt may exit with 0 on success, or ‐1 on failure, as it sees fit.  It may write to  stdout  or
       stderr, as it sees fit.

LICENSE

       This program is distributed under the GNU General Public License, as noted in each source file.