fishfish shell release notes

From 18ace555b05042720c0cc037eb4cf8588285f596 Mon Sep 17 00:00:00 2001 From: ridiculousfish Date: Sat, 19 May 2012 17:04:39 -0700 Subject: Added release notes for beta 1 --- release_notes.html | 84 ++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 84 insertions(+) create mode 100644 release_notes.html (limited to 'release_notes.html') diff --git a/release_notes.html b/release_notes.html new file mode 100644 index 00000000..999061d4 --- /dev/null +++ b/release_notes.html @@ -0,0 +1,84 @@ + +fishfish shell release notes + + +

Release Notes for fishfish Beta r1

+ +

Scripting

No changes! All existing fish scripts, config files, completions, etc. from trunk should continue to work.

+ +

New Features

Autosuggestions. Think URL fields in browsers. When you type a command, fish will suggest the rest of the command after the cursor, in a muted gray when possible. You can accept the suggestion with the right arrow key or Ctrl-F. Suggestions come from command history, completions, and some custom code for cd; there's a lot of potential for improvement here. The suggestions are computed on a background pthread, so they never slow down your typing. + +The autosuggestion feature is incredible. I miss it dearly every time I use anything else.
term256 support where available, specifically modern xterms and OS X Lion. You can specify colors the old way ('set_color cyan') or by specifying RGB hex values ('set_color FF3333'); fish will pick the closest supported color. Some xterms do not advertise term256 support either in the $TERM or terminfo max_colors field, but nevertheless support it. For that reason, fish will default into using it on any xterm (but it can be disabled with an environment variable).
Web-based configuration page. There is a new function 'fish_config'. This spins up a simple Python web server and opens a browser window to it. From this web page, you can set your shell colors and view your functions, variables, and history; all changes apply immediately to all running shells. Eventually all configuration ought to be supported via this mechanism (but in addition to, not instead of, command line mechanisms).
Man page completions. There is a new function 'fish_update_completions'. This function reads all the man1 files from your manpath, removes the roff formatting, parses them to find the commands and options, and outputs fish completions into ~/.config/fish/completions. It won't overwrite existing completion files (except ones that it generated itself).

+ +

Programmatic Changes

+ +

fish is now entirely in C++. I have no particular love for C++, but it provides a ready memory-model to replace halloc. We've made an effort to keep it to a sane and portable subset (no C++11, no boost, no going crazy with templates or smart pointers), but we do use the STL and a little tr1.
halloc is entirely gone, replaced by normal C++ ownership semantics. If you don't know what halloc is, well, now you have two reasons to be happy.
All the crufty C data structures are entirely gone. array_list_t, priority_queue_t, hash_table_t, string_buffer_t have been removed and replaced by STL equivalents like std::vector, std::map, and std::wstring. A lot of the string handling now uses std::wstring instead of wchar_t *
fish now spawns pthreads for tasks like syntax highlighting that require blocking I/O.
History has been completely rewritten. History files now use an extensible YAML-style syntax. History "merging" (multiple shells writing to the same history file) now works better. There is now a maximum history length of about 250k items (256 * 1024).
The parser has been "instanced," so you can now create more than one.
Total #LoC has shrunk slightly even with the new features.

+ +

Performance

+ +

fish now runs syntax highlighting in a background thread, so typing commands is always responsive even on slow filesystems.
echo, test, and pwd are now builtins, which eliminates many forks.
The files in share/functions and share/completions now get 'internalized' into C strings that get compiled in with fish. This substantially reduces the number of files touched at startup. A consequence is that you cannot change these functions without recompiling, but often other functions depend on these "standard" functions, so changing them is perhaps not a good idea anyways.

+ +

Here are some system call counts for launching and then exiting fish with the default configuration, on OS X. The first column is fish trunk, the next column is with our changes, and the last column is bash for comparison. This data was collected via dtrace. + +

+           before   after    bash    
+  open          9       4       5
+  fork         28      14       0
+  stat        131      85      11
+ lstat        670       0       0
+  read        332      80       4
+ write        172     149       0
+

+ +

The large number of forks relative to bash are due to fish's insanely expensive default prompt, which is unchanged in my version. If we switch to a prompt comparable to bash's (lame) default, the forks drop to 16 with trunk, 4 after our changes. + +

The large reduction in lstat() numbers is due to fish no longer needing to call ttyname() on OS X. + +

We've got some work to do to be as lean as bash, but we're on the right track. + + -- cgit v1.2.3