1
0
mirror of git://git.code.sf.net/p/zsh/code synced 2024-09-27 22:40:20 +02:00

46240: Make the expansion of manref()() in ztexi.yo match its expansion in zman.yo.

The difference was mostly harmless in the common case "(see manref(foo)(42))",
which expanded to "(see man page foo(42))" under ztexi.yo, but in other
contexts the ztexi.yo expansion was was nonsensical; for example:

    "the BSD manref(echo)(1) command"

    "the string returned by the manref(getlogin)(3) system call"

    "advisory file locking (via the manref(fcntl)(2) system call)"

    "this is the exact opposite from manref(ls)(1),"

While there, copyedit some uses of manref()().
This commit is contained in:
Daniel Shahaf 2020-07-12 18:06:50 +00:00
parent b5f24592ad
commit fa51a38955
6 changed files with 14 additions and 6 deletions

View File

@ -1,3 +1,10 @@
2020-07-13 Daniel Shahaf <d.s@daniel.shahaf.name>
* 46240: Doc/Zsh/builtins.yo, Doc/Zsh/contrib.yo,
Doc/Zsh/jobs.yo, Doc/Zsh/params.yo, Doc/ztexi.yo: Make the
expansion of manref()() in ztexi.yo match its expansion in
zman.yo.
2020-07-12 Daniel Shahaf <d.s@daniel.shahaf.name>
* 46183: Test/D03procsubst.ztst: New XFail test: external

View File

@ -2300,7 +2300,7 @@ findex(umask)
cindex(umask)
item(tt(umask) [ tt(-S) ] [ var(mask) ])(
The umask is set to var(mask). var(mask) can be either
an octal number or a symbolic value as described in manref(chmod)(1).
an octal number or a symbolic value as described in the manref(chmod)(1) man page.
If var(mask) is omitted, the current value is printed. The tt(-S)
option causes the mask to be printed as a symbolic value. Otherwise,
the mask is printed as an octal number. Note that in

View File

@ -3560,7 +3560,8 @@ Calling tt(zsh-mime-setup) with the option
tt(-v) causes verbose output to be shown during the setup operation.
The system respects the tt(mailcap) flags tt(needsterminal) and
tt(copiousoutput), see manref(mailcap)(4).
tt(copiousoutput); see manref(mailcap)(4) or manref(mailcap)(5)
(the man page's name varies across platforms).
The functions use the following styles, which are defined with the
tt(zstyle) builtin command (\
@ -4465,7 +4466,7 @@ counts the number of arguments passed to each execution of var(command),
em(including) any var(arg) list. Also, any time tt(-i) or tt(-I) is used,
each var(input) is processed separately as if by `tt(-L) tt(1)'.
For details of the other tt(zargs) options, see zmanref(xargs) (but note
For details of the other tt(zargs) options, see the manref(xargs)(1) man page (but note
the difference in function between tt(zargs) and tt(xargs)) or run
tt(zargs) with the tt(-)tt(-help) option.
)

View File

@ -111,7 +111,7 @@ cindex(jobs, disowning)
cindex(disowning jobs)
findex(disown, use of)
To avoid having the shell terminate the running jobs, either
use the bf(nohup) command (see manref(nohup)(1))
use the manref(nohup)(1) command
or the tt(disown) builtin.
sect(Signals)
The tt(INT) and tt(QUIT) signals for an invoked

View File

@ -731,7 +731,7 @@ explicitly set locally.
)
vindex(ERRNO)
item(tt(ERRNO) <S>)(
The value of errno (see manref(errno)(3))
The value of tt(errno) (see manref(errno)(3))
as set by the most recently failed system call.
This value is system dependent and is intended for debugging
purposes. It is also useful with the tt(zsh/system) module which

View File

@ -150,7 +150,7 @@ def(comment)(1)(\
COMMENT(--- cross-references ---)
def(manref)(2)(man page ARG1+LPAR()ARG2+RPAR())
def(manref)(2)(ARG1+LPAR()ARG2+RPAR())
def(zmanref)(1)(manref(ARG1)(1))
def(noderef)(1)(\
NOTRANS(@ref{)ARG1+NOTRANS(})\