BIBLEDIT-RDWRT(1)					      General Commands Manual						 BIBLEDIT-RDWRT(1)

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  read-
       ing/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.  Since bibledit-rdwrt is a console operation, after AdaptIt calls it using  ::wxExe-
       cute,  it would need to read the resulting temporary file to grab the contents for its use.  For a write (-w) operation this fileName argu-
       ment 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.

Version 4.2							  August 18 2011						 BIBLEDIT-RDWRT(1)