Zsh Mailing List Archive
Messages sorted by:
Reverse Date,
Date,
Thread,
Author
A possible fix of an indentation problem in manages
- X-seq: zsh-workers 32494
- From: "Jun T." <takimoto-j@xxxxxxxxxxxxxxxxx>
- To: zsh-workers@xxxxxxx
- Subject: A possible fix of an indentation problem in manages
- Date: Tue, 18 Mar 2014 01:01:32 +0900
- List-help: <mailto:zsh-workers-help@zsh.org>
- List-id: Zsh Workers List <zsh-workers.zsh.org>
- List-post: <mailto:zsh-workers@zsh.org>
- Mailing-list: contact zsh-workers-help@xxxxxxx; run by ezmlm
This is a reply to old posts X-seq: 29369, 29370
http://www.zsh.org/mla/workers/2011/msg00804.html
http://www.zsh.org/mla/workers/2011/msg00805.html
As pointed out in the above post, indentation of the text in the
description of _arguments in zshcompsys.1 has a problem. I think
that the place where the problem starts is:
....
the first optarg that follows the optspec; see
below.
It is possible for options with a literal `+' or `=' to appear,
but that character must be quoted, for example `-\+'.
Here, the indentation level is reduced by 2, but I think it should
be reduce only by 1.
This is due to that ENDITEM is redefined to emit '.RE' and used twice
by the macros item() and enditem().
A similar problem exists also in zshzle.1 (description of bindkey)
and zshmodule.1 (zparseopt).
The following patch *seems* to fix the problem, at least for the current
manpages. But even if it works, there may be a better way than to
re-re-define ENDITEM...
diff --git a/Doc/zman.yo b/Doc/zman.yo
index 8d17f78..3329cb9 100644
--- a/Doc/zman.yo
+++ b/Doc/zman.yo
@@ -110,7 +110,7 @@ def(startitem)(0)(\
def(enditem)(0)(\
ENDITEM()\
STDPAR()\
- +redef(ENDITEM)(0)(NOTRANS(.RE)STDPAR())\
+ +redef(ENDITEM)(0)(NOTRANS(.RE)STDPAR()redef(ENDITEM)(0)(CMT()))\
)
def(item)(2)(\
NOTRANS(.TP)+NL()\
@@ -121,7 +121,7 @@ def(item)(2)(\
+redef(PARAGRAPH)(0)(\
NL()NOTRANS(.RS)+NL()NOTRANS(.PP)+NL()\
STDPAR()\
- +redef(ENDITEM)(0)(NOTRANS(.RE)STDPAR())\
+ +redef(ENDITEM)(0)(NOTRANS(.RE)STDPAR()redef(ENDITEM)(0)(CMT()))\
)\
ARG2\
+ENDITEM()\
Messages sorted by:
Reverse Date,
Date,
Thread,
Author