diff --git a/VERSION.md b/VERSION.md index 446e024..8b922a6 100644 --- a/VERSION.md +++ b/VERSION.md @@ -1,3 +1,47 @@ +## 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]( + https://chrome.google.com/webstore/detail/locallinks/jllpkdkcdjndhggodimiphkghogcpida + ). + + * 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, diff --git a/bin/dasht b/bin/dasht index 0a71db2..06f36a2 100755 --- a/bin/dasht +++ b/bin/dasht @@ -1,6 +1,6 @@ #!/bin/sh -e # -# # DASHT 1 2016-05-28 2.1.0 +# # DASHT 1 2017-08-15 2.2.0 # # ## NAME # diff --git a/bin/dasht-docsets b/bin/dasht-docsets index fed0304..68808e5 100755 --- a/bin/dasht-docsets +++ b/bin/dasht-docsets @@ -1,6 +1,6 @@ #!/bin/sh -e # -# # DASHT-DOCSETS 1 2016-05-28 2.1.0 +# # DASHT-DOCSETS 1 2017-08-15 2.2.0 # # ## NAME # diff --git a/bin/dasht-docsets-extract b/bin/dasht-docsets-extract index 788b28b..bf02f1d 100755 --- a/bin/dasht-docsets-extract +++ b/bin/dasht-docsets-extract @@ -1,6 +1,6 @@ #!/bin/sh -e # -# # DASHT-DOCSETS-EXTRACT 1 2016-05-28 2.1.0 +# # DASHT-DOCSETS-EXTRACT 1 2017-08-15 2.2.0 # # ## NAME # diff --git a/bin/dasht-docsets-install b/bin/dasht-docsets-install index e9e9214..3af87b2 100755 --- a/bin/dasht-docsets-install +++ b/bin/dasht-docsets-install @@ -1,6 +1,6 @@ #!/bin/sh -e # -# # DASHT-DOCSETS-INSTALL 1 2016-05-28 2.1.0 +# # DASHT-DOCSETS-INSTALL 1 2017-08-15 2.2.0 # # ## NAME # diff --git a/bin/dasht-docsets-remove b/bin/dasht-docsets-remove index cac7c5e..952ad97 100755 --- a/bin/dasht-docsets-remove +++ b/bin/dasht-docsets-remove @@ -1,6 +1,6 @@ #!/bin/sh -e # -# # DASHT-DOCSETS-REMOVE 1 2016-05-28 2.1.0 +# # DASHT-DOCSETS-REMOVE 1 2017-08-15 2.2.0 # # ## NAME # diff --git a/bin/dasht-docsets-update b/bin/dasht-docsets-update index d473049..b37a408 100755 --- a/bin/dasht-docsets-update +++ b/bin/dasht-docsets-update @@ -1,6 +1,6 @@ #!/bin/sh -e # -# # DASHT-DOCSETS-UPDATE 1 2016-05-28 2.1.0 +# # DASHT-DOCSETS-UPDATE 1 2017-08-15 2.2.0 # # ## NAME # diff --git a/bin/dasht-query-exec b/bin/dasht-query-exec index 3a52df5..c491cb9 100755 --- a/bin/dasht-query-exec +++ b/bin/dasht-query-exec @@ -1,6 +1,6 @@ #!/bin/sh -e # -# # DASHT-QUERY-EXEC 1 2016-05-28 2.1.0 +# # DASHT-QUERY-EXEC 1 2017-08-15 2.2.0 # # ## NAME # diff --git a/bin/dasht-query-html b/bin/dasht-query-html index 17ece30..3d35834 100755 --- a/bin/dasht-query-html +++ b/bin/dasht-query-html @@ -1,6 +1,6 @@ #!/bin/sh -e # -# # DASHT-QUERY-HTML 1 2016-05-28 2.1.0 +# # DASHT-QUERY-HTML 1 2017-08-15 2.2.0 # # ## NAME # diff --git a/bin/dasht-query-line b/bin/dasht-query-line index cc1a061..56ec61a 100755 --- a/bin/dasht-query-line +++ b/bin/dasht-query-line @@ -1,6 +1,6 @@ #!/bin/sh -e # -# # DASHT-QUERY-LINE 1 2016-05-28 2.1.0 +# # DASHT-QUERY-LINE 1 2017-08-15 2.2.0 # # ## NAME # diff --git a/bin/dasht-server b/bin/dasht-server index e1c9a5d..136fcf6 100755 --- a/bin/dasht-server +++ b/bin/dasht-server @@ -1,6 +1,6 @@ #!/bin/sh -e # -# # DASHT-SERVER 1 2016-05-28 2.1.0 +# # DASHT-SERVER 1 2017-08-15 2.2.0 # # ## NAME # diff --git a/bin/dasht-server-http b/bin/dasht-server-http index 49e14c8..eb2297f 100755 --- a/bin/dasht-server-http +++ b/bin/dasht-server-http @@ -1,6 +1,6 @@ #!/bin/sh -e # -# # DASHT-SERVER-HTTP 1 2016-05-28 2.1.0 +# # DASHT-SERVER-HTTP 1 2017-08-15 2.2.0 # # ## NAME # diff --git a/man/man1/dasht-docsets-extract.1 b/man/man1/dasht-docsets-extract.1 index adc5f5b..0b5e1b1 100644 --- a/man/man1/dasht-docsets-extract.1 +++ b/man/man1/dasht-docsets-extract.1 @@ -1,4 +1,4 @@ -.TH DASHT\-DOCSETS\-EXTRACT 1 2016\-05\-28 2.1.0 +.TH DASHT\-DOCSETS\-EXTRACT 1 2016\-05\-28 2.2.0 .SH NAME .PP dasht\-docsets\-extract \- extracts Dash \[la]https://kapeli.com/dash\[ra] docset archives (\fB\fC*.tgz\fR files) diff --git a/man/man1/dasht-docsets-install.1 b/man/man1/dasht-docsets-install.1 index 249dda7..45c19e5 100644 --- a/man/man1/dasht-docsets-install.1 +++ b/man/man1/dasht-docsets-install.1 @@ -1,4 +1,4 @@ -.TH DASHT\-DOCSETS\-INSTALL 1 2016\-05\-28 2.1.0 +.TH DASHT\-DOCSETS\-INSTALL 1 2016\-05\-28 2.2.0 .SH NAME .PP dasht\-docsets\-install \- installs new Dash \[la]https://kapeli.com/dash\[ra] docsets diff --git a/man/man1/dasht-docsets-remove.1 b/man/man1/dasht-docsets-remove.1 index 65a894b..2c7a286 100644 --- a/man/man1/dasht-docsets-remove.1 +++ b/man/man1/dasht-docsets-remove.1 @@ -1,4 +1,4 @@ -.TH DASHT\-DOCSETS\-REMOVE 1 2016\-05\-28 2.1.0 +.TH DASHT\-DOCSETS\-REMOVE 1 2016\-05\-28 2.2.0 .SH NAME .PP dasht\-docsets\-remove \- removes installed Dash \[la]https://kapeli.com/dash\[ra] docsets diff --git a/man/man1/dasht-docsets-update.1 b/man/man1/dasht-docsets-update.1 index 154fda4..9a532e4 100644 --- a/man/man1/dasht-docsets-update.1 +++ b/man/man1/dasht-docsets-update.1 @@ -1,4 +1,4 @@ -.TH DASHT\-DOCSETS\-UPDATE 1 2016\-05\-28 2.1.0 +.TH DASHT\-DOCSETS\-UPDATE 1 2016\-05\-28 2.2.0 .SH NAME .PP dasht\-docsets\-update \- updates installed Dash \[la]https://kapeli.com/dash\[ra] docsets diff --git a/man/man1/dasht-docsets.1 b/man/man1/dasht-docsets.1 index 62a5867..3fef8fb 100644 --- a/man/man1/dasht-docsets.1 +++ b/man/man1/dasht-docsets.1 @@ -1,4 +1,4 @@ -.TH DASHT\-DOCSETS 1 2016\-05\-28 2.1.0 +.TH DASHT\-DOCSETS 1 2016\-05\-28 2.2.0 .SH NAME .PP dasht\-docsets \- lists installed Dash \[la]https://kapeli.com/dash\[ra] docsets diff --git a/man/man1/dasht-query-exec.1 b/man/man1/dasht-query-exec.1 index 2ccf41e..bc5642b 100644 --- a/man/man1/dasht-query-exec.1 +++ b/man/man1/dasht-query-exec.1 @@ -1,4 +1,4 @@ -.TH DASHT\-QUERY\-EXEC 1 2016\-05\-28 2.1.0 +.TH DASHT\-QUERY\-EXEC 1 2016\-05\-28 2.2.0 .SH NAME .PP dasht\-query\-exec \- searches a Dash \[la]https://kapeli.com/dash\[ra] docset's SQLite3 database file diff --git a/man/man1/dasht-query-html.1 b/man/man1/dasht-query-html.1 index 6270018..532bc4c 100644 --- a/man/man1/dasht-query-html.1 +++ b/man/man1/dasht-query-html.1 @@ -1,4 +1,4 @@ -.TH DASHT\-QUERY\-HTML 1 2016\-05\-28 2.1.0 +.TH DASHT\-QUERY\-HTML 1 2016\-05\-28 2.2.0 .SH NAME .PP dasht\-query\-html \- searches Dash \[la]https://kapeli.com/dash\[ra] docsets and emits HTML table rows diff --git a/man/man1/dasht-query-line.1 b/man/man1/dasht-query-line.1 index e08a06c..7fff524 100644 --- a/man/man1/dasht-query-line.1 +++ b/man/man1/dasht-query-line.1 @@ -1,4 +1,4 @@ -.TH DASHT\-QUERY\-LINE 1 2016\-05\-28 2.1.0 +.TH DASHT\-QUERY\-LINE 1 2016\-05\-28 2.2.0 .SH NAME .PP dasht\-query\-line \- searches Dash \[la]https://kapeli.com/dash\[ra] docsets and emits groups of lines diff --git a/man/man1/dasht-server-http.1 b/man/man1/dasht-server-http.1 index 15f8b88..f812548 100644 --- a/man/man1/dasht-server-http.1 +++ b/man/man1/dasht-server-http.1 @@ -1,4 +1,4 @@ -.TH DASHT\-SERVER\-HTTP 1 2016\-05\-28 2.1.0 +.TH DASHT\-SERVER\-HTTP 1 2016\-05\-28 2.2.0 .SH NAME .PP dasht\-server\-http \- simple search engine that powers diff --git a/man/man1/dasht-server.1 b/man/man1/dasht-server.1 index fd87e07..617f7fc 100644 --- a/man/man1/dasht-server.1 +++ b/man/man1/dasht-server.1 @@ -1,4 +1,4 @@ -.TH DASHT\-SERVER 1 2016\-05\-28 2.1.0 +.TH DASHT\-SERVER 1 2016\-05\-28 2.2.0 .SH NAME .PP dasht\-server \- runs a local search engine for your web browser diff --git a/man/man1/dasht.1 b/man/man1/dasht.1 index d381693..7c12746 100644 --- a/man/man1/dasht.1 +++ b/man/man1/dasht.1 @@ -1,4 +1,4 @@ -.TH DASHT 1 2016\-05\-28 2.1.0 +.TH DASHT 1 2016\-05\-28 2.2.0 .SH NAME .PP dasht \- API documentation in your terminal