memoire

@@ -7,7 +7,7 @@ Any time you run Memoire, it will operate on a deck.

 A deck is stored as a [Recfile]( https://www.gnu.org/software/recutils/manual/The-Rec-Format.html ).

 A deck consists of a list of cards, each card corresponding to a record.

 A card consists of a note and some associated fields, and may be expanded to a list of prompts generated from the note.

-For now, there are two types of cards: basic multi-cloze and sequential.

+For now, there are three types of cards: basic multi-cloze, pairwise cloze, and sequential.

 From a basic multi-cloze card, there is a prompt for each cloze deletion (indicated with curly brackets around the deletion), which shows the entire note except that deletion.

 For example, if the note is

@@ -17,6 +17,14 @@ bio organelles: matter enters the {Golgi apparatus} on the {cis face} and exits

 then Memoire will construct four prompts from the card, one omitting "Golgi apparatus", one omitting "cis face", one omitting "in a vesicle", and one omitting "trans face".

 Each prompt has the deletion re-inserted as the answer.

+From a pairwise cloze card, the note is broken into clauses, separated by double-semicolons.

+There is a prompt for each ordered pair of distinct clauses for which the second clause has a cloze deletion.

+For example, if the note is

+```memoire

+words zh:;; hanzi 面包;; pronounced {miànbāo};; means {bread} (en)

+```

+then Memoire will construct four prompts for the card, two asking for pronunciation (omitting "miànbāo"), two asking for meaning (omitting "bread").

+

 From a sequential card, there is a prompt for each clause (indicated with a double-semicolon separator), which shows the part of the note before that clause.

 For example, if the note is

 ```memoire

@@ -25,7 +33,7 @@ quotes: A.N. Whitehead on automatic thought processes: ;;Civilization advances b

 then Memoire will construct four prompts from the card.

 One of those will show "quotes: A.N. Whitehead on automatic thought processes: Civilization advances by extending ", and append "the number of important operations " as the answer.

-You may be able to include images in cards (of either type) with `IMG[path/to/image]` syntax, where the path is relative to the directory containing your deck file.

+You may be able to include images in cards (of any type) with `IMG[path/to/image]` syntax, where the path is relative to the directory containing your deck file.

 For example, if the note is

 ```memoire

 machines: what is this thing? IMG[img/velomobile.jpg] {velomobile}

@@ -56,10 +64,11 @@ The notes must be separated by blank lines.

 Each note can have multiple lines.

 There must be an extra blank line at the end of the input.

-This feature auto-detects the type of card (multi-cloze or sequential) from the content of the note.

+This feature auto-detects the type of card (multi-cloze, pairwise cloze, or sequential) from the content of the note.

+If the note is formatted plausibly like pairwise cloze, it's saved as pairwise cloze.

 If there are braces, it's saved as multi-cloze.

 If there are double-semicolons, it's saved as sequential.

-If both are present, the procedure favours multi-cloze.

+If both are present (and it was not detected as pairwise cloze), the procedure favours multi-cloze.

 ## Correcting cards

 `src/main.lua c N` (where `N` is an integer) opens the note for card N from the deck in a text editor.