Release request commit created with Cranko.

+++ cranko-rc-info-v1
[[projects]]
qnames = ["tectonic_errors", "cargo"]
bump_spec = "minor bump"

[[projects]]
qnames = ["tectonic_status_base", "cargo"]
bump_spec = "minor bump"

[[projects]]
qnames = ["tectonic_io_base", "cargo"]
bump_spec = "minor bump"

+++

Author: cranko

crates/bridge_flate/build.rs

@@ -15,8 +15,10 @@ fn main() {
     let mut header_path: PathBuf = outdir.into();
     header_path.push("tectonic_bridge_flate.h");
 
-    let mut config = cbindgen::Config::default();
-    config.cpp_compat = true;
+    let mut config = cbindgen::Config {
+        cpp_compat: true,
+        ..Default::default()
+    };
     config.enumeration.prefix_with_name = true;
 
     let mut manifest_dir: PathBuf = env::var("CARGO_MANIFEST_DIR").unwrap().into();

docs/src/SUMMARY.md

@@ -12,6 +12,7 @@
 # “V2” Command-Line Interface
 
 - [`tectonic -X build`](v2cli/build.md)
+- [`tectonic -X compile`](v2cli/compile.md)
 - [`tectonic -X new`](v2cli/new.md)
 
 # Concept Reference

docs/src/getting-started/first-document.md

@@ -46,6 +46,16 @@ $ cd myfirstdoc
 it will become unnecessary and you’ll just be able to write `tectonic new`, but
 that changeover hasn’t happened yet.*
 
+If you’ve got an existing TeX file, you can process it in in one-off fashion with:
+
+```sh
+$ tectonic -X compile myfile.tex
+```
+
+See [the `tectonic -X compile` documentation][cli-compile] for all of the options.
+
+[cli-compile]: ../v2cli/compile.md
+
 
 ## Basic document source structure
 

docs/src/v2cli/compile.md

@@ -0,0 +1,105 @@
+# tectonic -X compile
+
+Compile a standalone TeX document.
+
+***This is a [V2 CLI][v2cli-ref] command. For information on the original (“V1”
+CLI), see [its reference page][v1cli-ref].***
+
+[v2cli-ref]: ../ref/v2cli.md
+[v1cli-ref]: ../ref/v1cli.md
+
+#### Example
+
+Generate `myfile.pdf` from `myfile.tex`:
+
+```sh
+tectonic -X compile myfile.tex
+```
+
+#### Usage Synopsis
+
+```sh
+tectonic -X compile  # full form
+  [--bundle PATH] [-b PATH]
+  [--chatter LEVEL] [-c LEVEL]
+  [--color WHEN]
+  [--format PATH] [-f]
+  [--hide PATH...]
+  [--keep-intermediates] [-k]
+  [--keep-logs]
+  [--makefile-rules PATH]
+  [--only-cached] [-C]
+  [--open]
+  [--outdir DIR] [-o]
+  [--outfmt FORMAT]
+  [--pass PASS]
+  [--print] [-p]
+  [--reruns COUNT] [-r COUNT]
+  [--synctex]
+  [--web-bundle URL] [-w]
+  [-Z UNSTABLE-OPTION]
+  TEXPATH
+```
+
+#### Remarks
+
+This command compiles a freestanding TeX document, outside of the Tectonic
+[document][docs-ref] framework. It is virtually the same interface as the [“V1”
+command-line interface][v1cli-ref], with lots of options. In comparison, the V2
+interface is “[cargo]-like”, with a variety of subcommands anchored around a
+[Tectonic.toml] file defining a document to build.
+
+[docs-ref]: ../ref/documents.md
+[cargo]: https://doc.rust-lang.org/cargo/
+[Tectonic.toml]: ./tectonic-toml.md
+
+Basic usage of this command is often as simple as:
+
+```sh
+tectonic -X compile myfile.tex
+```
+
+This will compile the file and create `myfile.pdf` if nothing went wrong. You
+can use an input filename of `-` to have Tectonic process standard input. (In
+this case, the output file will be named `texput.pdf`.)
+
+
+#### Options
+
+The following are the available flags.
+
+| Short | Full                      | Explanation                                                                                    |
+|:------|:--------------------------|:-----------------------------------------------------------------------------------------------|
+| `-b`  | `--bundle <PATH>`         | Use this Zip-format bundle file to find resource files instead of the default |
+| `-c`  | `--chatter <LEVEL>`       | How much chatter to print when running. Possible values: `default`, `minimal` |
+|       | `--color <WHEN>`          | When to colorize the program’s output: `always`, `auto`, or `never` |
+|       | `--format <PATH>`         | The name of the "format" file used to initialize the TeX engine. Default: `latex` |
+| `-h`  | `--help`                  | Prints help information |
+|       | `--hide <PATH>...`        | Tell the engine that no file at `<PATH>` exists, if it tries to read it |
+| `-k`  | `--keep-intermediates`    | Keep the intermediate files generated during processing |
+|       | `--keep-logs`             | Keep the log files generated during processing |
+|       | `--makefile-rules <PATH>` | Write Makefile-format rules expressing the dependencies of this run to `<PATH>` |
+| `-C`  | `--only-cached`           | Use only resource files cached locally |
+|       | `--open`                  | Open the output PDF after it is built |
+| `-o`  | `--outdir <OUTDIR>`       | The directory in which to place output files. Default: the directory containing INPUT |
+|       | `--outfmt <FORMAT>`       | The kind of output to generate. Possible values: `pdf` (the default), `html`, `xdv`, `aux`, `format` |
+|       | `--pass <PASS>`           | Which engines to run. Possible values: `default`, `tex`, `bibtex_first` |
+| `-p`  | `--print`                 | Print the engine's chatter during processing |
+| `-r`  | `--reruns <COUNT>`        | Rerun the TeX engine exactly this many times after the first |
+|       | `--synctex`               | Generate SyncTeX data |
+| `-V`  | `--version`               | Prints version information |
+| `-w`  | `--web-bundle <URL>`      | Use this URL find resource files instead of the default |
+| `-Z`  | `-Z <UNSTABLE-OPTION>`    | Activate experimental “unstable” options |
+
+#### Unstable options
+
+The following unstable options may be available. As the name aims to indicate,
+the set of unstable options is subject to change at any time.
+
+| Expression               | Explanation |
+|:-------------------------|:------------|
+| `-Z help`                | List all unstable options |
+| `-Z continue-on-errors`  | Keep compiling even when severe errors occur |
+| `-Z min-crossrefs=<num>` | Equivalent to bibtex's `-min-crossrefs` flag. Default vaue: 2 |
+| `-Z paper-size=<spec>`   | Change the initial paper size. Default: `letter` |
+

src/engines/mod.rs

@@ -779,10 +779,21 @@ pub extern "C" fn input_getc(es: &mut ExecutionState, handle: *mut InputHandle)
 
     match es.input_getc(handle) {
         Ok(b) => libc::c_int::from(b),
-        Err(Error(ErrorKind::Io(ref ioe), _)) if ioe.kind() == io::ErrorKind::UnexpectedEof => {
-            libc::EOF
-        }
         Err(e) => {
+            if let Error(ErrorKind::Io(ref ioe), _) = e {
+                if ioe.kind() == io::ErrorKind::UnexpectedEof {
+                    return libc::EOF;
+                }
+            }
+
+            if let Error(ErrorKind::NewStyle(ref ns), _) = e {
+                if let Some(ioe) = ns.downcast_ref::<io::Error>() {
+                    if ioe.kind() == io::ErrorKind::UnexpectedEof {
+                        return libc::EOF;
+                    }
+                }
+            }
+
             tt_warning!(es.status, "getc failed"; SyncError::new(e).into());
             -1
         }