Version 2.4.0 (2020-05-16)

This release drops special Web browser requirements to access dasht-server(1), improves error messages in dasht-docset-install(1), ensures clean up of stale files that contain whitespace in their names, and resolves a few other issues.

Minor:

• dasht-server-http(1): serve local file:// URLs through http:// URLs.

  Users no longer have to use special browsers or special configurations that allow the loading of file:// links from http://127.0.0.1 URLs. All browsers can now natively access the dasht-server(1) search engine.

  See https://github.com/sunaku/dasht/issues/45

Patch:

• dasht-docsets-update(1): remove stale files with whitespace in names.

  Thanks to @frodeaa for reporting this issue and contributing a patch:

  Replace xargs with while read and avoid globbing. The same could be achived by using xargs -0 (GNU/BSD) if newline is replaced with \0.

  tr '\n' '\0' | xargs -0 sh -e -u -c '
  

  See https://github.com/sunaku/dasht/issues/35

• dasht-server-http(1): escape "C++" docset name as ^C\+\+$ regex.

  When the "C++" docset was selected from the "in docsets" dropdown menu in dasht-server(1), the plus signs weren't properly escaped per regex syntax.

  See https://github.com/sunaku/dasht/issues/49

• dasht-docsets-install(1): validate gzip(1) integrity before extraction.

  This avoids cryptic errors from tarball extraction:

  gzip: stdin: unexpected end of file
  tar: Child returned status 1
  tar: Error is not recoverable: exiting now
  

  By pointing out the cause of the error to the user:

  gzip: Apple_Guides_and_Sample_Code.tgz: unexpected end of file
  

• dasht-docsets-install(1): restore support for older wget(1) versions.

  Older wget versions don't support the --show-progress option:

  wget: unrecognized option '--show-progress'
  Usage: wget [OPTION]... [URL]...
  
  Try ‘wget --help’ for more options.
  

• dasht-query-line(1): update URI fragments for HTML and CSS docsets.

Version 2.3.0 (2018-10-09)

This release provides better error messaging for first-time users who try to search immediately after installing dasht but before they install any docsets. It also fixes some HTML rendering issues and improves portability under macOS.

Minor:

• Notify user when no docsets installed for searching.

• wget: don't be verbose but show download progress.

Patch:

• GH-28: some docsets embed <dash> XML in URL fields.

• GH-25: HTML 4 browsers don't support ' entity.

  See https://stackoverflow.com/a/2083770 which refers to this spec:

  C.16. The Named Character Reference '

  https://www.w3.org/TR/xhtml1/#C_16

  The named character reference ' (the apostrophe, U+0027) was introduced in XML 1.0 but does not appear in HTML. Authors should therefore use ' instead of ' to work as expected in HTML 4 user agents.

• GH-31: macOS error upon rmdir: illegal option -- v.

  Thanks to Frode Aannevik (@frodeaa) for reporting this issue.

Other:

• README: add installation method for macOS Homebrew.

• README: require gawk; Debian's default mawk hangs.

Version 2.2.0 (2017-08-15)

This release fixes the ability to install new docsets (which was broken since July 2017 due to unannounced, incompatible upstream changes in docset hosting), improves portability, search form usability, and saves space updating docsets.

Minor:

• When a docset is updated, any obsolete files left behind by the previous version of the docset's installation are now deleted to save disk space.

• dasht-server: update styling for a more user-friendly search form:

  • Make submit button as tall as the entire form so it's easy to hit.
  • Use monospace font throughout the form to enhance ilIO0o variance.
  • Shorten placeholder text to fit default width of popular browsers.

Patch:

• GH-23: Kapeli moved docset download links into Git, breaking our ability to install new docsets (because the download links page no longer exists).

  https://github.com/zealdocs/zeal/issues/294#issuecomment-84435400

• POSIX sed(1) reserves the right to reject the semicolon command separator.

  Per http://pubs.opengroup.org/onlinepubs/009695399/utilities/sed.html

  Historically, the sed ! and } editing commands did not permit multiple commands on a single line using a semicolon as a command delimiter. Implementations are permitted, but not required, to support this extension.

Other:

• dasht-server: recommend Chrome browser with LocalLinks extension.

• README: show how to set up $MANPATH for easy man(1).

• tar: use UNIX-style invocation syntax: -z after -f.

• sed: use pipe delimiters when dealing with slashes.

Version 2.1.0 (2016-05-28)

This release improves the feedback users and scripts get from dasht scripts, fixes the ability to run dasht from non-setpgid() environments like (Neo)Vim, adds TAB completion for ZSH, and provides screencasts for prospective users.

