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.
dasht-server-http(1): serve local
file:// URLs through
Users no longer have to use special browsers or special configurations
that allow the loading of
file:// links from
All browsers can now natively access the dasht-server(1) search engine.
dasht-docsets-update(1): remove stale files with whitespace in names.
Thanks to @frodeaa for reporting this issue and contributing a patch:
while readand avoid globbing. The same could be achived by using
xargs -0(GNU/BSD) if newline is replaced with
tr '\n' '\0' | xargs -0 sh -e -u -c '
dasht-server-http(1): escape "C++" docset name as
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.
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
Older wget versions don't support the
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.
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.
Notify user when no docsets installed for searching.
wget: don't be verbose but show download progress.
GH-28: some docsets embed
<dash> XML in URL fields.
GH-25: HTML 4 browsers don't support
See https://stackoverflow.com/a/2083770 which refers to this spec:
'(the apostrophe, U+0027) was introduced in XML 1.0 but does not appear in HTML. Authors should therefore use
'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.
README: add installation method for macOS Homebrew.
README: require gawk; Debian's default mawk hangs.
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.
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:
GH-23: Kapeli moved docset download links into Git, breaking our ability to install new docsets (because the download links page no longer exists).
POSIX sed(1) reserves the right to reject the semicolon command separator.
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.
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.
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.
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.
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.
dasht(1) has revised pipefail emulation since Vim doesn't setpgid().
:!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.
README: add screencasts of dasht in the terminal and browser:
README: add link to vim-dasht plugin for (Neo)Vim integration:
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.
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
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.
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
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-exec(1): escape SQL single quotes in the search pattern.
dasht-query-html(1): escape HTML entities in search result token name.
tr -s squeezes after translation, not beforehand.
% % resulted in SQL LIKE
%\%\% instead of
dasht-server-http(1): Fix W3C Validator error on scoped
Error: Element style is missing required attribute scoped.
dasht-server-http(1): Fix W3C Validator error on docsets
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.
Added dasht-docsets-extract(1) script for installing third-party docsets
and for making sure extracted directory names match docset
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.
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:
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.
This release adds UNIX manpages, improves the UI, and fixes MacOSX support.
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.
Initial public release of dasht, with stable command line API. :birthday: