Merge lp:~chipaca/snappy/snappy-man into lp:~snappy-dev/snappy/snappy-moved-to-github

[John Lenton]

zeroth iteration of snappy man.

Zyga correctly pointed out we should have a (ideally dynamically created) manpage. Here is the zeroth iteration of it. So much work to do still! But this is a start.

To read: snappy man | man -l -

[Sergio Schvezov (sergiusens)]

Can you add this to debian/rules as well?

Note: I tried adding to debian rules for u-d-f in the past and failed miserably.

review: Needs Information

[John Lenton (chipaca)]

I could, but we don't ship "man" in core ... still thinking about that.

[Sergio Schvezov (sergiusens)]

On Wed, Jul 29, 2015 at 01:25:11PM -0000, John Lenton wrote:
> I could, but we don't ship "man" in core ... still thinking about that.

But we do on the desktops running snappy build ;-)

[John Lenton (chipaca)]

That should do it.

[Snappy Tarmac (snappydevtarmac)]

PASSED: Continuous integration, rev:619
$BUILD_URL
Executed test runs:

Click here to trigger a rebuild:
$BUILD_URL/rebuild

review: Approve (continuous-integration)

[Sergio Schvezov (sergiusens)]

review: Approve

[Snappy Tarmac (snappydevtarmac)]

The attempt to merge lp:~chipaca/snappy/snappy-man into lp:snappy failed. Below is the output from the failed tests.

Checking docs
Checking formatting
Installing godeps
Install golint
Obtaining dependencies
update github.com/gosexy/gettext failed; trying to fetch newer version
update github.com/mvo5/goconfigparser failed; trying to fetch newer version
github.com/gosexy/gettext now at 98b7b91596d20b96909e6b60d57411547dd9959c
update github.com/blakesmith/ar failed; trying to fetch newer version
github.com/mvo5/goconfigparser now at 26426272dda20cc76aa1fa44286dc743d2972fe8
update github.com/cheggaaa/pb failed; trying to fetch newer version
github.com/blakesmith/ar now at c9a977dd0cc1392b023382c7bfa5a22af8d3b730
update github.com/jessevdk/go-flags failed; trying to fetch newer version
github.com/cheggaaa/pb now at e8c7cc515bfde3e267957a3b110080ceed51354e
update github.com/mvo5/uboot-go failed; trying to fetch newer version
github.com/jessevdk/go-flags now at 15347ef417a300349807983f15af9e65cd2e1b3a
update golang.org/x/crypto failed; trying to fetch newer version
github.com/mvo5/uboot-go now at 361f6ebcbb54f389d15dc9faefa000e996ba3e37
update gopkg.in/check.v1 failed; trying to fetch newer version
golang.org/x/crypto now at 60052bd85f2d91293457e8811b0cf26b773de469
update gopkg.in/yaml.v2 failed; trying to fetch newer version
gopkg.in/check.v1 now at 64131543e7896d5bcc6bd5a76287eb75ea96c673
gopkg.in/yaml.v2 now at 49c95bdc21843256fb6c4e0d370a05f24a0bf213
Building
Running tests from /tmp/tmp.F3pMmvW8Iq/src/launchpad.net/snappy
=== RUN Test
OK: 16 passed
--- PASS: Test (0.31 seconds)
PASS
coverage: 74.8% of statements
ok launchpad.net/snappy/clickdeb 0.319s coverage: 74.8% of statements
=== RUN Test
2015/08/14 12:31:50.771735 common.go:40: PANIC can not set option description for "package name"
OK: 9 passed
--- PASS: Test (0.01 seconds)
PASS
coverage: 19.1% of statements
ok launchpad.net/snappy/cmd/snappy 0.019s coverage: 19.1% of statements
=== RUN Test
OK: 24 passed
--- PASS: Test (0.05 seconds)
PASS
coverage: 100.0% of statements
ok launchpad.net/snappy/coreconfig 0.057s coverage: 100.0% of statements
=== RUN Test
OK: 55 passed
--- PASS: Test (0.31 seconds)
PASS
coverage: 79.9% of statements
ok launchpad.net/snappy/helpers 0.316s coverage: 79.9% of statements
=== RUN Test
OK: 0 passed, 2 skipped
--- PASS: Test (0.01 seconds)
PASS
coverage: 33.3% of statements
ok launchpad.net/snappy/i18n 0.018s coverage: 33.3% of statements
=== RUN Test
OK: 11 passed
--- PASS: Test (0.00 seconds)
PASS
coverage: 93.4% of statements
ok launchpad.net/snappy/i18n/xgettext-go 0.007s coverage: 93.4% of statements
=== RUN Test
OK: 6 passed
--- PASS: Test (0.00 seconds)
PASS
coverage: 93.5% of statements
ok launchpad.net/snappy/logger 0.006s coverage: 93.5% of statements
=== RUN Test
OK: 4 passed
--- PASS: Test (0.00 seconds)
PASS
coverage: 100.0% of statements
ok launchpad.net/snappy/oauth 0.005s coverage: 100.0% of statements
=== RUN Test
OK: 39 passed
--- PASS: Test (0.45 seconds)
PASS
coverage: 79.4% of statements
ok launchpad.net/snappy/partition 0.454s coverage: 79.4% of statements
=== RUN Test
OK: 3 passed
--- PASS: Test (0.00 seconds)
PASS
covera...

