<!--
 Licensed to the Apache Software Foundation (ASF) under one
 or more contributor license agreements.  See the NOTICE file
 distributed with this work for additional information
 regarding copyright ownership.  The ASF licenses this file
 to you under the Apache License, Version 2.0 (the
 "License"); you may not use this file except in compliance
 with the License.  You may obtain a copy of the License at

   http://www.apache.org/licenses/LICENSE-2.0

 Unless required by applicable law or agreed to in writing,
 software distributed under the License is distributed on an
 "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
 KIND, either express or implied.  See the License for the
 specific language governing permissions and limitations
 under the License.
-->

# tools13: foreign ODF 1.2 / 1.3 corpus

`make-foreign-corpus.py` converts the same input documents with another popular Open Source Office suite
(headless) once per output version, giving ODF 1.2 / 1.3 twins for an import smoke test.

## Version values (observed)

The output version comes from the profile setting `/org.openoffice.Office.Common/Save/ODF`, property
`DefaultVersion`, written to the private profile's `user/registrymodifications.xcu`. Found black-box by converting one
small document per value (`--probe`) and reading `office:version` / `manifest:version` and the declared namespaces back
from the result. "Ext" means loext, calcext, officeooo, drawooo, tableooo and the ooo-ms-interop `field` namespace are
declared.

| value | office:version | extension namespaces |
|---|---|---|
| 1 | none (ODF 1.0) | no |
| 2 | 1.1 (manifest has no version) | no |
| 4 | 1.2 | no |
| 8, 9 | 1.2 | yes |
| 10 | 1.3 | no |
| 11 | 1.3 | yes |
| 12 | 1.4 | no |
| 13 | 1.4 | yes |
| 0, 3, 5, 6, 7, 14-20 | 1.4 | yes (acts as the default) |

Modes used: `v12` = 4, `v12ext` = 8, `v13` = 10, `v13ext` = 11. Observed on one build (26.8.1.1); re-run `--probe`
for another one. Plain-mode outputs still carry the legacy `ooo`, `oooc`, `ooow`, `rpt`, `formx` namespaces.

## Run

    python3 -I make-foreign-corpus.py <path to the other suite's soffice binary>

Defaults: 55 documents chosen from `runs/gate-t16f/jobs.tsv` (see the comment above `QUOTA` in the script;
`--list-selection` prints them), output root `test/odf-validate/runs/phase3/foreign/`. Other options: `--inputs LIST`
(one path per line, first tab column used), `--root`, `--modes`, `--batch`, `--timeout`,
`--probe WORKDIR [--probe-range 0-20]` for the value table only.

Outputs: `<root>/<mode>/<name>.<odt|ods|odp|odg>` (legacy inputs map to their ODF type, e.g. `x.doc` -> `x.odt`; two
inputs that would give the same output name are refused), `<root>/manifest.tsv` (input, mode, output, office:version,
manifest:version, ok/fail, note), `<root>/logs/`, and one private profile per mode (`<root>/foreign-prof-<mode>`).
Every output is checked for the expected `office:version` (in content, styles, meta, settings) and
`manifest:version`; plain modes must declare no extension namespaces, ext modes must. Any mismatch or missing
output gives a non-zero exit. Timed-out batches are retried file by file.

Process safety: only processes whose command line carries one of its own profile URLs are ever killed, and the
script refuses to start if such a process already exists.

## Use

A later import smoke test loads `<root>/v13/X` and `<root>/v12/X` (and the `ext` pair) and compares what the importer
produced from each, so a 1.3-specific import difference shows up against the 1.2 twin of the same source.

## Clean-room note

Only the other suite's output files and its public behaviour are observed. Its source code and its installed
resource/configuration files are not read, and its name is not used in files here; the binary path is a command
line argument only.