diff options
| author | Robin Haberkorn <robin.haberkorn@googlemail.com> | 2025-08-06 16:46:37 +0300 |
|---|---|---|
| committer | Robin Haberkorn <robin.haberkorn@googlemail.com> | 2025-08-06 16:46:37 +0300 |
| commit | 280cb9da39fc7b5357f6071926d511394f6d0152 (patch) | |
| tree | cdca852694fd3e4cc9293c374d16ac69d9be01ea /doc/sciteco.7.template | |
| parent | c5510d684e4879ab9a5295b4a1981888a4268627 (diff) | |
| download | sciteco-280cb9da39fc7b5357f6071926d511394f6d0152.tar.gz | |
command-line arguments are no longer passed via the unnamed buffer, but via special Q-registers ^Ax
* The unnamed buffer is also used for reading from --stdin, so you couldn't practically combine
--stdin with passing command-line arguments to macros.
* The old approach of passing command-line arguments via lines in the
unnamed buffer was flawed anyway as it wouldn't work with filenames containing LF.
This is just a very ancient feature, written when there weren't even long Q-reg names in SciTECO.
* You can now e.g. pipe into SciTECO and edit what was read interactively, e.g. `dmesg | sciteco -i`.
You can practically use SciTECO as a pager.
* htbl.tes is now a command-line filter (uses -qio).
* grosciteco.tes reads Troff intermediate code from stdin, so we no longer need
"*.intermediate" temporary files.
* added a getopt.tes test case to the testsuite.
* This change unfortunately breaks most macros accepting command-line arguments,
even if they used getopt.tes.
It also requires updating ~/.teco_ini - see fallback.teco_ini.
Diffstat (limited to 'doc/sciteco.7.template')
| -rw-r--r-- | doc/sciteco.7.template | 20 |
1 files changed, 20 insertions, 0 deletions
diff --git a/doc/sciteco.7.template b/doc/sciteco.7.template index bad7e7d..21385a3 100644 --- a/doc/sciteco.7.template +++ b/doc/sciteco.7.template @@ -1668,6 +1668,26 @@ the original clipboard contents, though. The numeric parts of the clipboard registers are currently not used by \*(ST. .TP +.SCITECO_TOPIC ^Ax +.BI ^A x +An argument passed on the operating system's command line. +\fIx\fP can be an integer beginning with 0. +.B ^A0 +is the name of the program, as passed via \(lqargv[0]\(rq to +C programs, and is guaranteed to always exist. +All remaining registers for \fIx\fP larger than or equal to 1 +represent the command-line parameters after all the built-in +options as reported by \(lq@PACKAGE@ --help\(rq. +In other words all the options processed by the \*(ST main program +including the file names after \(lq--mung\(rq are automatically +excluded from the +.BI ^A x +array. +The numeric parts of the argument registers are +currently not used by \*(ST. +For more details, see +.BR sciteco (1). +.TP .BI ^K key Key macro registers as documented in section .BR "KEY TRANSLATION" . |