Zsh Mailing List Archive
Messages sorted by: Reverse Date, Date, Thread, Author

Manual for new style completion



Been busy at the weekend...

Below is a tar file that adds two doc files and a file `patch' (which
should be applied, of course).

In the docs the new style completion appears under the title
`Completion Widgets' after the old `Programmable Completion'. Even
though Bart said that we don't need a manual for stuff that will be
removed, I have described anything (I wrote it before I read his
mail). But the description is quite short and it should be clear that
many things may change or even disappear. 

All in all, you should take this only as a start, we will work upon
that some more.

Bye
 Sven

begin 600 new-comp-man.tar.gz
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
MF;O`Z,NCCNL@xxxxxxxxxxxx=OAKJ8LH0S'>GH/HY"HZTX8R%'%"(G:T)<6P
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
;?>X^=Y^[S]WG[G/WN?O\__G\#XJ$DSH`>```
`
end

--
Sven Wischnowsky                         wischnow@xxxxxxxxxxxxxxxxxxxxxxx



Messages sorted by: Reverse Date, Date, Thread, Author