Minor:

• dasht(1) now automatically opens the first search result if only one.

• dasht-query-* scripts now exit with status 44 when no results found.

• TAB completion for ZSH (see etc/zsh/ folder) for all dasht scripts.

  Pressing TAB at the first argument completes '' and puts you on the second argument, which is perfect for skipping the pattern altogether. Pressing TAB at the second argument completes installed docset names.

  Thanks to Tobias Mersmann (@tmerse) for suggesting this feature and providing starter code at https://github.com/sunaku/dasht/issues/10.

• dasht-server-http(1) now shows "no results found" message in browser.

Patch:

• dasht-query-line(1) now sets default URI fragment for Erlang docset.

  This affects modules, like the "dets" result in dasht dets erlang.

• dasht-server-http(1) now opens search result links in the same window.

  w3m(1) opens search result links in the same window, so don't make the experience any different in browsers connected to dasht-server(1).

• dasht(1) has revised pipefail emulation since Vim doesn't setpgid().

  When :!dasht some_query_that_has_no_results_here is run inside Vim, the w3m(1) instance still lives on, even though no results were found, because the child processes of dasht(1) don't inherit its pid as pgid.

  That's why terminating all children with kill(1) on pgid doesn't work. Instead, the new strategy is to selectively kill w3m(1) first and then dasht(1) to achieve the desired effect: no more w3m(1) and nonzero exit.

• dasht(1) now avoids /bin/sh: line 1: Terminated warning under BASH.

  To ensure normal SIGTERM propagation to children, trap SIGUSR1 instead.

• Revised "no results found" messages for HTML and text user interfaces.

Other:

• README: add screencasts of dasht in the terminal and browser:

  Watch the "dasht in a terminal" and "dasht in a browser" screencasts.

• README: add link to vim-dasht plugin for (Neo)Vim integration:

  https://github.com/sunaku/vim-dasht

Version 2.0.0 (2016-03-17)

This release improves the local search engine's responsiveness, usability, and appearance (especially on small displays, like those found in mobile devices); improves search term highlighting; and fixes escaping bugs and HTML5 validity.

Major:

• dasht-query-exec(1) now groups by first letter when nothing is searched.

  This gives you a better overview of the breadth of available topics (A-Z) than the previous approach of simply returning the first 100 topics did.

• dasht-query-html(1) now wraps its HTML output, if any, in <table> tags.

  This moves the printing of HTML <table> tags into dasht-query-html(1) and makes dasht(1) run w3m(1) eagerly, which provides visual feedback to the user when a large HTML document is being read and buffered, and in the case where no results are found: terminate with a message on stderr.

Minor:

• dasht-server-http(1) now streams search results to you as they are found.

  Serve the HTML header and search form immediately---before the search is even performed---so that the user instantly (and at the very least) sees the search form in case they decide to abort the HTTP transfer partway.

• dasht-server-http(1) now provides a drop-down menu for docset selection.

  Drop the HTML5 <datalist> because it can only suggest a single item, and that too only when the text field is empty! Instead, provide a <select> drop-down menu from which the user can choose a single item and build up multiple docset selections iteratively, with repeated form submissions.

• dasht-server-http(1) now word-wraps search results to fit small displays.

  Insert word-break opportunity <wbr> tags at the end of capitalized words, runs of lowercase text, numbers, and punctuation marks to help the browser fit search results to small displays, as found in mobile devices.

• dasht-query-html(1): Underline search terms so they stand out in w3m(1).

Patch:

• dasht-query-exec(1): escape SQL single quotes in the search pattern.

• dasht-query-html(1): escape HTML entities in search result token name.

• dasht-query-line(1): tr -s squeezes after translation, not beforehand.

  Searching for % % resulted in SQL LIKE %\%\% instead of %\%%\%%.

• dasht-server-http(1): Fix W3C Validator error on scoped <style> element.

  Error: Element style is missing required attribute scoped.

• dasht-server-http(1): Fix W3C Validator error on docsets <label> element.

  Error: The label element may contain at most one button, input, keygen, meter, output, progress, select, or textarea descendant.

• dasht-server-http(1): Specify UTF-8 charset for special chars in docsets.

  Bash and Docker docsets use the special "…" ellipsis Unicode character.

• dasht-query-html(1): Optimize search term highlighting and rework style.

  When an empty pattern was given, useless empty highlights (bold and italic) were added between every single character in a search result.

