What's New

File 1061

A Wonderous Tale (Fixing Up A Laundry Mess)

At our house when the laundry has been washed and dried it is supposed to be neatly folded and placed in a basket so the next person knows it is clean. Sometimes someone (who shall remain nameless) gets in a hurry and just piles the clean laundry unfolded in a basket. Someone else comes along and places a basket of dirty laundry next to the basket of clean laundry. Once we start moving these baskets around a sad tale of woe and gloom begins with no one being quite sure what baskets contain dirty laundry and what baskets contain clean laundry.

At this point you are probably wondering two things:

  1. How did anyone ever develop such a masterful story telling ability?
  2. Is there a deeper level of meaning to this story known only to the enlightened ones?

Enlightenment Revealed

OK. When you have two machines that have some books with old data (“dirty laundry”) and some books with current data (“clean laundry”) and you start moving data between them for the first time using Send/Receive you can end up with a confusing mixture of old and new data. Send/Receive does not initially know what machine has new data for each book and what machine has the old data.

The first time you do a Send/Receive when you have data on two machines, you should use File/Backup to create a copy of the latest version of each new book. Use File/Restore on the machine(s) which has old versions of the data to make sure that before the first Send/Receive is done that both machines have the same data. Once the two machines have identical data there is no danger of the data getting confused.

Ongoing Happiness

Why don't we have to do this every time? Wouldn't Send/Receive tend to mix up old and new data every time? It turns out once you have successfully done a Send/Receive between two machines Paratext can tell what is new data and what is old data just like we know which is the clean laundry as long as it is neatly folded.

Paratext does this by looking at the history for a verse. If Paratext does a Send/Receive between two machines today it knows that as of today Gen 1:1 said “In the beginning God made earth.” on both machines. If I do a Send/Receive tomorrow and Gen 1:1 says “In the beginning God made earth.” on my machine but it says “In the beginning God made heaven and earth.” on Marsha's machine, Paratext knows that Marsha has changed the verse and I haven't. Marsha's version is then made the new official version since it has changed. Paratext can only make this choice once the first Send/Receive has been done to establish what the unchanged version of the verse is.

Fixing Up A Laundry Mess

Sadly at this point some of you are thinking “Thank you for telling me this.” and some are thinking “I wish you had told me this yesterday!”. Thankfully all is not lost. Paratext remembers every version that has been saved in the repository. If I have done a Receive from Marsha's machine and discover that my current copy of Genesis has been overwritten with an older version from Marsha's machine I do the following.

  1. Go to the editing project window.
  2. Click Project > View Project History. Click on the most recent version of the project before the Send/Receive was done that has my name on it,
  3. Click Revert Books in the toolbar and select the book of Genesis. Click OK.

Now I have set Genesis back to my new version of the data.

Getting Information on Send/Receive

There are several sources of information on Send/Receive:

  1. Click Help > Update Help to get the latest version of the helps on you machine. Click Help > Browse Help and type Send in the search bar.
  2. In a web browser logon to the paratext.org web site. Click Support > Learning Center > Paratext 7 Written Tutorials > Paratext Project Sharing Illustrated (by Steve White).
  3. In a web browser logon to the paratext.org web site. Click Support > Learning Center > Paratext 7 Video Tutorials > Project Sharing.

Thanks for taking time to read this and may all your laundry be unmixedly clean.

Nathan