[lp:~chipaca/snappy/snappy-man]

620. By John Lenton on 2015-08-14

run update-pot

=== added file 'cmd/snappy/cmd_man.go'
--- cmd/snappy/cmd_man.go	1970-01-01 00:00:00 +0000
+++ cmd/snappy/cmd_man.go	2015-08-14 12:37:01 +0000
@@ -0,0 +1,42 @@
+// -*- Mode: Go; indent-tabs-mode: t -*-
+
+/*
+ * Copyright (C) 2014-2015 Canonical Ltd
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License version 3 as
+ * published by the Free Software Foundation.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ *
+ */
+
+package main
+
+import (
+	"os"
+
+	"launchpad.net/snappy/i18n"
+	"launchpad.net/snappy/logger"
+)
+
+type man struct{}
+
+func init() {
+	_, err := parser.AddCommand("man", i18n.G("produces manpage"), i18n.G("produces manpage"), &man{})
+	if err != nil {
+		logger.Panicf("Unable to man: %v", err)
+	}
+}
+
+func (*man) Execute([]string) error {
+	parser.WriteManPage(os.Stdout)
+
+	return nil
+}

=== modified file 'debian/rules'
--- debian/rules	2015-07-29 00:58:34 +0000
+++ debian/rules	2015-08-14 12:37:01 +0000
@@ -64,7 +64,11 @@
 	go generate ./i18n
 	dh_auto_build
 
-override_dh_auto_install:
+override_dh_auto_install: snappy.8
 	dh_auto_install -O--buildsystem=golang
 	# Making the packages private
 	rm -rf ${CURDIR}/debian/ubuntu-snappy/usr/share/gocode
+
+snappy.8:
+	./debian/ubuntu-snappy/usr/bin/snappy man > $@
+

=== added file 'debian/ubuntu-snappy-cli.manpages'
--- debian/ubuntu-snappy-cli.manpages	1970-01-01 00:00:00 +0000
+++ debian/ubuntu-snappy-cli.manpages	2015-08-14 12:37:01 +0000
@@ -0,0 +1,1 @@
+snappy.8

=== modified file 'po/snappy.pot'
--- po/snappy.pot	2015-07-24 15:16:48 +0000
+++ po/snappy.pot	2015-08-14 12:37:01 +0000
@@ -7,7 +7,7 @@
 msgid   ""
 msgstr  "Project-Id-Version: snappy\n"
         "Report-Msgid-Bugs-To: [e-mail]\n"
-        "POT-Creation-Date: 2015-07-24 16:16+0100\n"
+        "POT-Creation-Date: 2015-08-14 13:36+0100\n"
         "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
         "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
         "Language-Team: LANGUAGE <[e-mail]>\n"
@@ -325,6 +325,9 @@
 msgid   "package name is required"
 msgstr  ""
 
+msgid   "produces manpage"
+msgstr  ""
+
 #. TRANSLATORS: the %s release string
 #, c-format
 msgid   "release: %s\n"