hancock

Check-in [45ed13f554]
Login

Many hyperlinks are disabled.
Use anonymous login to enable hyperlinks.

Overview
Comment:cmd/hancock: updates to generated documentation
Downloads: Tarball | ZIP archive | SQL archive
Timelines: family | ancestors | descendants | both | trunk
Files: files | file ages | folders
SHA3-256: 45ed13f554427a6324058f464cabd57c2a4f081739b4c76ec5ebf0417acf0485
User & Date: dnc 2020-01-09 19:37:11
Context
2020-01-09
21:41
update dependency versions check-in: 7a7aedc928 user: dnc tags: trunk
19:37
cmd/hancock: updates to generated documentation check-in: 45ed13f554 user: dnc tags: trunk
19:36
cmd/hancock: fix support for relative file URLs check-in: edf65bff1c user: dnc tags: trunk
Changes
Hide Diffs Unified Diffs Ignore Whitespace Patch

Changes to cmd/hancock/README.md.

2
3
4
5
6
7
8
9
10
11
12
13
14
15






16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46

The source author produces testimony - a signed attestation - about the
source.

Verifiers then confirm their copy is identical to the souce, using `hancock
verify` to test the copy against the testimony.

Testimony includes robust hashes and signatures, to guarantee authenticity
while not revealing details about the original source. Hancock treats all
testimony as public information; currently using IPFS to distribute
testimony and a public index service to look up IPFS content identifiers.

Testimony may be produced by third parties (not exclusively the source
author). Each verifiers independently chooses which authorities they trust.







The name "hancock" comes from "John Hancock" - a slang term in the United
States meaning a person's signature.

Copyright (C) 2019 David N. Cohen see source code for license (AGPL 3)

## Dependencies

Hancock relies on IPFS to distribute data. Running your own IPFS node is
strongly recommended. See http://ipfs.io .

For building hancock, install Go version 1.12 or higher. See
https://golang.org/doc/install .

## Build and Configure

    go get src.d10.dev/hancock/cmd/...
    cp ${GOPATH%:*}/src/src.d10.dev/hancock/cmd/hancock/example/hancock.cfg ~/.config/hancock/hancock.cfg

The file `examples/hancock.cfg` has a reasonable set of defaults. Review the
comments in that file for more information. Copy the example to your
`~/.config/hancock/` and make edits if needed.

## General Usage as author

The hancock command expects optional flags and exactly one operation. Each
operation may expect operation-specific flags or arguments.

    hancock [command flags] operation [operation flags] [operation args]

Each operation produces output to stdout and expects input from stdin, in







<
<
<
<
<


>
>
>
>
>
>




|



<
<
<
|





<

<
<
<
<
|







2
3
4
5
6
7
8





9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24



25
26
27
28
29
30

31




32
33
34
35
36
37
38
39

The source author produces testimony - a signed attestation - about the
source.

Verifiers then confirm their copy is identical to the souce, using `hancock
verify` to test the copy against the testimony.






Testimony may be produced by third parties (not exclusively the source
author). Each verifiers independently chooses which authorities they trust.

Testimony is based on a robust hash of source data, in order to guarantee
authenticity while not revealing the original source. Hancock treats all
testimony as public information; although the implementation is currently
limited to finding testimony locally, the ability to store and retreive
testimony from public servers is under development.

The name "hancock" comes from "John Hancock" - a slang term in the United
States meaning a person's signature.

Copyright (C) 2019, 2020 David N. Cohen see source code for license (AGPL 3)

## Dependencies




For building hancock, install a (very) recent version of Go. See
https://golang.org/doc/install .

## Build and Configure

    go get src.d10.dev/hancock/cmd/...






## General Usage As Author

The hancock command expects optional flags and exactly one operation. Each
operation may expect operation-specific flags or arguments.

    hancock [command flags] operation [operation flags] [operation args]

Each operation produces output to stdout and expects input from stdin, in