diff options
| author | Jay Berkenbilt <ejb@ql.org> | 2024-01-09 19:35:23 +0100 |
|---|---|---|
| committer | Jay Berkenbilt <ejb@ql.org> | 2024-01-10 22:45:14 +0100 |
| commit | 0df672049bb726385bca36aa9ccf35565c8f0201 (patch) | |
| tree | 6eabfbbe829c49606585bd9ce212623a1b8b0db2 /TODO-pages.md | |
| parent | 1ecdbc1e55a7970f4822e32883405b6bbaeb8495 (diff) | |
| download | qpdf-0df672049bb726385bca36aa9ccf35565c8f0201.tar.zst | |
Remove completed work from TODO-pages
Diffstat (limited to 'TODO-pages.md')
| -rw-r--r-- | TODO-pages.md | 22 |
1 files changed, 3 insertions, 19 deletions
diff --git a/TODO-pages.md b/TODO-pages.md index fa556800..1d428f13 100644 --- a/TODO-pages.md +++ b/TODO-pages.md @@ -194,10 +194,9 @@ Other notes: ## Flexible Assembly This section discusses modifications to the command-line syntax to make it easier to add flexibility -going forward without breaking backward compatibility. The main thrust will be to create -non-positional alternatives to some things that currently use positional arguments (`--pages`, -`--overlay`, `--underlay`), as was done for `--encrypt` in 11.7.0, to make it possible to add -additional flags. +going forward without breaking backward compatibility. In qpdf 11.9.0, we added non-positional +options to `--pages`, `--overlay`, `--underlay` and modifid configuration to make it easier to add +new options. In several cases, we allow specification of transformations or placements. In this context: * The origin is always lower-left corner. @@ -222,21 +221,6 @@ In several cases, we allow specification of transformations or placements. In th * A rectangle may also be just one of `M|C|B|T|A` to refer to a page's media, crop, bleed, trim, or art box. -Tweak `--pages` similarly to `--encrypt`. As an alternative to `--pages file [--password=p] range ---`, support `--pages --file=x --password=y --range=z --`. This allows for a more flexible syntax. -If `--file` appears, positional arguments are disallowed. The same applies to `--overlay` and -`--underlay`. - -``` -OLD: qpdf 2.pdf --pages 1.pdf --password=x . 3.pdf 1-z -- out.pdf -NEW: qpdf 2.pdf --pages --file=1.pdf --password=x --file=. --file 3.pdf --range=1-z -- out.pdf -``` - -This makes it possible to add additional flags to do things like control how document-level features -are handled, specify placement options, etc. Given the above framework, it would be possible to add -additional features incrementally, without breaking compatibility, such as selecting or splitting -pages based on tags, article threads, or outlines. - It's tempting to allow assemblies to be nested, but this gets very complicated. From the C++ API, there is no problem using the output of one `QPDFAssembler` as the input to another, but supporting this from the CLI is hard because of the way JSON/arg parsing is set up. If people need to do that, |