Version 2.2.0 (2017-08-15)

sunaku · Aug 16, 2017 · 8e91ef3 · 8e91ef3
1 parent 40c4bef
commit 8e91ef3
Show file tree

Hide file tree

Showing 23 changed files with 66 additions and 22 deletions.
diff --git 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
@@ -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
@@ -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
@@ -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
@@ -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
@@ -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
@@ -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
@@ -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
@@ -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
@@ -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
@@ -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
@@ -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
@@ -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
@@ -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
@@ -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
@@ -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
@@ -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
@@ -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
@@ -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
@@ -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
@@ -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
@@ -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
@@ -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