Summary: | Proposal for Zsh guide section in Gentoo documentation | ||
---|---|---|---|
Product: | [OLD] Docs on www.gentoo.org | Reporter: | Henryk Konsek <hak8> |
Component: | New Documentation | Assignee: | Xavier Neys (RETIRED) <neysx> |
Status: | RESOLVED FIXED | ||
Severity: | normal | CC: | docs-team, morritt.andrew |
Priority: | High | ||
Version: | unspecified | ||
Hardware: | All | ||
OS: | Linux | ||
Whiteboard: | |||
Package list: | Runtime testing required: | --- | |
Attachments: |
Proposal of initial version of the Zsh guide
zsh.xml zsh.diff Added Custom Prompt section Typos, more about completion, misc section Diff against last version Aspelling, history section has been added Diff against the latest version zsh.xml zsh.xml zsh.xml |
Description
Henryk Konsek
2006-02-18 15:42:13 UTC
Created attachment 80129 [details]
Proposal of initial version of the Zsh guide
Latching onto this bug to do some basic editing. Created attachment 80133 [details]
zsh.xml
New edited version. Added <i>'s to prompts, Zsh->zsh, some other minor guidexml fixes, and some grammar fixes.
Created attachment 80134 [details, diff]
zsh.diff
Diff against the original version.
Created attachment 80144 [details]
Added Custom Prompt section
Here is a version I created, adding a section on creating a custom zsh prompt. I created it using Chris White's version, and set the version tag to 1.2. Because I'm on a Windows computer at the moment, I can't create a patch.
Thank You,
Andrew
Comment on attachment 80144 [details]
Added Custom Prompt section
Changed filetype
Created attachment 80319 [details]
Typos, more about completion, misc section
Created attachment 80320 [details, diff]
Diff against last version
Created attachment 80326 [details]
Aspelling, history section has been added
Created attachment 80327 [details, diff]
Diff against the latest version
Is that finished? We could finally publish it if i got some input from you. BTW, while reading it, i noticed that it doesn't in fact mention switching to zsh permanently (usermod -s)... How about adding it? Hi > Is that finished? We could finally publish it if i got some input from you. In my humble opinion it is fine to publish. At this moment it contains majority of information needed by "zsh youngsters". > BTW, while reading it, i noticed that it doesn't in fact mention switching to > zsh permanently (usermod -s)... How about adding it? Good idea. usermod or ~/.bashrc (for non-root users with lazy sysadmins :-) ). I can write it. I'll do it and commit results this evening or night I guess. Created attachment 93612 [details]
zsh.xml
I've added chapter 'Making zsh default shell' as requested.
Created attachment 95857 [details]
zsh.xml
Just grammar/spellchecked it, added a little bit about starting zsh after installation - nothing too big though, improves the quality of the doc though imho. Also updated version number and date. Made sure that it followed the GuideXML standards (it didn't when i got it...).
Created attachment 95873 [details]
zsh.xml
Added a paragraph on chsh, double checked for grammatical/spelling mistakes - all looks good. Passes xmllint, and I've double-checked to ensure that there are no missing <c> or <i> tags. Sorted out the indentation of the table - everything looks good to go :)
Edited & commented out the bit about searching the history as it just does not work as explained (up arrow displays previous commands in sequence). Feel free to open a new bug about it. Thanks to all for your contribution. (In reply to comment #16) > Edited & commented out the bit about searching the history as it just does not > work as explained (up arrow displays previous commands in sequence). Weird. I've checked again on brand new zsh installation and it still works as it ought to. I've noticed similar behaviour sth about 2 years ago on PLD Linux, but I haven't figured out why it happens. I would be grateful is somebody else olso could try it and share his or her observation with us. Maybe we could fix it somehow. This history searching is really splendid feature and we should share it with others :) I've never used zsh for more than half an hour so i can't really say what's wrong. But i can say that neysx is right and this search part just isn't working. It shows the last command typed in and doesn't search for anything. Hmmm. I hadn't meant to keep this on open. Sorry. I've done some research and noticed that this weird history scanning depends on terminal used. In particular Eterm used by me (as well as TTY console) works fine, while for instance Xterm and GnomeTerminal ignore search settings. I can't figure out why such weird things happen so I've issued this question to Zsh-Users mailing list. Greetings. Thanks to Andrey Borzenkov who has answered my question on Zsh-Users mailing list. Solution is to use 'zkdb' module: autoload zkbd; zkbd However there is a relative lots of user interaction with zkdb script and also few additional lines to add to zshrc to make our shell to load script generated by zkbd. It may be hard to make description of this process short and clear enough. I consider removal of this feature from this tutorial then. Another anxious issue is that XTerm configured with zkb works fine while Gnome-Terminal prompt me with Help when zkb asks me to enter F1 during its tests. That may be another reason to avoid this feature due to nondeterministic behaviour of zkb under various types of X11-terms. I'm afraid that this section (i.e. history searching) of guide will be too large and complicated to fit into Gentoo Guides convention. |