Zsh Mailing List Archive
Messages sorted by:
Reverse Date,
Date,
Thread,
Author
[PATCH] docs: fix more warnings
- X-seq: zsh-workers 54504
- From: dana <dana@xxxxxxx>
- To: zsh-workers@xxxxxxx
- Subject: [PATCH] docs: fix more warnings
- Date: Fri, 08 May 2026 14:22:13 -0500
- Archived-at: <https://zsh.org/workers/54504>
- Feedback-id: i9be146f9:Fastmail
- List-id: <zsh-workers.zsh.org>
i was testing mikael's documentation change (54499) -- it does fix the new
warnings that bart mentioned, but there's still this one:
./zsh.texi:19922: warning: node `Cursor Shape and Color' not in menu
i've fixed that by making that its own sect -- i don't think it logically made
sense as a subsect of Character Highlighting
then there are these, produced by `make html`:
troff:././intro.ms:2733: warning: cannot select font 'C'
idk that much about roff/ms but just changing \fC to \f(CR seems to work. the
warnings are gone and the pdf and html files both look the same as they do
without the change
i've included a preview of this below (the full diff is ~1800 lines of
find/replace)
i did notice that the intro.html we can build now (w/53213) has semi broken
formatting compared to the copy on the site -- there's no monospace at all
currently the script that updates docs on the site does not re-generate the
html version of the intro (there's a note about how we don't update it since
the texinfo is no longer available), so i guess this isn't really an issue,
but mentioning anyway
dana
diff --git a/Doc/Zsh/manual.yo b/Doc/Zsh/manual.yo
index ba38cbfe4..6dcec0063 100644
--- a/Doc/Zsh/manual.yo
+++ b/Doc/Zsh/manual.yo
@@ -111,6 +111,7 @@ menu(Zle Widgets)
menu(User-Defined Widgets)
menu(Standard Widgets)
menu(Character Highlighting)
+menu(Cursor Shape and Color)
Completion Widgets
diff --git a/Doc/Zsh/zle.yo b/Doc/Zsh/zle.yo
index 8c1cd078d..e7f062156 100644
--- a/Doc/Zsh/zle.yo
+++ b/Doc/Zsh/zle.yo
@@ -56,6 +56,7 @@ menu(User-Defined Widgets)
menu(Standard Widgets)
menu(Terminal Extensions)
menu(Character Highlighting)
+menu(Cursor Shape and Color)
endmenu()
texinode(Keymaps)(Zle Builtins)()(Zsh Line Editor)
@@ -2712,7 +2713,7 @@ termcap and the tt(COLORTERM) environment variable.
)
enditem()
-texinode(Character Highlighting)()(Terminal Extensions)(Zsh Line Editor)
+texinode(Character Highlighting)(Cursor Shape and Color)(Terminal Extensions)(Zsh Line Editor)
sect(Character Highlighting)
vindex(zle_highlight, setting)
@@ -2977,8 +2978,8 @@ special array parameter tt(region_highlight); see
ifnzman(noderef(Zle Widgets))\
ifzman(above).
-texinode(Cursor Shape and Color)()()(Character Highlighting)
-subsect(Cursor Shape and Color)
+texinode(Cursor Shape and Color)()(Character Highlighting)(Zsh Line Editor)
+sect(Cursor Shape and Color)
cindex(cursor shape)
cindex(cursor color)
diff --git a/Doc/intro.ms b/Doc/intro.ms
index cb1775490..3aabf1519 100644
--- a/Doc/intro.ms
+++ b/Doc/intro.ms
@@ -1,8 +1,8 @@
.nr PI 0
.nr LL 6.5i
.if \n(.g \{\
-.if "\*(.T"ascii" .ftr C R
-.if "\*(.T"latin1" .ftr C R
+.if "\*(.T"ascii" .ftr CR R
+.if "\*(.T"latin1" .ftr CR R
.if "\*(.T"html" .nr HTML 1
.nr De \n[.ss]
.\}
@@ -16,7 +16,7 @@
.ie \n[HTML] \{\
.de Ds
.DS I .5i
-.ft C
+.ft CR
..
.de De
.DE
@@ -31,7 +31,7 @@
.el \{\
.de Ds
.DS I .5i
-.ft C
+.ft CR
.ps 9
.vs 11
.ss 11
@@ -105,11 +105,11 @@ The text will frequently mention options that you can set to change
the behaviour of \fBzsh\fP. You can set these options with the
command
.Ds
-%\0setopt\0\fIoptionname\fC
+%\0setopt\0\fIoptionname\f(CR
.De
and unset them again with
.Ds
-%\0unsetopt\0\fIoptionname\fC
+%\0unsetopt\0\fIoptionname\f(CR
.De
Case is ignored in option names, as are embedded underscores.
.Sh "Filename Generation"
@@ -135,7 +135,7 @@ foo.c\0\0q.c
.De
Also, if the \fIEXTENDEDGLOB\fP option is set,
some new features are activated.
-For example, the \fC^\fP character negates the pattern following it:
+For example, the \f(CR^\fP character negates the pattern following it:
.Ds
%\0setopt\0extendedglob
%\0ls\0-d\0^*.c
(etc)
Messages sorted by:
Reverse Date,
Date,
Thread,
Author