• dasht-query-html(1): Emulate the IGNORECASE=1 feature for POSIX awk(1).

Version 1.2.0 (2016-03-14)

Minor:

• Added dasht-docsets-extract(1) script for installing third-party docsets and for making sure extracted directory names match docset *.tgz files.

  Docset tarballs downloaded by dasht-docset-install(1) have no spaces in their names, so use the same naming scheme for their extracted folders. Thanks to Martijn Hoogendoorn (@mhoogendoorn) for reporting that such naming mismatches occur and for suggesting a potential fix in issue #5.

• dasht-docsets-install(1) and dasht-docsets-remove(1) learned --force.

  The xargs -p prompt reads from /dev/tty so it's not easy to automate.

• dasht-docsets-remove(1) is now verbose when deleting files because large docsets (like the Mono docset, sized at 7.6 GiB) take a while to delete.

• dasht-query-line(1) now adds default URI fragments to search result URLs, letting you skip past the mess of navigation links atop these 138 docsets:

  AWSJavaScript, ActionScript, Akka, Android, Angular.dart, AngularJS, Ansible, ApacheHTTPServer, AppceleratorTitanium, Arduino, Bash, Boost, Bootstrap2, C, C++, CMake, CSS, CakePHP, Cappuccino, Chai, Chef, Clojure, Cocos2D, Cocos2D-X, Cocos3D, CodeIgniter, CoffeeScript, ColdFusion, Compass, Cordova, Corona, CouchDB, Craft, D3JS, Dart, Docker, Dojo, Drupal7, Drupal8, ElasticSearch, Elixir, EmberJS, Erlang, Express, ExpressionEngine, ExtJS, FontAwesome, Foundation, GLib, Go, Grails, Groovy, GroovyJDK, Grunt, Gulp, HTML, Handlebars, Haskell, Ionic, Jasmine, JavaFX, JavaScript, JavaEE6, JavaEE7, JavaSE6, JavaSE7, JavaSE8, Jekyll, Joomla, KnockoutJS, Kobold2D, Laravel, Less, MarionetteJS, Meteor, MongoDB, Mongoose, Mono, Nginx, OpenCVC, OpenCVC++, OpenCVJava, OpenCVPython, PHP, PHPUnit, Perl, Phalcon, PhoneGap, PlayJava, PlayScala, Polymer.dart, Processing, PrototypeJS, Puppet, Qt4, Qt5, R, React, Redis, Ruby, Ruby2, RubyonRails3, RubyonRails4, RubyonRails5, Rust, SQLite, SVG, SailsJS, Scala, SemanticUI, SenchaTouch, Smarty, Sparrow, SpringFramework, Statamic, Stylus, Susy, Swift, Symfony, TYPO3, Tcl, Twig, Twisted, Unity3D, VMwarevSphere, VueJS, WordPress, XSLT, XUL, Xamarin, Xojo, YUI, Yii, ZendFramework1, ZendFramework2, jQuery, jQueryMobile, jQuery_UI.

• dasht(1) now sets w3m(1) options to make find-on-page more forgiving.

Patch:

• dasht-query-exec(1): Guides in C++ docset have 0-length zanchor values.

  This produced URLs with a stray "#" URI fragment separator at the end, which in turn broke w3m(1)'s ability to follow links in search results.

• dasht-query-exec(1): sqlite 3.7.9 wants options before arguments.

  Thanks to @joshpy for reporting this in issue #3 and suggesting the fix.

• dasht-docsets-install(1): fix gotcha in shell short-circuit evaluation.

  Thanks to Edgar Hipp (@netei) for reporting and fixing this in issue #6.

• dasht-docsets-install(1) is now visibly faster to install large docsets.

  Don't bother checking whether the docset archive is corrupt or partially downloaded because tar(1) will subsequently fail under such cases anyway.

• dasht-server-http(1): Search form obscured results in mobile browsers.

• dasht-server-http(1): Bold effect on hover slowed graphical browsers.

Version 1.1.0 (2016-02-28)

This release adds UNIX manpages, improves the UI, and fixes MacOSX support.

Minor:

• Add "[y/N]" hint to xargs confirmation prompt. Thanks to Christian Höppner for suggesting this improvement.

• Add UNIX manual pages for all scripts, generated using binman.

Patch:

• sed(1), awk(1), et. al. differ in curious ways under MacOSX. Thanks to Alaric Holloway and Kareem Gan for reporting bugs and testing fixes.

Version 1.0.0 (2016-01-24)

Initial public release of dasht, with stable command line API. :birthday: